DescribeInstanceAttribute - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Consulta as informações de atributo de uma instância ECS especificada.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:DescribeInstanceAttribute

get

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância.	i-uf6f5trc95ug8t33****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Status	string	O status da instância. Valores válidos: Pending: sendo criada. Running: em execução. Starting: sendo iniciada. Stopping: sendo parada. Stopped: parada.	Running
SerialNumber	string	O número de série da instância.	51d1353b-22bf-4567-a176-8b3e12e4****
CreationTime	string	A hora em que a instância foi criada. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. A hora é exibida em UTC. Para mais informações, consulte ISO 8601.	2017-12-10T04:04Z
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
Description	string	A descrição da instância.	testDescription
InstanceName	string	Nome da instância.	testInstanceName
InstanceNetworkType	string	O tipo de rede da instância. Valores válidos: vpc: virtual private cloud (VPC). classic: rede clássica. A rede clássica foi descontinuada. Para mais informações, consulte Aviso de descontinuação.	vpc
Memory	integer	O tamanho da memória. Unidade: MiB.	16384
ImageId	string	O ID da imagem que a instância está executando.	m-bp1h46wfpjsjastc****
ClusterId	string	O ID do cluster ao qual a instância pertence. Nota Este parâmetro será descontinuado em breve. Para garantir a compatibilidade futura, use outros parâmetros.	cls-bp67acfmxazb4p****
VlanId	string	O ID da VLAN da instância. Nota Este parâmetro será descontinuado em breve. Para garantir a compatibilidade futura, use outros parâmetros.	10
StoppedMode	string	Indica se a instância continua a ser cobrada após ser parada. Valores válidos: KeepCharging: A instância continua a ser cobrada após ser parada. Os recursos de inventário são reservados para a instância. StopCharging: A instância não é cobrada após ser parada. Depois que a instância é parada, seus recursos, como vCPUs, memória e endereços IP públicos, são liberados. A possibilidade de reiniciar a instância depende da disponibilidade de recursos na região atual. Not-applicable: A instância não oferece suporte ao recurso Sem cobranças para instâncias paradas.	KeepCharging
HostName	string	O nome do host da instância.	testHostName
InstanceId	string	O ID da instância.	i-uf6f5trc95ug8t33****
InstanceType	string	O tipo da instância.	ecs.g5.large
InternetMaxBandwidthIn	integer	A largura de banda pública de entrada máxima. Unidade: Mbit/s.	50
InternetMaxBandwidthOut	integer	A largura de banda pública de saída máxima. Unidade: Mbit/s.	5
RegionId	string	O ID da região da instância.	cn-hangzhou
InstanceChargeType	string	O método de cobrança da instância. Valores válidos: PrePaid: assinatura. PostPaid: pago conforme o uso.	PrePaid
IoOptimized	string	Indica se a instância é otimizada para I/O. Valores válidos: optimized: otimizada para I/O. none: não otimizada para I/O.	optimized
Cpu	integer	O número de núcleos de vCPU.	8
ExpiredTime	string	A hora de expiração. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. A hora é exibida em UTC. Para mais informações, consulte ISO 8601.	2017-12-10T04:04Z
ZoneId	string	O ID da zona da instância.	cn-hangzhou-g
InternetChargeType	string	O método de cobrança para largura de banda pública. Valores válidos: PayByBandwidth: cobrança por largura de banda. PayByTraffic: cobrança por tráfego. Nota No modo cobrança por tráfego, as larguras de banda de pico de entrada e saída são usadas como limites superiores para larguras de banda e não são garantidas. Quando ocorre contenção de recursos, as larguras de banda de pico podem ser limitadas. Se suas cargas de trabalho exigirem largura de banda garantida, use o modo cobrança por largura de banda.	PayByTraffic
CreditSpecification	string	O modo de execução da instância burstable. Valores válidos: Standard: modo padrão. Para mais informações sobre o desempenho da instância, consulte Modo de desempenho. Unlimited: modo ilimitado. Para mais informações sobre o desempenho da instância, consulte Modo de desempenho.	Standard
SecurityGroupIds	object
SecurityGroupId	array	Os grupos de segurança aos quais a instância pertence.
	string	O grupo de segurança ao qual a instância pertence.	sg-bp1fg655nh68xyz9i****
PublicIpAddress	object
IpAddress	array	A lista de endereços IP públicos da instância.
	string	O endereço IP público da instância.	121.40..
InnerIpAddress	object
IpAddress	array	A lista de endereços IP de rede interna de instâncias do tipo de rede clássica. Nota A rede clássica foi descontinuada. Para mais informações, consulte Aviso de descontinuação.
	string	O endereço IP de rede interna da instância do tipo de rede clássica.	192.168..
VpcAttributes	object	Os atributos da VPC.
VpcId	string	O ID da VPC.	vpc-wz9e4e9pmbcnj6ki6****
NatIpAddress	string	O endereço IP do serviço em nuvem, que é usado para comunicação de rede entre serviços em nuvem conectados à VPC.	172.17..
VSwitchId	string	O ID do vSwitch.	vsw-uf6ixacqz8osrwnqb****
PrivateIpAddress	object
IpAddress	array	O endereço IP privado da instância.
	string	O endereço IP privado da instância.	192.168..
