Kueri kuota produk menggunakan ListProductQuotas - Quota Center - Alibaba Cloud - Quota Center

Mengkueri kuota layanan cloud tertentu.

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

quotas:ListProductQuotas

list

*Quota

acs:quotas:{#regionId}:{#accountId}:quota/{#ProductCode}/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
NextToken	string	No	Token yang digunakan untuk mengambil halaman hasil berikutnya. Kosongkan parameter ini untuk permintaan pertama atau ketika tidak ada lagi hasil yang tersedia. Jika masih ada hasil yang tersedia, atur parameter ini ke nilai NextToken yang dikembalikan saat Anda memanggil API sebelumnya.	AAAAAd****
MaxResults	integer	No	Jumlah maksimum entri yang dikembalikan dalam satu permintaan. Nilai valid: 1 hingga 100. Nilai default: 30.	30
ProductCode	string	Yes	Singkatan layanan cloud. Catatan Untuk informasi selengkapnya tentang cara mendapatkan singkatan layanan cloud, lihat `ProductCode` di ListProducts.	ecs
QuotaActionCode	string	No	ID kuota.	q_security-groups
KeyWord	string	No	Kata kunci pencarian untuk kuota. Catatan Parameter ini hanya berlaku untuk kuota tipe instans server Elastic Computing Service (ecs-spec). Cakupan pencarian mencakup `QuotaName` dan `QuotaActionCode`.	security
SortField	string	No	Metode pengurutan yang didukung oleh kuota. Catatan Parameter ini hanya berlaku untuk kuota tipe instans server Elastic Computing Service (ecs-spec). Jika tidak ada Pengaturan yang ditentukan, parameter ini akan dikosongkan. Valid values: TOTAL : urutkan berdasarkan penggunaan kuota total. TIME : urutkan berdasarkan waktu pembaruan terakhir. RESERVED : urutkan berdasarkan penggunaan kuota yang dicadangkan.	TIME
SortOrder	string	No	Metode pengurutan yang didukung oleh kuota. Catatan Parameter ini hanya berlaku untuk kuota tipe instans server Elastic Computing Service (ecs-spec). Jika tidak ada Pengaturan yang ditentukan, parameter ini akan dikosongkan. Valid values: Descending : urutan menurun. Ascending : urutan menaik.	Ascending
Dimensions	array<object>	No	Dimensi kuota.
	object	No	Dimensi kuota.
Key	string	No	Kunci dimensi kuota. Catatan Rentang nilai N bergantung pada jumlah dimensi yang didukung oleh layanan cloud terkait.	regionId
Value	string	No	Nilai dimensi kuota. Catatan Rentang nilai N bergantung pada jumlah dimensi yang didukung oleh layanan cloud terkait.	cn-hangzhou
QuotaCategory	string	No	Kategori kuota. Nilai default: CommonQuota. Valid values: FlowControl : Batas laju API. WhiteListLabel : hak istimewa. CommonQuota : kuota umum.	FlowControl
GroupCode	string	No	Kode kelompok dimensi.	entconsole_w1j3ms****

Elemen respons

Element	Type	Description	Example
	object	Tanggapan.
MaxResults	integer	Jumlah maksimum rekaman yang dikembalikan untuk kueri saat ini.	1
NextToken	string	Apakah token untuk kueri berikutnya tersedia. Jika NextToken kosong, ini menunjukkan bahwa tidak ada kueri berikutnya yang tersedia. Jika NextToken dikembalikan, nilainya adalah token yang digunakan untuk memulai kueri berikutnya.	AAAAAd****
Quotas	array<object>	Detail kuota.
	array<object>	Detail kuota.
Adjustable	boolean	Apakah kuota dapat disesuaikan. Valid values: true : Kuota dapat disesuaikan. false : Kuota tidak dapat disesuaikan.	true
ApplicableRange	array	Rentang nilai kuota yang dapat diajukan untuk item kuota saat ini, yang berfungsi sebagai referensi untuk pengajuan kuota.
	number	Rentang nilai kuota yang dapat diajukan untuk item kuota saat ini. Rentang ini tidak mencakup rentang yang sudah ada dari pengguna saat ini dan berfungsi sebagai referensi untuk pengajuan kuota. Contoh: `[1010,10000]`.	[1010,10000]
ApplicableType	string	Tipe penyesuaian kuota. Valid values: continuous : Kontinu. discontinuous : Diskontinu.	discontinuous
ApplyReasonTips	string	Contoh alasan untuk mengajukan penyesuaian kuota.	The business xxx is expected to grow by 50%.
Consumable	boolean	Apakah kuota yang digunakan ditampilkan. Valid values: true : Kuota yang digunakan ditampilkan. false : Kuota yang digunakan tidak ditampilkan.	true
Dimensions	object	Dimensi kuota. Format: `{"regionId":"Wilayah"}`.	{"regionId":"cn-hangzhou"}
EffectiveTime	string	Pengatur waktu UTC saat kuota berlaku.	2022-09-28T06:07:00Z
ExpireTime	string	Pengatur waktu UTC saat kuota kedaluwarsa.	2022-09-29T06:07:00Z
GlobalQuota	boolean	Apakah kuota merupakan kuota global. Valid values: true : Item kuota dibagikan di semua wilayah. false : Item kuota bersifat independen untuk setiap wilayah.	true
Period	object	Periode perhitungan kuota.
PeriodUnit	string	Unit periode perhitungan kuota. Valid values: week : Minggu. hour : Jam. day : Hari. second : Detik. minute : Menit.	day
PeriodValue	integer	Nilai periode perhitungan kuota.	{}
ProductCode	string	Singkatan nama layanan cloud.	ecs
QuotaActionCode	string	ID kuota.	q_security-groups
QuotaArn	string	Nama Sumber Daya Alibaba Cloud kuota.	acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups
QuotaCategory	string	Tipe kuota. Valid values: FlowControl : Batas laju API. WhiteListLabel : hak istimewa. CommonQuota : kuota umum.	CommonQuota
QuotaDescription	string	Deskripsi kuota.	The maximum number of security groups that can be owned by the current account.
QuotaItems	array<object>	Detail kuota.
	object	Detail kuota.
Quota	string	The quota value.	1009
QuotaUnit	string	Unit kuota.	Count
Type	string	Kategori kuota. Valid values: BaseQuota : Kuota dasar. ReservedQuota : Kuota cadangan.	BaseQuota
Usage	string	Penggunaan kuota.	1009
QuotaName	string	Nama kuota.	ecs.g5.2xlarge
QuotaType	string	Tipe kuota. Valid values: normal : Normal. privilege : Hak istimewa.	privilege
QuotaUnit	string	Unit kuota.	AMOUNT
SupportedRange	array	Rentang nilai kuota yang didukung oleh item kuota saat ini, yang berfungsi sebagai referensi saat Anda mengonfigurasi templat kuota.
	number	Rentang nilai kuota yang didukung oleh item kuota saat ini, yang berfungsi sebagai referensi saat Anda mengonfigurasi templat kuota. Jika ApplicableType adalah continuous dan nilainya adalah [1009,10000], ini menunjukkan semua angka dari 1009 hingga 10000. Jika ApplicableType adalah discontinuous dan nilainya adalah [10,20,50,100], ini hanya menunjukkan nilai 10, 20, 50, dan 100.	[1009,10000]
TotalQuota	number	Nilai kuota.	200
TotalUsage	number	Penggunaan kuota.	1009
UnadjustableDetail	string	Alasan mengapa kuota tidak dapat disesuaikan. Valid values: limitReached : Batas kuota telah tercapai. nonactivated : Layanan tidak diaktifkan. applicationProcess : Pengajuan kuota sedang diproses.	applicationProcess
UsageMetric	object	Informasi pemantauan penggunaan kuota di CloudMonitor. Catatan Nilai kosong menunjukkan bahwa tidak ada data pemantauan yang tersedia untuk kuota ini di CloudMonitor.
MetricDimensions	object	Dimensi data deret waktu pemantauan CloudMonitor. Format: kumpulan pasangan `kunci:nilai`. Contoh: `{"productCode":"*","metricKey":"","regionId":"","label":"*"}`.
	string	Nilai dimensi pemantauan CloudMonitor.	ecs
MetricName	string	Nama data deret waktu pemantauan CloudMonitor.	Usage
MetricNamespace	string	Namespace data pemantauan CloudMonitor.	acs_quotas_flowcontrol
RequestId	string	ID permintaan.	D0131FD5-5397-44FE-BF5A-4B7165B813CC
TotalCount	integer	Jumlah total rekaman yang dikembalikan untuk permintaan saat ini.	1

Contoh

Respons sukses

JSONformat

{
  "MaxResults": 1,
  "NextToken": "AAAAAd****",
  "Quotas": [
    {
      "Adjustable": true,
      "ApplicableRange": [
        0
      ],
      "ApplicableType": "discontinuous",
      "ApplyReasonTips": "The business xxx is expected to grow by 50%.",
      "Consumable": true,
      "Dimensions": {
        "regionId": "cn-hangzhou"
      },
      "EffectiveTime": "2022-09-28T06:07:00Z",
      "ExpireTime": "2022-09-29T06:07:00Z",
      "GlobalQuota": true,
      "Period": {
        "PeriodUnit": "day",
        "PeriodValue": 0
      },
      "ProductCode": "ecs",
      "QuotaActionCode": "q_security-groups",
      "QuotaArn": "acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups",
      "QuotaCategory": "CommonQuota",
      "QuotaDescription": "The maximum number of security groups that can be owned by the current account.",
      "QuotaItems": [
        {
          "Quota": "1009",
          "QuotaUnit": "Count",
          "Type": "BaseQuota",
          "Usage": "1009"
        }
      ],
      "QuotaName": "ecs.g5.2xlarge",
      "QuotaType": "privilege",
      "QuotaUnit": "AMOUNT",
      "SupportedRange": [
        0
      ],
      "TotalQuota": 200,
      "TotalUsage": 1009,
      "UnadjustableDetail": "applicationProcess",
      "UsageMetric": {
        "MetricDimensions": {
          "key": "ecs"
        },
        "MetricName": "Usage",
        "MetricNamespace": "acs_quotas_flowcontrol"
      }
    }
  ],
  "RequestId": "D0131FD5-5397-44FE-BF5A-4B7165B813CC",
  "TotalCount": 1
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidSortOrder	Invalid SortOrder
400	INVALID.MAX.RESULTS	The maxResults parameter is invalid. Use an integer ranging from 1 to 100.
400	DIMENSIONGROUP.NOT.FOUND	Dimension group does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.