DescribeElasticityAssurances - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri detail elasticity assurance. Misalnya, Anda dapat mengkueri status, mode pencocokan, mode efektif, pengatur waktu kedaluwarsa, dan jumlah instans yang digunakan dari elasticity assurance.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:DescribeElasticityAssurances

get

*ElasticityAssurance.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah tempat elasticity assurance berada. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
ResourceGroupId	string	No	ID kelompok sumber daya. Saat Anda menggunakan parameter ini untuk memfilter resource, jumlah resource tidak boleh melebihi 1.000. Catatan Memfilter berdasarkan kelompok sumber daya default tidak didukung.	rg-bp67acfmxazb4p****
Tag	array<object>	No	Daftar pasangan kunci tag dan nilai tag yang terikat pada elasticity assurance.
	object	No	Informasi tag.
Key	string	No	Kunci tag. N menunjukkan bahwa Anda dapat menetapkan beberapa kunci tag untuk pemfilteran. Nilai valid N: 1 hingga 20. Jika Anda menggunakan satu tag untuk memfilter Sumber daya, jumlah Sumber daya dengan tag ini tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter Sumber daya, jumlah Sumber daya yang memiliki semua tag tertentu terpasang tidak boleh melebihi 1.000. Jika jumlah Sumber daya melebihi 1.000, panggil operasi ListTagResources untuk mengkueri Sumber daya.	TestKey
Value	string	No	Nilai tag. N menunjukkan bahwa Anda dapat menentukan beberapa kunci tag untuk pemfilteran. Nilai valid N: 1 hingga 20.	TestValue
MaxResults	integer	No	Jumlah entri maksimum per halaman untuk kueri berhalaman. Nilai maksimum: 100. Nilai default: 10.	10
NextToken	string	No	Token paginasi untuk kueri elasticity assurance. Dapatkan nilai dari hasil permintaan sebelumnya.	caeba0bbb2be03f84eb48b699f0a4883
PrivatePoolOptions.Ids	string	No	Daftar ID elasticity assurance. Nilai dapat berupa array JSON yang terdiri dari hingga 100 ID. Pisahkan beberapa ID dengan koma (,).	["eap-bp67acfmxazb4**", "eap-bp67acfmxazb5**"]
Platform	string	No	Catatan Parameter ini tidak digunakan lagi.	null
InstanceType	string	No	Tipe instans. Anda dapat menggunakan tipe instans untuk mengkueri hanya elasticity assurance yang aktif. Elasticity assurance yang dirilis hanya dapat dikueri dengan menggunakan `PrivatePoolOptions.Ids`.	ecs.c6.large
ZoneId	string	No	ID zona di wilayah tempat elasticity assurance berada.	cn-hangzhou-h
InstanceChargeType	string	No	Metode penagihan instans. Nilai valid: PostPaid. Hanya pay-as-you-go yang didukung. Nilai default: PostPaid.	PostPaid
Status	string	No	Status elasticity assurance. Nilai valid: All: semua status. Deactived: akan diaktifkan. Status ini dalam pratinjau undangan. Preparing: sedang disiapkan. Prepared: akan berlaku. Active: sedang berlaku. Released: telah dirilis. Jika Anda tidak menentukan parameter ini, elasticity assurance dalam semua status kecuali Pending dan Released akan dikueri.	Active
PackageType	string	No	Tipe elasticity assurance. Nilai valid: ElasticityAssurance: elasticity assurance standar. Ini adalah tipe ketika RecurrenceRules tidak ditentukan. TimeDivisionElasticityAssurance: elasticity assurance pembagian waktu. Ini adalah tipe ketika RecurrenceRules ditentukan.	ElasticityAssurance

Elemen respons

Element	Type	Description	Example
	object
NextToken	string	Token paginasi untuk kueri berikutnya.	caeba0bbb2be03f84eb48b699f0a4883
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCount	integer	Jumlah total entri yang cocok dengan kondisi kueri.	1
MaxResults	integer	Jumlah entri maksimum per halaman untuk elasticity assurance.	10
ElasticityAssuranceSet	object
ElasticityAssuranceItem	array<object>	Kumpulan detail elasticity assurance.
	array<object>	Detail elasticity assurance.
