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

Consulta uma lista de instâncias com base nas condições de solicitação especificadas e obtém as informações detalhadas associadas das instâncias.

Descrição da operação

Antes de começar

Ao invocar uma operação de API usando o Cloud Assistant CLI, certifique-se de que os valores dos parâmetros de solicitação de diferentes tipos de dados estejam em conformidade com os requisitos de formato. Para mais informações, consulte Visão geral do formato de parâmetros da CLI.

Notas de uso

Envie uma solicitação de dry run usando o parâmetro de solicitação DryRun para verificar a validade dos parâmetros e da autorização.
Ao realizar uma consulta paginada para a primeira página de resultados, defina apenas MaxResults para limitar o número de entradas a serem retornadas. O valor NextToken na resposta é usado como credencial para consultar as páginas subsequentes. Ao realizar uma consulta paginada para as páginas subsequentes, defina NextToken com o valor NextToken obtido na resposta anterior e defina MaxResults para limitar o número de entradas a serem retornadas.

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:DescribeInstances

list

Instância.

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

Instância.

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

ResourceOwner

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da instância. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
VpcId	string	Não	O ID da nuvem privada virtual (VPC).	v-bp67acfmxazb4p****
VSwitchId	string	Não	O ID do vSwitch.	vsw-bp67acfmxazb4p****
ZoneId	string	Não	O ID da zona.	cn-hangzhou-g
InstanceNetworkType	string	Não	O tipo de rede da instância. Valores válidos: vpc: VPC. classic: rede clássica. A rede clássica não está mais disponível. Para mais informações, consulte Aviso de descontinuação.	vpc
SecurityGroupId	string	Não	O ID do grupo de segurança ao qual a instância pertence.	sg-bp67acfmxazb4p****
InstanceIds	string	Não	Os IDs das instâncias. O valor é uma matriz JSON que consiste em até 100 IDs de instâncias. Separe os IDs das instâncias com vírgulas (,).	["i-bp67acfmxazb4p**", "i-bp67acfmxazb4p", … "i-bp67acfmxazb4p**"]
PageNumber	integer	Não	Nota Este parâmetro está prestes a ser descontinuado. Use NextToken e MaxResults para concluir operações de consulta paginada.	1
PageSize	integer	Não	Nota Este parâmetro está prestes a ser descontinuado. Use NextToken e MaxResults para concluir operações de consulta paginada.	10
NextToken	string	Não	O token de consulta. Defina o valor como o valor NextToken retornado na chamada de API anterior.	caeba0bbb2be03f84eb48b699f0a4883
MaxResults	integer	Não	O número máximo de entradas por página para uma consulta paginada. Valor máximo: 100. Valor padrão: Se você não definir este parâmetro ou defini-lo com um valor menor que 10, o valor padrão será 10. Se você definir este parâmetro com um valor maior que 100, o valor padrão será 100.	10
InnerIpAddresses	string	Não	Os endereços IP de rede interna das instâncias com o tipo de rede clássica. Este parâmetro entra em vigor quando InstanceNetworkType é definido como classic. O valor é uma matriz JSON que consiste em até 100 endereços IP. Separe os endereços IP com vírgulas (,). Nota O recurso de rede clássica foi descontinuado. Para obter detalhes, consulte Aviso de descontinuação.	["10.1.1.1", "10.1.2.1", … "10.1.10.1"]
PrivateIpAddresses	string	Não	Os endereços IP privados das instâncias com o tipo de rede VPC. Este parâmetro entra em vigor quando InstanceNetworkType é definido como vpc. O valor é uma matriz JSON que consiste em até 100 endereços IP. Separe os endereços IP com vírgulas (,).	["172.16.1.1", "172.16.2.1", … "172.16.10.1"]
PublicIpAddresses	string	Não	Os endereços IP públicos das instâncias. O valor é uma matriz JSON que consiste em até 100 endereços IP. Separe os endereços IP com vírgulas (,).	["42.1.1.", "42.1.2.", … "42.1.10.**"]
EipAddresses	string	Não	Os endereços IP elásticos (EIPs) das instâncias. Este parâmetro entra em vigor quando InstanceNetworkType é definido como vpc. O valor é uma matriz JSON que consiste em até 100 endereços IP. Separe os endereços IP com vírgulas (,).	["42.1.1.", "42.1.2.", … "42.1.10.**"]
InstanceChargeType	string	Não	O método de cobrança da instância. Valores válidos: PostPaid: pós-pago. PrePaid: assinatura.	PostPaid
InternetChargeType	string	Não	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 de largura de banda e não são garantidas. Quando ocorre contenção de recursos, as larguras de banda de pico podem ser limitadas. Se você precisar de largura de banda garantida para suas cargas de trabalho, use o modo cobrança por largura de banda.	PayByTraffic
InstanceName	string	Não	O nome da instância. Há suporte para pesquisa difusa com o curinga asterisco (*).	Teste
ImageId	string	Não	O ID da imagem.	m-bp67acfmxazb4p****
Status	string	Não	O status da instância. Valores válidos: Pending: sendo criada. Running: em execução. Starting: sendo iniciada. Stopping: sendo parada. Stopped: parada.	Running
LockReason	string	Não	O motivo pelo qual o recurso está bloqueado. Valores válidos: financial: O recurso está bloqueado devido a pagamento em atraso. security: O recurso está bloqueado por motivos de segurança. Recycling: A instância spot está bloqueada e aguardando liberação. dedicatedhostfinancial: A instância ECS está bloqueada porque o host dedicado tem um pagamento em atraso. refunded: O recurso está bloqueado porque um reembolso foi feito.	security
Filter.1.Key	string	Não	A chave do filtro 1 usada para consultar recursos. Defina o valor como CreationStartTime. Você pode especificar Filter.1.Key e Filter.1.Value para consultar recursos que foram criados após o ponto no tempo especificado.	CreationStartTime
Filter.2.Key	string	Não	A chave do filtro 2 usada para consultar recursos. Defina o valor como CreationEndTime. Você pode especificar Filter.2.Key e Filter.2.Value para consultar recursos que foram criados antes do ponto no tempo especificado.	CreationEndTime
Filter.3.Key	string	Não	A chave do filtro 3 usada para consultar recursos. Defina o valor como ExpiredStartTime. Você pode especificar Filter.3.Key e Filter.3.Value para consultar recursos que expiram após o ponto no tempo especificado.	ExpiredStartTime
Filter.4.Key	string	Não	A chave do filtro 4 usada para consultar recursos. Defina o valor como ExpiredEndTime. Você pode especificar Filter.4.Key e Filter.4.Value para consultar recursos que expiram antes do ponto no tempo especificado.	ExpiredEndTime
Filter.1.Value	string	Não	O valor do filtro 1 usado para consultar recursos. Ao especificar este parâmetro, você também deve especificar Filter.1.Key. Especifique a hora no formato `yyyy-MM-ddTHH:mmZ` em UTC.	2017-12-05T22:40Z
Filter.2.Value	string	Não	O valor do filtro 2 usado para consultar recursos. Ao especificar este parâmetro, você também deve especificar Filter.2.Key. Especifique a hora no formato `yyyy-MM-ddTHH:mmZ` em UTC.	2017-12-06T22:40Z
Filter.3.Value	string	Não	O valor do filtro 3 usado para consultar recursos. Ao especificar este parâmetro, você também deve especificar Filter.3.Key. Especifique a hora no formato `yyyy-MM-ddTHH:mmZ` em UTC.	2017-12-07T22:40Z
Filter.4.Value	string	Não	O valor do filtro 4 usado para consultar recursos. Ao especificar este parâmetro, você também deve especificar Filter.4.Key. Especifique a hora no formato `yyyy-MM-ddTHH:mmZ` em UTC.	2017-12-08T22:40Z
DeviceAvailable	boolean	Não	Nota Este parâmetro está em pré-visualização por convite e não está disponível publicamente.	false
IoOptimized	boolean	Não	Especifica se a instância é otimizada para E/S. Valores válidos: true: A instância é otimizada para E/S. false: A instância não é otimizada para E/S.	true
NeedSaleCycle	boolean	Não	Nota Este parâmetro está em pré-visualização por convite e não está disponível publicamente.	false
InstanceType	string	Não	O tipo de instância.	ecs.g5.large
InstanceTypeFamily	string	Não	A família da instância.	ecs.g5
KeyPairName	string	Não	O nome do par de chaves SSH vinculado à instância.	KeyPairNameTest
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual a instância pertence. Ao usar este parâmetro para filtrar recursos, a contagem de recursos não pode exceder 1.000. Nota Não há suporte para filtragem pelo grupo de recursos padrão.	rg-bp67acfmxazb4p****
HpcClusterId	string	Não	O ID do cluster HPC ao qual a instância pertence.	hpc-bp67acfmxazb4p****
RdmaIpAddresses	string	Não	Os endereços IP RDMA da instância HPC.	10.10.10.102
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run. Valores válidos: true: realiza apenas um dry run. O sistema verifica a solicitação quanto a possíveis problemas, incluindo pares AccessKey inválidos, usuários do Resource Access Management (RAM) não autorizados e valores de parâmetros ausentes. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro DryRunOperation será retornado. false: realiza um dry run e envia a solicitação. Se a solicitação passar no dry run, um código de status HTTP 2XX será retornado e a operação será executada. Valor padrão: false.	false
HttpEndpoint	string	Não	Especifica se o canal de acesso para metadados da instância está ativado. Valores válidos: enabled: ativado. disabled: desativado. Valor padrão: enabled. Nota Para mais informações sobre metadados de instância, consulte Visão geral dos metadados de instância ECS.	enabled
HttpTokens	string	Não	Especifica se o uso do modo reforçado (IMDSv2) é obrigatório ao acessar os metadados da instância. Valores válidos: optional: O modo reforçado não é obrigatório. required: O modo reforçado é obrigatório. Após definir este parâmetro como required, você não poderá acessar os metadados da instância no modo normal. Valor padrão: optional. Nota Para mais informações sobre os padrões de acesso a metadados de instância, consulte Modos de acesso a metadados de instância.	optional
HttpPutResponseHopLimit	integer	Não	Nota Este parâmetro ainda não está disponível.	0
Ipv6Address	array	Não	Os endereços IPv6 atribuídos às Elastic Network Interfaces (ENIs).
	string	Não	O endereço IPv6 da Elastic Network Interface (ENI). N especifica que você pode definir vários endereços IPv6. Valores válidos de N: 1 a 100.	2408:4321:180:1701:94c7:bc38:3bfa:****
