コンソールで既存のインスタンスのメタデータ・サービスへのアクセスを有効にする

UI を使用して、既存のインスタンス上のメタデータサービスへのアクセスを有効にします。

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

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

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

4. トグルをクリックしてください（緑色に変わります）。

コンソールでインスタンスを作成する際にメタデータ・サービスへのアクセスを有効にする

次の手順では、仮想サーバーインスタンスの作成時にメタデータサービスへのアクセスを有効にする方法を示します。

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

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

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

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

仮想サーバーインスタンスの作成の詳細については、 コンソールでの仮想サーバーインスタンスの作成を 参照してください。

コンソールでインスタンス・テンプレートのメタデータ・サービスへのアクセスを有効または無効にする

インスタンス・テンプレートを 作成すると、メタデータ・サービスのトグルはデフォルトで無効になります。 トグルをクリックして、サービスへのアクセスを有効にしてください。

既存のインスタンステンプレートの詳細を表示すると、そのテンプレートでメタデータサービスが有効になっているかどうかがページ上に表示されます。 テンプレートの作成後にインスタンス・テンプレートのメタデータ設定を変更することはできません。

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

instance-createで使用できるオプションの完全なリストについては、CLIのヘルプを参照してください。

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 有効を true に設定して新しいインスタンス・テンプレートを作成します。