Status	string	Status elasticity assurance. Nilai valid: Preparing: sedang disiapkan. Prepared: akan berlaku. Active: sedang berlaku. Released: telah dirilis.	Active
PrivatePoolOptionsMatchCriteria	string	Mode pencocokan elasticity assurance. Nilai valid: Open: mode terbuka. Sistem secara otomatis mencocokkan kapasitas private pool terbuka saat instans dimulai. Jika tidak ada kapasitas private pool yang cocok tersedia, Sumber daya public pool digunakan untuk memulai instans. Target: mode tertarget. Instans dimulai dengan menggunakan kapasitas private pool yang ditentukan. Jika kapasitas private pool yang ditentukan tidak tersedia, instans gagal dimulai.	Target
PrivatePoolOptionsId	string	ID elasticity assurance.	eap-bp1ir35kqtn8ywci****
UsedAssuranceTimes	integer	Catatan Parameter ini tidak tersedia secara publik.	0
LatestStartTime	string	Catatan Parameter ini tidak tersedia secara publik.	null
PrivatePoolOptionsName	string	Nama layanan elasticity assurance.	eapTestName
RegionId	string	ID wilayah tempat elasticity assurance berada.	cn-hangzhou
EndTime	string	Pengatur waktu kedaluwarsa elasticity assurance. Pengatur waktu dalam standar ISO 8601 UTC.	2021-12-03T16:00Z
StartTime	string	Periode efektif elasticity assurance. Pengatur waktu dalam format ISO 8601 UTC.	2020-12-03T05:25Z
Description	string	Deskripsi elasticity assurance.	Ini adalah deskripsi
ResourceGroupId	string	ID kelompok sumber daya.	rg-bp67acfmxazb4p****
TotalAssuranceTimes	string	Jumlah total kali elasticity assurance diterapkan. Saat ini, hanya mode tanpa batas dalam periode efektif yang didukung.	Tanpa Batas
AllocatedResources	object
AllocatedResource	array<object>	Daftar detail alokasi Sumber daya.
	array<object>	Detail alokasi Sumber daya.
UsedAmount	integer	Jumlah instans yang digunakan.	2
TotalAmount	integer	Jumlah total instans yang akan dicadangkan untuk satu tipe instans.	2
AvailableAmount	integer	Catatan Parameter ini tidak tersedia secara publik.	5
FailedAmount	integer	Kapasitas yang gagal.	1
LockedAmount	integer	Kapasitas yang terkunci.	1
zoneId	string	ID zona di wilayah tempat elasticity assurance berada.	cn-hangzhou-h
InstanceType	string	Tipe instans.	ecs.c6.large
ElasticityAssuranceUsages	object
ElasticityAssuranceUsage	array<object>	Catatan Parameter ini tidak tersedia secara publik.
	object	Catatan Parameter ini tidak tersedia secara publik.
AccountId	string	Catatan Parameter ini tidak tersedia secara publik.	1144775968548340
ServiceName	string	Catatan Parameter ini tidak tersedia secara publik.	name
UsedAmount	integer	Catatan Parameter ini tidak tersedia secara publik.	1
Tags	object
Tag	array<object>	Daftar pasangan kunci tag dan nilai tag yang terikat pada elasticity assurance.
	object	Informasi pasangan kunci tag dan nilai tag yang terikat pada elasticity assurance.
TagValue	string	Nilai tag.	TestValue
TagKey	string	Kunci tag.	TestKey
InstanceChargeType	string	Metode penagihan instans. Saat ini, hanya pay-as-you-go yang didukung. Nilai valid: PostPaid.	PostPaid
StartTimeType	string	Mode efektif elasticity assurance. Nilai valid: Now: berlaku segera. Later: berlaku pada pengatur waktu yang ditentukan.	Now
ElasticityAssuranceOwnerId	string	Catatan Parameter ini tidak tersedia secara publik.	e114477596854834
RecurrenceRules	object
RecurrenceRule	array<object>	Daftar aturan pengulangan untuk elasticity assurance pembagian waktu.
	object	Aturan pengulangan untuk elasticity assurance pembagian waktu.
