DescribeAutoProvisioningGroups - - Alibaba Cloud Documentation Center

Mengambil informasi mengenai kelompok penyediaan otomatis.

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	DescribeAutoProvisioningGroups	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeAutoProvisioningGroups.
RegionId	String	Yes	cn-hangzhou	ID wilayah dari kelompok penyediaan otomatis.
PageNumber	Integer	No	1	Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1.
PageSize	Integer	No	2	Jumlah entri per halaman. Nilai valid: 1 hingga 100. Nilai default: 10.
AutoProvisioningGroupName	String	No	testAutoProvisioningGroupName	Nama kelompok penyediaan otomatis.
AutoProvisioningGroupId.N	String	No	apg-sn54avj8htgvtyh8****	ID kelompok penyediaan otomatis N.
AutoProvisioningGroupStatus.N	String	No	active	Status kelompok penyediaan otomatis N. Nilai valid: submitted: Kelompok penyediaan otomatis telah dibuat tetapi belum menjalankan tugas penjadwalan. active: Kelompok penyediaan otomatis sedang menjalankan tugas penjadwalan. deleted: Kelompok penyediaan otomatis telah dihapus. deleted-running: Kelompok penyediaan otomatis sedang dalam proses penghapusan. modifying: Kelompok penyediaan otomatis sedang dimodifikasi.

Response parameters

