Risoluzione dei problemi relativi alla creazione collettiva di VM

Questo documento mostra come risolvere i problemi relativi alle operazioni di creazione dell'API di istanze collettive.

Errori di operazione

Quando utilizzi l'API di istanze collettive per creare VM, le richieste create restituiscono HTTP 200 OK con uno stato RUNNING se la richiesta viene avviata correttamente. Se la richiesta non si avvia correttamente, l'API restituisce una delle risposte riportate di seguito.

Non valido

Se i seguenti campi della risposta dell'API sono presenti quando crei le VM, la richiesta dell'API non è scritta correttamente o utilizza una proprietà non supportata dall'API per le importazioni collettive.

Campi di 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 API Explorer per convalidarla. Per ulteriori informazioni, consulta la sezione Convalida delle richieste API.

Quota superata

Se i seguenti campi di risposta dell'API sono presenti quando crei le VM, hai raggiunto un limite di quota per una risorsa. Per ulteriori informazioni sulle quote, consulta Quote delle risorse.

Campi di risposta dell'API:

  • HTTP 403
  • "reason": "quotaExceeded"
Per risolvere il problema:

  1. Visualizza il campo "message" per identificare la quota della risorsa superata dalla richiesta.
  2. Esegui una delle seguenti operazioni:

Limite di frequenza superato

Se i seguenti campi di risposta dell'API sono presenti quando crei le VM, hai raggiunto il limite di 20 richieste al secondo o hai più di 10 operazioni collettive in esecuzione contemporaneamente.

Campi di risposta dell'API:

  • HTTP 403
  • "reason": "rateLimitExceeded"

Per risolvere il problema, attendi il completamento di alcune richieste e riprova.

Capacità insufficiente

Se i seguenti campi di risposta dell'API sono presenti quando crei le VM, la regione o la zona in cui hai provato a creare le VM ha una capacità insufficiente.

Campi di risposta dell'API:

  • HTTP 503
  • "reason": "insufficientCapacity"
Per risolvere il problema, esegui una delle seguenti operazioni:

  • Creare VM in una regione diversa
  • Crea VM in una zona diversa se utilizzi l'endpoint zonale
  • Prova con una configurazione VM diversa
  • Riprova a inviare la richiesta in un secondo momento

Errori relativi allo stato della richiesta

Quando utilizzi l'API di istanze collettive per creare VM, la richiesta create restituisce HTTP 200 OK con uno stato RUNNING se la richiesta si avvia 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, viene visualizzato uno dei seguenti stati della richiesta.

Quota superata

Se i seguenti campi di risposta dell'API sono presenti quando esegui il polling delle operazioni, 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 di risposta dell'API:

  • "status": "done"
  • "httpErrorMessage": "FORBIDDEN"
  • "code"": "QUOTA_EXCEEDED"

Per risolvere il problema:

  1. Visualizza il campo "message" per identificare la quota della risorsa superata dalla richiesta.
  2. Esegui una delle seguenti operazioni:

La risorsa esiste già

Se i seguenti campi di risposta dell'API sono presenti durante le operazioni di polling, la richiesta non è andata a buon fine perché è stato tentato di creare una risorsa già esistente.

Campi di 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 ulteriori informazioni, consulta la sezione Creare più VM in una regione.

Capacità insufficiente

Se i seguenti campi di risposta dell'API sono presenti quando esegui il polling delle operazioni, la richiesta non è riuscita perché la regione o la zona (se utilizzi l'endpoint zonale) in cui hai provato a creare le VM non ha capacità sufficiente.

Campi di risposta dell'API:

  • "status": "DONE"
  • "httpErrorMessage": "SERVICE UNAVAILABLE"
  • "code": "ZONE_RESOURCE_POOL_EXHAUSTED"

Per risolvere il problema, esegui una delle seguenti operazioni:

  • Creare VM in una regione diversa
  • Crea VM in una zona diversa se utilizzi l'endpoint zonale
  • Prova con una configurazione VM diversa
  • Riprova a inviare la richiesta in un secondo momento

Passaggi successivi