在主控台中為現有的實例啟用對元資料服務的存取

使用使用者介面啟用存取現有實體上的元資料服務。

1. 跳至實例清單。 在 IBM Cloud控制台中，點選導航選單圖示> 基礎架構> 計算 > 虛擬伺服器實例。

2. 按一下實例名稱，以移至詳細資料頁面。

3. 在詳細資料頁面上，捲動至 meta 資料。

4. 按一下切換 (顯示綠色)。

在主控台中建立實體時，啟用對元資料服務的存取

以下程序說明如何在建立虛擬伺服器實例時啟用對元資料服務的存取。

1. 在 IBM Cloud控制台中，點選導航選單圖示> 基礎架構> 計算 > 虛擬伺服器實例。

2. 按一下建立。

3. 佈建實例。

4. 導覽至 進階選項 並啟用 meta 資料。

如需有關建立虛擬伺服器實體的詳細資訊，請參閱 在主控台中建立虛擬伺服器實體。

在主控台中啟用或停用對實例範本上的元資料服務的存取

當您建立 實例範本時，預設會停用元資料服務切換。 按一下切換開啟服務存取。

查看現有實例範本的詳細資訊時，頁面會顯示該範本是否啟用了元資料服務。 在建立範本之後，您無法變更實例範本 meta 資料設定。

從 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 建立 實例範本 時，可以指出是否針對根據此範本建立的實例收集 meta 資料。

使用 ibmcloud is instance-create-from-template 指令，並指定 --metadata-service true 選項啟用或 --metadata-service false 選項停用。 設定範本值之後，您無法變更它。

例如，若要建立一個已啟用 metadata 服務存取的實例範本，請執行此指令：

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} 呼叫來驗證 meta 資料服務設定。

使用 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} 呼叫來驗證 meta 資料服務設定。

使用 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。