このページに記載されている方法を使用して、マネージド インスタンス グループ(MIG)に関する情報と、各 MIG 内の仮想マシン(VM)インスタンスに関する情報を表示します。
始める前に
- 制限事項を確認して、グループを作成します。
-
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール
Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- デフォルトのリージョンとゾーンを設定します。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
MIG に関する情報を表示する
たとえば、グループにアタッチされているポリシーを調べるためや、グループが安定しているのか、または変更が行われているのかを確認するために、グループ自体に関する情報を取得できます。MIG 内の VM インスタンスに関する情報を取得するには、マネージド インスタンスに関する情報を表示するをご覧ください。
MIG を一覧表示する
マネージド インスタンス グループのリストを取得するには、コンソール、gcloud CLI、または REST を使用します。
コンソール
Google Cloud コンソールで、[インスタンス グループ] ページに移動します。
既存のインスタンス グループがある場合は、それらのグループ(マネージド インスタンス グループと非マネージド インスタンス グループの両方)がこのページに一覧表示されます。
[グループタイプ] 列には、グループがマネージド、ステートフル、非マネージドのいずれであるかが示されます。ステートフル グループ タイプもマネージド インスタンス グループです。
gcloud
次のコマンドで、プロジェクト内のすべてのマネージド インスタンス グループを一覧表示します。
gcloud compute instance-groups managed list
REST
ゾーン MIG の場合、instanceGroupManagers.list
メソッドを呼び出します。
GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers
リージョン MIG の場合、regionInstanceGroupManagers.list
メソッドを呼び出します。
GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers
MIG のプロパティを表示する
ポリシー(グループの自動修復や更新ポリシーなど)を含む特定の MIG に関する情報を表示するには、コンソール、gcloud CLI、または REST を使用します。
グループの id
値を表示するには、gcloud CLI か Compute Engine API を使用する必要があります。
コンソール
Google Cloud コンソールで、[インスタンス グループ] ページに移動します。
既存のインスタンス グループがある場合は、このページにそのグループのリストが表示されます。このページには、非マネージド インスタンス グループも表示されます。
リストの [名前] 列で、情報を調べるインスタンス グループの名前をクリックします。ページが開き、インスタンス グループ プロパティと、グループに含まれるインスタンスのリストが表示されます。
[詳細] をクリックして、グループの構成を確認します。
gcloud
特定のグループの情報を取得するには、次のコマンドを実行します。
gcloud compute instance-groups managed describe instance-group \ [--zone zone | --region region]
このコマンドは、接続されているポリシーなどの、グループの詳細を返します。
出力を制限するには、--format
フラグを使用します。たとえば、次のコマンドはグループのオートスケーラー構成が存在する場合のみ返します。
gcloud compute instance-groups managed describe instance-group --format="(autoscaler)"
REST
ゾーン MIG の場合、instanceGroupManagers.get
メソッドを呼び出します。リージョン MIG の場合、regionInstanceGroupManagers.get
メソッドを呼び出します。
GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group
レスポンスには、グループの自動スケーリング ポリシー以外のアタッチ済みポリシーを含む、グループについての詳細が含まれます。自動スケーリングは MIG の機能ですが、個別の REST リソースです。
自動スケーリング ポリシー
オートスケーラーがグループにアタッチされている場合、オートスケーラーのリソースはグループの status.autoscaler
フィールドにリスト表示されます。
オートスケーラーに関する情報を取得するには、ゾーン MIG の autoscalers.get
メソッドまたはリージョン MIG の regionAutoscalers.get
メソッドをご覧ください。オートスケーラー リソースの URL には、その名前(デフォルトではオートスケーラーがアタッチ先のグループ名)が含まれます。たとえば、リージョン MIG のオートスケーラーに対して次のようなリクエストを行うことができます。
GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/regionAutoscalers/mig_name
MIG が安定しているかどうかを確認する
マネージド インスタンス グループ内のインスタンスは、いくつかのコマンドやリクエストによって作成、削除、変更されます。これらのオペレーションでは、インスタンスの作成、削除、更新のアクションがグループでスケジュールされると DONE
が返されます。しかし、それらのアクションが完了するまでは、グループ内のインスタンスの作成、削除、更新が完了したわけではありません。グループのステータスを確認するか、それらのインスタンスのステータスを確認する必要があります。
マネージド インスタンス グループが安定しているのは、なんらかの変更が行われているインスタンスがマネージド インスタンス グループ内に 1 つもなく、インスタンスに対してスケジュールされている将来の変更がなく、グループ自体も変更途中でない場合です。
グループ内のすべてのインスタンスが正常に機能していることが前提の依存関係がある場合、そのグループが安定しているかどうかの確認が必要になることがあります。たとえば、ジョブのスケジュール、トラフィックの送信、キー範囲の割り当てを開始する前に、すべての VM が正常に稼働していることを確認します。
グループの status.isStable
フィールドの値をチェックして、マネージド インスタンス グループ内のすべてのインスタンスが実行中で正常な状態であることを確認します。
gcloud
describe
コマンドを実行します。
gcloud compute instance-groups managed describe instance-group-name \ [--zone zone | --region region]
gcloud CLI により、status.isStable
フィールドを含む MIG の詳細情報が返されます。
MIG が安定するまでスクリプトを一時停止するには、--stable
フラグを指定して wait-until
コマンドを使用します。次に例を示します。
gcloud compute instance-groups managed wait-until instance-group-name \
--stable \
[--zone zone | --region region]
Waiting for group to become stable, current operations: deleting: 4
Waiting for group to become stable, current operations: deleting: 4
...
Group is stable
status.isStable
が MIG に対して true
に設定された後に、このコマンドが返されます。
REST
ゾーン MIG の場合は、GET
リクエストを instanceGroupManagers.get
メソッドに対して作成します。
GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/get
リージョン マネージド インスタンス グループの場合は、zones/zone
を regions/region
に置き換えます。
GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group-name/get
これらのリクエストは、status.isStable
フィールドを含む MIG の詳細情報を返します。
status.isStable
が false
である場合は、変更がアクティブか保留中か、MIG 自体が変更されているかどうかを示します。
status.isStable
が true
の場合は、次のことを意味します。
- なんらかの変更が行われているインスタンスが MIG 内に 1 つもなく、すべてのインスタンスの
currentAction
がNONE
となっている。 - 変更が保留中になっているインスタンスが MIG 内に 1 つもない。
- MIG 自体も変更されていない。
MIG はさまざまな方法で変更可能なため、MIG の安定性はさまざまな要因で変化します。次に例を示します。
- 新しいインスタンス テンプレートのロールアウトをリクエストした。
- MIG 内のインスタンスの作成、削除、サイズ変更、または更新をリクエストした。
- オートスケーラーによって MIG のサイズ変更をリクエストした。
- 自動修復ツールリソースが MIG 内の正常な状態でないインスタンスを少なくとも 1 つ置き換えた。
- リージョン MIG で、一部のインスタンスが再分散された。
すべてのアクションが終了すると、その MIG の status.isStable
が true
に再び設定されます。
個々の VM インスタンスについては、マネージド インスタンスのステータスの確認をご覧ください。
MIG で VM の修復がオフになっているかどうかを確認する
MIG で VM の修復がオフになっているかどうかを確認するには、コンソール、gcloud CLI、または API を使用します。
コンソール
- Google Cloud コンソールで、[インスタンス グループ] ページに移動します。
- 表示するインスタンス グループの名前をクリックします。ページが開き、インスタンス グループ プロパティと、グループに含まれるインスタンスのリストが表示されます。
- [詳細] タブをクリックします。
- [VM インスタンスのライフサイクル] セクションで、[障害発生時のデフォルトのアクション] フィールドを確認します。値が
No action
の場合、MIG で修復がオフになります。
gcloud
次のように describe
メソッドを使用します。
gcloud compute instance-groups managed describe instance-group \ --format="(instanceLifecyclePolicy)"
レスポンスの本文で、defaultActionOnFailure
フィールドを確認します。可能な値は次のとおりです。
REPAIR
: MIG は、障害が発生した VM または異常な VM を同じゾーンに再作成します。DO_NOTHING
: MIG で修復がオフになっています。MIG は、グループ内の障害が発生した VM や異常な VM に対してアクションを行いません。
以下は、MIG が VM を再作成して修復することを示す出力例です。
instanceLifecyclePolicy: defaultActionOnFailure: REPAIR forceUpdateOnRepair: NO
API
ゾーン MIG の場合は、instanceGroupManagers.get
メソッドを使用し、リージョン MIG の場合は regionInstanceGroupManagers.get
メソッドを使用します。
ゾーン MIG の VM 障害に対する MIG アクションを表示するには、次の呼び出しを行います。
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP
レスポンスの本文で、instanceLifecyclePolicy.defaultActionOnFailure
フィールドを確認します。可能な値は次のとおりです。
REPAIR
: MIG は、障害が発生した VM または異常な VM を同じゾーンに再作成します。DO_NOTHING
: MIG で修復がオフになっています。MIG は、グループ内の障害が発生した VM や異常な VM に対してアクションを行いません。
以下は、MIG が VM を再作成して修復することを示すレスポンスの例です。
"instanceLifecyclePolicy": { "forceUpdateOnRepair": "NO", "defaultActionOnFailure": "REPAIR" }
グループ内の障害が発生した VM や異常な VM を MIG で修復しない場合は、MIG で修復をオフにします。
自動修復オペレーション履歴を表示する
自動修復を構成している場合は、過去の自動修復イベントを表示できます。
ローリング更新をモニタリングする
ローリング アップデートを開始した場合、アップデートが完了したかどうかを確認するには、アップデートのモニタリングをご覧ください。
ステートフル構成を表示する
ステートフル MIG を構成し、その構成を確認する場合は、ステートフル構成の表示をご覧ください。
MIG 内のマネージド VM インスタンスに関する情報を表示する
MIG のマネージド インスタンスを一覧表示する
コンソール、gcloud CLI、REST のいずれかを使用して、グループ内のマネージド インスタンスのリストと、それらのステータスおよびテンプレートを取得します。
コンソール
Google Cloud コンソールで、[インスタンス グループ] ページに移動します。
既存のインスタンス グループがある場合は、このページにそのグループのリストが表示されます。このページには、非マネージド インスタンス グループも表示されます。
リストの [名前] 列で、情報を調べるインスタンス グループの名前をクリックします。ページが開き、インスタンス グループ プロパティと、グループに含まれるインスタンスのリストが表示されます。
gcloud
gcloud CLI の list-instances
サブコマンドを使用します。
gcloud compute instance-groups managed list-instances instance-group \ [--zone zone | --region region]
このコマンドは、インスタンスのリストと、現在のステータス、インスタンス テンプレート、最後のエラーなどのインスタンスの詳細を返します。
REST
ゾーン MIG の場合は、instanceGroupManagers.listManagedInstances
メソッドに対する GET
リクエストを作成し、特定のマネージド インスタンス グループの名前をリクエストに含めます。
GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group
リージョン(マルチゾーン)マネージド インスタンス グループの場合は、代わりに regionInstanceGroupManagers
リソースを使用して、regionInstanceGroupManagers.list とします。
GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group
レスポンスには、インスタンスのリストと、現在のステータスやインスタンス テンプレートなどのインスタンスの詳細が含まれます。
マネージド インスタンスのステータスを確認する
マネージド インスタンス グループ内のインスタンスは、いくつかのコマンドやリクエストによって作成、削除、変更されます。これらのオペレーションでは、インスタンスの作成、削除、更新のアクションがグループでスケジュールされると DONE
が返されます。しかし、それらのアクションが完了するまでは、グループ内のインスタンスの作成、削除、更新が完了したわけではありません。インスタンスのステータスを確認するか、グループ自体のステータスを確認する必要があります。
Google Cloud CLI または REST を使用して、マネージド インスタンス グループ内のインスタンスの詳細を表示します。詳細には、インスタンスのステータスと、グループがインスタンスで実行中の現在のアクションが含まれます。
gcloud
すべてのマネージド インスタンス
グループ内のすべてのインスタンスのステータスと現在のアクションを確認するには、list-instances
コマンドを使用します。
gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \ [--zone=ZONE | --region=REGION]
このコマンドは、ステータス、現在のアクション、その他の詳細情報を含むグループ内のインスタンスの一覧を返します。
NAME ZONE STATUS HEALTH_STATE ACTION INSTANCE_TEMPLATE VERSION_NAME LAST_ERROR vm-instances-9pk4 us-central1-f CREATING my-new-template vm-instances-h2r1 us-central1-f STOPPING DELETING my-old-template vm-instances-j1h8 us-central1-f RUNNING NONE my-old-template vm-instances-ngod us-central1-f RUNNING NONE my-old-template
ヘルスチェックを設定しない限り、HEALTH_STATE
列は空欄になります。
特定のマネージド インスタンス
グループ内の特定のインスタンスのステータスと現在のアクションを確認するには、describe-instance
コマンドを使用します。
gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \ --instance INSTANCE_NAME \ [--zone=ZONE | --region=REGION]
このコマンドは、インスタンスの詳細情報(現在のステータス、現在のアクション、ステートフル MIG の保持状態など)を返します。
currentAction: NONE id: '6789072894767812345' instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41 instanceStatus: RUNNING name: example-mig-hz41 preservedStateFromConfig: metadata: example-key: example-value preservedStateFromPolicy: disks: persistent-disk-0: autoDelete: NEVER mode: READ_WRITE source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41 version: instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template
REST
リージョンまたはゾーンの MIG リソースに対して listManagedInstances
メソッドを呼び出します。たとえば、ゾーン MIG リソース内のインスタンスの詳細を表示するには、次のリクエストを行います。
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances
この呼び出しでは、各インスタンスの instanceStatus
と currentAction
を含む MIG のインスタンスのリストが返されます。
{ "managedInstances": [ { "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp", "id": "5317605642920955957", "instanceStatus": "RUNNING", "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template", "currentAction": "REFRESHING" }, { "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-pz5j", "currentAction": "DELETING" }, { "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5", "id": "2800161036826218547", "instanceStatus": "RUNNING", "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template", "currentAction": "REFRESHING" } ] }
有効な instanceStatus
フィールド値の一覧については、VM インスタンスのライフサイクルをご覧ください。
インスタンスがなんらかの種類の変更を実行している場合、マネージド インスタンス グループは、インスタンスの currentAction
フィールドを次のいずれかのアクションに設定して、変更の進捗状況を追跡できるようにします。それ以外の場合、currentAction
フィールドは NONE
に設定されます。
有効な currentAction
の値は次のとおりです。
ABANDONING
。インスタンスを MIG から削除中です。CREATING
。インスタンスは作成中です。CREATING_WITHOUT_RETRIES
。インスタンスが再試行なしで作成されています。インスタンスが最初の試行で作成されない場合、MIG はインスタンスの置換を行いません。DELETING
。インスタンスは削除中です。RECREATING
。インスタンスは置換中です。REFRESHING
。インスタンスは現在のターゲット プールから削除中で、現在のターゲット プールのリスト(このリストは既存のターゲット プールと同じ場合も異なる場合もあります)に再度追加中です。RESTARTING
。インスタンスはstop
メソッドとstart
メソッドを使用して再起動中です。RESUMING
。インスタンスは一時停止後に再開処理中です。STARTING
。インスタンスは停止後に起動中です。STOPPING
。インスタンスは停止の準備中です。SUSPENDING
。インスタンスは一時停止の準備中です。VERIFYING
。インスタンスは作成済みで、検証中です。NONE
。インスタンスに対して実行されているアクションはありません。
グループ全体が安定しているか、または変更が行われているのかを確認するには、グループのステータスの確認をご覧ください。
ヘルス状態を確認する
マネージド インスタンス グループの自動修復を構成した場合は、各 VM のヘルス状態を確認できます。ヘルス状態の確認をご覧ください。
インスタンス エラーを一覧表示する
マネージド インスタンスでエラーが発生した場合は、それらのエラーを表示して原因を診断し、軽減できます。
Google Cloud コンソール、gcloud CLI、または REST を使用して、エラーを一覧表示します。
コンソール
Google Cloud コンソールの [インスタンス グループ] ページに移動します。
リストの [名前] 列で、情報を調べるインスタンス グループの名前をクリックします。ページが開き、インスタンス グループ プロパティと、グループに含まれるインスタンスのリストが表示されます。
[エラー] をクリックします。
gcloud
instance-groups managed list-errors
コマンドを使用して、グループ内の最新のエラーを一覧表示する
gcloud compute instance-groups managed list-errors instance-group-name \ [--zone zone | --region region]
次に例を示します。
gcloud compute instance-groups managed list-errors example-group \ --region us-west1
INSTANCE_URL ACTION ERROR_CODE ERROR_MESSAGE TIMESTAMP INSTANCE_TEMPLATE VERSION_NAME https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-v0hl CREATING QUOTA_EXCEEDED Instance 'igm-1-v0hl' creation failed: Quota 'CPUS' exceeded. Limit: 1.0 in zone us-central1-a. 2019-07-11T07:44:40.156-07:00 https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1 https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-qp3d CREATING QUOTA_EXCEEDED Instance 'igm-1-qp3d' creation failed: Quota 'CPUS' exceeded. Limit: 1.0 in zone us-central1-a. 2019-07-11T07:44:40.081-07:00 https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1 ...
REST
ゾーンまたはリージョンのマネージド インスタンス グループの listErrors
メソッドに対する GET
リクエストを作成します。
次に例を示します。
GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100
その結果、次のようなレスポンスが得られます。
{ "items": [ { "error": { "code": "QUOTA_EXCEEDED", "message": "Instance 'example-mig-m1sz' creation failed: Quota 'CPUS' exceeded. Limit: 50.0 in zone us-central1-c." }, "timestamp": "2019-01-03T18:47:28.457-08:00", "instanceDetails" : { "instance": "zones/us-central1-c/instances/example-mig-m1sz", "action": "CREATING", "version": { "name": "example-version-name", "instanceTemplate": "global/instanceTemplates/example-template", } } } ], ... "nextPageToken": "Ch0yMDE5LTA3LTI5VDExOjA4OjA2LjYxMi0wNzowMBJ5aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vY29tcHV0ZS9zdGFnaW5nX2FscGhhL3Byb2plY3RzL215cnpha2VyZXltcy1zdGFnaW5nL3pvbmVzL3VzLWNlbnRyYWwxLWlyMS9pbnN0YW5jZXMvaWdtLTEtcXAzZA==" }
listErrors
API はリストのページ分割をサポートしています。結果の次のページを取得するには、後続のリクエストで 1 つのレスポンスから nextPageToken
フィールドを使用します。例: GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100&nextPageToken=next-page-token
。next-page-token
は、前のレスポンスから取得したトークンに置き換えます。
考えられるエラーのリストは次のとおりです。ただし、エラーはこれらの例に限定されるわけではありません。
- 次の理由により、新しいインスタンスを作成できない。
- プリエンプティブル容量を使用できない。
- 割り当ての不足。特定のリージョンの CPU に対する割り当ての不足など。
- グループに関連付けられたネットワークの VM インスタンス数の上限に達した。
- インスタンス テンプレートの
properties.disks[].initializeParams.sourceImage
フィールドで指定されたディスク イメージが削除されたか、その権限が変更された。 - プロジェクトに関連付けられた請求先アカウントのクレジット カードによる支払いが拒否された。
- 次の理由により、既存のインスタンスを削除できない。
- グループが使用するサービス アカウントに
compute.instances.delete
権限がない。 - リクエストされた同時削除の数が多すぎ、レート制限を超えた。
- グループが使用するサービス アカウントに
- ターゲット プールが削除されたため、インスタンスをターゲットプールに追加できない。
このようなエラーを調査した後、それらを軽減できます。次に例を示します。
- ワークロードをプリエンプティブル容量を持つ別のゾーンに移動します。
- 特定のリージョンで割り当ての増加をリクエストします。
- グループで使用するサービス アカウントに
compute.instances.delete
権限を追加します。
マネージド インスタンス グループによってトリガーされたアクションが失敗した場合(たとえば、オートスケーラーがグループのサイズを増やそうとしたときにエラーが発生した場合など)、グループは即時にそのアクションを再試行します。最後の即時再試行が失敗した場合、MIG はエラーを記録します。インスタンス エラーを一覧表示してエラーを確認できます。バックオフ時間が経過すると、グループは失敗した操作を再試行します。エラーが解消されない場合は、複数回記録されることがあります。
Compute Engine は、基盤となるインスタンスが存在しなくなったか、作成できなかった場合でも、過去 8 日間の最新の 500 件のエラーを保持します。
VM インスタンスが MIG のメンバーかどうかを確認する
特定の VM が現在グループのメンバーであるかどうかを確認するには、コンソールまたは REST を使用します。
コンソール
- Google Cloud コンソールで [VM インスタンス] ページに移動します。
- インスタンスをクリックして、[VM インスタンスの詳細] にアクセスします。
- VM インスタンスがマネージド インスタンス グループのメンバーである場合は、そのマネージド インスタンス グループの名前が [使用中] という見出しの下に表示されます。VM インスタンスがグループのメンバーでない場合、[使用中] という見出しはインスタンスの詳細ページに表示されません。
REST
VM インスタンスのリファラーの表示をご覧ください。
あるいは、インスタンスのメタデータで次の 2 つのメタデータキーを探し、VM がマネージド インスタンス グループのメンバーであるかどうかを識別します。
instance-template
は、VM の作成に使用されたテンプレートを示します。created-by
は、VM を作成したマネージド インスタンス グループを示します。
インスタンスを破棄する場合でも、手動で削除しない限り、VM にはこれらのメタデータ エントリが含まれています。
たとえば、random-instance-biy
という名前の VM があり、VM がマネージド インスタンス グループによって作成されたかどうかを知りたい場合は、インスタンスを記述してメタデータキーを探します。次に例を示します。
gcloud compute instances describe random-instance-biy \ --zone us-central1-f
gcloud CLI から次のようなレスポンスが返されます。
canIpForward: false cpuPlatform: Intel Ivy Bridge creationTimestamp: '2016-08-24T14:11:38.012-07:00' ... metadata: items: - key: instance-template value: projects/123456789012/global/instanceTemplates/example-it - key: created-by value: projects/123456789012/zones/us-central1-f/instanceGroupManagers/igm-metadata
マネージド インスタンスの保持状態を表示する
ステートフル MIG を構成し、各マネージド インスタンスの保持状態を確認する場合は、ステートフル構成と保持状態の表示をご覧ください。
次のステップ
- マネージド インスタンス グループの詳細を見る。
- マネージド インスタンス グループの作成に使用できるインスタンス テンプレートを作成する。