Recupero dei metadati delle istanze

Immagini supportate per IMDSv2

IMDSv2 è supportato sulle seguenti immagini della piattaforma:

• Immagini di Oracle Autonomous Linux 8.x
• Immagini di Oracle Autonomous Linux 7.x rilasciate a giugno 2020 o release successive
• Immagini di 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 l'inizializzazione cloud viene aggiornata 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 Oracle Cloud Agent 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 della console:
  1. Apri il menu di navigazione e seleziona Computazione. In Computazione, selezionare Istanze.
  2. Fare clic sull'istanza a cui si è interessati.
  3. Nella sezione Dettagli istanza, accanto al servizio metadati istanza, prendere nota dei numeri di versione.
• Utilizzo dell'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

Seguire una delle operazioni riportate di seguito.

• Uso della console:
  1. Apri il menu di navigazione e seleziona Computazione. In Computazione, selezionare Istanze.
  2. Fare clic sull'istanza a cui si è interessati.
  3. Nella sezione Dettagli istanza, accanto al 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'API: utilizzare l'operazione UpdateInstance. Nel corpo della richiesta, nell'oggetto InstanceOptions, passare il valore true per l'attributo areLegacyImdsEndpointsDisabled.

Per ottenere 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 Windows

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

Per ottenere i metadati dell'istanza di Windows mediante IMDSv2:

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

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

   • Se la versione di Windows 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 non include cURL, è possibile ottenere i metadati delle istanze 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 consente di includere le intestazioni delle richieste.

Per ottenere i metadati dell'istanza di Windows mediante IMDSv1:

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

Riprova per metadati istanza

Il servizio di metadati dell'istanza subisce periodicamente brevi periodi di inattività per la manutenzione. Pertanto, quando si tenta di accedere agli endpoint IMDS, questi 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 ed esempi, consultare la documentazione di SDK for Java.

Chiavi metadati per un'istanza

I metadati riportati di seguito sono disponibili su 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

Sono disponibili i metadati seguenti relativi alle 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 di metadati per i volumi collegati con allegati abilitati per più percorsi

Sono disponibili i metadati seguenti relativi ai 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 il 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 configurazione 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 conoscere meglio OCPUS, VNIC o qualsiasi dettaglio di forma configurabile.

Sono disponibili i metadati riportati di seguito relativi alla sezione Forme di computazione collegate all'istanza. I percorsi sono relativi a http://169.254.169.254/opc/v2/instance/shapeConfig.

Utilizzare il comando cURL seguente 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
}