Tag	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag da instância. Valores válidos de N: 1 a 20. Se você usar uma única tag para filtrar recursos, o número de recursos com esta tag não pode exceder 1.000. Se você usar várias tags para filtrar recursos, o número de recursos associados a todas as tags especificadas não pode exceder 1.000. Se a contagem de recursos exceder 1.000, use a operação ListTagResources para consultar os recursos.	TestKey
Value	string	Não	O valor da tag da instância. Valores válidos de N: 1 a 20.	TestValue
key	string	Não	A chave da tag. Nota Para melhorar a compatibilidade, use o parâmetro Tag.N.Key em seu lugar.	keyTest
value	string	Não	O valor da tag. Nota Para melhorar a compatibilidade, use o parâmetro Tag.N.Value em seu lugar.	valueTest
AdditionalAttributes	array	Não	A lista de propriedades adicionais da instância.	META_OPTIONS
	string	Não	O valor da propriedade adicional. Valores válidos de N: 1 a 5. Valores válidos: META_OPTIONS: metadados da instância. DDH_CLUSTER: cluster de host dedicado. NETWORK_PRIMARY_ENI_IP: endereços IP secundários da interface de rede (NIC) primária. PRIVATE_DNS_OPTIONS: informações de nome de domínio de rede privada. CPU_OPTIONS_TOPOLOGY_TYPE: o tipo de topologia de CPU da instância. CURRENT_OS_NVME_SUPPORTED: indica se o sistema operacional atual oferece suporte ao acesso a discos por meio do protocolo NVMe. LOGIN_AS_NON_ROOT: indica se a instância está configurada com logon ecs-user.	META_OPTIONS

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Instances	object
Instance	array<object>	Um array de objetos Instance que contém as informações sobre as instâncias.
	array<object>
