このドキュメントでは、マネージド インスタンス グループ（MIG）内の仮想マシン（VM）インスタンスの一括作成のステータスを表示する方法について説明します。また、進行中の一括作成をキャンセルする方法についても説明します。
MIG でのインスタンスの一括作成の仕組みについては、 MIG でのインスタンスの一括作成についてをご覧ください。
インスタンスの一括作成のステータスを表示する
MIG で一括作成オペレーションのステータスを表示できます。ステータスを使用すると、一括作成がまだ進行中かどうかを確認できます。また、インスタンスがまだ作成されていない場合は、その理由を把握できます。
MIG の詳細には、一括作成のステータスをモニタリングするのに役立つ次のフィールドが含まれています。
status.bulkInstanceOperation.inProgress: このフィールドは、インスタンスの一括作成が進行中かどうか（true）を示します。falselastProgressCheck: このフィールドには、インスタンスがまだ作成されていない理由の詳細が表示されます。考えられる理由は次のとおりです。容量不足: MIG がリクエストされた容量が使用可能になるのを待機している場合、
ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILSエラーコードが表示されます。割り当て不足: リクエストを満たすのに十分な割り当てがない場合、
QUOTA_EXCEEDEDエラーが表示されます。プロジェクトの割り当てを増やすには、割り当ての調整をリクエストするをご覧ください。
gcloud
MIG でインスタンスの一括作成のステータスを表示するには、
gcloud compute instance-groups managed describe コマンドを使用します。
ゾーン MIG の場合は、次のコマンドを実行します。
gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \ --zone=ZONEリージョン MIG の場合は、次のコマンドを実行します。
gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \ --region=REGION次のように置き換えます。
INSTANCE_GROUP_NAME: MIG の名前。ZONE: MIG が存在するゾーン。REGION: MIG が存在するリージョン。
次の例は、一括作成が進行中の MIG のレスポンスを示しています。lastProgressCheck フィールドは、ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS エラーにより一括作成がリソースを待機していることを示しています。また、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
MIG でインスタンスの一括作成のステータスを表示するには、次のように GET リクエストを送信します。
ゾーン MIG の場合は、
instanceGroupManagers.getメソッドを使用します。GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAMEリージョン MIG の場合は、
regionInstanceGroupManagers.getメソッドを使用します。GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
次のように置き換えます。
PROJECT_ID: プロジェクト ID。ZONE: MIG が存在するゾーン。REGION: MIG が存在するリージョン。INSTANCE_GROUP_NAME: MIG の名前。
次の例は、一括作成が進行中の MIG のレスポンスを示しています。lastProgressCheck フィールドは、ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS エラーにより一括作成がリソースを待機していることを示しています。また、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."
}
]
}
}
}
}
マネージド インスタンスのステータスを表示する
個々のマネージド インスタンスのステータスは、現在のオペレーションとインスタンスのステータスを確認することでモニタリングできます。
インスタンスの一括オペレーションが進行中の場合、マネージド インスタンス には次のステータスが表示されます。
currentAction: CREATINGinstanceStatus: PENDING
インスタンスの一括オペレーションが正常に完了すると、マネージド インスタンスのステータスは次のように変わります。
currentAction: NONEinstanceStatus: RUNNING
マネージド インスタンスに関するこの情報を表示するには、 マネージド インスタンスのステータスを確認するをご覧ください。
一括作成オペレーションをキャンセルする
一括作成オペレーションをキャンセルするには、MIG のサイズをゼロに変更するか、MIG を削除します。
MIG のサイズをゼロに変更する
コンソール
[インスタンス グループ] ページに移動します。
サイズを変更する MIG の名前をクリックします。
[編集] をクリックします。
[Group size &autoscaling] をクリックして、セクションを開きます。
[インスタンス数] を「
0」に設定します。[保存] をクリックします。
gcloud
MIG のサイズをゼロに変更するには、
gcloud compute instance-groups managed resize コマンドを使用して、--size フラグを 0 に設定します。
ゾーン MIG の場合は、次のコマンドを実行します。
gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \ --size=0 \ --zone=ZONEリージョン MIG の場合は、次のコマンドを実行します。
gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \ --size=0 \ --region=REGION
次のように置き換えます。
INSTANCE_GROUP_NAME: MIG の名前。ZONE: MIG が存在するゾーン。REGION: MIG が存在するリージョン。
REST
MIG のサイズをゼロに変更するには、次のいずれかの方法で
PATCHリクエストを送信します。リクエストの本文で、targetSizeを0に設定します。ゾーン MIG の場合は、
instanceGroupManagers.patchメソッドを使用します。PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME { "targetSize": 0 }リージョン MIG の場合は、
regionInstanceGroupManagers.patchメソッドを使用します。PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME { "targetSize": 0 }
次のように置き換えます。
PROJECT_ID: プロジェクト ID。ZONE: MIG が存在するゾーン。REGION: MIG が存在するリージョン。INSTANCE_GROUP_NAME: MIG の名前。
MIG を削除する
コンソール
Google Cloud コンソールで、[インスタンス グループ] ページに移動します。
削除する MIG のチェックボックスをオンにします。
[削除] をクリックして、MIG とその中のすべてのインスタンスを削除します。
gcloud
MIG を削除するには、
delete コマンドを使用します。
ゾーン MIG の場合は、次のコマンドを実行します。
gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \ --zone ZONEリージョン MIG の場合は、次のコマンドを実行します。
gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \ --region REGION
次のように置き換えます。
INSTANCE_GROUP_NAME: MIG の名前。ZONE: MIG が存在するゾーン。REGION: MIG が存在するリージョン。
REST
MIG を削除するには、次のいずれかの方法で PATCH リクエストを送信します。
ゾーン MIG の場合は、
instanceGroupManagers.deleteメソッドを使用します。DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME
リージョン MIG の場合は、
regionInstanceGroupManagers.deleteメソッド を使用します。DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
次のように置き換えます。
PROJECT_ID: プロジェクト ID。ZONE: MIG が存在するゾーン。REGION: MIG が存在するリージョン。INSTANCE_GROUP_NAME: MIG の名前。
次のステップ
- MIG 内のマネージド インスタンスに関する情報を表示する方法を確認する。