Resumo dos dados retornados pelo serviço de metadados

Use o serviço de metadados para acessar informações sobre a instância, as chaves SSH e os grupos de alocação. O resumo a seguir contém os caminhos URI e as chaves de metadados, além de descrever os metadados.

A resposta da API para cada tipo de metadados é apresentada no formato JSON, que contém pares de chave:valor de metadados.

Resumo de metadados para instâncias

Use as informações na Tabela 1 para entender o tipo de metadados retornados para uma instância. Para acessar todos os metadados, consulte Recuperação de metadados de uma instância.

Metadados de uma instância
Caminho de URI da instância Chave de metadados Descrição dos metadados
/instance availability_policy A política de disponibilidade para esta instância de servidor virtual.
/instance bandwidth A largura de banda total, em megabits por segundo, que é compartilhada entre as interfaces de rede da instância do servidor virtual e os volumes d Block Storage.
/instance boot_volume_attachment Anexo de volume de inicialização, com nome de volume, CRN e ID.
/instance catalog_offering Essas informações são exibidas se a instância do servidor virtual foi provisionada com uma imagem personalizada em um catálogo privado.
/instance created_at A data e a hora em que a instância de servidor virtual foi criada.
/instance crn O Cloud Resource Name para essa instância de servidor virtual.
/instance dedicated_host Conjunto de referências aos hosts dedicados, que inclui o CRN, os hosts excluídos, o ID, o nome e o resource_type.
/instance disks Uma lista dos discos da instância.
/instance gpu A configuração de GPU da instância de servidor virtual
/instance id O identificador exclusivo para essa instância de servidor virtual.
/instance image A imagem por meio da qual a instância de servidor virtual foi provisionada. Por exemplo, um banco de imagens do Debian Linux.
/instance lifecycle_reasons As razões para o lifecycle_state atual.
/instance lifecycle_state O estado do ciclo de vida da instância de servidor virtual.
/instance memory A quantidade de memória; arredondada para o número inteiro de gigabytes mais próximo.
/instance metadata_service Indica se o terminal em serviço de metadados está disponível para a instância de servidor virtual. (O status ativado é true ou false.)
/instance name O nome definido pelo usuário para essa instância de servidor virtual (e nome do host do sistema padrão).
/instance network_interfaces Uma lista das interfaces de rede da instância de servidor virtual, incluindo a interface de rede primária.
/instance placement_target As restrições de colocação para a instância de servidor virtual.
/instance primary_network_interface A interface de rede primária da instância.
/instance profile O nome globalmente exclusivo para esse perfil de instância de servidor virtual. Por exemplo, um perfil balanceado bx2-2x8.
/instance software_attachments Uma lista dos complementos de software da instância do servidor virtual.
/instance startable Indica se o estado da instância de servidor virtual permite uma solicitação de início.
/instance status O status da instância: excluindo, com falha, pausado, pausando, pendente, reiniciando, continuando, executando, iniciando, interrompido ou parando.
/instance status_reasons As razões para o status atual.
/instance total_network_bandwidth A quantidade de largura da banda, em megabits por segundo, que é alocada exclusivamente para interfaces de rede de instância.
/instance total_volume_bandwidth A quantidade de largura da banda, em megabits por segundo, alocada exclusivamente para volumes de armazenamento de bloco da instância. Aumentar esse valor resulta em uma redução correspondente na largura de banda total da rede.
/instance vcpu O número de VCPUs atribuídas por meio de uma estrutura que inclui propriedades de contagem e arquitetura.
/instance volume_attachments Uma lista com os anexos de volume da instância de servidor virtual.
/instance boot_volume_attachment Anexo de volume de inicialização da instância.
/instance volume_bandwidth_qos_mode A largura de banda do volume QoS para esta instância de servidor virtual. Agrupado ou ponderado.
/instance vpc A VPC na qual a instância de servidor virtual reside.
/instance zone O nome globalmente exclusivo para a zona.
/instance/initialization default_trusted_profile A configuração padrão do perfil de confiança especificada na criação da instância do servidor virtual.
/instance/initialization keys Uma lista de referências às chaves SSH públicas que foram utilizadas na inicialização da instância.
/instance/initialization password A senha do administrador na inicialização, criptografada usando encryption_key e retornada com codificação base64.
/instance/initialization user_data Dados do usuário que são disponibilizados ao configurar uma nova instância do servidor virtual.
/instance/network_interfaces network_interfaces Uma lista de interfaces de rede. Consulte /instance/network_interfaces/{id} para obter detalhes.
/instance/network_interfaces/{id} allow_ip_spoofing Indica se o spoofing de IP de origem é permitido nesta interface. Se falso, o spoofing de IP de origem é evitado nessa interface. Se verdadeiro, o spoofing de IP de origem é permitido nessa interface.
/instance/network_interfaces/{id} created_at A data e a hora em que a interface de rede foi criada.
/instance/network_interfaces/{id} floating_ips Matriz de referências a endereços IP flutuantes associados à interface de rede.
/instance/network_interfaces/{id} id O identificador exclusivo para a interface de rede.
/instance/network_interfaces/{id} name O nome definido pelo usuário para a interface de rede.
/instance/network_interfaces/{id} port_speed A velocidade da porta da interface de rede em Mbps.
/instance/network_interfaces/{id} primary_ipv4_address O endereço IPv4 primário.
/instance/network_interfaces/{id} resource_type O tipo de recurso.
/instance/network_interfaces/{id} security_groups Uma lista de grupos de segurança.
/instance/network_interfaces/{id} status O status da interface de rede.
/instance/network_interfaces/{id} subnet A sub-rede associada à instância.
/instance/network_interfaces/{id} type O tipo dessa interface de rede tal como ela está relacionada a uma instância.
/instance/software_attachments software_attachments Uma matriz contendo zero ou mais objetos de anexo de software.
/instance/software_attachments/{id} id O identificador único (UUID) deste anexo de software.
/instance/software_attachments/{id} name O nome deste anexo de software. O nome é único no conjunto de anexos de software associados à instância do servidor virtual.
/instance/software_attachments/{id} href URL para este complemento de software.
/instance/software_attachments/{id} catalog_offering Um objeto que contém o CRN da versão da oferta do catálogo e o CRN do plano de software associado, que representa o software.
/instance/software_attachments/{id} offering_instance Um objeto que representa a instância da oferta de software instanciada a partir do plano de software. Contém o CRN da instância da oferta de software.
/instance/software_attachments/{id} entitlement Um objeto que representa o direito de licença para a instância da oferta de software. Essa propriedade é preenchida dinamicamente após uma chamada bem-sucedida ao Gerenciador de Licenças para obter o direito de uso.
/instance/software_attachments/{id} entitlement.licensed_software Uma matriz composta por zero ou mais objetos, cada um representando um programa de software ou recurso instalado e licenciado na instância do servidor virtual.
/instance/software_attachments/{id} entitlement.licensed_software[].sku O SKU (Unidade de Manutenção de Estoque) de um programa de software sujeito a licença ou de um recurso associado ao plano de software e em execução na instância do servidor virtual.
/instance/software_attachments/{id} entitlement.licensed_software[].key A chave de licença para o direito de uso do software. O valor desse imóvel pode variar com o tempo.
/instance/software_attachments/{id} lifecycle_state O estado do ciclo de vida do anexo de software, indicando se ele está concluído e pronto para uso.
/instance/software_attachments/{id} lifecycle_reasons Uma lista de motivos para o atual ciclo de vida.
/instance/software_attachments/{id} resource_type O tipo de recurso. Configure para instance_software_attachment.
/instance/software_attachments/{id} created_at A data e a hora em que este anexo de software foi criado.
/instance/volume_attachments/{id} bandwidth A largura de banda máxima, em megabits por segundo, para o volume quando ele estiver conectado a esta instância. Esse valor pode ser menor do que a largura de banda do volume, dependendo da configuração da instância.
/instance/volume_attachments/{id} created_at A data e a hora em que o volume foi anexado.
/instance/volume_attachments/{id} delete_volume_on_instance_delete Se estiver configurado como “ true ”, ao excluir a instância, o volume também será excluído.
/instance/volume_attachments/{id} device Informações sobre como o volume é exposto ao sistema operacional da instância.
/instance/volume_attachments/{id} id O identificador exclusivo para o anexo de volume.
/instance/volume_attachments/{id} name O nome definido pelo usuário para o anexo de volume.
/instance/volume_attachments/{id} status O status do anexo de volume: anexado, anexando, excluindo ou desanexando.
/instance/volume_attachments/{id} type O tipo de anexo de volume, inicialização ou dados.
/instance/volume_attachments/{id} volume O volume conectado, que contém o valor CRN, ID, nome e deleted , quando o volume é excluído.

