Obtención de metadatos de instancia

Imágenes soportadas para IMDSv2

IMDSv2 está soportado en las siguientes imágenes de plataforma:

• Imágenes de Oracle Autonomous Linux 8.x
• Imágenes de Oracle Autonomous Linux 7.x publicadas a partir de junio de 2020
• Imágenes de Oracle Linux 8.x, Oracle Linux 7.x y Oracle Linux 6.x publicadas a partir de julio de 2020

Otras imágenes de plataforma, la mayoría de imágenes personalizadas y la mayoría de imágenes de Marketplace no soportan IMDSv2. Las imágenes personalizadas de Linux pueden soportar IMDSv2 si cloud-init se actualiza a la versión 20.3 o posterior y Oracle Cloud Agent se actualiza a la versión 0.0.19 o posterior. Las imágenes personalizadas de Windows pueden soportar IMDSv2 si Oracle Cloud Agent se actualiza a la versión 1.0.0.0 o posterior; cloudbase-init no soporta IMDSv2.

Identificación de las solicitudes a los puntos finales de IMDSv1 heredados

Para identificar los puntos finales de IMDS específicos a los que se están realizando solicitudes y los agentes que están realizando las solicitudes, utilice la métrica InstanceMetadataRequests.

Para identificar las versiones de IMDS activadas para una instancia, realice cualquiera de las siguientes acciones:

• Uso de la consola:
  1. Abra el menú de navegación y haga clic en Recursos informáticos. En Recursos informáticos, haga clic en Instancias.
  2. Haga clic en la instancia en la que está interesado.
  3. En la sección Detalles de instancia, junto a Servicio de metadatos de instancia, anote los números de versión.
• Mediante la API: utilice la operación GetInstance o la operación ListInstances. En la respuesta, el atributo areLegacyImdsEndpointsDisabled del objeto InstanceOptions devuelve false si IMDSv1 e IMDSv2 están activados para la instancia. Devuelve true si IMDSv1 está desactivado.

Desactivación de las solicitudes a los puntos finales de IMDSv1 heredados

Realice cualquiera de las siguientes acciones:

• Uso de la consola:
  1. Abra el menú de navegación y haga clic en Recursos informáticos. En Recursos informáticos, haga clic en Instancias.
  2. Haga clic en la instancia en la que está interesado.
  3. En la sección Detalles de instancia, junto a Servicio de metadatos de instancia, haga clic en Editar.
  4. Para Versión de IMDS permitida, seleccione la opción Solo versión 2.
  5. Haga clic en Guardar cambios.
• Mediante la API: utilice la operación UpdateInstance. En el cuerpo de solicitud, en el objeto InstanceOptions, transfiera el valor true para el atributo areLegacyImdsEndpointsDisabled.

Para obtener metadatos de instancia para instancias de Linux

1. Conexión a una instancia de Linux mediante SSH.

2. Utilice cURL para emitir una solicitud GET a la URL de metadatos de instancia en la que está interesado. Por ejemplo:

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

Para obtener metadatos de instancia para instancias de Windows

Los pasos para obtener metadatos en una instancia de Windows dependen de la versión del servicio de metadatos de instancia del que esté solicitando metadatos.

Para obtener metadatos de instancia de Windows mediante IMDSv2:

1. Conéctese a una instancia de Windows mediante una conexión de escritorio remoto.

2. En función de si la versión de Windows incluye cURL, realice una de las siguientes acciones:

   • Si la versión de Windows incluye cURL, utilice cURL para emitir una solicitud GET a la URL de metadatos de instancia que le interese. Por ejemplo:

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

   • Si la versión de Windows no incluye cURL, puede obtener metadatos de instancia en su explorador de Internet. Navegue a la URL de metadatos de instancia que le interesa y transfiera una solicitud que incluya la cabecera de autorización. Consulte las instrucciones de su explorador para obtener más información sobre cómo incluir cabeceras en una solicitud. Es posible que necesite instalar una extensión de explorador de terceros que le permita incluir cabeceras de solicitud.

Para obtener metadatos de instancia de Windows mediante IMDSv1:

1. Conéctese a una instancia de Windows mediante una conexión de escritorio remoto.
2. Abra un explorador de Internet y, a continuación, navegue a la URL de metadatos de instancia en la que está interesado.

Reintentos para metadatos de instancia

El servicio de metadatos de instancia experimenta periódicamente cortos períodos de tiempo de inactividad para el mantenimiento. Por lo tanto, si intenta acceder a los puntos finales de IMDS, es posible que no estén disponibles. Como mejor práctica, implante la lógica de reintento al acceder a los puntos finales de IMDS. Se recomienda la siguiente estrategia: vuelva a intentarlo hasta tres veces con un timeout de 30 segundos si recibe una respuesta 404, 429 o 5xx. Para obtener más información y ejemplos, consulte la documentación del SDK para Java.

Claves de metadatos para una instancia

Los siguientes metadatos están disponibles sobre una instancia. Las rutas son relativas a http://169.254.169.254/opc/v2/instance/.

Esta es una respuesta de ejemplo que muestra toda la información de una instancia:

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

Claves de metadatos para VNIC asociadas

Los siguientes metadatos están disponibles sobre las VNIC asociadas a la instancia. Las rutas son relativas a 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
} ]

Claves de metadatos para volúmenes asociados a asociaciones activadas para rutas múltiples

Los siguientes metadatos están disponibles sobre las asociaciones de volúmenes activadas para rutas múltiples asociadas a la instancia. Las rutas son relativas a http://169.254.169.254/opc/v2/volumeAttachments/.

A continuación, se muestra una respuesta de ejemplo con las asociaciones de volúmenes activadas para rutas múltiples para una instancia:

[
  {
    "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
      }
    ]
  }
]