Parameter	Type	Example	Description
PageSize	Integer	10	Jumlah entri per halaman.
RequestId	String	745CEC9F-0DD7-4451-9FE7-8B752F39****	ID permintaan.
PageNumber	Integer	1	Nomor halaman.
TotalCount	Integer	10	Jumlah kelompok penyediaan otomatis yang ditanyakan.
AutoProvisioningGroups	Array of AutoProvisioningGroup		Detail kelompok penyediaan otomatis.
AutoProvisioningGroup
CreationTime	String	2019-04-01T15:10:20Z	Waktu pembuatan kelompok penyediaan otomatis.
AutoProvisioningGroupName	String	EcsDocTest	Nama kelompok penyediaan otomatis.
Status	String	submitted	Status kelompok penyediaan otomatis. Nilai valid: submitted: Kelompok penyediaan otomatis telah dibuat tetapi belum menjalankan tugas penjadwalan. active: Kelompok penyediaan otomatis sedang menjalankan tugas penjadwalan. deleted: Kelompok penyediaan otomatis telah dihapus. deleted-running: Kelompok penyediaan otomatis sedang dalam proses penghapusan. modifying: Kelompok penyediaan otomatis sedang dimodifikasi.
TerminateInstances	Boolean	false	Menunjukkan apakah instans dalam kelompok penyediaan otomatis dilepas saat kelompok tersebut dihapus. Nilai valid: true: melepas instans. false: hanya menghapus instans dari kelompok penyediaan otomatis tanpa melepasnya.
MaxSpotPrice	Float	2	Harga maksimum untuk instans preemptible dalam kelompok penyediaan otomatis. Catatan Jika Anda menentukan parameter MaxSpotPrice dan LaunchTemplateConfig.N.MaxPrice, harga maksimum adalah nilai terendah dari kedua parameter tersebut. Parameter LaunchTemplateConfig.N.MaxPrice ditetapkan saat kelompok penyediaan otomatis dibuat dan tidak dapat dimodifikasi.
State	String	fulfilled	Status keseluruhan penjadwalan instans dalam kelompok penyediaan otomatis. Nilai valid: fulfilled: Penjadwalan selesai dan kluster instans telah dikirimkan. pending-fulfillment: Instans sedang dibuat. pending-termination: Instans sedang dihapus. error: Terjadi pengecualian selama penjadwalan dan kluster instans tidak dikirimkan.
LaunchTemplateId	String	lt-bp1fgzds4bdogu03****	ID template peluncuran yang terkait dengan kelompok penyediaan otomatis.
ValidFrom	String	2019-04-01T15:10:20Z	Waktu mulai berlakunya kelompok penyediaan otomatis. Kelompok penyediaan ini berlaku hingga waktu yang ditentukan oleh parameter `ValidUntil`.
LaunchTemplateVersion	String	1	Versi template peluncuran yang terkait dengan kelompok penyediaan otomatis.
TerminateInstancesWithExpiration	Boolean	true	Menunjukkan apakah instans dalam kelompok penyediaan otomatis dilepas saat kelompok tersebut kedaluwarsa. Nilai valid: true: melepas instans. false: hanya menghapus instans dari kelompok penyediaan otomatis tanpa melepasnya.
RegionId	String	cn-hangzhou	ID wilayah dari kelompok penyediaan otomatis.
ValidUntil	String	2019-06-01T15:10:20Z	Waktu kedaluwarsa kelompok penyediaan otomatis. Kelompok penyediaan ini dimulai sejak waktu yang ditentukan oleh parameter `ValidFrom`.
AutoProvisioningGroupType	String	maintain	Jenis pengiriman kelompok penyediaan otomatis. Nilai valid: request: pengiriman satu kali. Saat kelompok penyediaan otomatis dimulai, sistem hanya mengirimkan kluster satu kali. Jika pengiriman gagal, sistem tidak mencoba lagi. maintain: pengiriman berkelanjutan. Saat kelompok penyediaan otomatis dimulai, sistem berusaha mengirimkan kluster instans yang memenuhi kapasitas target dan memantau kapasitas secara real-time. Jika kapasitas target belum tercapai, kelompok penyediaan otomatis terus membuat instans hingga kapasitas target tercapai.
AutoProvisioningGroupId	String	apg-sn54avj8htgvtyh8****	ID kelompok penyediaan otomatis.
ExcessCapacityTerminationPolicy	String	termination	Menunjukkan apakah instans yang diskalakan turun dilepas saat kapasitas real-time melebihi kapasitas target dan kelompok melakukan scaling in. Nilai valid: termination: melepas instans yang diskalakan turun. no-termination: menghapus instans yang diskalakan turun dari kelompok penyediaan otomatis, tetapi tidak melepas instans tersebut.
LaunchTemplateConfigs	Array of LaunchTemplateConfig		Detail konfigurasi tambahan.
LaunchTemplateConfig
MaxPrice	Float	3	Harga maksimum tipe instans yang ditentukan dalam konfigurasi tambahan.
Priority	Float	1	Prioritas tipe instans yang ditentukan dalam konfigurasi tambahan. Nilai 0 menunjukkan prioritas tertinggi.
VSwitchId	String	vsw-sn5bsitu4lfzgc5o7****	ID vSwitch yang ditentukan dalam konfigurasi tambahan.
WeightedCapacity	Float	2	Bobot tipe instans yang ditentukan dalam konfigurasi tambahan.
InstanceType	String	ecs.g5.large	Tipe instans yang ditentukan dalam konfigurasi tambahan.
SpotOptions	Object		Kebijakan terkait instans preemptible.
InstancePoolsToUseCount	Integer	2	Jumlah instans yang dibuat oleh kelompok penyediaan otomatis dengan memilih tipe instans berharga terendah. Catatan Parameter ini ditetapkan saat kelompok penyediaan otomatis dibuat dan tidak dapat dimodifikasi.
AllocationStrategy	String	diversified	Kebijakan penyediaan untuk instans preemptible. Nilai valid: lowest-price: kebijakan optimalisasi biaya. Kebijakan ini menunjukkan bahwa tipe instans termurah digunakan untuk membuat instans. diversified: kebijakan distribusi seimbang. Kebijakan ini menunjukkan bahwa instans dibuat secara merata di beberapa zona yang ditentukan dalam konfigurasi tambahan.
InstanceInterruptionBehavior	String	stop	Aksi yang dilakukan setelah instans preemptible berlebih dihentikan. Nilai valid: stop: menyimpan instans preemptible berlebih dalam status stopped. terminate: melepas instans preemptible berlebih.
PayAsYouGoOptions	Object		Kebijakan terkait instans pay-as-you-go.
AllocationStrategy	String	prioritized	Kebijakan untuk membuat instans pay-as-you-go. Nilai valid: lowest-price: kebijakan optimalisasi biaya. Kebijakan ini menunjukkan bahwa tipe instans termurah digunakan untuk membuat instans. prioritized: kebijakan berbasis prioritas. Kebijakan ini menunjukkan bahwa instans dibuat berdasarkan prioritas yang ditentukan oleh parameter LaunchTemplateConfig.N.Priority. Catatan Parameter LaunchTemplateConfig.N.Priority ditetapkan saat kelompok penyediaan otomatis dibuat dan tidak dapat dimodifikasi.
TargetCapacitySpecification	Object		Pengaturan kapasitas target kelompok penyediaan otomatis.
SpotTargetCapacity	Float	20	Kapasitas target instans preemptible dalam kelompok penyediaan otomatis.
PayAsYouGoTargetCapacity	Float	30	Kapasitas target instans pay-as-you-go dalam kelompok penyediaan otomatis.
DefaultTargetCapacityType	String	Spot	Metode penagihan untuk instans tambahan ketika kapasitas target kelompok penyediaan otomatis harus minimal sama dengan jumlah (`TotalTargetCapacity`) dari kapasitas instans pay-as-you-go yang ditentukan oleh parameter `PayAsYouGoTargetCapacity` dan kapasitas instans preemptible yang ditentukan oleh parameter `SpotTargetCapacity`. Nilai valid: PayAsYouGo: instans pay-as-you-go Spot: instans preemptible
TotalTargetCapacity	Float	60	Kapasitas target kelompok penyediaan otomatis. Kapasitas ini terdiri dari bagian-bagian berikut: PayAsYouGoTargetCapacity SpotTargetCapacity Kapasitas tambahan selain kapasitas instans yang ditentukan oleh parameter PayAsYouGoTargetCapacity dan SpotTargetCapacity.

