Todos os produtos
Search
Central de documentação

Elastic Compute Service:DescribeInstanceAttribute

Última atualização: Oct 16, 2026

Consulta os atributos 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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

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: A instância está sendo criada.

  • Running: A instância está em execução.

  • Starting: A instância está sendo iniciada.

  • Stopping: A instância está sendo parada.

  • Stopped: A instância está 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 é exibida em UTC e segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. 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

O nome da instância.

testInstanceName

InstanceNetworkType

string

O tipo de rede da instância. Valores válidos:

  • vpc: 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 da instância. 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

[Deprecated] Este parâmetro está prestes a ser descontinuado. Para garantir a compatibilidade, use outros parâmetros em seu lugar.

cls-bp67acfmxazb4p****

VlanId

string

O ID da VLAN da instância.

Nota

[Deprecated] Este parâmetro está prestes a ser descontinuado. Para garantir a compatibilidade, use outros parâmetros em seu lugar.

10

StoppedMode

string

Especifica 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 e os recursos de inventário são reservados.

  • StopCharging: A instância não é cobrada após ser parada. Após a instância ser parada, recursos como vCPUs, memória e endereços IP públicos são liberados. A possibilidade de reiniciar a instância depende do inventário de recursos na região atual.

  • Not-applicable: A instância não suporta o modo econômico.

KeepCharging

HostName

string

O nome do host da instância.

testHostName

InstanceId

string

O ID da instância.

i-uf6f5trc95ug8t33****

InstanceType

string

O tipo de 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: pay-as-you-go.

PrePaid

IoOptimized

string

Especifica se a instância é otimizada para I/O. Valores válidos:

  • optimized: A instância é otimizada para I/O.

  • none: A instância 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 é exibida em UTC e segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. Para mais informações, consulte ISO 8601.

2017-12-10T04:04Z

ZoneId

string

A 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, os valores de pico de largura de banda de entrada e saída são os valores máximos de largura de banda e não são garantidos. Quando ocorre contenção de recursos, a largura de banda de pico pode ser limitada. Se o seu negócio requer 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 Modos de desempenho.

  • Unlimited: modo ilimitado. Para mais informações sobre o desempenho da instância, consulte Modos de desempenho.

Standard

SecurityGroupIds

object

SecurityGroupId

array

Os IDs dos grupos de segurança aos quais a instância pertence.

string

O ID de um grupo de segurança ao qual a instância pertence.

sg-bp1fg655nh68xyz9i****

PublicIpAddress

object

IpAddress

array

Os endereços IP públicos da instância.

string

Um endereço IP público da instância.

121.40.**.**

InnerIpAddress

object

IpAddress

array

Os endereços IP internos das instâncias na rede clássica.

Nota

O recurso de rede clássica foi descontinuado. Para mais informações, consulte Aviso de descontinuação.

string

O endereço IP interno de uma instância na 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 conectividade de rede entre serviços em nuvem na VPC.

172.17.**.**

VSwitchId

string

O ID do vSwitch.

vsw-uf6ixacqz8osrwnqb****

PrivateIpAddress

object

IpAddress

array

Os endereços IP privados.

string

Um endereço IP privado.

192.168.**.**

EipAddress

object

As informações de vinculação do elastic IP (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, os valores de pico de largura de banda de entrada e saída são os valores máximos de largura de banda e não são garantidos. Quando ocorre contenção de recursos, a largura de banda de pico pode ser limitada. Se o seu negócio requer 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 incluem o ID do cluster de host dedicado (DedicatedHostClusterId), o ID do host dedicado (DedicatedHostId) e o 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>

Os motivos de bloqueio.

object

Um motivo de bloqueio.

LockReason

string

O motivo do bloqueio. Valores válidos:

  • financial: A instância está bloqueada devido a pagamentos em atraso.

  • security: A instância está bloqueada por motivos de segurança.

  • Recycling: A instância spot está bloqueada e com liberação pendente.

  • dedicatedhostfinancial: A instância ECS está bloqueada devido a pagamentos em atraso do host dedicado.

  • refunded: A instância está bloqueada devido a um reembolso.

financial

EnableJumboFrame

boolean

Especifica se o recurso de jumbo frame está ativado para a instância ECS. Valores válidos:

  • true: O recurso está ativado.

  • false: O recurso está desativado.

Para mais informações, consulte MTU da instância ECS.

false

EnableNetworkEncryption

boolean

Especifica se a criptografia de tráfego de rede da VPC está ativada para a instância. Valores válidos:

  • true: Ativada.

  • false: Desativada.

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

Especifica se o recurso de jumbo frame está ativado para a instância. Valores válidos:

  • true: O recurso está ativado.

  • false: O recurso está desativado.

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

Especifica se a criptografia de tráfego de rede da VPC está ativada para a instância. Valores válidos:

  • true: Ativada.

  • false: Desativada.

Nota

Este parâmetro está em preview por convite e não está disponível publicamente.

False

BandwidthWeighting

string

O peso da largura de banda.

Os valores suportados variam de acordo com o tipo de instância. Você pode chamar a operação DescribeInstanceTypes para consultar os valores de peso 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 :

    Default.

Vpc-L1

SecurityOptions

object

EnableSecureBoot

boolean

Especifica se a Inicialização Segura UEFI está ativada.

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"
  },
  "SecurityOptions": {
    "EnableSecureBoot": false
  }
}

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. A instância especificada não existe. Verifique se o ID da instância está correto.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.