AdditionalInfo	object	Nota Este parâmetro está em pré-visualização por convite e não está disponível publicamente.
EnableHighDensityMode	boolean	Nota Este parâmetro está em pré-visualização por convite e não está disponível publicamente.	true
ManagedHostId	string	O ID exclusivo do host gerenciado pela plataforma, como mh-f2d3647ca21****.	mh-f2d3647ca21****
NodeSerialNumber	string
AutoReleaseTime	string	A hora de liberação automática da instância pós-paga.	2017-12-10T04:04Z
ClockOptions	object
PtpStatus	string
ClusterId	string	O ID do cluster ao qual a instância pertence. Nota Este parâmetro será descontinuado. Para garantir a compatibilidade, use outros parâmetros.	c-bp67acfmxazb4p****
Cpu	integer	O número de vCPUs.	8
CpuOptions	object	Os detalhes de configuração da CPU.
CoreCount	integer	O número de núcleos físicos da CPU.	2
EnableVISST	boolean
EnableVRDT	boolean
NestedVirtualization	string	Indica se a virtualização aninhada está ativada.	enabled
Numa	string	Nota Este parâmetro está descontinuado.	null
ThreadsPerCore	integer	O número de threads por núcleo de CPU.	2
TopologyType	string	O tipo de topologia de CPU da instância. Valores válidos: ContinuousCoreToHTMapping: modo discreto de HT. DiscreteCoreToHTMapping: modo contínuo de HT.	DiscreteCoreToHTMapping
TurboMode	string
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+0. Para mais informações, consulte ISO 8601.	2017-12-10T04:04Z
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 a seção de modo de desempenho restrito em Visão geral das instâncias burstable. Unlimited: modo ilimitado. Para mais informações sobre o desempenho da instância, consulte a seção de modo ilimitado em Visão geral das instâncias burstable.	Standard
DedicatedHostAttribute	object	Um array de atributos de host dedicado, que consiste no ID do cluster de host dedicado (DedicatedHostClusterId), ID do host dedicado (DedicatedHostId) e nome do host dedicado (DedicatedHostName).
DedicatedHostClusterId	string	O ID do cluster de host dedicado.	dc-bp67acfmxazb4h****
DedicatedHostId	string	O ID do host dedicado.	dh-bp67acfmxazb4p****
DedicatedHostName	string	O nome do host dedicado.	testDedicatedHostName
DedicatedInstanceAttribute	object	Os atributos da instância no host dedicado.
Affinity	string	Indica se a instância no host dedicado está associada ao host dedicado. Valores válidos: default: A instância não está associada ao host dedicado. Quando uma instância que está no estado Sem Cobrança para Instâncias Paradas é reiniciada, a instância pode ser colocada em outro host dedicado no pool de recursos de implantação automática. host: A instância está associada ao host dedicado. Quando uma instância que está no estado Sem Cobrança para Instâncias Paradas é reiniciada, a instância ainda é colocada no host dedicado original.	default
Tenancy	string	Indica se o tipo de host da instância é um host dedicado. Valores válidos: default: O tipo de host da instância não é um host dedicado. host: O tipo de host da instância é um host dedicado.	default
DeletionProtection	boolean	O atributo de proteção contra liberação da instância. Especifica se a instância pode ser liberada no console do ECS ou chamando a operação DeleteInstance. true: A proteção contra liberação está ativada para a instância. false: A proteção contra liberação não está ativada para a instância. Nota Este atributo é aplicável apenas a instâncias pós-pagas. Ele pode restringir apenas operações de liberação manual, não operações de liberação do sistema.	false
DeploymentSetGroupNo	integer	O número do grupo da instância ECS no conjunto de implantação quando a instância ECS é implantada com a estratégia de implantação distribuída.	1
DeploymentSetId	string	O ID do conjunto de implantação.	ds-bp67acfmxazb4p****
Description	string	A descrição da instância.	testDescription
DeviceAvailable	boolean	Indica se discos de dados em nuvem podem ser anexados à instância. true: Discos de dados em nuvem podem ser anexados à instância. false: Discos de dados em nuvem não podem ser anexados à instância.	true
EcsCapacityReservationAttr	object	Os parâmetros relacionados à reserva de capacidade do Elastic Compute Service (ECS).
CapacityReservationId	string	O ID da reserva de capacidade.	cr-bp67acfmxazb4p****
CapacityReservationPreference	string	A preferência de reserva de capacidade.	cr-bp67acfmxazb4p****
EipAddress	object	As informações de vinculação do Elastic IP Address (EIP).
AllocationId	string	O ID do EIP.	eip-2ze88m67qx5z****
Bandwidth	integer	O limite de largura de banda pública do EIP. Unidade: Mbit/s.	5
InternetChargeType	string	O método de cobrança do EIP para uso da Internet. PayByBandwidth: cobrança por largura de banda. PayByTraffic: cobrança por tráfego.	PayByTraffic
IpAddress	string	O endereço EIP.	42.112..
IsSupportUnassociate	boolean	Indica se o EIP de Internet pode ser desassociado de um EIP.	true
EnableNVS	boolean
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+0. Para mais informações, consulte ISO 8601.	2017-12-10T04:04Z
GPUAmount	integer	O número de GPUs para o tipo de instância.	4
GPUSpec	string	O tipo de GPU para o tipo de instância.	NVIDIA V100
HibernationOptions	object	Nota Este parâmetro está em pré-visualização por convite e não está disponível publicamente.
Configured	boolean	Nota Este parâmetro está em pré-visualização por convite e não está disponível publicamente.	false
HostName	string	O nome do host da instância.	testHostName
HpcClusterId	string	O ID do cluster HPC ao qual a instância pertence.	hpc-bp67acfmxazb4p****
ISP	string	Nota Este parâmetro está em pré-visualização por convite e não está disponível publicamente.	null
ImageId	string	O ID da imagem que a instância está executando.	m-bp67acfmxazb4p****
ImageOptions	object	As informações de atributos relacionados à imagem.
CurrentOSNVMeSupported	boolean	Indica se o sistema operacional atual suporta acesso a discos em nuvem através do protocolo NVMe. Valores válidos: true: Suportado. false: Não suportado. Nota Este parâmetro é retornado apenas quando o parâmetro de solicitação AdditionalAttributes contém CURRENT_OS_NVME_SUPPORTED.	true
LoginAsNonRoot	boolean	Indica se a instância que usa esta imagem suporta login com o usuário ecs-user. Valores válidos: true: Suportado. false: Não suportado.	false
InnerIpAddress	object
IpAddress	array	A lista de endereços IP de rede interna da instância no tipo de rede clássica. Nota O recurso de rede clássica foi desativado. Para mais detalhes, consulte Aviso de desativação.
	string	O endereço IP de rede interna da instância no tipo de rede clássica.	10.170..