Examples

Contoh permintaan

https://ecs.aliyuncs.com/?Action=DescribeAutoProvisioningGroups
&AutoProvisioningGroupId.1=apg-sn54avj8htgvtyh8****
&RegionId=cn-hangzhou
&<Common request parameters>

Contoh respons sukses

XML format

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

<DescribeAutoProvisioningGroups>
  <PageNumber>1</PageNumber>
  <TotalCount>1</TotalCount>
  <PageSize>10</PageSize>
  <RequestId>85331AC9-82C0-4604-9A14-048865BE****</RequestId>
  <AutoProvisioningGroups>
    <AutoProvisioningGroup>
      <TerminateInstancesWithExpiration>false</TerminateInstancesWithExpiration>
      <TerminateInstances>false</TerminateInstances>
      <ValidFrom>2019-06-17T15:22Z</ValidFrom>
      <AutoProvisioningGroupType>maintain</AutoProvisioningGroupType>
      <PayAsYouGoOptions>
        <AllocationStrategy>lowest-price</AllocationStrategy>
      </PayAsYouGoOptions>
      <AutoProvisioningGroupName>test61****</AutoProvisioningGroupName>
      <CreationTime></CreationTime>
      <ExcessCapacityTerminationPolicy>no-termination</ExcessCapacityTerminationPolicy>
      <Status>active</Status>
      <MaxSpotPrice>5</MaxSpotPrice>
      <LaunchTemplateVersion>1</LaunchTemplateVersion>
      <ValidUntil>2100-01-01T07:59Z</ValidUntil>
      <TargetCapacitySpecification>
        <SpotTargetCapacity>180</SpotTargetCapacity>
        <TotalTargetCapacity>300</TotalTargetCapacity>
        <PayAsYouGoTargetCapacity>120</PayAsYouGoTargetCapacity>
        <DefaultTargetCapacityType>PayAsYouGo</DefaultTargetCapacityType>
      </TargetCapacitySpecification>
      <State>fulfilled</State>
      <LaunchTemplateId>lt-uf657o6auob6aivd****</LaunchTemplateId>
      <RegionId>cn-shanghai</RegionId>
      <AutoProvisioningGroupId>apg-uf6c7pl7b30t4m98****</AutoProvisioningGroupId>
      <SpotOptions>
        <InstancePoolsToUseCount>1</InstancePoolsToUseCount>
        <InstanceInterruptionBehavior>terminate</InstanceInterruptionBehavior>
        <AllocationStrategy>lowest-price</AllocationStrategy>
      </SpotOptions>
      <LaunchTemplateConfigs>
        <LaunchTemplateConfig>
          <MaxPrice>3</MaxPrice>
          <WeightedCapacity>1</WeightedCapacity>
          <VSwitchId>vsw-uf6qbjwokzl67uqqf****</VSwitchId>
          <Priority>1</Priority>
          <InstanceType>ecs.c5.xlarge</InstanceType>
        </LaunchTemplateConfig>
        <LaunchTemplateConfig>
          <MaxPrice>2</MaxPrice>
          <WeightedCapacity>2</WeightedCapacity>
          <VSwitchId>vsw-uf6n6iy1ib39eqvph****</VSwitchId>
          <Priority>1</Priority>
          <InstanceType>ecs.g5.large</InstanceType>
        </LaunchTemplateConfig>
        <LaunchTemplateConfig>
          <MaxPrice>1</MaxPrice>
          <WeightedCapacity>3</WeightedCapacity>
          <VSwitchId>vsw-uf6gs8uerj5osels4****</VSwitchId>
          <Priority>1</Priority>
          <InstanceType>ecs.hfc5.large</InstanceType>
        </LaunchTemplateConfig>
      </LaunchTemplateConfigs>
    </AutoProvisioningGroup>
  </AutoProvisioningGroups>
