配置元数据服务

在控制台中为现有实例启用元数据服务访问权限

使用用户界面在现有实例上启用对元数据服务的访问。

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

通过 CLI 启用或禁用现有实例的元数据服务访问权限

运行 ibmcloud is instance-update 命令并指定实例标识。 若要启用访问元数据服务，请将 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 创建实例模板的更多信息，请参阅 创建实例模板。

使用应用程序接口创建新实例时，启用或禁用对元数据服务的访问

通过 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} 调用来验证元数据服务设置。

使用应用程序接口创建新实例模板时，启用或禁用对元数据服务的访问

创建实例模板时，可通过 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。