Risoluzione dei problemi relativi alla creazione collettiva delle VM

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:

  1. Visualizza il campo message nella risposta per determinare quale proprietà della richiesta ha causato l'errore.
  2. Aggiorna la proprietà che ha causato l'errore.
  3. Riprova a inviare la richiesta.
  4. 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"
Per risolvere il problema:

  1. Visualizza il campo "messaggio" per identificare la quota di risorse superata dalla richiesta.
  2. Esegui una delle seguenti operazioni:

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"
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.

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:

  1. Visualizza il campo "messaggio" per identificare la quota di risorse superata dalla richiesta.
  2. Esegui una delle seguenti operazioni:

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:

  1. Visualizza il campo message per identificare il nome della risorsa già esistente.
  2. 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?