インスタンスの柔軟性構成を表示する

このドキュメントでは、マネージド インスタンス グループ（MIG）内のインスタンスの柔軟性構成と、グループ内の各 VM で使用されるマシンタイプを表示する方法について説明します。

MIG でインスタンスの柔軟性を追加または変更した後、次のことができます。

始める前に

  • まだ設定していない場合は、認証を設定します。認証とは、Google Cloud のサービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      詳細については、Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

インスタンスの柔軟性構成を表示する

コンソール

  1. Google Cloud コンソールで、[インスタンス グループ] ページに移動します。

    [インスタンス グループ] に移動

  2. [名前] 列で、インスタンスの柔軟性構成を表示する MIG の名前をクリックします。

    MIG の概要ページが開きます。

  3. [詳細] タブをクリックします。

    [インスタンスの柔軟性] セクションの [インスタンスの選択] テーブルに、インスタンスの選択名、ランク、選択内のマシンタイプが表示されます。MIG にインスタンスの柔軟性が構成されていない場合、[インスタンスの柔軟性] セクションは表示されません。

gcloud

インスタンスの柔軟性構成を表示するには、ベータ版の instance-groups managed describe コマンドを使用します。--format フラグを指定して、instanceFlexibilityPolicy.instanceSelections プロパティをフィルタします。

  gcloud beta compute instance-groups managed describe INSTANCE_GROUP_NAME \
      --region REGION \
      --format="json(instanceFlexibilityPolicy.instanceSelections)"

出力例は次のとおりです。

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

MIG にインスタンスの柔軟性が構成されていない場合、出力は null を返します。

次のように置き換えます。

  • INSTANCE_GROUP_NAME: インスタンスの柔軟性構成を表示する MIG の名前。
  • REGION: MIG が配置されているリージョン。

REST

インスタンスの柔軟性構成を表示するには、ベータ版の regionInstanceGroupManagers.get メソッドを使用します。リクエスト URL に fields パラメータを含めて、instanceFlexibilityPolicy.instanceSelections プロパティをフィルタします。

  GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME?fields=instanceFlexibilityPolicy.instanceSelections

出力例は次のとおりです。

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

MIG にインスタンスの柔軟性が構成されていない場合、出力は null を返します。

次のように置き換えます。

  • PROJECT_ID: 実際のプロジェクト ID。
  • REGION: MIG が配置されているリージョン。
  • INSTANCE_GROUP_NAME: インスタンスの柔軟性構成を表示する MIG の名前。

各 VM で使用されているマシンタイプを表示する

コンソール

  1. Google Cloud コンソールで、[インスタンス グループ] ページに移動します。

    [インスタンス グループ] に移動

  2. [名前] 列で、各 VM で使用されているマシンタイプを表示する MIG の名前をクリックします。

    MIG の [概要] ページが開きます。このページには、グループ内のすべての VM、そのマシンタイプ、その他の詳細が表示されます。

gcloud

MIG 内の各 VM で使用されているマシンタイプを表示するには、ベータ版の instance-groups managed list-instances コマンドを使用して VM を一覧表示し、--format フラグを指定して propertiesFromFlexibilityPolicy.machineType フィールドをフィルタします。必要に応じて、他のフィールドをフィルタすることもできます。

  gcloud beta compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
      --region REGION \
      --format='(name,instanceStatus,currentAction,propertiesFromFlexibilityPolicy.machineType,lastAttempt.errors.errors)'

出力例は次のとおりです。

NAME: example-mig-0md2
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

NAME: example-mig-vbgg
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

次のように置き換えます。

  • REGION: MIG が配置されているリージョン。
  • INSTANCE_GROUP_NAME: インスタンスの柔軟性構成を表示する MIG の名前。

REST

MIG 内の各 VM で使用されているマシンタイプを表示するには、ベータ版の listManagedInstances メソッドを使用して VM を一覧表示し、レスポンスの propertiesFromFlexibilityPolicy.machineType フィールドを確認します。

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

出力の例を次に示します。VM の machineType フィールドが設定されている propertiesFromFlexibilityPolicy フィールドを探します。

{
  "managedInstances": [
    {
      "instance": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-b/instances/example-mig-0md2",
      "instanceStatus": "RUNNING",
      "id": "2656095434923471959",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/beta/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-0md2",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    },
    {
      "instance": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-b/instances/example-mig-vbgg",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "9171259522409694366",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/beta/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-vbgg",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    }
  ]
}

次のように置き換えます。

  • PROJECT_ID: 実際のプロジェクト ID。
  • REGION: MIG が配置されているリージョン。
  • INSTANCE_GROUP_NAME: インスタンスの柔軟性構成を表示する MIG の名前。

次のステップ