Ce document explique comment afficher l'état de la création groupée d'instances de machine virtuelle (VM) dans un groupe d'instances géré (MIG). Il explique également comment annuler une création groupée en cours.
Pour savoir comment fonctionne la création groupée d'instances dans un MIG, consultez À propos de la création groupée d'instances dans un MIG.
Afficher l'état de la création groupée d'instances
Vous pouvez afficher l'état d'une opération de création groupée dans un MIG. L'état vous permet de vérifier si la création groupée est toujours en cours et, si les instances ne sont pas encore créées, d'en comprendre les raisons.
Les détails du MIG contiennent les champs suivants pour vous aider à surveiller l'état de la création groupée :
status.bulkInstanceOperation.inProgress: ce champ indique si une création groupée d'instances est en cours (true) ou non (false).lastProgressCheck: ce champ fournit des informations sur les raisons pour lesquelles les instances n'ont peut-être pas encore été créées. Voici les raisons possibles :Manque de capacité : lorsque le MIG attend que la capacité demandée devienne disponible, le code d'erreur
ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILSs'affiche.Quota insuffisant : si le quota est insuffisant pour répondre à votre demande, l'erreur
QUOTA_EXCEEDEDs'affiche. Pour augmenter le quota de votre projet, consultez Demander un ajustement de quota.
gcloud
Pour afficher l'état de la création groupée d'instances dans un MIG, utilisez la commande gcloud compute instance-groups managed describe.
Pour un MIG zonal, exécutez la commande suivante :
gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \ --zone=ZONEPour un MIG régional, exécutez la commande suivante :
gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \ --region=REGIONRemplacez les éléments suivants :
INSTANCE_GROUP_NAME: nom du MIG.ZONE: zone où se trouve le MIG.REGION: région où se trouve le MIG.
L'exemple suivant montre une réponse pour un MIG dans lequel une création groupée est en cours et le champ lastProgressCheck indique que la création groupée attend des ressources en raison d'une erreur ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS et comporte également une erreur QUOTA_EXCEEDED.
{
"status": {
"bulkInstanceOperation": {
"inProgress": true,
"lastProgressCheck": {
"timestamp": "2024-01-01T12:00:00.712-08:00",
"errors": [
{
"code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
"message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
},
{
"code": "QUOTA_EXCEEDED",
"message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
}
]
}
}
}
}
REST
Pour afficher l'état de la création groupée d'instances dans un MIG, envoyez une requête GET comme suit :
Pour un MIG zonal, utilisez la méthode
instanceGroupManagers.get.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAMEPour un MIG régional, utilisez la méthode
regionInstanceGroupManagers.get.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
Remplacez les éléments suivants :
PROJECT_ID: ID du projet.ZONE: zone où se trouve le MIG.REGION: région où se trouve le MIG.INSTANCE_GROUP_NAME: nom du MIG.
L'exemple suivant montre une réponse pour un MIG dans lequel une création groupée est en cours et le champ lastProgressCheck indique que la création groupée attend des ressources en raison d'une erreur ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS et comporte également une erreur QUOTA_EXCEEDED.
{
"status": {
"bulkInstanceOperation": {
"inProgress": true,
"lastProgressCheck": {
"timestamp": "2024-01-01T12:00:00.712-08:00",
"errors": [
{
"code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
"message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
},
{
"code": "QUOTA_EXCEEDED",
"message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
}
]
}
}
}
}
Afficher l'état des instances gérées
Vous pouvez surveiller l'état des instances gérées individuelles en vérifiant leur action en cours et leur état.
Pendant l'opération d'instance groupée, les instances gérées affichent les états suivants :
currentAction: CREATINGinstanceStatus: PENDING
Une fois l'opération sur les instances groupées terminée, l'état des instances gérées passe à :
currentAction: NONEinstanceStatus: RUNNING
Pour afficher ces informations sur les instances gérées, consultez Vérifier l'état des instances gérées.
Annuler l'opération de création groupée
Pour annuler une opération de création groupée, redimensionnez le MIG à zéro ou supprimez-le.
Redimensionner le MIG à zéro
Console
Accédez à la page Groupes d'instances.
Cliquez sur le nom du MIG que vous souhaitez redimensionner.
Cliquez sur Modifier.
Cliquez sur Taille du groupe et autoscaling pour développer la section.
Définissez le nombre d'instances sur
0.Cliquez sur Enregistrer.
gcloud
Pour redimensionner un MIG à zéro, utilisez la commande gcloud compute instance-groups managed resize et définissez l'option --size sur 0.
Pour un MIG zonal, exécutez la commande suivante :
gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \ --size=0 \ --zone=ZONEPour un MIG régional, exécutez la commande suivante :
gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \ --size=0 \ --region=REGION
Remplacez les éléments suivants :
INSTANCE_GROUP_NAME: nom du MIG.ZONE: zone où se trouve le MIG.REGION: région où se trouve le MIG.
REST
Pour redimensionner un MIG à zéro, envoyez une requête
PATCHà l'aide de l'une des méthodes suivantes. Dans le corps de la requête, définisseztargetSizesur0.Pour un MIG zonal, utilisez la méthode
instanceGroupManagers.patch.PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME { "targetSize": 0 }Pour un MIG régional, utilisez la méthode
regionInstanceGroupManagers.patch.PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME { "targetSize": 0 }
Remplacez les éléments suivants :
PROJECT_ID: ID du projet.ZONE: zone où se trouve le MIG.REGION: région où se trouve le MIG.INSTANCE_GROUP_NAME: nom du MIG.
Supprimer un groupe d'instances géré (MIG)
Console
Dans la console Cloud de Confiance , accédez à la page Groupes d'instances.
Cochez la case correspondant au MIG que vous souhaitez supprimer.
Cliquez sur Supprimer pour supprimer le MIG et toutes les instances qu'il contient.
gcloud
Pour supprimer un MIG, utilisez la commande delete.
Pour un MIG zonal, exécutez la commande suivante :
gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \ --zone ZONEPour un MIG régional, exécutez la commande suivante :
gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \ --region REGION
Remplacez les éléments suivants :
INSTANCE_GROUP_NAME: nom du MIG.ZONE: zone où se trouve le MIG.REGION: région où se trouve le MIG.
REST
Pour supprimer un MIG, envoyez une requête PATCH à l'aide de l'une des méthodes suivantes :
Pour un MIG zonal, utilisez la méthode
instanceGroupManagers.delete.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME
Pour un MIG régional, utilisez la méthode
regionInstanceGroupManagers.delete.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
Remplacez les éléments suivants :
PROJECT_ID: ID du projet.ZONE: zone où se trouve le MIG.REGION: région où se trouve le MIG.INSTANCE_GROUP_NAME: nom du MIG.
Étapes suivantes
- Découvrez comment afficher des informations sur les instances gérées d'un MIG.