Zusammenfassung der vom Metadatendienst zurückgegebenen Daten

Nutzen Sie den Metadatendienst, um auf Informationen zur Instanz, zu SSH-Schlüsseln und zu Platzierungsgruppen zuzugreifen. Die folgende Zusammenfassung enthält die URI-Pfade und Metadatenschlüssel und beschreibt die Metadaten.

Die API-Antwort für jeden Metadatentyp wird im JSON-Format bereitgestellt, das Schlüssel-Wert-Paare der Metadaten enthält.

Zusammenfassung der Metadaten für Instanzen

Die Informationen in Tabelle 1 erläutern den Typ der Metadaten, die für eine Instanz zurückgegeben werden. Um auf alle Metadaten zuzugreifen, siehe Abrufen von Metadaten aus einer Instanz.

Metadaten für eine Instanz
URI-Pfad der Instanz Metadatenschlüssel Beschreibung der Metadaten
/instance availability_policy Die Verfügbarkeitsrichtlinie für diese virtuelle Serverinstanz.
/instance bandwidth Die Gesamtbandbreite in Megabit pro Sekunde, die sich auf die Netzwerkschnittstellen der virtuellen Serverinstanz und die „ Block Storage “-Volumes verteilt.
/instance boot_volume_attachment Bootdatenträgerzuordnung mit Datenträgername, Cloudressourcenname (CRN) und ID.
/instance catalog_offering Diese Informationen werden angezeigt, wenn die virtuelle Serverinstanz mit einem benutzerdefinierten Image aus einem privaten Katalog bereitgestellt wurde.
/instance created_at Der Zeitpunkt (Datum und Uhrzeit), zu dem die Virtual Server-Instanz erstellt wurde.
/instance crn Der Cloudressourcenname für diese Virtual Server-Instanz.
/instance dedicated_host Sammlung der Referenzen zu den zugewiesenen Hosts, einschließlich CRN, gelöschter Hosts, ID, Name und resource_type.
/instance disks Eine Liste der Platten der Instanz.
/instance gpu Die GPU-Konfiguration der Virtual Server-Instanz.
/instance id Die eindeutige Kennung für diese Virtual Server-Instanz.
/instance image Das Image, aus dem die Virtual Server-Instanz eingerichtet wurde, z. B. ein Debian Linux-Archivimage.
/instance lifecycle_reasons Die Gründe für den aktuellen Lebenszyklus_status.
/instance lifecycle_state Der Lebenszyklusstatus der virtuellen Serverinstanz.
/instance memory Die Speichergröße; auf ganze Gigabyte gerundet.
/instance metadata_service Gibt an, ob der Metadatenserviceendpunkt für die virtuelle Serverinstanz verfügbar ist. (Der Aktivierungsstatus ist wahr oder falsch.)
/instance name Der benutzerdefinierte Name für diese Virtual Server-Instanz (und der Standardsystemhostname).
/instance network_interfaces Eine Liste der Netzschnittstellen der Virtual Server-Instanz einschließlich der primären Netzschnittstelle.
/instance placement_target Die Verteilungseinschränkungen für die virtuelle Serverinstanz.
/instance primary_network_interface Die primäre Netzschnittstelle der Instanz.
/instance profile Der global eindeutige Name des Profils für diese Virtual Server-Instanz. Beispiel: Profil 'bx2-2x8' des Typs 'Ausgewogen'.
/instance software_attachments Eine Liste der Software-Anhänge der virtuellen Serverinstanz.
/instance startable Gibt an, ob der Status der virtuellen Serverinstanz eine Startanforderung zulässt.
/instance status Der Status der Instanz: löschen, fehlgeschlagen, pausiert, pausiert, anstehend, Neustart, fortsetzen, laufend, starten, gestoppt oder stoppend.
/instance status_reasons Die Gründe für den aktuellen Status.
/instance total_network_bandwidth Die Bandbreite in Megabit pro Sekunde, die ausschließlich Netzschnittstellen der Instanz zugeordnet ist.
/instance total_volume_bandwidth Die Bandbreite in Megabit pro Sekunde, die ausschließlich den Blockspeicherdatenträgern der Instanz zugeordnet ist. Eine Erhöhung dieses Wertes führt zu einer entsprechenden Verringerung von „total_network_bandwidth“.
/instance vcpu Die Anzahl der VCPUs, die über eine Struktur zugewiesen werden, die Eigenschaften wie Anzahl und Architektur enthält.
/instance volume_attachments Eine Liste der Datenträgerzuordnungen der virtuellen Serverinstanz.
/instance boot_volume_attachment Bootdatenträgerzuordnung der Instanz.
/instance volume_bandwidth_qos_mode Die Bandbreite des Volumes QoS-Modus für diese virtuelle Serverinstanz. Entweder gepoolt oder gewichtet.
/instance vpc Die VPC, in der sich die Virtual Server-Instanz befindet.
/instance zone Der global eindeutige Name für die Zone.
/instance/initialization default_trusted_profile Die Standardkonfiguration des vertrauenswürdigen Profils, die bei der Erstellung der virtuellen Serverinstanz festgelegt wurde.
/instance/initialization keys Eine Liste mit Verweisen auf öffentliche SSH-Schlüssel, die bei der Initialisierung der Instanz verwendet wurden.
/instance/initialization password Das Administratorkennwort bei der Initialisierung, das mit encryption_key verschlüsselt wurde und in base64-Codierung zurückgegeben wird.
/instance/initialization user_data Benutzerdaten, die verfügbar gemacht werden, wenn Sie eine neue virtuelle Serverinstanz einrichten.
/instance/network_interfaces network_interfaces Eine Liste der Netzschnittstellen. Ausführliche Informationen enthält die Erläuterung zu '/instance/network_interfaces/{id}'.
/instance/network_interfaces/{id} allow_ip_spoofing Gibt an, ob Quellen-IP-Spoofing in dieser Schnittstelle zulässig ist. Bei falsch wird das Quellen-IP-Spoofing auf dieser Schnittstelle verhindert. Bei wahr ist das Quellen-IP-Spoofing in dieser Schnittstelle zulässig.
/instance/network_interfaces/{id} created_at Der Zeitpunkt (Datum und Uhrzeit), zu dem die Netzschnittstelle erstellt wurde.
/instance/network_interfaces/{id} floating_ips Array mit Verweisen auf Floating-IP-Adressen, die der Netzwerkschnittstelle zugeordnet sind.
/instance/network_interfaces/{id} id Die eindeutige Kennung für die Netzschnittstelle.
/instance/network_interfaces/{id} name Der benutzerdefinierte Name für die Netzschnittstelle.
/instance/network_interfaces/{id} port_speed Die Anschlussgeschwindigkeit der Netzschnittstelle in Mb/s.
/instance/network_interfaces/{id} primary_ipv4_address Die primäre IPv4-Adresse.
/instance/network_interfaces/{id} resource_type Der Ressourcentyp.
/instance/network_interfaces/{id} security_groups Eine Liste der Sicherheitsgruppen.
/instance/network_interfaces/{id} status Der Status der Netzschnittstelle.
/instance/network_interfaces/{id} subnet Das der Instanz zugeordnete Teilnetz.
/instance/network_interfaces/{id} type Der Typ dieser Netzschnittstelle in Bezug auf eine Instanz.
/instance/software_attachments software_attachments Ein Array aus null oder mehr Software-Anhang-Objekten.
/instance/software_attachments/{id} id Die eindeutige Kennung (UUID) für diesen Software-Anhang.
/instance/software_attachments/{id} name Der Name dieses Software-Anhangs. Der Name ist innerhalb der Gruppe der mit der virtuellen Serverinstanz verknüpften Software-Anhänge eindeutig.
/instance/software_attachments/{id} href URL en zu diesem Software-Anhang.
/instance/software_attachments/{id} catalog_offering Ein Objekt, das die CRN des Katalogangebots und die zugehörige CRN des Softwareplans enthält, die die Software repräsentieren.
/instance/software_attachments/{id} offering_instance Ein Objekt, das die aus dem Softwareplan instanziierte Instanz des Softwareangebots darstellt. Enthält die CRN der Instanz des Softwareangebots.
/instance/software_attachments/{id} entitlement Ein Objekt, das die Lizenzberechtigung für die Instanz des Softwareangebots repräsentiert. Diese Eigenschaft wird dynamisch gefüllt, nachdem der License Manager erfolgreich aufgerufen wurde, um die Berechtigung abzurufen.
/instance/software_attachments/{id} entitlement.licensed_software Ein Array aus null oder mehr Objekten, von denen jedes ein installiertes, lizenziertes Softwareprogramm oder eine Funktion in der virtuellen Serverinstanz darstellt.
/instance/software_attachments/{id} entitlement.licensed_software[].sku Die SKU (Stock Keeping Unit) eines lizenzierbaren Softwareprogramms oder einer mit dem Softwareplan verbundenen Funktion, die auf der virtuellen Serverinstanz ausgeführt wird.
/instance/software_attachments/{id} entitlement.licensed_software[].key Der Lizenzschlüssel für die Software-Nutzungsberechtigung. Der Wert dieser Immobilie kann sich im Laufe der Zeit ändern.
/instance/software_attachments/{id} lifecycle_state Der Lebenszyklusstatus des Software-Anhangs, der angibt, ob dieser vollständig und nutzbar ist.
/instance/software_attachments/{id} lifecycle_reasons Eine Reihe von Gründen für den aktuellen Lebenszyklusstatus.
/instance/software_attachments/{id} resource_type Der Ressourcentyp. Wird auf instance_software_attachment festgelegt.
/instance/software_attachments/{id} created_at Datum und Uhrzeit der Erstellung dieses Software-Anhangs.
/instance/volume_attachments/{id} bandwidth Die maximale Bandbreite in Megabit pro Sekunde für das Volume, wenn es an diese Instanz angeschlossen ist. Dieser Wert kann je nach Konfiguration der Instanz unter der Bandbreite des Volumes liegen.
/instance/volume_attachments/{id} created_at Der Zeitpunkt (Datum und Uhrzeit), zu dem der Datenträger zugeordnet wurde.
/instance/volume_attachments/{id} delete_volume_on_instance_delete Wenn die Einstellung auf „ true “ gesetzt ist, wird beim Löschen der Instanz auch das Volume gelöscht.
/instance/volume_attachments/{id} device Informationen dazu, wie der Datenträger dem Instanzbetriebssystem zugänglich gemacht wird.
/instance/volume_attachments/{id} id Die eindeutige Kennung für die Datenträgerzuordnung.
/instance/volume_attachments/{id} name Der benutzerdefinierte Name für die Datenträgerzuordnung.
/instance/volume_attachments/{id} status Der Status der Datenträgerzuordnung: zugeordnet, anhängen, löschen oder abhängen.
/instance/volume_attachments/{id} type Der Typ der Datenträgerzuordnung ('boot' oder 'data').
/instance/volume_attachments/{id} volume Der zugeordnete Datenträger; enthält den CRN, die ID, den Namen und den Wert für deleted, wenn der Datenträger gelöscht wird.

