Résoudre les problèmes de création groupée de VM

Ce document explique comment résoudre les problèmes liés aux opérations de création d'API d'instances groupées.

Erreurs d'opération

Lorsque vous créez des VM à l'aide de l'API d'instances groupées, les requêtes create renvoient HTTP 200 OK avec l'état RUNNING si la requête démarre correctement. Si la requête ne démarre pas correctement, l'API renvoie l'une des réponses ci-dessous.

Non valide

Si les champs de réponse d'API suivants sont présents lorsque vous créez des VM, votre requête d'API n'est pas écrite correctement ou elle utilise une propriété qui n'est pas compatible avec l'API groupée.

Champs de réponse d'API :

  • HTTP 400
  • "reason": "invalid"

Pour résoudre ce problème, procédez comme suit :

  1. Affichez le champ message dans la réponse pour déterminer quelle propriété de la requête a causé l'erreur.
  2. Mettez à jour la propriété à l'origine de l'erreur.
  3. Réessayez d'envoyer la requête.
  4. Si la requête échoue à nouveau, essayez d'utiliser APIs Explorer pour la valider. Pour en savoir plus, consultez la section Valider des requêtes API.

Quota dépassé

Si les champs de réponse d'API suivants sont présents lorsque vous créez des VM, vous avez atteint une limite de quota pour une ressource. Pour en savoir plus sur les quotas, consultez la page Quotas de ressources.

Champs de réponse d'API :

  • HTTP 403
  • "reason": "quotaExceeded"
Pour résoudre ce problème, procédez comme suit :

  1. Affichez le champ "message" pour identifier le quota de ressources dépassé par la requête.
  2. Effectuez l'une des opérations suivantes :

Limitation du débit dépassée

Si les champs de réponse d'API suivants sont présents lorsque vous créez des VM, vous avez atteint la limite de 20 requêtes par seconde ou vous avez plus de 10 opérations groupées en train de s'exécuter en même temps.

Champs de réponse d'API :

  • HTTP 403
  • "reason": "rateLimitExceeded"

Pour résoudre ce problème, attendez que certaines requêtes soient terminées, puis réessayez.

Capacité insuffisante

Si les champs de réponse d'API suivants sont présents lorsque vous créez des VM, la région ou la zone dans laquelle vous avez tenté de créer des VM dispose d'une capacité insuffisante.

Champs de réponse d'API :

  • HTTP 503
  • "reason": "insufficientCapacity"
Pour résoudre ce problème, effectuez l'une des opérations suivantes :

  • Créez des VM dans une autre région.
  • Créez des VM dans une autre zone si vous utilisez le point de terminaison zonal.
  • Essayez une autre configuration de VM.
  • Réessayer la requête ultérieurement

Erreurs liées à l'état de la requête

Lorsque vous utilisez l'API d'instances groupées pour créer des VM, votre requête create renvoie HTTP 200 OK avec l'état RUNNING si la requête démarre correctement. Cependant, la requête peut échouer avant de se terminer. Vous pouvez vérifier l'état de votre requête pour vous assurer qu'elle a abouti. Si la requête n'a pas abouti, l'un des états de requête suivants s'affiche.

Quota dépassé

Si les champs de réponse d'API suivants sont présents lorsque vous interrogez des opérations, votre requête a échoué car vous avez atteint une limite de quota pour une ressource. Pour plus d'informations sur les quotas, consultez la section Quotas de ressources.

Champs de réponse d'API :

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

Pour résoudre ce problème, procédez comme suit :

  1. Affichez le champ "message" pour identifier le quota de ressources dépassé par la requête.
  2. Effectuez l'une des opérations suivantes :

La ressource existe déjà.

Si les champs de réponse d'API suivants sont présents lorsque vous interrogez des opérations, votre requête a échoué car elle a tenté de créer une ressource qui existe déjà.

Champs de réponse d'API :

  • code: RESOURCE_ALREADY_EXISTS
  • httpErrorMessage: CONFLICT
  • status: DONE

Pour résoudre ce problème, procédez comme suit :

  1. Affichez le champ message pour identifier le nom de la ressource qui existe déjà.
  2. Relancez votre requête avec un autre namePattern. Pour en savoir plus, consultez la section Créer plusieurs VM dans une région.

Capacité insuffisante

Si les champs de réponse d'API suivants sont présents lorsque vous interrogez les opérations, votre requête a échoué car la région ou la zone (si vous utilisez le point de terminaison zonal) où vous avez essayé de créer des VM présente une capacité insuffisante.

Champs de réponse d'API :

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

Pour résoudre ce problème, effectuez l'une des opérations suivantes :

  • Créez des VM dans une autre région.
  • Créez des VM dans une autre zone si vous utilisez le point de terminaison zonal.
  • Essayez une autre configuration de VM.
  • Réessayer la requête ultérieurement

Étape suivante