Resumen de los datos proporcionados por el servicio de metadatos

Utiliza el servicio de metadatos para acceder a información sobre la instancia, las claves SSH y los grupos de ubicación. El siguiente resumen contiene las rutas URI y las claves de metadatos, y describe los metadatos.

La respuesta de la API para cada tipo de metadatos se presenta en formato JSON, que contiene pares clave:valor de metadatos.

Resumen de metadatos para instancias

Utilice la información de la Tabla 1 para comprender el tipo de metadatos devueltos para una instancia. Para acceder a todos los metadatos, consulte Recuperación de metadatos de una instancia.

Metadatos de una instancia
Vía de acceso de URI de instancia Clave de metadatos Descripción de los metadatos
/instance availability_policy Política de disponibilidad de esta instancia de servidor virtual.
/instance bandwidth El ancho de banda total, en megabits por segundo, que se comparte entre las interfaces de red de la instancia del servidor virtual y los volúmenes de « Block Storage ».
/instance boot_volume_attachment Conexión de volumen de arranque, con nombre de volumen, CRN e ID.
/instance catalog_offering Esta información se muestra si la instancia del servidor virtual se aprovisionó con una imagen personalizada en un catálogo privado.
/instance created_at La fecha y la hora en que se ha creado la instancia de servidor virtual.
/instance crn El nombre de recurso de nube para esta instancia de servidor virtual.
/instance dedicated_host Recopilación de las referencias de los servidores dedicados, que incluye el CRN, los servidores eliminados, el ID, el nombre y el «resource_type».
/instance disks Una lista de los discos de la instancia.
/instance gpu Configuración de GPU de instancia de servidor virtual
/instance id El identificador exclusivo para esta instancia de servidor virtual.
/instance image La imagen de la que se ha suministrado la instancia de servidor virtual. Por ejemplo, una imagen en stock de Debian Linux.
/instance lifecycle_reasons Razones del estado de ciclo de vida (lifecycle_state) actual.
/instance lifecycle_state Estado del ciclo de vida de la instancia de servidor virtual.
/instance memory La cantidad de memoria; redondeada a gigabytes enteros.
/instance metadata_service Indica si el punto final del servicio de metadatos está disponible a la instancia de servidor virtual. (El estado habilitado es true o false).
/instance name El nombre definido por el usuario para esta instancia de servidor virtual (y el nombre de host del sistema predeterminado).
/instance network_interfaces Una lista de las interfaces de red de la instancia de servidor virtual, incluida la interfaz de red primaria.
/instance placement_target Restricciones de colocación de la instancia de servidor virtual.
/instance primary_network_interface La interfaz de red primaria de la instancia.
/instance profile El nombre exclusivo global para este perfil de instancia de servidor virtual. Por ejemplo, un perfil equilibrado bx2-2x8.
/instance software_attachments Una lista de los complementos de software de la instancia del servidor virtual.
/instance startable Indica si el estado de la instancia de servidor virtual permite una solicitud de inicio.
/instance status Estado de la instancia: suprimiendo, error, pausada, pausando, pendiente, reiniciando, reanudando, ejecutando, iniciando, detenida o deteniendo.
/instance status_reasons Razones del estado actual.
/instance total_network_bandwidth Cantidad de ancho de banda en megabits por segundo asignados exclusivamente a interfaces de red de la instancia.
/instance total_volume_bandwidth Cantidad de ancho de banda en megabits por segundo asignada exclusivamente a los volúmenes de almacenamiento en bloques de la instancia. Al aumentar este valor, se produce una disminución correspondiente en «total_network_bandwidth».
/instance vcpu El número de VCPU que se asignan mediante una estructura que incluye propiedades de recuento y arquitectura.
/instance volume_attachments Lista de las conexiones de volumen de la instancia de servidor virtual.
/instance boot_volume_attachment Conexión del volumen de arranque de la instancia.
/instance volume_bandwidth_qos_mode El ancho de banda de volumen QoS modo para esta instancia de servidor virtual. De forma conjunta o ponderada.
/instance vpc La VPC en la que reside la instancia de servidor virtual.
/instance zone El nombre exclusivo global para la zona.
/instance/initialization default_trusted_profile La configuración predeterminada del perfil de confianza que se especificó al crear la instancia del servidor virtual.
/instance/initialization keys Una lista de referencias a las claves SSH públicas que se utilizaron durante la inicialización de la instancia.
/instance/initialization password La contraseña del administrador en la inicialización, cifrada mediante encryption_keyy devuelta en base64-codificada.
/instance/initialization user_data Datos de usuario que se ponen a disposición al configurar una nueva instancia de servidor virtual.
/instance/network_interfaces network_interfaces Una lista de interfaces de red. Consulte /instance/network_interfaces/{id} para obtener detalles.
/instance/network_interfaces/{id} allow_ip_spoofing Indica si se permite suplantación de IP de origen en esta interfaz. Si es false, se impide la suplantación de IP de origen en esta interfaz. Si es true, se permite la suplantación de IP de origen en esta interfaz.
/instance/network_interfaces/{id} created_at La fecha y la hora en que se ha creado la interfaz de red.
/instance/network_interfaces/{id} floating_ips Matriz de referencias a direcciones IP flotantes asociadas a la interfaz de red.
/instance/network_interfaces/{id} id El identificador exclusivo para la interfaz de red.
/instance/network_interfaces/{id} name El nombre definido por el usuario para la interfaz de red.
/instance/network_interfaces/{id} port_speed Velocidad de los puertos de la interfaz de red en Mbps.
/instance/network_interfaces/{id} primary_ipv4_address La dirección IPv4 primaria.
/instance/network_interfaces/{id} resource_type El tipo de recurso.
/instance/network_interfaces/{id} security_groups Una lista de grupos de seguridad.
/instance/network_interfaces/{id} status Estado actual de la interfaz de red.
/instance/network_interfaces/{id} subnet El caso padre asociado con la instancia.
/instance/network_interfaces/{id} type El tipo de esta interfaz de red que se relaciona con una instancia.
/instance/software_attachments software_attachments Una matriz que contiene cero o más objetos de archivos adjuntos de software.
/instance/software_attachments/{id} id El identificador único (UUID) de este archivo adjunto de software.
/instance/software_attachments/{id} name El nombre de este complemento de software. El nombre es único dentro del conjunto de complementos de software asociados a la instancia del servidor virtual.
/instance/software_attachments/{id} href URL para este complemento de software.
/instance/software_attachments/{id} catalog_offering Un objeto que contiene el CRN de la oferta del catálogo y el CRN del plan de software asociado que representa el software.
/instance/software_attachments/{id} offering_instance Un objeto que representa la instancia de la oferta de software creada a partir del plan de software. Contiene el CRN de la instancia de la oferta de software.
/instance/software_attachments/{id} entitlement Un objeto que representa los derechos de licencia de la instancia de la oferta de software. Esta propiedad se rellena dinámicamente tras una llamada satisfactoria al Gestor de licencias para obtener los derechos de uso.
/instance/software_attachments/{id} entitlement.licensed_software Una matriz de cero o más objetos, cada uno de los cuales representa un programa o una función de software instalado y con licencia en la instancia del servidor virtual.
/instance/software_attachments/{id} entitlement.licensed_software[].sku El SKU (unidad de gestión de existencias) de un programa de software con licencia o de una función asociada al plan de software que se ejecuta en la instancia del servidor virtual.
/instance/software_attachments/{id} entitlement.licensed_software[].key La clave de licencia correspondiente al derecho de uso del software. El valor de este inmueble puede variar con el tiempo.
/instance/software_attachments/{id} lifecycle_state El estado del ciclo de vida del complemento de software, que indica si está terminado y listo para su uso.
/instance/software_attachments/{id} lifecycle_reasons Una serie de motivos que explican el estado actual del ciclo de vida.
/instance/software_attachments/{id} resource_type El tipo de recurso. Se establece en instance_software_attachment.
/instance/software_attachments/{id} created_at La fecha y la hora en que se creó este archivo adjunto de software.
/instance/volume_attachments/{id} bandwidth El ancho de banda máximo, en megabits por segundo, del volumen cuando está conectado a esta instancia. Este valor podría ser inferior al ancho de banda del volumen, dependiendo de la configuración de la instancia.
/instance/volume_attachments/{id} created_at La fecha y la hora en que se ha adjuntado el volumen.
/instance/volume_attachments/{id} delete_volume_on_instance_delete Si se configura en « true », al eliminar la instancia, el volumen también se eliminará.
/instance/volume_attachments/{id} device Información sobre cómo se expone el volumen al sistema operativo de la instancia.
/instance/volume_attachments/{id} id El identificador exclusivo para la conexión de volumen.
/instance/volume_attachments/{id} name El nombre definido por el usuario para la conexión de volumen.
/instance/volume_attachments/{id} status Estado de la conexión de volumen: conectado, conectando, suprimiendo o desconectando.
/instance/volume_attachments/{id} type El tipo de conexión de volumen, arranque o datos.
/instance/volume_attachments/{id} volume El volumen conectado, que contiene el CRN, el ID, el nombre y el valor deleted, si el volumen se ha suprimido.

