DescribeInstanceStatus - : Central de Documentação do Alibaba Cloud

Descrição

Para obter informações sobre os estados do ciclo de vida de uma instância ECS, consulte Estados da instância.
Esta operação também consulta a lista de instâncias ECS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeInstanceStatus	Operação a ser executada. Defina o valor como DescribeInstanceStatus.
RegionId	String	Sim	cn-hangzhou	ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ZoneId	String	Não	cn-hangzhou-d	ID da zona da instância. Chame a operação DescribeZones para consultar a lista de zonas mais recente.
ClusterId	String	Não	cls-bp67acfmxazb4p****	ID do cluster da instância.
PageNumber	Integer	Não	1	Número da página a retornar. A numeração começa em 1. Valor padrão: 1.
PageSize	Integer	Não	10	Quantidade de entradas por página. Valores válidos: 1 a 50. Valor padrão: 10.
InstanceId.N	String	Não	i-bp1j4i2jdf3owlhe****	ID da instância N. Para especificar vários IDs, separe-os com vírgulas (,). Exemplo: `InstanceId.1=i-bp1j4i2jdf3owlhe, InstanceId.2=i-bp1j4i2jdf3o1234`.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageSize	Integer	1	Número de entradas retornadas por página.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
PageNumber	Integer	1	Número da página retornada.
TotalCount	Integer	58	Número total de instâncias.
InstanceStatuses	Array of InstanceStatus		Informações de status das instâncias.
InstanceStatus
Status	String	Running	Estado 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.
InstanceId	String	i-bp1j4i2jdf3owlhe****	ID da instância.

Exemplos

Solicitações de exemplo

http(s)://ecs.aliyuncs.com/?Action=DescribeInstanceStatus
&ResourceOwnerId=155780923770
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-d
&ClusterId=cls-bp67acfmxazb4p****
&PageNumber=1
&PageSize=10
&InstanceId=["i-bp1j4i2jdf3owlhe****"]
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeInstanceStatusResponse>
    <PageNumber>1</PageNumber>
    <InstanceStatuses>
        <InstanceStatus>
            <Status>Running</Status>
            <InstanceId>i-bp1j4i2jdf3owlhe****</InstanceId>
        </InstanceStatus>
    </InstanceStatuses>
    <TotalCount>58</TotalCount>
    <PageSize>1</PageSize>
    <RequestId>746C3444-9A24-4D7D-B8A8-DCBF7AC8BD66</RequestId>
</DescribeInstanceStatusResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageNumber" : 1,
  "InstanceStatuses" : {
    "InstanceStatus" : [ {
      "Status" : "Running",
      "InstanceId" : "i-bp1j4i2jdf3owlhe****"
    } ]
  },
  "TotalCount" : 58,
  "PageSize" : 1,
  "RequestId" : "746C3444-9A24-4D7D-B8A8-DCBF7AC8BD66"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.