tencent cloud

Cloud Virtual Machine

Dinâmicas e anúncios
Dinâmica do produto
Dinâmica de atualização de imagem pública
Anúncio do produto
Introdução do produto
Visão geral da Cloud Virtual Machine
Vantagens do produto
Conceitos básicos
Regiões e zonas
Tutorial
Service Regions and Service Providers
Cobrança do produto
Visão geral de cobrança
Modo de cobrança
Item de cobrança
Converter modo de cobrança
Aquisição de instâncias
Descrição de cobrança de ajustes de configuração
Descrição de cobrança em atraso
Guia de início rápido
Comprar instância Linux personalizada
Comprar instância Windows personalizada
Guia do usuário
Visão geral do guia de operação
Visão geral dos limites de uso
Instância
Instância spot
Instância reservada
Imagem
Armazenamento
Backup e recuperação
Rede
Segurança
Senhas/chaves secretas
Gerenciamento de operação e manutenção
Migrar o servidor
Migração online
Consultoria de migração
Solução de falhas
Falhas relacionados ao login em instâncias Windows
Falhas relacionados ao login em instâncias Linux
Outras falhas relacionadas ao login em instâncias
Falha na execução de instância
Falha de memória em instâncias Linux
Falha de rede
Tutorial prático
Recomendações de seleção da CVM
Configurar o ambiente
Configurar o site
Configurar o aplicativo
Configurar a página visual
Carregar arquivos locais para a CVM
Teste de desempenho de rede
Outros tutoriais práticos
Segurança e conformidade
Gerenciamento de acesso
Rede
Perguntas frequentes
Regiões e zonas
Sobre o faturamento
Instância
Armazenamento
Imagem
Migração de servidor
Rede
Segurança
Operação/manutenção e monitoramento
Gerenciamento de acesso
Serviço NTP
Cenário de aplicação
Agreements
CVM Service Level Agreements
Red Hat Enterprise Linux Image Service Agreement
Public IP Service Level Agreement
Glossário

Visualizar metadados de instância

PDF
Modo Foco
Tamanho da Fonte
Última atualização: 2024-01-23 17:33:45
Os metadados da instância referem-se aos dados relevantes para uma instância. Eles podem ser usados para configurar ou gerenciar uma instância em execução.
Nota:
Embora os metadados da instância só possam ser acessados após o login, os dados não foram criptografados. Qualquer pessoa que acessar a instância pode visualizar seus metadados. Portanto, você deve tomar as medidas adequadas para proteger os dados confidenciais.

Visão geral

