Instanzmetadaten abrufen

Unterstützte Images für IMDSv2

IMDSv2 wird auf den folgenden Plattformimages unterstützt:

• Oracle Autonomous Linux 8.x-Images
• Oracle Autonomous Linux 7.x-Images, die im Juni 2020 oder später veröffentlicht wurden
• Oracle Linux 8.x-, Oracle Linux 7.x- und Oracle Linux 6.x-Images, die im Juli 2020 oder später veröffentlicht wurden

Andere Plattformimages, die meisten benutzerdefinierten Images und die meisten Marktplatzimages unterstützen IMDSv2 nicht. Benutzerdefinierte Linux-Images können IMDSv2 unterstützen, wenn cloud-init auf Version 20.3 oder höher und Oracle Cloud Agent auf Version 0.0.19 oder höher aktualisiert wird. Benutzerdefinierte Windows-Images können IMDSv2 unterstützen, wenn Oracle Cloud Agent auf Version 1.0.0.0 oder höher aktualisiert wird. Cloudbase-init unterstützt IMDSv2 nicht.

Anforderungen an Legacy-IMDSv1-Endpunkte identifizieren

Um die spezifischen IMDS-Endpunkte zu identifizieren, an die Anforderungen gestellt werden, und die Agents, die die Anforderungen stellen, verwenden Sie die Metrik InstanceMetadataRequests.

So identifizieren Sie, welche IMDS-Versionen für eine Instanz aktiviert sind:

• Konsole verwenden:
  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Instanzen.
  2. Klicken Sie auf die gewünschte Instanz.
  3. Beachten Sie im Abschnitt Instanzdetails neben Instance Metadata Service die Versionsnummern.
• API verwenden: Verwenden Sie den Vorgang GetInstance oder ListInstances. In der Antwort gibt das Attribut areLegacyImdsEndpointsDisabled im InstanceOptions-Objekt false zurück, wenn sowohl IMDSv1 als auch IMDSv2 für die Instanz aktiviert sind. Gibt true zurück, wenn IMDSv1 deaktiviert ist.

Anforderungen an Legacy-IMDSv1-Endpunkte deaktivieren

Führen Sie eine der folgenden Aktionen aus:

• Konsole verwenden:
  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Instanzen.
  2. Klicken Sie auf die gewünschte Instanz.
  3. Klicken Sie im Abschnitt Instanzdetails neben Instance Metadata Service auf Bearbeiten.
  4. Wählen Sie unter Zulässige IMDS-Version die Option Nur Version 2 aus.
  5. Klicken Sie auf Änderungen speichern.
• API verwenden: Verwenden Sie den Vorgang UpdateInstance. Übergeben Sie im Anforderungsbody im Objekt InstanceOptions den Wert true für das Attribut areLegacyImdsEndpointsDisabled.

So rufen Sie Instanzmetadaten für Linux-Instanzen ab

1. Stellen Sie mit SSH eine Verbindung zu einer Linux-Instanz her.

2. Geben Sie mit cURL eine GET-Anforderung an die gewünschte Instanzmetadaten-URL aus. Beispiel:

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

So rufen Sie Instanzmetadaten für Windows-Instanzen ab

Die Schritte zum Abrufen von Metadaten auf einer Windows-Instanz hängen davon ab, von welcher Version des Instance Metadata Service Sie Metadaten anfordern.

So rufen Sie Windows-Instanzmetadaten mit IMDSv2 ab

1. Stellen Sie eine Remotedesktopverbindung zu einer Windows-Instanz her.

2. Führen Sie einen der folgenden Schritte aus, je nachdem, ob Ihre Windows-Version cURL enthält:

   • Wenn Ihre Windows-Version cURL enthält, geben Sie mit cURL eine GET-Anforderung an die Instanzmetadaten-URL aus, an der Sie interessiert sind. Beispiel:

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

   • Wenn Ihre Windows-Version cURL nicht enthält, können Sie Instanzmetadaten in Ihrem Internetbrowser abrufen. Navigieren Sie zu der gewünschten Instanzmetadaten-URL, und übergeben Sie eine Anforderung mit dem Autorisierungsheader. Weitere Informationen zum Einbinden von Headern in eine Anforderung finden Sie in den Anweisungen für Ihren Browser. Möglicherweise müssen Sie eine Browsererweiterung von Drittanbietern installieren, mit der Sie Anforderungsheader aufnehmen können.

So rufen Sie Windows-Instanzmetadaten mit IMDSv1 ab:

1. Stellen Sie eine Remotedesktopverbindung zu einer Windows-Instanz her.
2. Öffnen Sie einen Internetbrowser, und navigieren Sie zu der gewünschten Instanzmetadaten-URL.

Wiederholungen für Instanzmetadaten

Der Instance Metadata Service verzeichnet in regelmäßigen Abständen kurze Ausfallzeiten für Wartungsarbeiten. IMDS-Endpunkte sind daher bei einem Zugriffsversuch möglicherweise nicht verfügbar. Als Best Practice sollten Sie beim Zugriff auf IMDS-Endpunkte Wiederholungslogik implementieren. Die folgende Strategie wird empfohlen: Wiederholen Sie den Vorgang bis zu dreimal mit einem 30-Sekunden-Timeout, wenn Sie eine 404-, 429- oder 5xx-Antwort erhalten. Weitere Informationen und Beispiele finden Sie in der Dokumentation zu SDK für Java.

Metadatenschlüssel für eine Instanz

Zu einer Instanz sind die folgenden Metadaten verfügbar. Die Pfade sind relativ zu http://169.254.169.254/opc/v2/instance/.

Nachfolgend finden Sie eine Beispielantwort, in der alle Informationen für eine Instanz angezeigt werden:

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

Metadatenschlüssel für angehängte VNICs

Zu den an die Instanz angehängten VNICs sind die folgenden Metadaten verfügbar. Die Pfade sind relativ zu 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
} ]

Metadatenschlüssel für angehängte Volumes mit Multipath-fähigen Anhängen

Zu den an die Instanz angehängten Multipath-fähigen Volume-Anhängen sind die folgenden Metadaten verfügbar. Die Pfade sind relativ zu http://169.254.169.254/opc/v2/volumeAttachments/.

Im Folgenden finden Sie eine Beispielantwort, in der die Multipath-fähigen Volume-Anhänge für eine Instanz angezeigt werden:

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