RecurrenceType	string	Tipe kebijakan aturan pengulangan. Nilai valid: Daily: pengulangan harian. Weekly: pengulangan mingguan. Monthly: pengulangan bulanan.	Daily
RecurrenceValue	string	Nilai aturan pengulangan. Nilai valid: Jika RecurrenceType diatur ke Daily, hanya satu nilai yang dapat ditentukan. Nilai valid: 1 hingga 31. Nilai menunjukkan interval dalam hari. Jika RecurrenceType diatur ke Weekly, beberapa nilai dapat ditentukan dan dipisahkan dengan koma (,). Nilai untuk Minggu, Senin, Selasa, Rabu, Kamis, Jumat, dan Sabtu adalah 0, 1, 2, 3, 4, 5, dan 6. Misalnya, `1,2` menunjukkan Senin dan Selasa. Jika RecurrenceType diatur ke Monthly, formatnya adalah `A-B`. Nilai valid A dan B: 1 hingga 31. B harus lebih besar atau sama dengan A. Misalnya, `1-5` menunjukkan tanggal 1 hingga 5 setiap bulan.	1
StartHour	integer	Periode efektif assurance pembagian waktu.	4
EndHour	integer	Pengatur waktu berakhir assurance pembagian waktu.	10
PackageType	string	Tipe elasticity assurance. Nilai valid: ElasticityAssurance: elasticity assurance standar. TimeDivisionElasticityAssurance: elasticity assurance pembagian waktu.	ElasticityAssurance

Contoh

Respons sukses

