Obtention des métadonnées d'instance

Images prises en charge pour IMDS version 2

IMDS version 2 est pris en charge sur les images de plate-forme suivantes :

• image Oracle Autonomous Linux 8.x,
• images Oracle Autonomous Linux 7.x publiées en juin 2020 ou ultérieurement,
• images Oracle Linux 8.x, Oracle Linux 7.x et Oracle Linux 6.x publiées en juillet 2020 ou ultérieurement.

D'autres images de plate-forme, la plupart des images personnalisées et la plupart des images Marketplace ne prennent pas en charge IMDSv2. Les images Linux personnalisées peuvent prendre en charge IMDSv2 si cloud-init est mis à jour vers la version 20.3 ou une version ultérieure et l'agent Oracle Cloud vers la version 0.0.19 ou une version ultérieure. Les images Windows personnalisées peuvent prendre en charge IMDS version 2 si l'agent Oracle Cloud est mis à jour vers la version 1.0.0.0 ou une version ultérieure ; cloudbase-init ne prend pas en charge IMDS version 2.

Identification des demandes aux adresses IMDS version 1 héritées

Pour identifier les adresses IMDS spécifiques auxquelles les demandes sont adressées et les agents qui effectuent les demandes, utilisez la mesure InstanceMetadataRequests.

Afin d'identifier les versions d'IMDS activées pour une instance, effectuez l'une des opérations suivantes :

• Utilisation de la console :
  1. Ouvrez le menu de navigation et cliquez sur Compute. Sous Compute, cliquez sur Instances.
  2. Cliquez sur l'instance qui vous intéresse.
  3. Dans la section Détails de l'instance, en regard de Service de métadonnées d'instance, relevez les numéros de version.
• Utilisation de l'API : utilisez l'opération GetInstance ou ListInstances. Dans la réponse, l'attribut areLegacyImdsEndpointsDisabled de l'objet InstanceOptions renvoie false si IMDS version 1 et IMDS version 2 sont activés pour l'instance. Il renvoie true si IMDS version 1 est désactivé.

Désactivation des demandes aux adresses IMDS version 1 héritées

Effectuez ensuite l'une des opérations suivantes :

• Utilisation de la console :
  1. Ouvrez le menu de navigation et cliquez sur Compute. Sous Compute, cliquez sur Instances.
  2. Cliquez sur l'instance qui vous intéresse.
  3. Dans la section Détails de l'instance, en regard de Service de métadonnées d'instance, cliquez sur Modifier.
  4. Dans Version IMDS autorisée, sélectionnez l'option Version 2 uniquement.
  5. Cliquez sur Enregistrer les modifications.
• Utilisation de l'API : utilisez l'opération UpdateInstance. Dans le corps de demande, dans l'objet InstanceOptions, transmettez la valeur true pour l'attribut areLegacyImdsEndpointsDisabled.

Procédure d'obtention de métadonnées d'instance pour les instances Linux

1. Connectez-vous à une instance Linux à l'aide de SSH.

2. Utilisez cURL pour émettre une demande GET à l'URL de métadonnées d'instance qui vous intéresse. Par exemple :

   curl -H "Authorization: Bearer Oracle" -L http://169.254.169.254/opc/v2/instance/

Procédure d'obtention de métadonnées d'instance pour les instances Windows

Les étapes permettant d'obtenir des métadonnées sur une instance Windows dépendent de la version du service de métadonnées d'instance à partir duquel vous demandez les métadonnées.

Pour obtenir des métadonnées d'instance Windows à l'aide d'IMDS version 2, procédez comme suit :

1. Connectez-vous à une instance Windows à l'aide d'une connexion Bureau à distance.

2. Selon que votre version de Windows inclut cURL, effectuez l'une des opérations suivantes :

   • Si votre version de Windows inclut la commande cURL, utilisez-la pour envoyer une demande GET à l'URL de métadonnées d'instance qui vous intéresse. Par exemple :

     curl -H "Authorization: Bearer Oracle" -L http://169.254.169.254/opc/v2/instance/

   • Si votre version de Windows n'inclut pas la commande cURL, vous pouvez obtenir les métadonnées d'instance dans votre navigateur Web. Accédez à l'URL de métadonnées d'instance qui vous intéresse et transmettez une demande incluant l'en-tête d'autorisation. Pour plus d'informations sur l'inclusion d'en-têtes dans une demande, reportez-vous aux instructions de votre navigateur. Vous pourriez avoir besoin d'installer une extension de navigateur tiers qui vous permette d'inclure des en-têtes de demande.

Pour obtenir des métadonnées d'instance Windows à l'aide d'IMDS version 1, procédez comme suit :

