Permettre l'accès au service de métadonnées pour une instance existante dans la console

Utilisez l'interface utilisateur pour activer l'accès au service de métadonnées sur une instance existante.

1. Accéder à la liste des instances. Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation > Infrastructure > Compute > Instances de serveurs virtuels.

2. Cliquez sur le nom d'une instance pour accéder à la page de détails.

3. Sur la page des détails, accédez à Métadonnées.

4. Cliquez sur le bouton bascule (qui devient vert).

Activation de l'accès au service de métadonnées lors de la création d'une instance dans la console

La procédure suivante montre comment activer l'accès au service de métadonnées lorsque vous créez une instance de serveur virtuel.

1. Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation > Infrastructure > Compute > Instances de serveurs virtuels.

2. Cliquez sur Créer.

3. Mise à disposition de l'instance.

4. Accédez à Options avancées et activez Métadonnées.

Pour plus d'informations sur la création d'instances de serveurs virtuels, voir Création d'instances de serveurs virtuels dans la console.

Activation ou désactivation de l'accès au service de métadonnées sur les modèles d'instance dans la console

Lorsque vous créez un modèle d'instance, la bascule du service de métadonnées est désactivée par défaut. Cliquez sur le bouton pour activer l'accès au service.

Lorsque vous consultez les détails d'un modèle d'instance existant, la page indique si le service de métadonnées a été activé ou non pour ce modèle. Vous ne pouvez pas modifier le paramètre de métadonnées du modèle d'instance après avoir créé le modèle.

Activation ou désactivation de l'accès au service de métadonnées lorsque vous créez une instance à partir de la CLI

Exécutez la commande ibmcloud is instance-create et affectez à la propriété metadata-service la valeur true. L'accès au service de métadonnées est désactivé par défaut. Dans la réponse, vous voyez Metadata service enabled défini sur 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

Voir l'aide CLI pour la liste complète des options disponibles pour instance-create.

Activation ou désactivation de l'accès au service de métadonnées pour une instance existante à partir de la CLI

Exécutez la commande ibmcloud is instance-update et indiquez l'ID d'instance. Pour activer l'accès au service de métadonnées, réglez le paramètre metadata-service sur true; pour le désactiver, réglez-le sur false. Voici un exemple de commande permettant d'activer l'accès au service :

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

Activation ou désactivation de l'accès au service de métadonnées lorsque vous créez de nouveaux modèles d'instance à partir de l'interface de gestion

Lorsque vous créez un modèle d'instance à partir de l'interface de ligne de commande, vous pouvez indiquer si des métadonnées sont collectées pour les instances créées à partir de ce modèle.

Utilisez la commande ibmcloud is instance-create-from-template et spécifiez l'option --metadata-service true pour activer ou l'option --metadata-service false pour désactiver. Une fois que vous avez défini la valeur du modèle, vous ne pouvez plus la modifier.

Par exemple, pour créer un modèle d'instance avec l'accès au service de métadonnées activé, exécutez la commande suivante :

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

Lorsque vous créez une instance à partir de ce modèle, spécifiez à nouveau l'option « --metadata-service true » pour activer l'accès au service sur la nouvelle instance :

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

Si vous remplacez le modèle d'instance en exécutant la commande ibmcloud is instance-template-create-override-source-template, vous pouvez activer ou désactiver l'accès au service de métadonnées en spécifiant l'option --metadata-service avec true ou false.

Pour plus d'informations sur ces commandes, voir Référence de l'interface CLI VPC. Pour plus d'informations sur la création d'un modèle d'instance à partir de l'interface de ligne de commande, voir Création d'un modèle d'instance.

Activation ou désactivation de l'accès au service de métadonnées lorsque vous créez une nouvelle instance avec l'API

L'accès au service de métadonnées est désactivé par défaut lorsque vous créez une instance en faisant un appel à POST /instances.

Vous pouvez activer l'accès au service de métadonnées en spécifiant le paramètre metadata_service et en définissant enabled sur true.

Cet exemple montre comment activer l'accès au service de métadonnées lors de la création d'une instance :

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

La réponse indique que le paramètre de métadonnées est défini sur true lorsque vous activez l'accès au service. Vous pouvez également vérifier la configuration du service de métadonnées en effectuant un appel GET /instance/{id}.

Activation ou désactivation de l'accès au service de métadonnées pour une instance existante à l'aide de l'API

Pour activer ou désactiver l'accès au service à partir d'une instance existante, faites une demande PATCH /instance/{instance_id} et spécifiez le paramètre metadata_service. Par défaut, la propriété enabled a la valeur false. Pour permettre l'accès au service, réglez-le sur true.

Cet exemple d'appel montre comment activer l'accès au service de métadonnées pour une instance :

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

La réponse indique que le paramètre de métadonnées est défini sur true lorsque vous activez l'accès au service. Vous pouvez également vérifier la configuration du service de métadonnées en effectuant un appel GET /instance/{id}.

Activation ou désactivation de l'accès au service de métadonnées lorsque vous créez de nouveaux modèles d'instance à l'aide de l'API

Lorsque vous créez un modèle d'instance, vous pouvez définir cette valeur en effectuant une requête de type « POST /instance/templates ». Par défaut, la propriété enabled a la valeur false. Pour l'activer, affectez true à ce paramètre.

Par exemple :

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

Vous ne pouvez pas utiliser l'API pour modifier le paramètre metadata-service après la création du modèle d'instance. Si vous avez désactivé l'accès au service pour un modèle, créez un nouveau modèle d'instance avec l'option metadata-service activée définie sur true.