JSONformat

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount": 1,
  "MaxResults": 10,
  "ElasticityAssuranceSet": {
    "ElasticityAssuranceItem": [
      {
        "Status": "Active",
        "PrivatePoolOptionsMatchCriteria": "Target",
        "PrivatePoolOptionsId": "eap-bp1ir35kqtn8ywci****",
        "UsedAssuranceTimes": 0,
        "LatestStartTime": "null",
        "PrivatePoolOptionsName": "eapTestName",
        "RegionId": "cn-hangzhou",
        "EndTime": "2021-12-03T16:00Z",
        "StartTime": "2020-12-03T05:25Z",
        "Description": "Ini adalah deskripsi",
        "ResourceGroupId": "rg-bp67acfmxazb4p****",
        "TotalAssuranceTimes": "Tanpa Batas",
        "AllocatedResources": {
          "AllocatedResource": [
            {
              "UsedAmount": 2,
              "TotalAmount": 2,
              "AvailableAmount": 5,
              "FailedAmount": 1,
              "LockedAmount": 1,
              "zoneId": "cn-hangzhou-h",
              "InstanceType": "ecs.c6.large",
              "ElasticityAssuranceUsages": {
                "ElasticityAssuranceUsage": [
                  {
                    "AccountId": "1144775968548340",
                    "ServiceName": "name",
                    "UsedAmount": 1
                  }
                ]
              }
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "TagValue": "TestValue",
              "TagKey": "TestKey"
            }
          ]
        },
        "InstanceChargeType": "PostPaid",
        "StartTimeType": "Now",
        "ElasticityAssuranceOwnerId": "e114477596854834",
        "RecurrenceRules": {
          "RecurrenceRule": [
            {
              "RecurrenceType": "Daily",
              "RecurrenceValue": "1",
              "StartHour": 4,
              "EndHour": 10
            }
          ]
        },
        "PackageType": "ElasticityAssurance"
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	MissingParameter.RegionId	The specified RegionId should not be null.	Parameter RegionId tidak boleh kosong.
400	InvalidParameter.Name	The specified PrivatePoolOptions.Name is invalid.
400	InvalidParameter.PrivatePoolOptions.Ids	The specified PrivatePoolOptions.Ids is invalid.
400	DedicatedHostNotSupported	DedicatedHost is not supported for PrivatePool.	Private pool tidak mendukung host khusus.
400	SpotNotSupported	Spot is not supported for PrivatePool.	Private pool tidak mendukung spot instans.
400	ClassicNetworkNotSupported	Classic network is not supported for PrivatePool.	Private pool tidak mendukung instans dengan jenis jaringan klasik.
400	Invalid.InstanceId	Instance does not exist.	Instans tidak cocok dengan private pool.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	Parameter PrivatePoolOptions.MatchCriteria yang ditentukan tidak cocok dengan private pool.
400	MissingParameter.PrivatePoolOptions.Id	The specified PrivatePoolOptions.Id should not be null.	Parameter PrivatePoolOptions.Id tidak boleh kosong.
400	Invalid.PrivatePoolOptions.Id	The PrivatePool does not exist.	Private pool tidak ada.
400	Invalid.InstanceType	The InstanceType does not match the PrivatePool.	Tipe instans tidak cocok dengan private pool.
400	Invalid.InstanceChargeType	The InstanceChargeType does not match the PrivatePool.	Parameter InstanceChargeType yang ditentukan tidak valid.
400	Invalid.ZoneId	The ZoneId does not match the PrivatePool.	Zona tidak cocok dengan private pool.
400	Invalid.PrivatePoolOptions.status	The PrivatePool has been used up.	Status private pool yang ditentukan tidak valid.
400	InvalidPlatform.ValueNotSupported	The Platform does not match the PrivatePool.	Parameter Platform yang ditentukan tidak cocok dengan private pool.
400	InvalidAliUid	The PrivatePool does not belong to the user of the Instance.	Private pool bukan milik pengguna yang membuat instans.
400	MissingParameter.PackageType	The specified parameter "PackageType" can not be empty.	Parameter PackageType tidak boleh kosong.
400	MissingParameter.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" can not be empty.	Parameter PrivatePoolOptions.ids yang ditentukan tidak boleh kosong.
400	MissingParameter.InstanceCpuCoreCount	The specified parameter "InstanceCpuCoreCount" can not be empty.	Parameter InstanceCpuCocount yang ditentukan tidak boleh kosong.
400	MissingParameter.InstanceAmount	The specified parameter "InstanceAmount" can not be empty.	Parameter InstanceAmount yang ditentukan tidak boleh kosong.
400	MissingParameter.InstanceCpuCoreCountOrInstanceAmount	The specified parameter "InstanceCpuCoreCount" and "InstanceAmount" must not be empty at the same time.	Parameter InstanceCpuCoreCount dan InstanceAmount tidak boleh kosong secara bersamaan.
400	Invalid.TooManyPrivatePoolOptions.Ids	Too many PrivatePoolOptions.Ids in this request.	Parameter PrivatePoolOptions.Ids melebihi batas atas.
400	Invalid.TooManyZoneIds	Too many ZoneIds in the request.	Parameter ZoneIds melebihi batas atas.
400	Invalid.TooManyInstanceTypes	Too many InstanceTypes in the request.	Parameter InstanceTypes melebihi batas atas.
400	Invalid.TooManyUnpaidPrivatePool	Too many PrivatePools create but still unpaid.	Beberapa private pool belum dibayar.
400	Invalid.InstanceCpuCoreCountOrInstanceAmount	Both InstanceCpuCoreCount and InstanceAmount are provided.	Parameter InstanceCpuCoreCount dan InstanceAmount tidak perlu ditentukan secara bersamaan.
400	Invalid.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" exist invalid element Id.	ID private pool yang ditentukan tidak ada.
400	Invalid.PackageType	The specified parameter "PackageType" is invalid.	Parameter PackageType yang ditentukan tidak valid.
400	Invalid.PrivatePool.Purchase	The PrivatePool has already paid.	Private pool sudah dibayar.
400	Invalid.AssuranceTimes.NotSupported	The value of AssuranceTimes is not supported.	Nilai parameter AssuranceTimes tidak didukung.
400	RepeatStartPrivatePool	PrivatePool has already been started.	Private pool sudah dimulai.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Terjadi error internal. Coba lagi.
404	InvalidResourceGroup.NotFound	The specified resource group is not found.	Kelompok sumber daya tidak ditemukan dalam catatan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.