Resumen de metadatos para claves SSH

Utilice la información de la Tabla 2 para comprender el tipo de metadatos devueltos para claves SSH.

Metadatos para claves SSH
Vía de acceso de URI de clave SSH Clave de metadatos Descripción de los metadatos
/keys keys Una colección de claves. Consulte keys/{id} para obtener detalles.
/keys/{id} created_at La fecha y la hora en que se creó la clave.
/keys/{id} crn El nombre del recurso en la nube correspondiente a la clave.
/keys/{id} fingerprint La huella digital de la clave. El valor se devuelve codificado en base64 y con el prefijo del algoritmo hash (siempre SHA256).
/keys/{id} id El identificador exclusivo para la clave.
/keys/{id} length La longitud de la clave, en bits.
/keys/{id} name El nombre único definido por el usuario para la clave. Si no se especifica, el nombre es una lista de palabras seleccionadas al azar separadas por guiones (por ejemplo, elderly-mountain-troop-opponent)
/keys/{id} public_key La clave SSH pública.
/keys/{id} type El sistema criptográfico utilizado por la clave.

Resumen de metadatos para grupos de colocación

Utilice la información de la Tabla 3 para comprender el tipo de metadatos devueltos para los grupos de colocación.

Metadatos para grupos de colocación
Vía de acceso de URI de grupo de colocación Clave de metadatos Descripción de los metadatos
/placement_groups placement_groups Una colección de grupos de colocación. Consulte placement_groups/{id} para obtener detalles.
/placement_groups/{id} created_at La fecha y la hora en que se ha creado el grupo de colocación.
/placement_groups/{id} crn El nombre del recurso en la nube correspondiente al grupo de ubicación.
/placement_groups/{id} id El identificador único del grupo de asignación.
/placement_groups/{id} lifecycle_state Estado de ciclo de vida del grupo de colocación.
/placement_groups/{id} name El nombre definido por el usuario para el grupo de colocación.
/placement_groups/{id} resource_type El tipo de recurso.
/placement_groups/{id} strategy La estrategia para el grupo de colocación.