Resumo de metadados para chaves SSH

Use as informações na Tabela 2 para entender o tipo de metadados retornados para chaves SSH.

Metadados para chaves SSH
Caminho de URI da chave SSH Chave de metadados Descrição dos metadados
/keys keys Uma coleção de chaves. Consulte keys/{id} para obter detalhes.
/keys/{id} created_at A data e a hora em que a chave foi criada.
/keys/{id} crn O nome do recurso na nuvem para a chave.
/keys/{id} fingerprint A impressão digital da chave. O valor é retornado com codificação base64 e prefixado com o algoritmo hash (sempre SHA256).
/keys/{id} id O identificador exclusivo para a chave.
/keys/{id} length O comprimento da chave, em bits.
/keys/{id} name O nome exclusivo definido pelo usuário para a chave. Se não for especificado, o nome é uma lista de palavras selecionadas aleatoriamente, separadas por hífens (por exemplo, elderly-mountain-troop-opponent.)
/keys/{id} public_key A chave SSH pública.
/keys/{id} type O sistema de criptografia utilizado pela chave.

Resumo de metadados para grupos de posicionamento

Use as informações na Tabela 3 para entender o tipo de metadados retornados para grupos de posicionamento.

Metadados para grupos de colocação
Caminho de URI do grupo de posicionamento Chave de metadados Descrição dos metadados
/placement_groups placement_groups Uma coleção de grupos de posicionamento. Consulte placement_groups/{id} para obter detalhes.
/placement_groups/{id} created_at A data e a hora em que o grupo de posicionamento foi criado.
/placement_groups/{id} crn O nome do recurso na nuvem para o grupo de alocação.
/placement_groups/{id} id O identificador exclusivo do grupo de colocação.
/placement_groups/{id} lifecycle_state O estado do ciclo de vida do grupo de posicionamento.
/placement_groups/{id} name O nome definido pelo usuário para o grupo de posicionamento.
/placement_groups/{id} resource_type O tipo de recurso.
/placement_groups/{id} strategy A estratégia para o grupo de colocação.

