UIを使用して、既存のインスタンスのメタデータ・サービスを有効にする

UI を使用して、既存のインスタンスでメタデータ・サービスを有効にします。

1. インスタンスのリストに移動する。 IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > 仮想サーバーインスタンス をクリックします。

2. インスタンス名をクリックすると詳細ページに移動します。

3. 詳細ページで、**「メタデータ」**までスクロールします。

4. トグルをクリックする（緑色に表示される）。

UIを使用して新しいインスタンスを作成する際に、メタデータ・サービスを有効にする

次の手順では、新しい仮想サーバーインスタンスを作成するときにメタデータサービスを有効にする方法を示します。

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > 仮想サーバーインスタンス をクリックします。

2. 「作成」 をクリックします。

3. インスタンスをプロビジョンします。

4. 「拡張オプション」 にナビゲートし、 「メタデータ」 を有効にします。

仮想サーバー・インスタンスの作成について詳しくは、『UI を使用した仮想サーバー・インスタンスの作成』を参照してください。

CLI を使用してインスタンスを作成するときのメタデータ・サービスの有効化または無効化

ibmcloud is instance-create コマンドを実行し、metadata-service プロパティーを true に設定します。 デフォルトでは、メタデータ・サービスは無効になっています。 応答では、 Metadata service enabled が true に設定されています。

ibmcloud is instance-create test-instance-1 7002c1cd-9b0b-43ee-8112-5124dedbe84b us-south-1  bx2-2x8  0711-08206578-d749-49ea-86c9-1014622d1c6f --image-id 9f0050d0-636b-4fe6-82ea-931664fd9d91 --metadata-service true

Creating instance test under account VPC1 as user myuser@mycompany.com...

ID                         264060c2-e5e9-44d4-994f-eea4a6688172
Name                       test-instance-1
CRN                        crn:v1:public:is:us-south-1:a/a1234567::instance:264060c2-e5e9-44d4-994f-eea4a6688172
Status                     pending
Startable                  true
Profile                    bx2-2x8
Architecture               amd64
vCPUs                      2
Memory(GiB)                8
Bandwidth(Mbps)            4000
Metadata service enabled   true
Image                      ID                                          Name
                           9f0050d0-636b-4fe6-82ea-931664fd9d91        ibm-ubuntu-20-04-minimal-amd64-1

VPC                        ID                                          Name
                           7002c1cd-9b0b-43ee-8112-5124dedbe84b        test-vpc1

Zone                       us-south-1
Resource group             ID                                  Name
                           21cabbd983d9c4beb82690daab08717e8   Default

Created                    2022-08-08T22:12:11+05:30
Boot volume                ID   Name           Attachment ID                               Attachment name
                           -    PROVISIONING   954c1c47-906d-423f-a8c8-dd3adfafd278        my-vol-attachment1

CLI を使用した既存のインスタンスのメタデータ・サービスの有効化または無効化

ibmcloud is instance-update コマンドを実行して、インスタンス ID を指定します。 メタデータ・サービスを有効にするには、metadata-service パラメーターを trueに設定し、無効にするには false に設定します。 サービスを有効にするためのコマンド例は、以下のようになります。

ibmcloud is instance-update e219a883-41f2-4680-810e-ee63ade35f98 --metadata-service true

CLIを使用して新しいインスタンス・テンプレートを作成するときに、メタデータ・サービスを有効または無効にします

CLI から インスタンス・テンプレート を作成するときに、このテンプレートに基づいて作成されたインスタンスのメタデータを収集するかどうかを指定できます。

ibmcloud is instance-create-from-template コマンドを使用して、metadata-service true (有効にする場合) または metadata-service false (無効にする場合) を指定します。 テンプレート値を設定した後、それを変更することはできません。

例えば、メタデータ・サービスを有効にしたインスタンス・テンプレートを作成するには、次のコマンドを実行します。