Resumen de los metadatos de los archivos adjuntos de software

Utiliza la información de la siguiente tabla para conocer el tipo de metadatos que se devuelven para los archivos adjuntos de software.

El punto final « /metadata/v1/instance/software_attachments » devuelve una matriz de cero o más objetos de archivos adjuntos de software. Cada objeto representa una instancia de software registrada en el controlador de recursos que se corresponde con un plan de software.

Metadatos de los archivos adjuntos de software
Ruta URI de los archivos adjuntos de software Clave de metadatos Descripción de los metadatos
/instance/software_attachments/{id} id Un UUID único para el archivo adjunto del software.
/instance/software_attachments/{id} name Un nombre único dentro del conjunto de complementos de software asociados a la instancia del servidor virtual. Este nombre se establece con un valor aleatorio generado por el sistema y, posteriormente, el propietario puede modificarlo si lo desea. Ten en cuenta que actualizar el nombre en el dispositivo de software de la instancia del servidor virtual no afecta al del volumen de arranque asociado ni a ninguna instantánea que ya se haya creado a partir de dicho volumen.
/instance/software_attachments/{id} href URL para este complemento de software.
/instance/software_attachments/{id} catalog_offering Un objeto cuyo valor es el mismo que el del objeto de la instancia con el mismo nombre, que contiene el CRN de la oferta del catálogo y el CRN del plan de software asociado que representa el software.
/instance/software_attachments/{id} offering_instance Un objeto que representa la instancia de la oferta de software creada a partir del plan de software.
/instance/software_attachments/{id} offering_instance.crn La instancia de la oferta de software CRN.
/instance/software_attachments/{id} entitlement (opcional) Un objeto que representa los derechos de licencia de la instancia de la oferta de software. Si no aparece, significa que no hay ninguna licencia asociada al plan de software.
/instance/software_attachments/{id} entitlement.licensed_software Una matriz de cero o más objetos, cada uno de los cuales representa un programa o una función de software instalado y con licencia en la instancia del servidor virtual.
/instance/software_attachments/{id} entitlement.licensed_software[].sku El SKU (unidad de gestión de existencias) de un programa de software con licencia o de una función asociada al plan de software que se ejecuta en la instancia del servidor virtual. Es importante para el proveedor del software.
/instance/software_attachments/{id} entitlement.licensed_software[].key (opcional) La clave de licencia correspondiente al derecho de uso del software. Si no aparece, significa que aún no se ha obtenido la licencia.
/instance/software_attachments/{id} lifecycle_state El estado del ciclo de vida del archivo adjunto de software. Si aparece «estable», significa que la instancia del software se ha creado correctamente.
/instance/software_attachments/{id} lifecycle_reasons[] Razones del estado de ciclo de vida (lifecycle_state) actual.
/instance/software_attachments/{id} resource_type El tipo de recurso, establecido en « instance_software_attachment ».
/instance/software_attachments/{id} created_at La fecha y la hora en que se creó este archivo adjunto de software.

Próximos pasos

Recuperar datos utilizando el servicio de metadatos.