Questo documento mostra come risolvere i problemi relativi alle operazioni di creazione dell'API di istanza collettiva.
Errori relativi alle operazioni
Quando utilizzi l'API dell'istanza collettiva per creare VM, le richieste create
restituiscono
HTTP 200 OK
con uno stato RUNNING
se l'avvio della richiesta è riuscito. Se la richiesta non viene avviata correttamente, l'API restituisce una delle risposte seguenti.
Non valida
Se durante la creazione delle VM sono presenti i seguenti campi di risposta dell'API, la richiesta API non è scritta correttamente o utilizza una proprietà non supportata dall'API collettiva.
Campi della risposta dell'API:
HTTP 400
"reason": "invalid"
Per risolvere il problema:
- Visualizza il campo
message
nella risposta per determinare quale proprietà della richiesta ha causato l'errore. - Aggiorna la proprietà che ha causato l'errore.
- Riprova a inviare la richiesta.
- Se la richiesta non riesce di nuovo, prova a utilizzare Explorer API per convalidarla. Per ulteriori informazioni, consulta la sezione Convalida delle richieste API.
Quota superata
Se durante la creazione delle VM sono presenti i seguenti campi di risposta dell'API, hai raggiunto un limite di quota per una risorsa. Per ulteriori informazioni sulle quote, consulta Quote delle risorse.
Campi della risposta dell'API:
HTTP 403
"reason": "quotaExceeded"
- Visualizza il campo "messaggio" per identificare la quota di risorse superata dalla richiesta.
- Esegui una delle seguenti operazioni:
- Riprova la richiesta con un numero inferiore di VM
- Richiedi un aumento della quota
Limite di frequenza superato
Se durante la creazione delle VM sono presenti i seguenti campi di risposta dell'API, hai raggiunto il limite di 20 richieste al secondo o hai più di 10 operazioni collettive in esecuzione contemporaneamente.
Campi della risposta dell'API:
HTTP 403
"reason": "rateLimitExceeded"
Per risolvere il problema, attendi il completamento di alcune richieste e riprova.
Capacità insufficiente
Se durante la creazione delle VM sono presenti i seguenti campi di risposta dell'API, la regione o la zona in cui hai provato a creare le VM ha una capacità insufficiente.
Campi della risposta dell'API:
HTTP 503
"reason": "insufficientCapacity"
- Crea VM in una regione diversa
- Crea VM in una zona diversa se utilizzi l'endpoint di zona
- Prova con una configurazione VM diversa
- Riprova a inviare la richiesta in un secondo momento.
Errori di stato delle richieste
Quando utilizzi l'API di istanza collettiva per creare VM, la richiesta create
restituisce HTTP 200 OK
con lo stato RUNNING
se viene avviata correttamente.
Tuttavia, la richiesta potrebbe non riuscire prima del completamento. Puoi controllare lo stato della tua richiesta per assicurarti che sia stata completata correttamente. Se la richiesta non è stata completata correttamente, verrà visualizzato uno dei seguenti stati della richiesta.
Quota superata
Se quando esegui il polling delle operazioni sono presenti i seguenti campi di risposta dell'API, la richiesta non è andata a buon fine perché hai raggiunto un limite di quota per una risorsa. Per ulteriori informazioni sulle quote, consulta Quote delle risorse.
Campi della risposta dell'API:
"status": "done"
"httpErrorMessage": "FORBIDDEN"
"code"": "QUOTA_EXCEEDED"
Per risolvere il problema:
- Visualizza il campo "messaggio" per identificare la quota di risorse superata dalla richiesta.
- Esegui una delle seguenti operazioni:
- Riprova la richiesta con un numero inferiore di VM
- Richiedi un aumento della quota
La risorsa esiste già
Se quando esegui il polling delle operazioni sono presenti i seguenti campi di risposta dell'API, la richiesta non è riuscita perché ha tentato di creare una risorsa già esistente.
Campi della risposta dell'API:
code: RESOURCE_ALREADY_EXISTS
httpErrorMessage: CONFLICT
status: DONE
Per risolvere il problema:
- Visualizza il campo
message
per identificare il nome della risorsa già esistente. - Riprova a effettuare la richiesta utilizzando un altro
namePattern
. Per saperne di più, consulta Creazione di più VM in una regione.
Capacità insufficiente
Se quando esegui il polling delle operazioni sono presenti i seguenti campi di risposta dell'API, la richiesta non è riuscita perché la regione o la zona (se utilizzi l'endpoint di zona) in cui hai provato a creare VM non dispone di capacità sufficiente.
Campi della risposta dell'API:
"status": "DONE"
"httpErrorMessage": "SERVICE UNAVAILABLE"
"code": "ZONE_RESOURCE_POOL_EXHAUSTED"
Per risolvere il problema, esegui una delle seguenti operazioni:
- Crea VM in una regione diversa
- Crea VM in una zona diversa se utilizzi l'endpoint di zona
- Prova con una configurazione VM diversa
- Riprova a inviare la richiesta in un secondo momento.
Che cosa succede dopo?
- Per scoprire di più sull'utilizzo dell'API di istanza collettiva, consulta Utilizzo dell'API di istanza collettiva.