DescribeDeploymentSets - - Alibaba Cloud Documentation Center

Mengkueri atribut set penyebaran.

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.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeDeploymentSets	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeDeploymentSets.
RegionId	String	Yes	cn-hangzhou	ID wilayah dari set penyebaran. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
PageNumber	Integer	No	1	Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1.
PageSize	Integer	No	10	Jumlah entri per halaman. Nilai valid: 1 hingga 50. Nilai default: 10.
DeploymentSetIds	String	No	["ds-bp67acfmxazb4ph**", "ds-bp67acfmxazb4pi", … "ds-bp67acfmxazb4pj**"]	ID set penyebaran. Nilainya dapat berupa array JSON yang terdiri dari maksimal 100 ID set penyebaran dalam format `["ds-xxxxxxxxx", "ds-yyyyyyyyy", … "ds-zzzzzzzzz"]`. Pisahkan ID set penyebaran dengan koma (,).
NetworkType	String	No	null	Catatan Parameter ini tidak digunakan lagi.
Strategy	String	No	Availability	Strategi penyebaran. Nilai valid: Availability: strategi ketersediaan tinggi. AvailabilityGroup: strategi kelompok ketersediaan tinggi.
DeploymentSetName	String	No	testDeploymentSetName	Nama set penyebaran. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan `http://` atau `https://`. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-).
Granularity	String	No	null	Catatan Parameter ini tidak digunakan lagi.
Domain	String	No	null	Catatan Parameter ini tidak digunakan lagi.

Parameter respons

Parameter	Type	Example	Description
PageSize	Integer	1	Jumlah entri per halaman.
PageNumber	Integer	1	Nomor halaman.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
TotalCount	Integer	1	Total jumlah set penyebaran yang dikueri.
RegionId	String	cn-hangzhou	ID wilayah dari set penyebaran.
DeploymentSets	Array of DeploymentSet		Detail tentang set penyebaran.
DeploymentSet
CreationTime	String	2021-12-07T06:01:46Z	Waktu saat set penyebaran dibuat.
Strategy	String	LooseDispersion	Strategi penyebaran.
DeploymentSetId	String	ds-bp67acfmxazb4ph****	ID set penyebaran.
DeploymentStrategy	String	Availability	Strategi penyebaran. Nilai kembali parameter ini sama dengan nilai parameter permintaan `Strategy`.
DeploymentSetDescription	String	testDeploymentSetDescription	Deskripsi set penyebaran.
Domain	String	default	Domain penyebaran.
GroupCount	Integer	3	Jumlah kelompok set penyebaran dalam set penyebaran. Catatan Parameter ini hanya berlaku ketika set penyebaran menggunakan strategi kelompok ketersediaan (AvailabilityGroup).
Granularity	String	host	Granularitas penyebaran.
DeploymentSetName	String	testDeploymentSetName	Nama set penyebaran.
InstanceAmount	Integer	3	Jumlah instans dalam set penyebaran.
InstanceIds	Array of String	i-bp67acfmxazb4ph****	ID instans.
Capacities	Array of Capacity		Detail kapasitas set penyebaran. Parameter ini tersedia hanya jika set penyebaran berisi Instance ECS. Nilainya mencakup kapasitas set penyebaran di zona yang berbeda.
Capacity
ZoneId	String	cn-hangzhou-i	ID zona. Hanya ID zona dari Instance ECS yang ada dalam set penyebaran yang dikembalikan.
UsedAmount	Integer	2	Jumlah Instance ECS yang berada di zona dalam set penyebaran.
AvailableAmount	Integer	18	Jumlah Instance ECS yang dapat ditambahkan ke set penyebaran di zona tersebut.

Contoh

Permintaan Contoh

https://ecs.aliyuncs.com/?Action=DescribeDeploymentSets
&RegionId=cn-hangzhou
&PageSize=1
&<Common request parameters>

Contoh Respons Sukses

XML format

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

<DescribeDeploymentSetsResponse>
    <DeploymentSets>
        <DeploymentSet>
            <CreationTime>2021-12-07T06:01:46Z</CreationTime>
            <Granularity>host</Granularity>
            <DeploymentSetDescription>testDeploymentSetDescription</DeploymentSetDescription>
            <Domain>default</Domain>
            <InstanceIds>
                <InstanceId>i-bp67acfmxazb4ph****</InstanceId>
                <InstanceId>i-bp67acfmxazb4pi****</InstanceId>
                <InstanceId>i-bp67acfmxazb4pj****</InstanceId>
            </InstanceIds>
            <InstanceAmount>3</InstanceAmount>
            <Strategy>LooseDispersion</Strategy>
            <DeploymentSetName>testDeploymentSetName</DeploymentSetName>
            <DeploymentStrategy>Availability</DeploymentStrategy>
            <DeploymentSetId>ds-bp67acfmxazb4ph****</DeploymentSetId>
            <capacities>
                <Capacity>
                    <UsedAmount>1</UsedAmount>
                    <ZoneId>cn-hangzhou-h</ZoneId>
                    <AvailableAmount>19</AvailableAmount>
                </Capacity>
                <Capacity>
                    <UsedAmount>2</UsedAmount>
                    <ZoneId>cn-hangzhou-i</ZoneId>
                    <AvailableAmount>18</AvailableAmount>
                </Capacity>
            </capacities>
        </DeploymentSet>
    </DeploymentSets>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <PageSize>1</PageSize>
    <RegionId>cn-hangzhou</RegionId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DescribeDeploymentSetsResponse>

JSON format

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

{
  "DeploymentSets" : {
    "DeploymentSet" : {
      "CreationTime" : "2021-12-07T06:01:46Z",
      "Granularity" : "host",
      "DeploymentSetDescription" : "testDeploymentSetDescription",
      "Domain" : "default",
      "InstanceIds" : {
        "InstanceId" : [ "i-bp67acfmxazb4ph****", "i-bp67acfmxazb4pi****", "i-bp67acfmxazb4pj****" ]
      },
      "InstanceAmount" : 3,
      "Strategy" : "LooseDispersion",
      "DeploymentSetName" : "testDeploymentSetName",
      "DeploymentStrategy" : "Availability",
      "DeploymentSetId" : "ds-bp67acfmxazb4ph****",
      "capacities" : {
        "Capacity" : [ {
          "UsedAmount" : 1,
          "ZoneId" : "cn-hangzhou-h",
          "AvailableAmount" : 19
        }, {
          "UsedAmount" : 2,
          "ZoneId" : "cn-hangzhou-i",
          "AvailableAmount" : 18
        } ]
      }
    }
  },
  "PageNumber" : 1,
  "TotalCount" : 1,
  "PageSize" : 1,
  "RegionId" : "cn-hangzhou",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
403	InvalidDeploymentSetIds.TooManyInput	The parameter DeploymentSets size should less than 100.	Jumlah set penyebaran yang ditentukan melebihi 100.

Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.