Resumo dos metadados dos anexos de software

Use as informações da tabela a seguir para entender o tipo de metadados retornados para anexos de software.

O endpoint /metadata/v1/instance/software_attachments retorna uma matriz com zero ou mais objetos de anexo de software. Cada objeto representa uma instância de software registrada no controlador de recursos, correspondente a um plano de software.

Metadados para anexos de software
Caminho do URI dos anexos de software Chave de metadados Descrição dos metadados
/instance/software_attachments/{id} id Um UUID exclusivo para o anexo de software.
/instance/software_attachments/{id} name Um nome exclusivo dentro do conjunto de anexos de software associados à instância do servidor virtual. Esse nome é definido como um valor aleatório gerado pelo sistema e pode ser atualizado posteriormente pelo proprietário, se desejar. Observe que a atualização do nome no anexo de software da instância do servidor virtual não afeta o nome do volume de inicialização anexado nem de quaisquer instantâneos já criados a partir desse volume.
/instance/software_attachments/{id} href URL para este complemento de software.
/instance/software_attachments/{id} catalog_offering Um objeto cujo valor é o mesmo que o do objeto da instância com o mesmo nome, contendo o CRN da versão da oferta do catálogo e o CRN do plano de software associado que representa o software.
/instance/software_attachments/{id} offering_instance Um objeto que representa a instância da oferta de software instanciada a partir do plano de software.
/instance/software_attachments/{id} offering_instance.crn A instância de oferta de software CRN.
/instance/software_attachments/{id} entitlement (opcional) Um objeto que representa o direito de licença para a instância da oferta de software. Se estiver ausente, não há nenhuma licença associada ao plano de software.
/instance/software_attachments/{id} entitlement.licensed_software Uma matriz composta por zero ou mais objetos, cada um representando um programa de software ou recurso instalado e licenciado na instância do servidor virtual.
/instance/software_attachments/{id} entitlement.licensed_software[].sku O SKU (Unidade de Manutenção de Estoque) de um programa de software sujeito a licença ou de um recurso associado ao plano de software e em execução na instância do servidor virtual. Isso é importante para o fornecedor do software.
/instance/software_attachments/{id} entitlement.licensed_software[].key (opcional) A chave de licença para o direito de uso do software. Se não estiver presente, significa que a licença ainda não foi obtida.
/instance/software_attachments/{id} lifecycle_state O estado do ciclo de vida do anexo de software. Se o status for “estável”, significa que a instância do software foi criada com sucesso.
/instance/software_attachments/{id} lifecycle_reasons[] As razões para o lifecycle_state atual.
/instance/software_attachments/{id} resource_type O tipo de recurso, definido como “ instance_software_attachment ”.
/instance/software_attachments/{id} created_at A data e a hora em que este anexo de software foi criado.

Próximas etapas

Recuperar dados usando o serviço de metadados.