Riepilogo dei dati restituiti dal servizio di metadati

Utilizzare il servizio di metadati per accedere alle informazioni sull'istanza, sulle chiavi SSH e sui gruppi di collocamento. Il seguente riepilogo contiene i percorsi URI e le chiavi dei metadati e descrive i metadati.

La risposta API per ogni tipo di metadati è presentata in formato JSON che contiene coppie chiave: valore metadati.

Riepilogo dei metadati per le istanze

Utilizzare le informazioni nella Tabella 1 per comprendere il tipo di metadati restituiti per una istanza. Per accedere a tutti i metadati, vedere Recupero dei metadati da un'istanza.

Metadati per un'istanza
Percorso URI istanza Chiave dei metadati Descrizione dei metadati
/instance availability_policy La politica di disponibilità per questa istanza di server virtuale.
/instance bandwidth La larghezza di banda totale in megabit al secondo condivisa tra le interfacce di rete dell'istanza del server virtuale e i volumi dell' Block Storage.
/instance boot_volume_attachment Collegamento volume di boot, con nome volume, CRN e ID.
/instance catalog_offering Queste informazioni vengono visualizzate se l'istanza del server virtuale è stata fornita con un'immagine personalizzata in un catalogo privato.
/instance created_at La data e l'ora di creazione dell'istanza del server virtuale.
/instance crn Il nome risorsa cloud per questa istanza del server virtuale.
/instance dedicated_host Raccolta dei riferimenti host dedicati, che include il CRN, gli host eliminati, l'ID, il nome e il resource_type.
/instance disks Un elenco dei dischi dell'istanza.
/instance gpu La configurazione della GPU dell'istanza del server virtuale
/instance id L'identificativo univoco per questa istanza del server virtuale.
/instance image L'immagine da cui è stato eseguito il provisioning dell'istanza del server virtuale. Ad esempio, un'immagine stock Debian Linux.
/instance lifecycle_reasons I motivi per il lifecycle_state corrente.
/instance lifecycle_state Lo stato del ciclo di vita dell'istanza del server virtuale.
/instance memory La quantità di memoria; troncata a gigabyte interi.
/instance metadata_service Indica se l'endpoint del servizio metadati è disponibile per l'istanza del server virtuale. Lo stato abilitato è true o false.
/instance name Il nome definito dall'utente per questa istanza del server virtuale (e il nome host del sistema predefinito).
/instance network_interfaces Un elenco delle interfacce di rete dell'istanza del server virtuale, inclusa l'interfaccia di rete primaria.
/instance placement_target Le restrizioni di collocazione relative all'istanza del server virtuale.
/instance primary_network_interface L'interfaccia di rete primaria dell'istanza.
/instance profile Il nome univoco globale per questo profilo dell'istanza del server virtuale. Ad esempio, un profilo bilanciato bx2-2x8.
/instance software_attachments Un elenco dei componenti software associati all'istanza del server virtuale.
/instance startable Indica se lo stato dell'istanza del server virtuale consente una richiesta di avvio.
/instance status Lo stato dell'istanza: eliminazione, non riuscito, in pausa, in pausa, in sospeso, in riavvio, in ripresa, in esecuzione, in avvio, arrestato o in fase di arresto.
/instance status_reasons I motivi dello stato corrente.
/instance total_network_bandwidth La quantità di larghezza di banda, espressa in megabit al secondo, assegnata esclusivamente alle interfacce di rete delle istanze.
/instance total_volume_bandwidth La quantità di larghezza di banda, espressa in megabit al secondo, assegnata esclusivamente ai volumi Block Storage dell'istanza. Aumentando questo valore si ottiene una diminuzione corrispondente a total_network_bandwidth.
/instance vcpu Il numero di VCPU assegnate tramite una struttura che include le proprietà count e architecture.
/instance volume_attachments Un elenco di collegamenti di volume dell'istanza del server virtuale.
/instance boot_volume_attachment Collegamento del volume di boot dell'istanza.
/instance volume_bandwidth_qos_mode La larghezza di banda in volume QoS per questa istanza di server virtuale. In forma aggregata o ponderata.
/instance vpc Il VPC in cui risiede l'istanza del server virtuale.
/instance zone Il nome univoco globale per la zona.
/instance/initialization default_trusted_profile La configurazione del profilo attendibile predefinito specificata durante la creazione dell'istanza del server virtuale.
/instance/initialization keys Un elenco di riferimenti alle chiavi SSH pubbliche che erano utilizzate durante l'inizializzazione dell'istanza.
/instance/initialization password La password amministratore all'inizializzazione, crittografata utilizzando e restituita Base64-encodedencryption_key.
/instance/initialization user_data I dati utente resi disponibili quando imposti una nuova istanza del server virtuale.
/instance/network_interfaces network_interfaces Un elenco di interfacce di rete. Per ulteriori dettagli, consultare /instance/network_interfaces/ {id}.
/instance/network_interfaces/{id} allow_ip_spoofing Indica se lo spoofing dell'IP di origine è consentito su questa interfaccia. Se impostato su false, lo spoofing dell'IP di origine viene impedito su questa interfaccia. Se impostato su true, lo spoofing dell'IP di origine è consentito su questa interfaccia.
/instance/network_interfaces/{id} created_at La data e l'ora di creazione dell'interfaccia di rete.
/instance/network_interfaces/{id} floating_ips Array di riferimenti agli indirizzi IP mobili associati all'interfaccia di rete.
/instance/network_interfaces/{id} id L'identificativo univoco per l'interfaccia di rete.
/instance/network_interfaces/{id} name Il nome definito dall'utente per l'interfaccia di rete.
/instance/network_interfaces/{id} port_speed La velocità della porta dell'interfaccia di rete in Mbps.
/instance/network_interfaces/{id} primary_ipv4_address L'indirizzo principale di IPv4.
/instance/network_interfaces/{id} resource_type Il tipo di risorsa.
/instance/network_interfaces/{id} security_groups Un elenco di gruppi di sicurezza.
/instance/network_interfaces/{id} status Lo stato dell'interfaccia di rete.
/instance/network_interfaces/{id} subnet La sottorete associata all'istanza.
/instance/network_interfaces/{id} type Il tipo di questa interfaccia di rete in relazione a una istanza.
/instance/software_attachments software_attachments Un array contenente zero o più oggetti di allegato software.
/instance/software_attachments/{id} id L'identificatore univoco (UUID) di questo allegato software.
/instance/software_attachments/{id} name Il nome di questo componente aggiuntivo del software. Il nome è univoco all'interno dell'insieme degli allegati software associati all'istanza del server virtuale.
/instance/software_attachments/{id} href URL per questo componente aggiuntivo del software.
/instance/software_attachments/{id} catalog_offering Un oggetto contenente il CRN della versione dell'offerta di catalogo e il CRN del piano software associato che identifica il software.
/instance/software_attachments/{id} offering_instance Un oggetto che rappresenta l'istanza dell'offerta software istanziata dal piano software. Contiene il CRN dell'istanza dell'offerta software.
/instance/software_attachments/{id} entitlement Un oggetto che rappresenta i diritti di licenza relativi all'istanza dell'offerta software. Questa proprietà viene popolata dinamicamente dopo che la chiamata al License Manager per ottenere l'autorizzazione è andata a buon fine.
/instance/software_attachments/{id} entitlement.licensed_software Un array composto da zero o più oggetti, ciascuno dei quali rappresenta un programma o una funzionalità software installata e con licenza nell'istanza del server virtuale.
/instance/software_attachments/{id} entitlement.licensed_software[].sku Lo SKU (Stock Keeping Unit) di un programma software soggetto a licenza o di una funzionalità associata al piano software e in esecuzione sull'istanza del server virtuale.
/instance/software_attachments/{id} entitlement.licensed_software[].key La chiave di licenza relativa al diritto d'uso del software. Il valore di questo immobile potrebbe variare nel tempo.
/instance/software_attachments/{id} lifecycle_state Lo stato del ciclo di vita dell'allegato software, che indica se è completo e utilizzabile.
/instance/software_attachments/{id} lifecycle_reasons Una serie di motivi alla base dell'attuale stato del ciclo di vita.
/instance/software_attachments/{id} resource_type Il tipo di risorsa. Imposta su instance_software_attachment.
/instance/software_attachments/{id} created_at Data e ora di creazione di questo allegato software.
/instance/volume_attachments/{id} bandwidth La larghezza di banda massima in megabit al secondo per il volume quando è collegato a questa istanza. Questo valore potrebbe essere inferiore alla larghezza di banda in volume, a seconda della configurazione dell'istanza.
/instance/volume_attachments/{id} created_at La data e l'ora in cui il volume è stato collegato.
/instance/volume_attachments/{id} delete_volume_on_instance_delete Se impostato su true, quando elimini l'istanza, viene eliminato anche il volume.
/instance/volume_attachments/{id} device Informazioni su come il volume viene esposto al sistema operativo dell'istanza.
/instance/volume_attachments/{id} id L'identificativo univoco per il collegamento volume.
/instance/volume_attachments/{id} name Il nome definito dall'utente per il collegamento del volume.
/instance/volume_attachments/{id} status Lo stato del collegamento del volume: collegato, in fase di collegamento, in fase di eliminazione o in fase di scollegamento.
/instance/volume_attachments/{id} type Il tipo di collegamento del volume, di avvio o di dati.
/instance/volume_attachments/{id} volume Il volume collegato, che contiene il CRN, l'ID, il nome e il valore deleted, quando il volume viene eliminato.