InstanceChargeType	string	O método de cobrança da instância. Valores válidos: PrePaid: assinatura. PostPaid: pós-pago.	PostPaid
InstanceId	string	O ID da instância.	i-bp67acfmxazb4p****
InstanceName	string	O nome da instância.	InstanceNameTest
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 desativada. Para mais informações, consulte Aviso de desativação.	vpc
InstanceType	string	O tipo de instância.	ecs.g5.large
InstanceTypeFamily	string	A família da instância.	ecs.g5
InternetChargeType	string	O método de cobrança para uso de rede. Valores válidos: PayByBandwidth: cobrança por largura de banda. PayByTraffic: cobrança por tráfego.	PayByTraffic
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
IoOptimized	boolean	Indica se a instância é otimizada para E/S. true: A instância é otimizada para E/S. false: A instância não é otimizada para E/S.	true
KeyPairName	string	O nome do par de chaves.	testKeyPairName
LocalStorageAmount	integer	O número de dispositivos de armazenamento local anexados à instância.	2
LocalStorageCapacity	integer	A capacidade do armazenamento local anexado à instância. Unidade: GiB.	1000
Memory	integer	O tamanho da memória. Unidade: MiB.	16384
MetadataOptions	object	O conjunto de opções de metadados.
HttpEndpoint	string	Indica se o canal de acesso para metadados da instância está ativado. Valores válidos: enabled: O canal de acesso está ativado. disabled: O canal de acesso está desativado.	enabled
HttpPutResponseHopLimit	integer	Nota Este parâmetro não está disponível publicamente.	0
HttpTokens	string	Indica se o modo IMDSv2 é usado obrigatoriamente para acessar os metadados da instância. Valores válidos: optional: O modo IMDSv2 não é usado obrigatoriamente. required: O modo IMDSv2 é usado obrigatoriamente.	optional
InstanceMetadataTags	string
NetworkInterfaces	object
NetworkInterface	array<object>	O conjunto de Elastic Network Interfaces (ENIs) anexadas à instância, incluindo as informações da interface de rede (NIC).
	array<object>	O conjunto de Elastic Network Interfaces (ENIs) anexadas à instância, incluindo as informações da interface de rede (NIC).
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	O conjunto de prefixos IPv4 alocado à interface de rede (NIC). Este parâmetro é retornado apenas quando o parâmetro de solicitação AdditionalAttributes.N é definido como NETWORK_PRIMARY_ENI_IP.
	object