Zusammenfassung der Metadaten für SSH-Schlüssel

Die Informationen in Tabelle 2 erläutern den Typ der Metadaten, die für SSH-Schlüssel zurückgegeben werden.

Metadaten für SSH-Schlüssel
URI-Pfad des SSH-Schlüssels Metadatenschlüssel Beschreibung der Metadaten
/keys keys Eine Zusammenstellung von Schlüsseln. Ausführliche Informationen finden Sie in keys/{id}.
/keys/{id} created_at Das Datum und die Uhrzeit des Zeitpunkts, zu dem der Schlüssel erstellt wurde.
/keys/{id} crn Der Name der Cloud-Ressource für den Schlüssel.
/keys/{id} fingerprint Der Fingerabdruck für den Schlüssel. Der Wert wird in Base64-Codierung zurückgegeben und enthält als Präfix den Hashalgorithmus (immer SHA256).
/keys/{id} id Die eindeutige Kennung für den Schlüssel.
/keys/{id} length Die Länge des Schlüssels in Bit.
/keys/{id} name Der eindeutige, benutzerdefinierte Name für den Schlüssel. Sofern nicht anders angegeben, besteht der Name aus einer durch Bindestriche getrennten Liste zufällig ausgewählter Wörter (zum Beispiel elderly-mountain-troop-opponent)
/keys/{id} public_key Der öffentliche SSH-Schlüssel.
/keys/{id} type Das vom Schlüssel verwendete Kryptosystem.