Riepilogo dei metadati per le chiavi SSH

Utilizzare le informazioni nella Tabella 2 per comprendere il tipo di metadati restituiti per chiavi SSH.

Metadati per le chiavi SSH
Percorso URI chiave SSH Chiave dei metadati Descrizione dei metadati
/keys keys Una raccolta di chiavi. Consultare keys/{id} per i dettagli.
/keys/{id} created_at La data e l'ora di creazione della chiave.
/keys/{id} crn Il nome della risorsa cloud per la chiave.
/keys/{id} fingerprint L'impronta per la chiave. Il valore viene restituito c Base64-encoded e e preceduto dall'algoritmo hash (sempre SHA256 ).
/keys/{id} id L'identificatore univoco della chiave.
/keys/{id} length La lunghezza della chiave, in bit.
/keys/{id} name Il nome univoco definito dall'utente per la chiave. Se non specificato, il nome è un elenco con sillabazione di parole selezionate casualmente (ad esempio, elderly-mountain-troop-opponent.)
/keys/{id} public_key La chiave SSH pubblica.
/keys/{id} type Il sistema crittografico utilizzato dalla chiave.

Riepilogo dei metadati per i gruppi di posizionamento

Utilizzare le informazioni nella tabella 3 per comprendere il tipo di metadati restituiti per i gruppi di posizionamento.