Ipv4Prefix	string	O prefixo IPv4 atribuído à interface de rede (NIC).	192.168../28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	O conjunto de prefixos IPv6 alocado à interface de rede (NIC). Este parâmetro é retornado apenas quando o parâmetro de solicitação AdditionalAttributes.N é definido como NETWORK_PRIMARY_ENI_IP.
	object
Ipv6Prefix	string	O prefixo IPv6 atribuído à interface de rede (NIC).	2001:1111::::/80
Ipv6Sets	object
Ipv6Set	array<object>	O conjunto de endereços IPv6 alocado à interface de rede (NIC). Este parâmetro é retornado apenas quando o parâmetro de solicitação AdditionalAttributes.N é definido como NETWORK_PRIMARY_ENI_IP.
	object
Ipv6Address	string	O endereço IPv6 alocado à interface de rede (NIC).	2408:4321:180:1701:94c7:bc38:3bfa:***
Primary	boolean
MacAddress	string	O endereço MAC da interface de rede (NIC).	00:16:3e:32:b4:**
NetworkInterfaceId	string	O ID da interface de rede (NIC).	eni-2zeh9atclduxvf1z****
PrimaryIpAddress	string	O endereço IP privado principal da interface de rede (NIC).	172.17..*
PrivateIpSets	object
PrivateIpSet	array<object>	O conjunto de objetos PrivateIpSet.
	object
Primary	boolean	Indica se o endereço IP é o endereço IP privado principal. Valores válidos: true: O endereço IP é o endereço IP privado principal. false: O endereço IP não é o endereço IP privado principal.	true
PrivateDnsName	string	O nome de domínio privado da instância. Nota Um nome de domínio privado em um formato fixo é retornado apenas quando HostnameType está definido como IpBased ou InstanceIdBased.	dnsTestName
PrivateIpAddress	string	O endereço IP privado da instância.	172.17..
Type	string	O tipo da Elastic Network Interface (ENI). Valores válidos: Primary: interface de rede (NIC) principal. Secondary: ENI secundária.	Primary
OSName	string	O nome do sistema operacional da instância.	CentOS 7.4 64 位
OSNameEn	string	O nome em inglês do sistema operacional da instância.	CentOS 7.4 64 bit
OSType	string	O tipo do sistema operacional da instância. Valores válidos: windows linux	linux
OperationLocks	object
LockReason	array<object>	Os motivos pelos quais a instância está bloqueada.
	object