ibmcloud is instance-template-create my-template-name {template_id} us-south-1 mx2-2x16 {subnet_id} --image-id {image_id} --metadata-service true

このテンプレートからインスタンスを作成する場合は、metadata-service true を再度指定して、新規インスタンスでサービスを有効にします。

ibmcloud is instance-create-from-template --template-id {template_id} --name my-instance --metadata-service true

ibmcloud is instance-template-create-override-source-template コマンドを実行してインスタンス・テンプレートをオーバーライドする場合は、true または false で metadata-service パラメーターを指定して、メタデータ・サービスを有効または無効にすることができます。

これらのコマンドについて詳しくは、『VPC CLI リファレンス』を参照してください。 CLI からインスタンス・テンプレートを作成する方法について詳しくは、『インスタンス・テンプレートの作成』を参照してください。

APIを使用して新しいインスタンスを作成する際に、メタデータ・サービスを有効または無効にする

POST /instances 呼び出しを行って新規インスタンスを作成すると、メタデータ・サービスはデフォルトで無効になります。

metadata_service パラメーターを指定し、enabled を true に設定することで、サービスを有効にすることができます。

この例では、インスタンスの作成時にメタデータ・サービスを有効にする方法を示します。

curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-11-12&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
      "image": {
         "id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"
      },
      "keys": [
         {
           "id": "363f6d70-0000-0001-0000-00000013b96c"
         }
      ],
      "name": "my-instance",
      "metadata_service": {
         "enabled": true
      },
      .
      .
      .
   }'

この応答は、サービスを有効にしたときに設定されたメタデータ・パラメーターが true であることを示している。 また、GET /instance/{id} 呼び出しを実行して、メタデータ・サービス設定を確認することもできます。

API を使用した既存のインスタンスのメタデータ・サービスの有効化または無効化

既存のインスタンスからサービスを有効または無効にするには、PATCH /instance/{instance_id} 呼び出しを行い、metadata_service パラメーターを指定します。 デフォルトでは、enabled プロパティーは false に設定されています。 サービスを有効にするには、 true に設定する。

この呼び出し例は、インスタンスのメタデータ・サービスの有効化を示しています。

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-11-12&generation=2"\
    -H "Authorization: Bearer $iam_token"\
    -d '{
          "metadata_service": {
            "enabled": true
          }
      }'

この応答は、サービスを有効にしたときに設定されたメタデータ・パラメーターが true であることを示している。 また、GET /instance/{id} 呼び出しを実行して、メタデータ・サービス設定を確認することもできます。

APIを使用して新しいインスタンス・テンプレートを作成する際に、メタデータ・サービスを有効または無効にする

インスタンス・テンプレートを作成するときに、POST /instance/templates 呼び出しを行うことによってこの値を設定できます。 デフォルトでは、enabled プロパティーは false に設定されています。 有効にするには、true に設定します。

以下に例を示します。

curl -X POST "$vpc_api_endpoint/v1/instance/templates?version=2024-11-12&generation=2"\
    -H "Authorization: Bearer $iam_token"\
    -d '{
         "image": {
           "id": "3f9a2d96-830e-4100-9b4c-663225a3f872"
         },
         "keys": [
           {
             "id": "363f6d70-0000-0001-0000-00000013b96c"
           }
         ],
         "name": "my-instance-template",
         "metadata_service": {
             "enabled": true
         },
         "primary_network_interface": {
           "subnet": {
             "id": "0d933c75-492a-4756-9832-1200585dfa79"
           }
         },
         "profile": {
           "name": "bx2-2x8"
         },
         "vpc": {
           "id": "dc201ab2-8536-4904-86a8-084d84582133"
         },
         "zone": {
           "name": "us-south-1"
         }
       }'

インスタンス・テンプレートの作成後は、API を使用して metadata-service 設定を変更することはできません。 テンプレートでこれを無効にした場合は、metadata-service enabled を true に設定して、新規インスタンス・テンプレートを作成します。