Recupero dei metadati dell'istanza

Immagini supportate per IMDSv2

IMDSv2 è supportato nelle seguenti immagini della piattaforma:

• Immagini di Oracle Autonomous Linux 8.x
• Immagini di Oracle Autonomous Linux 7.x rilasciate a giugno 2020 o versioni successive
• Immagini Oracle Linux 8.x e Oracle Linux 7.x rilasciate a luglio 2020 o versioni successive

Altre immagini della piattaforma, la maggior parte delle immagini personalizzate e la maggior parte delle immagini del Marketplace non supportano IMDSv2. Le immagini Linux personalizzate potrebbero supportare IMDSv2 se il cloud-init viene aggiornato alla versione 20.3 o successiva e l'agente Oracle Cloud viene aggiornato alla versione 0.0.19 o successiva. Le immagini Windows personalizzate potrebbero supportare IMDSv2 se l'agente Oracle Cloud viene aggiornato alla versione 1.0.0.0 o successiva; cloudbase-init non supporta IMDSv2.

Identificazione delle richieste agli endpoint IMDSv1 precedenti

Per identificare gli endpoint IMDS specifici a cui vengono effettuate le richieste e gli agenti che effettuano le richieste, utilizzare la metrica InstanceMetadataRequests.

Per identificare le versioni di IMDS abilitate per un'istanza, effettuare una delle operazioni riportate di seguito.

• Uso di Console:
  1. Aprire il menu di navigazione e selezionare Computazione. In Computazione, selezionare Istanze.
  2. Fare clic sull'istanza a cui si è interessati.
  3. Nella sezione Dettagli istanza, accanto a Servizio metadati istanza, prendere nota dei numeri di versione.
• Utilizzo dell'interfaccia API: utilizzare l'operazione GetInstance o l'operazione ListInstances. Nella risposta, l'attributo areLegacyImdsEndpointsDisabled nell'oggetto InstanceOptions restituisce false se per l'istanza sono abilitati sia IMDSv1 che IMDSv2. Restituisce true se IMDSv1 è disabilitato.

Disabilitazione delle richieste agli endpoint IMDSv1 precedenti

Eseguire una delle operazioni riportate di seguito.

• Uso di Console:
  1. Aprire il menu di navigazione e selezionare Computazione. In Computazione, selezionare Istanze.
  2. Fare clic sull'istanza a cui si è interessati.
  3. Nella sezione Dettagli istanza, accanto a Servizio metadati istanza, fare clic su Modifica.
  4. Per Versione IMDS consentita, selezionare l'opzione Solo versione 2.
  5. Fare clic su Salva modifiche.
• Utilizzo dell'interfaccia API: utilizzare l'operazione UpdateInstance. Nell'oggetto InstanceOptions del corpo della richiesta, passare il valore true per l'attributo areLegacyImdsEndpointsDisabled.

Per recuperare i metadati dell'istanza per le istanze Linux

1. Connettersi a un'istanza Linux utilizzando SSH.

2. Utilizzare cURL per inviare una richiesta GET all'URL dei metadati dell'istanza a cui si è interessati. Ad esempio:

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

Per ottenere i metadati dell'istanza per le istanze di Windows

I passi per ottenere i metadati in un'istanza Windows dipendono dalla versione del servizio di metadati dell'istanza da cui si richiedono i metadati.

Per ottenere i metadati dell'istanza Windows mediante IMDSv2:

1. Connettersi a un'istanza di Windows utilizzando una connessione desktop remoto.

2. A seconda che la versione di Windows in uso includa cURL, effettuare una delle operazioni riportate di seguito.

   • Se la versione di Windows in uso include cURL, utilizzare cURL per inviare una richiesta GET all'URL dei metadati dell'istanza a cui si è interessati. Ad esempio:

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

   • Se la versione di Windows in uso non include cURL, è possibile ottenere i metadati dell'istanza nel browser Internet. Passare all'URL dei metadati dell'istanza a cui si è interessati e passare una richiesta che include l'intestazione di autorizzazione. Per ulteriori informazioni sull'inclusione delle intestazioni in una richiesta, vedere le istruzioni del browser. Potrebbe essere necessario installare un'estensione browser di terze parti che consenta di includere le intestazioni delle richieste.

Per ottenere i metadati dell'istanza Windows mediante IMDSv1:

1. Connettersi a un'istanza di Windows utilizzando una connessione desktop remoto.
2. Aprire un browser Internet e quindi passare all'URL dei metadati dell'istanza a cui si è interessati.

Nuovi tentativi per i metadati dell'istanza

Il servizio metadati dell'istanza subisce periodicamente brevi periodi di inattività per le attività di manutenzione. Pertanto, quando si tenta di accedere agli endpoint IMDS, potrebbero non essere disponibili. Come best practice, implementa la logica dei nuovi tentativi quando accedi agli endpoint IMDS. Si consiglia di eseguire un nuovo tentativo fino a tre volte con un timeout di 30 secondi se si riceve una risposta 404, 429 o 5xx. Per ulteriori informazioni e per gli esempi, vedere la documentazione del SDK per Java.

Chiavi di metadati per un'istanza

Sono disponibili i seguenti metadati relativi a un'istanza. I percorsi sono relativi a http://169.254.169.254/opc/v2/instance/.

Di seguito è riportata una risposta di esempio che mostra tutte le informazioni per un'istanza.

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

Chiavi di metadati per le VNIC collegate

I metadati riportati di seguito sono disponibili per le VNIC collegate all'istanza. I percorsi sono relativi 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
} ]

Chiavi metadati per volumi collegati a collegamenti abilitati per più percorsi

I metadati riportati di seguito sono disponibili per i collegamenti di volumi abilitati per più percorsi collegati all'istanza. I percorsi sono relativi a http://169.254.169.254/opc/v2/volumeAttachments/.

Di seguito è riportata una risposta di esempio che mostra i collegamenti di volume abilitati per multipath per un'istanza.

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

Chiavi metadati per la configurazione della forma

Questo comando visualizza le OCPU disponibili in ogni forma di computazione. Queste informazioni sono utili per le forme flessibili in cui un'applicazione deve avere maggiori informazioni su OCPUS, VNIC o su eventuali dettagli delle forme configurabili.

Sono disponibili i seguenti metadati relativi alle forme di computazione collegate all'istanza. I percorsi sono relativi a http://169.254.169.254/opc/v2/instance/shapeConfig.

Utilizzare il seguente comando cURL per inviare una richiesta GET ai metadati di configurazione della forma dell'istanza a cui si è interessati.

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

Di seguito è riportata una risposta di esempio che mostra i metadati di configurazione della forma per un'istanza Linux.

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