O Tencent Cloud fornece os seguintes metadados:
Nome
Descrição
Versão
instance-id
ID da instância
1,0
instance-name
Nome da instância
1,0
uuid
ID exclusiva da instância
1,0
local-ipv4
Endereço IP privado da instância
1,0
public-ipv4
Endereço IP público da instância
1,0
mac
Endereço MAC do dispositivo eth0 da instância
1,0
placement/region
Região da instância
2017-09-19
placement/zone
Zona de disponibilidade da instância
2017-09-19
network/interfaces/macs/${mac}/mac
Endereço MAC da interface de rede da instância
1,0
network/interfaces/macs/${mac}/primary-local-ipv4
IP privado principal da interface de rede da instância
1,0
network/interfaces/macs/${mac}/public-ipv4s
Endereço IP público da interface de rede da instância
1,0
network/interfaces/macs/${mac}/vpc-id
ID do VPC da interface de rede da instância
2017-09-19
network/interfaces/macs/${mac}/subnet-id
ID da sub-rede da interface de rede da instância
2017-09-19
network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/gateway
Endereço de gateway da interface de rede da instância
1,0
network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/local-ipv4
Endereço IP privado da interface de rede da instância
1,0
network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/public-ipv4
Endereço IP público da interface de rede da instância
1,0
network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/public-ipv4-mode
Modo da rede pública da interface de rede da instância
1,0
network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/subnet-mask
Máscara da sub-rede da interface de rede da instância
1,0
payment/charge-type
Plano de faturamento da instância
2017-09-19
payment/create-time
Hora de criação da instância
2017-09-19
payment/termination-time
Hora de encerramento da instância
2017-09-19
app-id
AppID do proprietário da instância
2017-09-19
as-group-id
ID do grupo do Auto Scaling da instância
2017-09-19
spot/termination-time
Horário de encerramento da instância spot
2017-09-19
/meta-data/instance/instance-type
Tipo de instância
2017-09-19
/instance/image-id
ID da imagem da instância
2017-09-19
/instance/security-group
Informações do grupo de segurança vinculado à instância
2017-09-19
/instance/bandwidth-limit-egress
Limite de largura de banda de saída da rede privada da instância, em Kbit/s
29/09/2019
/instance/bandwidth-limit-ingress
Limite de largura de banda de entrada da rede privada da instância, em Kbit/s
29/09/2019
/cam/security-credentials/${role-name}
Credencial temporária gerada pela política de funções do CAM, que pode ser obtida apenas quando a instância está associada à função do CAM. Mude `${role-name}` para o nome real da função do CAM; caso contrário, `404` será retornado
11/12/2019
Nota:
Os campos ${mac} e ${local-ipv4} na tabela acima indicam o endereço MAC e o endereço IP privado da interface de rede especificada para a instância, respectivamente.
O endereço URL de destino da solicitação diferencia maiúsculas de minúsculas. Você deve criar o endereço URL de destino de uma nova solicitação de acordo com o resultado retornado da solicitação.
Os dados retornados de placement são alterados na nova versão. Para usar os dados na versão anterior, especifique o caminho dela ou deixe o caminho da versão vazio para acessar os dados da versão 1.0. Para obter mais informações sobre os dados retornados de placement, consulte as Regiões e zonas de disponibilidade.

Consulta de metadados da instância

Depois de fazer login em uma instância, você pode acessar os metadados, como seu endereço IP local e endereço IP público para gerenciar conexões com aplicativos externos. Para visualizar todos os metadados da instância em uma instância em execução, use o seguinte URI:
http://metadata.tencentyun.com/latest/meta-data/
Você pode acessar os metadados usando a ferramenta cURL ou uma solicitação HTTP GET, por exemplo:
curl http://metadata.tencentyun.com/latest/meta-data/
Para recursos que não existem, o código de erro HTTP "404 - Not Found (404 - Não encontrado)" será retornado.
Para operar nos metadados da instância, primeiro faça login na instância. Para obter mais informações, consulte Login em uma instância do Windows usando o RDP (recomendado) e Login em uma instância do Linux usando o método de login padrão.

Exemplo de consulta de metadados

O exemplo a seguir mostra como obter a versão dos metadados.
Atenção:
Quando o Tencent Cloud modifica o caminho de acesso aos metadados ou os dados retornados, uma nova versão dos metadados é lançada. Se seu aplicativo ou script depender da estrutura ou dos dados retornados da versão anterior, você poderá acessar os metadados usando a versão anterior especificada. Se nenhuma versão for especificada, a versão 1.0 será acessada por padrão.
[qcloud-user]# curl http://metadata.tencentyun.com/
1,0
2017-09-19
latest
meta-data
O exemplo a seguir mostra como visualizar o diretório raiz de metadados. As linhas que terminam com / representam os diretórios e as outras linhas representam os dados acessados. Para obter a descrição dos dados acessados, consulte a seção Visão geral descrita acima.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/
instance-id
instance-name
local-ipv4
mac
network/
placement/
public-ipv4
uuid
O exemplo a seguir mostra como obter as informações de localização física de uma instância. Para saber a relação entre os dados retornados e a localização física, consulte as Regiões e zonas de disponibilidade.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/placement/region
ap-guangzhou