LockMsg	string	A descrição do bloqueio da instância.	A instância especificada está bloqueada por motivos financeiros
LockReason	string	O tipo de bloqueio. Valores válidos: financial: a instância ECS está bloqueada devido a pagamento em atraso. security: a instância ECS 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 porque o host dedicado tem um pagamento em atraso. refunded: a instância ECS está bloqueada porque um reembolso foi realizado.	Recycling
PrivateDnsNameOptions	object	A configuração de nome de domínio privado da instância. Para obter mais informações sobre a resolução de nome de domínio privado do ECS, consulte Resolução de nome de domínio privado do ECS. Nota Este parâmetro é retornado apenas quando o parâmetro de solicitação AdditionalAttributes contém PRIVATE_DNS_OPTIONS.
EnableInstanceIdDnsAAAARecord	boolean	Indica se a resolução de nome de domínio para IPv6 baseada no ID da instância está ativada. Valores válidos: true: Ativada. false: Desativada. Valor padrão: false.	false
EnableInstanceIdDnsARecord	boolean	Indica se a resolução de nome de domínio para IPv4 baseada no ID da instância está ativada. Valores válidos: true: Ativada. false: Desativada. Valor padrão: false.	false
EnableIpDnsARecord	boolean	Indica se a resolução de nome de domínio para IPv4 baseada em IP está ativada. Valores válidos: true: Ativada. false: Desativada. Valor padrão: false.	true
EnableIpDnsPtrRecord	boolean	Indica se a resolução de nome de domínio para IPv4 baseada em IP está ativada. Valores válidos: true: Ativada. false: Desativada. Valor padrão: false.	true
HostnameType	string	O tipo de nome de host. Valores válidos: Custom: personalizado. IpBased: nome de host baseado em IP. InstanceIdBased: nome de host baseado no ID da instância. Valor padrão: Custom.	Custom
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..
RdmaIpAddress	object
IpAddress	array	A lista de endereços IP RDMA da instância HPC.
	string	Os endereços IP RDMA da instância HPC.	10.10.10.102
Recyclable	boolean	Indica se a instância pode ser reciclada.	false
RegionId	string	O ID da região da instância.	cn-hangzhou
ResourceGroupId	string	O ID do grupo de recursos ao qual a instância pertence.	rg-bp67acfmxazb4p****
SaleCycle	string	Nota Este parâmetro foi descontinuado e não retorna mais dados significativos.	month
SecurityGroupIds	object
SecurityGroupId	array	A lista de IDs de grupos de segurança da instância.
	string	O ID do grupo de segurança.	sg-bp67acfmxazb4p****
SecurityOptions	object
EnableSecureBoot	boolean	Indica se a Inicialização Segura UEFI está ativada.
SerialNumber	string	O número de série da instância.	51d1353b-22bf-4567-a176-8b3e12e4****
SpotDuration	integer	O período de proteção da instância spot. Unidade: horas. Valores válidos: 1: Após a criação da instância spot, o Alibaba Cloud garante que a instância não esteja sujeita à liberação automática dentro de 1 hora. Após 1 hora, o sistema compara automaticamente o preço do lance com o preço de mercado e verifica o inventário de recursos para determinar se deve reter ou revogar a instância. 0: Após a criação da instância spot, o Alibaba Cloud não garante que a instância seja executada por 1 hora. O sistema compara automaticamente o preço do lance com o preço de mercado e verifica o inventário de recursos para determinar se deve reter ou revogar a instância. O Alibaba Cloud envia uma notificação de evento do sistema ECS 5 minutos antes de a instância ser revogada. As instâncias spot são cobradas por segundo. Selecione um período de proteção apropriado com base na duração esperada da execução da tarefa. Nota Este parâmetro é retornado apenas quando SpotStrategy está definido como SpotWithPriceLimit ou SpotAsPriceGo.	1
SpotInterruptionBehavior	string	O padrão de interrupção da instância spot quando a plataforma inicia uma interrupção de instância spot. Valores válidos: Terminate: A instância é liberada. Stop: A instância é parada no modo econômico.	Terminate
SpotPriceLimit	number	O preço máximo por hora da instância. O valor suporta até três casas decimais. Este parâmetro entra em vigor quando SpotStrategy=SpotWithPriceLimit.	0.98
SpotStrategy	string	A estratégia de lance para a instância pay-as-you-go. Valores válidos: NoSpot: A instância é uma instância pay-as-you-go regular. SpotWithPriceLimit: A instância é uma instância spot com um limite de preço máximo. SpotAsPriceGo: A instância é uma instância spot para a qual o sistema dá lances automaticamente até o preço pay-as-you-go.	NoSpot
StartTime	string	A hora de início mais recente da instância. A hora segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mmZ. A hora é exibida em UTC. Para obter mais informações, consulte ISO 8601.	2017-12-10T04:04Z
Status	string	O status da instância.	Running
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 a instância ser reiniciada 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
Tags	object
Tag	array<object>	As tags da instância.
	object