</DescribeAutoProvisioningGroups>

JSON format

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

{
  "PageNumber" : 1,
  "TotalCount" : 1,
  "PageSize" : 10,
  "RequestId" : "85331AC9-82C0-4604-9A14-048865BE****",
  "AutoProvisioningGroups" : {
    "AutoProvisioningGroup" : {
      "TerminateInstancesWithExpiration" : false,
      "TerminateInstances" : false,
      "ValidFrom" : "2019-06-17T15:22Z",
      "AutoProvisioningGroupType" : "maintain",
      "PayAsYouGoOptions" : {
        "AllocationStrategy" : "lowest-price"
      },
      "AutoProvisioningGroupName" : "test61****",
      "CreationTime" : "",
      "ExcessCapacityTerminationPolicy" : "no-termination",
      "Status" : "active",
      "MaxSpotPrice" : 5,
      "LaunchTemplateVersion" : 1,
      "ValidUntil" : "2100-01-01T07:59Z",
      "TargetCapacitySpecification" : {
        "SpotTargetCapacity" : 180,
        "TotalTargetCapacity" : 300,
        "PayAsYouGoTargetCapacity" : 120,
        "DefaultTargetCapacityType" : "PayAsYouGo"
      },
      "State" : "fulfilled",
      "LaunchTemplateId" : "lt-uf657o6auob6aivd****",
      "RegionId" : "cn-shanghai",
      "AutoProvisioningGroupId" : "apg-uf6c7pl7b30t4m98****",
      "SpotOptions" : {
        "InstancePoolsToUseCount" : 1,
        "InstanceInterruptionBehavior" : "terminate",
        "AllocationStrategy" : "lowest-price"
      },
      "LaunchTemplateConfigs" : {
        "LaunchTemplateConfig" : [ {
          "MaxPrice" : 3,
          "WeightedCapacity" : 1,
          "VSwitchId" : "vsw-uf6qbjwokzl67uqqf****",
          "Priority" : 1,
          "InstanceType" : "ecs.c5.xlarge"
        }, {
          "MaxPrice" : 2,
          "WeightedCapacity" : 2,
          "VSwitchId" : "vsw-uf6n6iy1ib39eqvph****",
          "Priority" : 1,
          "InstanceType" : "ecs.g5.large"
        }, {
          "MaxPrice" : 1,
          "WeightedCapacity" : 3,
          "VSwitchId" : "vsw-uf6gs8uerj5osels4****",
          "Priority" : 1,
          "InstanceType" : "ecs.hfc5.large"
        } ]
      }
    }
  }
}

Error codes

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	MissingParamter.RegionId	The regionId should not be null.	RegionId wajib diisi.

Daftar kode kesalahan lengkap tersedia di Service error codes.