Obtention des métadonnées d'instance

Images prises en charge pour IMDSv2

IMDSv2 est pris en charge sur les images de plate-forme suivantes :

• Images Oracle Autonomous Linux 8.x
• Images Oracle Autonomous Linux 7.x lancées en juin 2020 ou ultérieurement
• Images Oracle Linux 8.x et Oracle Linux 7.x lancé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 à la version 20.3 ou version ultérieure et si Oracle Cloud Agent est mis à jour à la version 0.0.19 ou version ultérieure. Les images Windows personnalisées peuvent prendre en charge IMDSv2 si Oracle Cloud Agent est mis à jour à la version 1.0.0.0 ou versions ultérieures; cloudbase-init ne prend pas en charge IMDSv2.

Identification des demandes pour les points d'extrémité IMDSv1 existants

Pour identifier les points d'extrémité du service de métadonnées d'instance spécifiques pour les demandes et les agents qui effectuent les demandes, utilisez la mesure InstanceMetadataRequests.

Pour identifier les versions du service de métadonnées d'instance activées pour une instance, procédez de l'une des façons suivantes :

• Utilisation de la console :
  1. Ouvrez le menu de navigation et sélectionnez Calcul. Sous Calcul, sélectionnez Instances.
  2. Cliquez sur l'instance qui vous intéresse.
  3. Dans la section Détails de l'instance, à côté de Service de métadonnées d'instance, notez 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 retourne false si IMDSv1 et IMDSv2 sont activés pour l'instance. Il retourne true si IMDSv1 est désactivé.

Désactivation des demandes pour les points d'extrémité IMDSv1 existants

Procédez de l'une des façons suivantes :

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

Pour obtenir les métadonnées d'instance des instances Linux

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

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

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

Pour obtenir les métadonnées d'instance des instances Windows

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

Pour obtenir les métadonnées d'instance Windows à l'aide d'IMDSv2 :

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

2. Selon que votre version Windows inclut cURL, procédez de l'une des façons suivantes :

   • Si votre version Windows inclut cURL, 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/

   • Si votre version Windows n'inclut pas cURL, vous pouvez obtenir les métadonnées d'instance dans votre navigateur Internet. Naviguez jusqu'à l'URL de métadonnées d'instance qui vous intéresse et transmettez une demande qui inclut l'en-tête d'autorisation. Pour plus d'informations sur l'inclusion des en-têtes dans une demande, voir les instructions ayant trait à votre navigateur. Vous aurez peut-être besoin d'installer une extension de navigateur de tierce partie qui vous permet d'inclure les en-têtes de demande.

Pour obtenir les métadonnées d'instance Windows à l'aide d'IMDSv1 :

1. Connectez-vous à une instance Windows à l'aide d'une connexion Bureau à distance.
2. Ouvrez un navigateur Internet et naviguez jusqu'à l'URL des métadonnées d'instance qui vous intéressent.

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

Le service de métadonnées d'instance subit périodiquement de courtes périodes d'arrêt pour la maintenance. Par conséquent, lorsque vous essayez d'accéder aux points d'extrémité IMDS, ils peuvent être indisponibles. Comme meilleure pratique, mettez en oeuvre la logique de nouvelle tentative lors de l'accès aux points d'extrémité IMDS. La stratégie suivante est recommandée : Réessayez jusqu'à trois fois avec une temporisation de 30 secondes si vous recevez une réponse 404, 429 ou 5xx. Pour plus d'informations et des exemples, voir la documentation sur la trousse SDK pour Java.

Clés de métadonnées pour une instance

Les métadonnées suivantes sont disponibles à propos d'une instance. Les chemins sont relatifs à http://169.254.169.254/opc/v2/instance/.

Voici un exemple de réponse présentant toutes les informations pour 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 vNIC attachées

Les métadonnées suivantes sont disponibles pour les cartes vNIC attachées à l'instance. 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 activés pour la configuration multichemin

Les métadonnées suivantes sont disponibles pour les attachements de volume multichemins attachées à l'instance. Les chemins sont relatifs à http://169.254.169.254/opc/v2/volumeAttachments/.

Voici un exemple de réponse qui présente les attachements de volume multichemins pour 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
      }
    ]
  }
]

Clés de métadonnées pour la configuration de forme

Cette commande affiche les OCPU disponibles dans chaque forme de calcul. Ces informations sont utiles pour les formes flexibles où une application doit en savoir plus sur les OCPUS, les cartes vNIC ou tout détail configurable de forme.

Les métadonnées suivantes sont disponibles pour les formes de calcul attachées à l'instance. Les chemins sont relatifs à http://169.254.169.254/opc/v2/instance/shapeConfig.

Utilisez la commande cURL suivante pour émettre une demande GET aux métadonnées de configuration de forme d'instance qui vous intéressent.

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

Voici un exemple de réponse qui présente les métadonnées de configuration de forme pour une instance Linux.

{
  "ocpus" : 4.0,
  "memoryInGBs" : 60.0,
  "networkingBandwidthInGbps" : 4.0,
  "maxVnicAttachments" : 4
}