TagKey	string	A chave da tag da instância.	TestKey
TagValue	string	O valor da tag da instância.	TestValue
VlanId	string	O ID da VLAN da instância. Nota Este parâmetro será descontinuado. Para melhor compatibilidade, use outros parâmetros.	10
VpcAttributes	object	Os atributos de VPC da instância.
NatIpAddress	string	O endereço IP do serviço em nuvem, que é usado para conectividade de rede entre serviços em nuvem baseados em VPC.	172.17..
PrivateIpAddress	object
IpAddress	array	A lista de endereços IP privados.
	string	O endereço IP privado.	172.17..
VSwitchId	string	O ID do vSwitch.	vsw-2zeh0r1pabwtg6wcs****
VpcId	string	O ID da nuvem privada virtual (VPC).	vpc-2zeuphj08tt7q3brd****
ZoneId	string	O ID da zona da instância.	cn-hangzhou-g
NextToken	string	O token de paginação retornado nesta chamada.	caeba0bbb2be03f84eb48b699f0a4883
PageNumber	integer	O número da página.	1
PageSize	integer	O número de entradas por página especificado na solicitação.	10
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCount	integer	O número total de instâncias consultadas. Nota Quando você usa os parâmetros MaxResults e NextToken para consulta de paginação, o valor do parâmetro TotalCount retornado não tem significado.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "Instances": {
    "Instance": [
      {
        "AdditionalInfo": {
          "EnableHighDensityMode": true,
          "ManagedHostId": "mh-f2d3647ca21****",
          "NodeSerialNumber": ""
        },
        "AutoReleaseTime": "2017-12-10T04:04Z",
        "ClockOptions": {
          "PtpStatus": ""
        },
        "ClusterId": "c-bp67acfmxazb4p****",
        "Cpu": 8,
        "CpuOptions": {
          "CoreCount": 2,
          "EnableVISST": false,
          "EnableVRDT": false,
          "NestedVirtualization": "enabled",
          "Numa": "null",
          "ThreadsPerCore": 2,
          "TopologyType": "DiscreteCoreToHTMapping",
          "TurboMode": ""
        },
        "CreationTime": "2017-12-10T04:04Z",
        "CreditSpecification": "Standard",
        "DedicatedHostAttribute": {
          "DedicatedHostClusterId": "dc-bp67acfmxazb4h****",
          "DedicatedHostId": "dh-bp67acfmxazb4p****",
          "DedicatedHostName": "testDedicatedHostName"
        },
        "DedicatedInstanceAttribute": {
          "Affinity": "default",
          "Tenancy": "default"
        },
        "DeletionProtection": false,
        "DeploymentSetGroupNo": 1,
        "DeploymentSetId": "ds-bp67acfmxazb4p****",
        "Description": "testDescription",
        "DeviceAvailable": true,
        "EcsCapacityReservationAttr": {
          "CapacityReservationId": "cr-bp67acfmxazb4p****",
          "CapacityReservationPreference": "cr-bp67acfmxazb4p****"
        },
        "EipAddress": {
          "AllocationId": "eip-2ze88m67qx5z****",
          "Bandwidth": 5,
          "InternetChargeType": "PayByTraffic",
          "IpAddress": "42.112.**.**",
          "IsSupportUnassociate": true
        },
        "EnableNVS": false,
        "ExpiredTime": "2017-12-10T04:04Z",
        "GPUAmount": 4,
        "GPUSpec": "NVIDIA V100",
        "HibernationOptions": {
          "Configured": false
        },
        "HostName": "testHostName",
        "HpcClusterId": "hpc-bp67acfmxazb4p****",
        "ISP": "null",
        "ImageId": "m-bp67acfmxazb4p****",
        "ImageOptions": {
          "CurrentOSNVMeSupported": true,
          "LoginAsNonRoot": false
        },
        "InnerIpAddress": {
          "IpAddress": [
            "10.170.**.**"
          ]
        },
        "InstanceChargeType": "PostPaid",
        "InstanceId": "i-bp67acfmxazb4p****",
        "InstanceName": "InstanceNameTest",
        "InstanceNetworkType": "vpc",
        "InstanceType": "ecs.g5.large",
        "InstanceTypeFamily": "ecs.g5",
        "InternetChargeType": "PayByTraffic",
        "InternetMaxBandwidthIn": 50,
        "InternetMaxBandwidthOut": 5,
        "IoOptimized": true,
        "KeyPairName": "testKeyPairName",
        "LocalStorageAmount": 2,
        "LocalStorageCapacity": 1000,
        "Memory": 16384,
        "MetadataOptions": {
          "HttpEndpoint": "enabled",
          "HttpPutResponseHopLimit": 0,
          "HttpTokens": "optional",
          "InstanceMetadataTags": ""
        },
        "NetworkInterfaces": {
          "NetworkInterface": [
            {
              "Ipv4PrefixSets": {
                "Ipv4PrefixSet": [
                  {
                    "Ipv4Prefix": "192.168.*.*/28"
                  }
                ]
              },
              "Ipv6PrefixSets": {
                "Ipv6PrefixSet": [
                  {
                    "Ipv6Prefix": "2001:1111:*:*::/80"
                  }
                ]
              },
              "Ipv6Sets": {
                "Ipv6Set": [
                  {
                    "Ipv6Address": "2408:4321:180:1701:94c7:bc38:3bfa:***",
                    "Primary": false
                  }
                ]
              },
              "MacAddress": "00:16:3e:32:b4:**",
              "NetworkInterfaceId": "eni-2zeh9atclduxvf1z****",
              "PrimaryIpAddress": "172.17.**.***",
              "PrivateIpSets": {
                "PrivateIpSet": [
                  {
                    "Primary": true,
                    "PrivateDnsName": "dnsTestName",
                    "PrivateIpAddress": "172.17.**.**"
                  }
                ]
              },
              "Type": "Primary"
            }
          ]
        },
        "OSName": "CentOS  7.4 64 位",
        "OSNameEn": "CentOS  7.4 64 bit",
        "OSType": "linux",
        "OperationLocks": {
          "LockReason": [
            {
              "LockMsg": "A instância especificada está bloqueada por motivos financeiros",
              "LockReason": "Recycling"
            }
          ]
        },
        "PrivateDnsNameOptions": {
          "EnableInstanceIdDnsAAAARecord": false,
          "EnableInstanceIdDnsARecord": false,
          "EnableIpDnsARecord": true,
          "EnableIpDnsPtrRecord": true,
          "HostnameType": "Custom"
        },
        "PublicIpAddress": {
          "IpAddress": [
            "121.40.**.**"
          ]
        },
        "RdmaIpAddress": {
          "IpAddress": [
            "10.10.10.102"
          ]
        },
        "Recyclable": false,
        "RegionId": "cn-hangzhou",
        "ResourceGroupId": "rg-bp67acfmxazb4p****",
        "SaleCycle": "month",
        "SecurityGroupIds": {
          "SecurityGroupId": [
            "sg-bp67acfmxazb4p****"
          ]
        },
        "SecurityOptions": {
          "EnableSecureBoot": false
        },
        "SerialNumber": "51d1353b-22bf-4567-a176-8b3e12e4****",
        "SpotDuration": 1,
        "SpotInterruptionBehavior": "Terminate",
        "SpotPriceLimit": 0.98,
        "SpotStrategy": "NoSpot",
        "StartTime": "2017-12-10T04:04Z",
        "Status": "Running",
        "StoppedMode": "KeepCharging",
        "Tags": {
          "Tag": [
            {
              "TagKey": "TestKey",
              "TagValue": "TestValue"
            }
          ]
        },
        "VlanId": "10",
        "VpcAttributes": {
          "NatIpAddress": "172.17.**.**",
          "PrivateIpAddress": {
            "IpAddress": [
              "172.17.**.**"
            ]
          },
          "VSwitchId": "vsw-2zeh0r1pabwtg6wcs****",
          "VpcId": "vpc-2zeuphj08tt7q3brd****"
        },
        "ZoneId": "cn-hangzhou-g"
      }
    ]
  },
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount": 1
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	O Tag.N.Key e o Tag.N.Value especificados não correspondem.
400	InvalidTagCount	The specified tags are beyond the permitted range.	A tag especificada está fora do intervalo válido.
400	InvalidHpcClusterId.NotFound	The specified HpcClusterId is not found.	O parâmetro HpcClusterId especificado não existe.
400	InvalidHpcClusterId.Creating	The specified HpcClusterId is creating.	O cluster HPC especificado está sendo criado.
400	InternalError	The request processing has failed due to some unknown error, exception or failure.
400	Throttling.PageNumberLimited	Request throttled. Please use NextToken instead of PageNumber for pagination.	A solicitação atual foi limitada. Use NextToken para substituir PageNumber para paginação em solicitações de consulta paginadas.
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.
404	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.
404	InvalidLockReason.NotFound	The specified LockReason is not found.	O tipo de bloqueio especificado não existe.
404	InvalidFilterKey.NotFound	Invalid filter.%s.	O parâmetro de hora de início ou hora de expiração especificado é inválido.
404	InvalidFilterValue	Invalid filter.%s.
404	InvalidNetworkType.NotFound	The specified InstanceNetworkType is not found.
404	InvalidStatus.NotFound	The specified Status is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.