Metadati per i gruppi di collocamento
Percorso URI gruppo di posizionamento Chiave dei metadati Descrizione dei metadati
/placement_groups placement_groups Una raccolta di gruppi di posizionamento. Consultare placement_groups/{id} per i dettagli.
/placement_groups/{id} created_at La data e l'ora di creazione del gruppo di collocamento.
/placement_groups/{id} crn Il nome della risorsa cloud per il gruppo di posizionamento.
/placement_groups/{id} id L'identificatore univoco del gruppo di posizionamento.
/placement_groups/{id} lifecycle_state Lo stato del ciclo di vita del gruppo di collocazione.
/placement_groups/{id} name Il nome definito dall'utente per il gruppo di posizionamento.
/placement_groups/{id} resource_type Il tipo di risorsa.
/placement_groups/{id} strategy La strategia per il gruppo di collocamento.

Riepilogo dei metadati relativi agli allegati software

Utilizza le informazioni contenute nella tabella seguente per comprendere il tipo di metadati restituiti per gli allegati software.

L'endpoint /metadata/v1/instance/software_attachments restituisce un array composto da zero o più oggetti di allegato software. Ogni oggetto rappresenta un'istanza software registrata dal controllore delle risorse, corrispondente a un piano software.

Metadati relativi agli allegati software
Percorso URI degli allegati software Chiave dei metadati Descrizione dei metadati
/instance/software_attachments/{id} id Un UUID univoco per l'allegato software.
/instance/software_attachments/{id} name Un nome univoco all'interno dell'insieme degli allegati software associati all'istanza del server virtuale. Questo nome viene impostato su un valore casuale generato dal sistema e può essere successivamente modificato dal proprietario, se lo desidera. Si noti che l'aggiornamento del nome nell'allegato del software dell'istanza del server virtuale non influisce su quello del volume di avvio collegato né su eventuali snapshot già creati da tale volume.
/instance/software_attachments/{id} href URL per questo componente aggiuntivo del software.
/instance/software_attachments/{id} catalog_offering Un oggetto il cui valore è identico a quello dell'oggetto dell'istanza con lo stesso nome, contenente il CRN della versione dell'offerta di catalogo e il CRN del piano software associato che rappresentano il software.
/instance/software_attachments/{id} offering_instance Un oggetto che rappresenta l'istanza dell'offerta software istanziata dal piano software.
/instance/software_attachments/{id} offering_instance.crn L'istanza dell'offerta software CRN.
/instance/software_attachments/{id} entitlement (facoltativo) Un oggetto che rappresenta i diritti di licenza relativi all'istanza dell'offerta software. Se non presente, al piano software non è associata alcuna licenza.
/instance/software_attachments/{id} entitlement.licensed_software Un array composto da zero o più oggetti, ciascuno dei quali rappresenta un programma o una funzionalità software installata e con licenza nell'istanza del server virtuale.
/instance/software_attachments/{id} entitlement.licensed_software[].sku Lo SKU (Stock Keeping Unit) di un programma software soggetto a licenza o di una funzionalità associata al piano software e in esecuzione sull'istanza del server virtuale. È importante per il fornitore del software.
/instance/software_attachments/{id} entitlement.licensed_software[].key (facoltativo) La chiave di licenza relativa al diritto d'uso del software. Se non è presente, significa che la licenza non è stata ancora ottenuta.
/instance/software_attachments/{id} lifecycle_state Lo stato del ciclo di vita dell'allegato software. Se lo stato è "stabile", significa che l'istanza del software è stata creata correttamente.
/instance/software_attachments/{id} lifecycle_reasons[] I motivi per il lifecycle_state corrente.
/instance/software_attachments/{id} resource_type Il tipo di risorsa, impostato su " instance_software_attachment".
/instance/software_attachments/{id} created_at Data e ora di creazione di questo allegato software.

Passi successivi

Recuperare i dati utilizzando il servizio metadati.