Zusammenfassung der Metadaten für Platzierungsgruppen

Die Informationen in Tabelle 3 erläutern den Typ der Metadaten, die für Platzierungsgruppen zurückgegeben werden.

Metadaten für Vermittlungsgruppen
URI-Pfad der Platzierungsgruppe Metadatenschlüssel Beschreibung der Metadaten
/placement_groups placement_groups Eine Zusammenstellung von Platzierungsgruppen. Ausführliche Informationen finden Sie in placement_groups/{id}.
/placement_groups/{id} created_at Der Zeitpunkt (Datum und Uhrzeit), zu dem die Platzierungsgruppe erstellt wurde.
/placement_groups/{id} crn Der Name der Cloud-Ressource für die Platzierungsgruppe.
/placement_groups/{id} id Die eindeutige Kennung für die Platzierungsgruppe.
/placement_groups/{id} lifecycle_state Der Lebenszyklusstatus der Platzierungsgruppe.
/placement_groups/{id} name Der benutzerdefinierte Name für die Platzierungsgruppe.
/placement_groups/{id} resource_type Der Ressourcentyp.
/placement_groups/{id} strategy Die Strategie für die Vermittlungsgruppe.

Zusammenfassung der Metadaten für Software-Anhänge

Anhand der Informationen in der folgenden Tabelle können Sie nachvollziehen, welche Art von Metadaten für Software-Anhänge zurückgegeben werden.