1. Connectez-vous à une instance Windows à l'aide d'une connexion Bureau à distance.
2. Ouvrez un navigateur Web et accédez à l'URL de métadonnées d'instance qui vous intéresse.

Nouvelles tentatives pour les métadonnées d'instance

Le service de métadonnées d'instance subit régulièrement de courts temps d'inactivité pour la maintenance. Par conséquent, certaines adresses IMDS auxquelles vous essayez d'accéder peuvent ne pas être disponibles. La meilleure pratique consiste à implémenter une logique de nouvelles tentatives lors de l'accès aux adresses IMDS. La stratégie suivante est recommandée : réessayez jusqu'à trois fois avec un délai de 30 secondes si vous recevez une réponse 404, 429 ou 5xx. Afin d'obtenir plus d'informations et des exemples, reportez-vous à la documentation du kit SDK pour Java.

Clés de métadonnées d'une instance

Les métadonnées suivantes sur les instances sont disponibles. Les chemins sont relatifs à http://169.254.169.254/opc/v2/instance/.

Voici un exemple de réponse affichant toutes les informations d'une instance :

{
  "availabilityDomain" : "EMIr:PHX-AD-1",
  "faultDomain" : "FAULT-DOMAIN-3",
  "compartmentId" : "ocid1.tenancy.oc1..exampleuniqueID",
  "displayName" : "my-example-instance",
  "hostname" : "my-hostname",
  "id" : "ocid1.instance.oc1.phx.exampleuniqueID",
  "image" : "ocid1.image.oc1.phx.exampleuniqueID",
  "metadata" : {
    "ssh_authorized_keys" : "example-ssh-key"
  },
  "region" : "phx",
  "canonicalRegionName" : "us-phoenix-1",
  "ociAdName" : "phx-ad-1",
  "regionInfo" : {
    "realmKey" : "oc1",
    "realmDomainComponent" : "oraclecloud.com",
    "regionKey" : "PHX",
    "regionIdentifier" : "us-phoenix-1"
  },
  "shape" : "VM.Standard.E3.Flex",
  "state" : "Running",
  "timeCreated" : 1600381928581,
  "agentConfig" : {
    "monitoringDisabled" : false,
    "managementDisabled" : false,
    "allPluginsDisabled" : false,
    "pluginsConfig" : [ {
      "name" : "OS Management Service Agent",
      "desiredState" : "ENABLED"
    }, {
      "name" : "Custom Logs Monitoring",
      "desiredState" : "ENABLED"
    }, {
      "name" : "Compute Instance Run Command",
      "desiredState" : "ENABLED"
    }, {
      "name" : "Compute Instance Monitoring",
      "desiredState" : "ENABLED"
    } ]
  },
  "freeformTags": {
    "Department": "Finance"
  },
  "definedTags": {
    "Operations": {
      "CostCenter": "42"
    }
  }
}

Clés de métadonnées pour les cartes d'interface réseau virtuelles attachées

Les métadonnées suivantes sur les cartes d'interface réseau virtuelles attachées à l'instance sont disponibles. Les chemins sont relatifs à http://169.254.169.254/opc/v2/vnics/.

[ {
    "vnicId" : "ocid1.vnic.oc1.phx.exampleuniqueID",
    "privateIp" : "10.0.3.6",
    "vlanTag" : 11,
    "macAddr" : "00:00:00:00:00:01",
    "virtualRouterIp" : "10.0.3.1",
    "subnetCidrBlock" : "10.0.3.0/24",
    "nicIndex" : 0
}, {
    "vnicId" : "ocid1.vnic.oc1.phx.exampleuniqueID",
    "privateIp" : "10.0.4.3",
    "vlanTag" : 12,
    "macAddr" : "00:00:00:00:00:02",
    "virtualRouterIp" : "10.0.4.1",
    "subnetCidrBlock" : "10.0.4.0/24",
    "nicIndex" : 0
} ]

Clés de métadonnées pour les volumes attachés avec des attachements à chemins d'accès multiples

Les métadonnées suivantes sur les attachements de volume à chemins d'accès multiples attachés à l'instance sont disponibles. Les chemins sont relatifs à http://169.254.169.254/opc/v2/volumeAttachments/.

L'exemple de réponse ci-dessous indique les attachements de volume à chemins d'accès multiples d'une instance :

[
  {
    "id": "ocid1.volumeattachment.oc1.phx.exampleuniqueID",
    "instanceId": "ocid1.instance.oc1.phx.exampleuniqueID",
    "volumeId": "ocid1.volume.oc1.phx.exampleuniqueID",
    "ipv4": "169.254.2.2",
    "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
    "port": 3260,
    "multipathDevices":
    [
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      }
    ]
  }
]