EipAddress	object	As informações de vinculação do Elastic IP Address (EIP).
InternetChargeType	string	O método de cobrança para largura de banda pública. Valores válidos: PayByBandwidth: cobrança por largura de banda. PayByTraffic: cobrança por tráfego. Nota No modo cobrança por tráfego, as larguras de banda de pico de entrada e saída são usadas como limites superiores para larguras de banda e não são garantidas. Quando ocorre contenção de recursos, as larguras de banda de pico podem ser limitadas. Se suas cargas de trabalho exigirem largura de banda garantida, use o modo cobrança por largura de banda.	PayByTraffic
IpAddress	string	O EIP.	30.21..
Bandwidth	integer	O limite de largura de banda pública do EIP. Unidade: Mbit/s.	8
AllocationId	string	O ID do EIP.	eip-wz9uilio26dfscamm****
DedicatedHostAttribute	object	Os atributos do host dedicado, que consistem no ID do cluster de hosts dedicados (DedicatedHostClusterId), no ID do host dedicado (DedicatedHostId) e no nome do host dedicado (DedicatedHostName).
DedicatedHostName	string	O nome do host dedicado.	ecs-autoui-create-ddh-temp
DedicatedHostId	string	O ID do host dedicado.	dh-2ze7qrzz6lvbfhr0****
OperationLocks	object
LockReason	array<object>	A lista de motivos de bloqueio.
	object	O motivo do bloqueio.
LockReason	string	O motivo pelo qual a instância foi bloqueada. Valores válidos: financial: A instância foi bloqueada devido a pagamentos em atraso. security: A instância foi bloqueada por motivos de segurança. recycling: A instância spot foi bloqueada e está pendente de liberação. dedicatedhostfinancial: A instância foi bloqueada devido a pagamentos em atraso do host dedicado. refunded: A instância foi bloqueada porque um reembolso foi feito para a instância.	financial
EnableJumboFrame	boolean	Indica se o recurso Jumbo Frame está ativado para a instância ECS. Valores válidos: true: ativado. false: não ativado. Para mais informações, consulte MTU da instância ECS.	false
EnableNetworkEncryption	boolean	Indica se a criptografia de tráfego de rede da VPC está ativada para a instância. Valores válidos: true: ativada. false: não ativada. Nota Este parâmetro está em preview por convite e não está disponível publicamente.	True
NetworkOptions	object	Os atributos relacionados à rede. Nota Este parâmetro está em preview por convite e não está disponível publicamente.
EnableJumboFrame	boolean	Indica se o recurso Jumbo Frame está ativado para a instância. Valores válidos: true: ativado. false: não ativado. Para mais informações, consulte MTU da instância ECS. Nota Este parâmetro está em preview por convite e não está disponível publicamente.	false
EnableNetworkEncryption	boolean	Indica se a criptografia de tráfego de rede da VPC está ativada para a instância. Valores válidos: true: ativada. false: não ativada. Nota Este parâmetro está em preview por convite e não está disponível publicamente.	False
BandwidthWeighting	string	A ponderação de largura de banda. Diferentes tipos de instância suportam diferentes valores. Chame DescribeInstanceTypes para consultar os valores de ponderação de largura de banda suportados pelo tipo de instância atual. Valores válidos: Vpc-L1 : Vpc-L1 Vpc-L2 : Vpc-L2 Ebs-L1 : Ebs-L1 Ebs-L2 : Ebs-L2 Default : Padrão.	Vpc-L1

Exemplos

Resposta de sucesso

JSON formato

{
  "Status": "Running",
  "SerialNumber": "51d1353b-22bf-4567-a176-8b3e12e4****",
  "CreationTime": "2017-12-10T04:04Z",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Description": "testDescription",
  "InstanceName": "testInstanceName",
  "InstanceNetworkType": "vpc",
  "Memory": 16384,
  "ImageId": "m-bp1h46wfpjsjastc****",
  "ClusterId": "cls-bp67acfmxazb4p****",
  "VlanId": "10",
  "StoppedMode": "KeepCharging",
  "HostName": "testHostName",
  "InstanceId": "i-uf6f5trc95ug8t33****",
  "InstanceType": "ecs.g5.large",
  "InternetMaxBandwidthIn": 50,
  "InternetMaxBandwidthOut": 5,
  "RegionId": "cn-hangzhou",
  "InstanceChargeType": "PrePaid",
  "IoOptimized": "optimized",
  "Cpu": 8,
  "ExpiredTime": "2017-12-10T04:04Z",
  "ZoneId": "cn-hangzhou-g",
  "InternetChargeType": "PayByTraffic",
  "CreditSpecification": "Standard",
  "SecurityGroupIds": {
    "SecurityGroupId": [
      "sg-bp1fg655nh68xyz9i****"
    ]
  },
  "PublicIpAddress": {
    "IpAddress": [
      "121.40.**.**"
    ]
  },
  "InnerIpAddress": {
    "IpAddress": [
      "192.168.**.**"
    ]
  },
  "VpcAttributes": {
    "VpcId": "vpc-wz9e4e9pmbcnj6ki6****",
    "NatIpAddress": "172.17.**.**",
    "VSwitchId": "vsw-uf6ixacqz8osrwnqb****",
    "PrivateIpAddress": {
      "IpAddress": [
        "192.168.**.**"
      ]
    }
  },
  "EipAddress": {
    "InternetChargeType": "PayByTraffic",
    "IpAddress": "30.21.**.**",
    "Bandwidth": 8,
    "AllocationId": "eip-wz9uilio26dfscamm****"
  },
  "DedicatedHostAttribute": {
    "DedicatedHostName": "ecs-autoui-create-ddh-temp",
    "DedicatedHostId": "dh-2ze7qrzz6lvbfhr0****"
  },
  "OperationLocks": {
    "LockReason": [
      {
        "LockReason": "financial"
      }
    ]
  },
  "EnableJumboFrame": false,
  "EnableNetworkEncryption": true,
  "NetworkOptions": {
    "EnableJumboFrame": false,
    "EnableNetworkEncryption": true,
    "BandwidthWeighting": "Vpc-L1"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
500	InternalError	The request processing has failed due to some unknown error.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	O ID da instância especificado é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.