Der Endpunkt „ /metadata/v1/instance/software_attachments “ gibt ein Array mit null oder mehr Software-Anhang-Objekten zurück. Jedes Objekt repräsentiert eine beim Ressourcen-Controller registrierte Softwareinstanz, die einem Softwareplan entspricht.

Metadaten für Software-Anhänge
URI-Pfad für Software-Anhänge Metadatenschlüssel Beschreibung der Metadaten
/instance/software_attachments/{id} id Eine eindeutige UUID für den Software-Anhang.
/instance/software_attachments/{id} name Ein Name, der innerhalb der Gruppe der mit der virtuellen Serverinstanz verknüpften Software-Anhänge eindeutig ist. Dieser Name wird auf einen vom System generierten Zufallswert gesetzt und kann anschließend vom Eigentümer bei Bedarf geändert werden. Beachten Sie, dass die Änderung des Namens in der Software-Anbindung der virtuellen Serverinstanz keine Auswirkungen auf den Namen des angehängten Startvolumes oder auf bereits von diesem Volume erstellte Snapshots hat.
/instance/software_attachments/{id} href URL en zu diesem Software-Anhang.
/instance/software_attachments/{id} catalog_offering Ein Objekt, dessen Wert mit dem des gleichnamigen Objekts der Instanz übereinstimmt und das die CRN der Katalogangebotversion sowie die zugehörige CRN des Softwareplans enthält, die die Software repräsentieren.
/instance/software_attachments/{id} offering_instance Ein Objekt, das die aus dem Softwareplan instanziierte Instanz des Softwareangebots darstellt.
/instance/software_attachments/{id} offering_instance.crn Die Software-Angebotsinstanz CRN.
/instance/software_attachments/{id} entitlement (fakultativ) Ein Objekt, das die Lizenzberechtigung für die Instanz des Softwareangebots repräsentiert. Falls nicht vorhanden, ist mit dem Software-Plan keine Lizenz verknüpft.
/instance/software_attachments/{id} entitlement.licensed_software Ein Array aus null oder mehr Objekten, von denen jedes ein installiertes, lizenziertes Softwareprogramm oder eine Funktion in der virtuellen Serverinstanz darstellt.
/instance/software_attachments/{id} entitlement.licensed_software[].sku Die SKU (Stock Keeping Unit) eines lizenzierbaren Softwareprogramms oder einer mit dem Softwareplan verbundenen Funktion, die auf der virtuellen Serverinstanz ausgeführt wird. Für den Anbieter der Software ist dies von Bedeutung.
/instance/software_attachments/{id} entitlement.licensed_software[].key (fakultativ) Der Lizenzschlüssel für die Software-Nutzungsberechtigung. Falls dieser Eintrag fehlt, wurde die Lizenz noch nicht erteilt.
/instance/software_attachments/{id} lifecycle_state Der Lebenszyklusstatus des Software-Anhangs. Wenn der Status „stabil“ angezeigt wird, wurde die Software-Instanz erfolgreich erstellt.
/instance/software_attachments/{id} lifecycle_reasons[] Die Gründe für den aktuellen Lebenszyklus_status.
/instance/software_attachments/{id} resource_type Der Ressourcentyp, eingestellt auf „ instance_software_attachment “.
/instance/software_attachments/{id} created_at Datum und Uhrzeit der Erstellung dieses Software-Anhangs.

Nächste Schritte

Daten mithilfe des Metadatenservice abrufen.