DescribeInstanceStatus - - Alibaba Cloud Documentation Center

Mengkueri informasi status beberapa instans Elastic Compute Service (ECS).

Description

Untuk informasi mengenai status siklus hidup instans ECS, lihat Instance states.
Operasi ini juga dapat digunakan untuk mengkueri daftar instans ECS.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeInstanceStatus	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeInstanceStatus.
RegionId	String	Yes	cn-hangzhou	ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
ZoneId	String	No	cn-hangzhou-d	ID zona instans. Anda dapat memanggil operasi DescribeZones untuk mengkueri daftar zona terbaru.
ClusterId	String	No	cls-bp67acfmxazb4p****	ID kluster instans.
PageNumber	Integer	No	1	Nomor halaman yang dikembalikan. Halaman dimulai dari halaman 1. Nilai default: 1.
PageSize	Integer	No	10	Jumlah entri yang dikembalikan pada setiap halaman. Nilai yang valid: 1 hingga 50. Nilai default: 10.
InstanceId.N	String	No	i-bp1j4i2jdf3owlhe****	ID instans N. Saat Anda menggunakan parameter ini untuk menentukan beberapa ID instans, pisahkan ID tersebut dengan koma (,). Contoh: `InstanceId.1=i-bp1j4i2jdf3owlhe**, InstanceId.2=i-bp1j4i2jdf3o1234**`.

Response parameters

Parameter	Type	Example	Description
PageSize	Integer	1	Jumlah entri yang dikembalikan per halaman.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
PageNumber	Integer	1	Nomor halaman yang dikembalikan.
TotalCount	Integer	58	Jumlah total instans.
InstanceStatuses	Array of InstanceStatus		Informasi status instans.
InstanceStatus
Status	String	Running	Status instans. Nilai yang valid: Pending: Instans sedang dibuat. Running: Instans sedang berjalan. Starting: Instans sedang dinyalakan. Stopping: Instans sedang dihentikan. Stopped: Instans telah dihentikan.
InstanceId	String	i-bp1j4i2jdf3owlhe****	ID instans.

Examples

Contoh permintaan

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>

Contoh respons sukses

XML format

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>

JSON format

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"
}

Error codes

Untuk daftar kode kesalahan, kunjungi API Error Center.