Ativação do acesso ao serviço de metadados para uma instância existente no console

Use a interface do usuário para habilitar o acesso ao serviço de metadados em uma instância existente.

1. Acesse a lista de instâncias. No IBM Cloud console, clique no ícone Navigation Menu > Infrastructure > Compute > Virtual server instances.

2. Clique no nome de uma instância para acessar a página de detalhes.

3. Na página de detalhes, role para Metadados.

4. Clique no botão de alternância (que fica verde).

Ativação do acesso ao serviço de metadados quando você cria uma instância no console

O procedimento a seguir mostra como habilitar o acesso ao serviço de metadados quando você cria uma instância de servidor virtual.

1. No IBM Cloud console, clique no ícone Navigation Menu > Infrastructure > Compute > Virtual server instances.

2. Clique em Criar.

3. Provisione a instância.

4. Navegue para Opções avançadas e ative Metadados.

Para obter mais informações sobre a criação de instâncias de servidor virtual, consulte Criação de instâncias de servidor virtual no console.

Ativação ou desativação do acesso ao serviço de metadados em modelos de instância no console

Quando você cria um modelo de instância, a alternância do serviço de metadados é desativada por padrão. Clique no botão de alternância para habilitar o acesso ao serviço.

Ao visualizar os detalhes de um modelo de instância existente, a página indica se o serviço de metadados estava habilitado ou não para o modelo. Não é possível mudar a configuração de metadados do modelo de instância depois de criar o modelo

Ativação ou desativação do acesso ao serviço de metadados quando você cria uma instância a partir da CLI

Execute o comando ibmcloud is instance-create e configure a propriedade metadata-service como true. O acesso ao serviço de metadados está desativado por padrão. Na resposta, você vê Metadata service enabled configurado como 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

Consulte a ajuda da CLI para obter a lista completa de opções disponíveis para instance-create.

Ativação ou desativação do acesso ao serviço de metadados para uma instância existente a partir da CLI

Execute o comando ibmcloud is instance-update e especifique o ID da instância. Para ativar o acesso ao serviço de metadados, defina o parâmetro metadata-service como true; para desativar, defina-o como false. Um exemplo de comando para habilitar o acesso ao serviço é o seguinte:

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

Ativação ou desativação do acesso ao serviço de metadados quando você cria novos modelos de instância a partir da CLI

Ao criar um modelo de instância a partir da CLI, é possível indicar se os metadados são coletadas para as instâncias criadas com base nesse modelo

Use o comando ibmcloud is instance-create-from-template e especifique a opção --metadata-service true para ativar ou a opção --metadata-service false para desativar. Depois de definir o valor do modelo, não é mais possível alterá-lo.

Por exemplo, para criar um modelo de instância com o acesso ao serviço de metadados habilitado, execute este comando:

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

Ao criar uma instância a partir deste modelo, especifique novamente a opção --metadata-service true para habilitar o acesso ao serviço na nova instância:

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

Se você substituir o modelo de instância executando o comando ibmcloud is instance-template-create-override-source-template, poderá ativar ou desativar o acesso ao serviço de metadados especificando a opção --metadata-service com true ou false.

Para obter mais informações sobre esses comandos, consulte a Referência da CLI da VPC. Para obter mais informações sobre a criação de um modelo de instância por meio da CLI, consulte Criando um modelo de instância.

Ativação ou desativação do acesso ao serviço de metadados quando você cria uma nova instância com a API

O acesso ao serviço de metadados é desativado por padrão quando você cria uma instância por meio de uma chamada para POST /instances.

Você pode habilitar o acesso ao serviço de metadados especificando o parâmetro metadata_service e definindo enabled como true.

Este exemplo mostra como habilitar o acesso ao serviço de metadados na criação da instância:

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
      },
      .
      .
      .
   }'

A resposta mostra que o parâmetro de metadados está definido como true quando você ativa o acesso ao serviço. Também é possível verificar a configuração do serviço de metadados fazendo uma chamada GET /instance/{id}.

Ativação ou desativação do acesso ao serviço de metadados para uma instância existente com a API

Para ativar ou desativar o acesso ao serviço em uma instância existente, faça uma solicitação PATCH /instance/{instance_id} e especifique o parâmetro metadata_service. Por padrão, a propriedade enabled é configurada como false. Para habilitar o acesso ao serviço, defina-o como true.

Esta chamada de exemplo mostra como habilitar o acesso ao serviço de metadados para uma instância:

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
          }
      }'

A resposta mostra que o parâmetro de metadados está definido como true quando você ativa o acesso ao serviço. Também é possível verificar a configuração do serviço de metadados fazendo uma chamada GET /instance/{id}.

Ativação ou desativação do acesso ao serviço de metadados quando você cria novos modelos de instância usando a API

Ao criar um modelo de instância, você pode definir esse valor enviando uma solicitação do tipo “ POST /instance/templates ”. Por padrão, a propriedade enabled é configurada como false. Para ativá-lo, configure-o como true.

Por exemplo,

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"
         }
       }'

Não é possível usar a API para mudar a configuração de metadata-service após a criação do modelo de instância. Se você desativou o acesso ao serviço para um modelo, crie um novo modelo de instância com a opção metadata-service enabled definida como true.