[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/placement/zone
ap-guangzhou-3
O exemplo a seguir mostra como obter o endereço IP privado de uma instância. Se uma instância tiver vários ENIs, o endereço de rede do dispositivo eth0 será retornado.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/local-ipv4
10.104.13.59
O exemplo a seguir mostra como obter o endereço IP público de uma instância.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/public-ipv4
139.199.11.29
O exemplo a seguir mostra como obter o ID de uma instância. O ID da instância é usado para identificar exclusivamente uma instância.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/instance-id
ins-3g445roi
O exemplo a seguir mostra como consultar o UUID da instância. O UUID da instância também pode ser usado como o identificador exclusivo de uma instância, mas recomendamos que você use o ID da instância para identificá-las.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/uuid
cfac763a-7094-446b-a8a9-b995e638471a
O exemplo a seguir mostra como obter o endereço MAC do dispositivo eth0 de uma instância.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/mac
52:54:00:BF:B3:51
O exemplo a seguir mostra como obter as informações do ENI de uma instância. No caso de vários ENIs, várias linhas de dados são retornadas, com cada linha indicando o diretório de dados de um ENI.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/
52:54:00:BF:B3:51/
O exemplo a seguir mostra como obter as informações de um ENI especificado.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/
local-ipv4s/
mac
vpc-id
subnet-id
owner-id
primary-local-ipv4
public-ipv4s
local-ipv4s/
O exemplo a seguir mostra como obter as informações do VPC de um ENI especificado.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/vpc-id
vpc-ja82n9op

[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/subnet-id
subnet-ja82n9op
O exemplo a seguir mostra como obter a lista de endereços IP privados vinculados ao ENI especificado. Se o ENI estiver vinculado a vários endereços IP privados, várias linhas de dados serão retornadas.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/
10.104.13.59/
O exemplo a seguir mostra como obter as informações de um endereço IP privado.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59
gateway
local-ipv4
public-ipv4
public-ipv4-mode
subnet-mask
O exemplo a seguir mostra como obter o gateway de um endereço IP privado. Esses dados estão disponíveis apenas para os modelos do CVM baseados no VPC. Para obter mais informações, consulte Virtual Private Cloud (VPC).
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59/gateway
10.15.1.1
O exemplo a seguir mostra como obter o modo de acesso usado por um endereço IP privado para acessar a rede pública. Esses dados podem ser consultados apenas para os CVMs baseados no VPC. Um CVM baseado na rede clássica acessa a rede pública por meio do gateway público.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59/public-ipv4-mode
NAT
O exemplo a seguir mostra como obter o endereço IP público vinculado a um endereço IP privado.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59/public-ipv4
139.199.11.29
O exemplo a seguir mostra como obter a máscara da sub-rede de um endereço IP privado.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59/subnet-mask
255.255.192.0
O exemplo a seguir mostra como obter o tipo de faturamento de uma instância.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/payment/charge-type
POSTPAID_BY_HOUR
O exemplo a seguir mostra como obter a hora de criação de uma instância.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/payment/create-time
18/09/2018 11:27:33
O exemplo a seguir mostra como obter a hora de encerramento para instâncias spot.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/spot/termination-time
18/08/2018 12:05:33
O exemplo a seguir mostra como obter o AppID da conta à qual o CVM pertence.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/app-id
123456789
O exemplo a seguir mostra como obter a credencial temporária gerada pela função do CAM à qual a instância pertence. Neste exemplo, o nome da função é CVMas.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/cam/security-credentials/CVMas
{
"TmpSecretId": "************************************",
"TmpSecretKey": "********************************",
"ExpiredTime": 1615590047,
"Expiration": "2021-03-12T23:00:47Z",
"Token": "******",
"Code": "Success"
}

Consulta dos dados do usuário da instância

Você pode especificar os dados do usuário da instância ao criar uma instância. As instâncias do CVM com o cloud-init configurado podem acessar os dados.

Pesquisa de dados do usuário

Após o login, você pode acessar os dados do usuário usando o método a seguir.
[qcloud-user]# curl http://metadata.tencentyun.com/latest/user-data
179, client, shanghai


Ajuda e Suporte

Esta página foi útil?

comentários