ListProductQuotas - - Alibaba Cloud Dokümantasyon Merkezi

Belirtilen bir bulut hizmetinin kotalarını sorgular.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

quotas:ListProductQuotas

list

*Quota

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

None

Request parameters

Parameter	Type	Required	Description	Example
NextToken	string	No	Sonuçların bir sonraki sayfasını almak için kullanılan belirteç.\n\n- İlk istek için veya kullanılabilecek başka sonuç olmadığında bu parametreyi boş bırakın.\n- Daha fazla sonuç varsa, bu parametreyi önceki API çağrısını gerçekleştirdiğinizde döndürülen NextToken değerine ayarlayın.	AAAAAd****
MaxResults	integer	No	Tek bir istekte döndürülecek en fazla giriş sayısı.\n\nGeçerli değerler: 1 ile 100 arası. Varsayılan değer: 30.	30
ProductCode	string	Yes	Bulut hizmetinin kısaltması.\n\n> Bir bulut hizmetinin kısaltmasının nasıl alınacağı hakkında daha fazla bilgi için ListProducts içindeki `ProductCode` parametresine bakın.	ecs
QuotaActionCode	string	No	Kotanın kimliği.	q_security-groups
KeyWord	string	No	Kota için arama anahtar sözcüğü.\n> Bu parametre yalnızca Elastic Computing Service sunucu örnek türü kotaları (ecs-spec) için geçerlidir. Arama kapsamı `QuotaName` ve `QuotaActionCode` alanlarını içerir.	security
SortField	string	No	Kota tarafından desteklenen sıralama yöntemi.\n\n> Bu parametre yalnızca Elastic Computing Service sunucu örnek türü kotaları (ecs-spec) için geçerlidir. Herhangi bir ayar belirtilmezse boş bırakılır. Valid values: TOTAL : Toplam kota kullanımına göre sıralama. TIME : Son güncelleme zamanına göre sıralama. RESERVED : Ayrılmış kota kullanımına göre sıralama.	TIME
SortOrder	string	No	Kota tarafından desteklenen sıralama yöntemi.\n\n> Bu parametre yalnızca Elastic Computing Service sunucu örnek türü kotaları (ecs-spec) için geçerlidir. Herhangi bir ayar belirtilmezse boş bırakılır. Valid values: Descending : Azalan sıra. Ascending : Artan sıra.	Ascending
Dimensions	array<object>	No	Kota boyutları.
	object	No	Kota boyutları.
Key	string	No	Kota boyutunun anahtarı.\n\n> N'nin değer aralığı, ilgili bulut hizmeti tarafından desteklenen boyut sayısına bağlıdır.	regionId
Value	string	No	Kota boyutunun değeri.\n\n> N'nin değer aralığı, ilgili bulut hizmeti tarafından desteklenen boyut sayısına bağlıdır.	cn-hangzhou
QuotaCategory	string	No	Kota kategorisi.\n\nVarsayılan değer: CommonQuota. Valid values: FlowControl : API hız sınırı. WhiteListLabel : Ayrıcalık. CommonQuota : Genel kota.	FlowControl
GroupCode	string	No	Boyut grubunun kodu.	entconsole_w1j3ms****

Response elements

Element	Type	Description	Example
	object	Yanıt.
MaxResults	integer	Mevcut sorgu için döndürülen maksimum kayıt sayısı.	1
NextToken	string	Bir sonraki sorgu için bir belirteç olup olmadığını gösterir. NextToken boşsa, sonraki bir sorgunun olmadığını gösterir. NextToken döndürülürse, değer bir sonraki sorguyu başlatmak için kullanılan belirteçtir.	AAAAAd****
Quotas	array<object>	Kota ayrıntıları.
	array<object>	Kota ayrıntıları.
Adjustable	boolean	Kotanın ayarlanabilir olup olmadığını gösterir. Valid values: true : Kota ayarlanabilir. false : Kota ayarlanabilir değildir.	true
ApplicableRange	array	Mevcut kota öğesi için başvurulabilecek kota değerleri aralığı; kota başvuruları için referans görevi görür.
	number	Mevcut kota öğesi için başvurulabilecek kota değerleri aralığı. Bu aralık, mevcut kullanıcının mevcut aralığı hariçtir ve kota başvuruları için referans görevi görür. Örnek: `[1010,10000]`.	[1010,10000]
ApplicableType	string	Kota ayarlama türü. Valid values: continuous : Sürekli. discontinuous : Süreksiz.	discontinuous
ApplyReasonTips	string	Kota ayarlaması başvurusu için örnek nedenler.	The business xxx is expected to grow by 50%.
Consumable	boolean	Kullanılan kotanın görüntülenip görüntülenmediğini gösterir. Valid values: true : Kullanılan kota görüntülenir. false : Kullanılan kota görüntülenmez.	true
Dimensions	object	Kota boyutları. Biçim: `{"regionId":"region"}`.	{"regionId":"cn-hangzhou"}
EffectiveTime	string	Kotanın yürürlüğe girdiği UTC saati.	2022-09-28T06:07:00Z
ExpireTime	string	Kotanın sona erdiği UTC saati.	2022-09-29T06:07:00Z
GlobalQuota	boolean	Kotanın global bir kota olup olmadığını gösterir. Valid values: true : Kota öğesi tüm bölgeler arasında paylaşılır. false : Kota öğesi her bölge için bağımsızdır.	true
Period	object	Kota hesaplama dönemi.
PeriodUnit	string	Kota hesaplama döneminin birimi. Valid values: week : Hafta. hour : Saat. day : Gün. second : Saniye. minute : Dakika.	day
PeriodValue	integer	Kota hesaplama döneminin değeri.	{}
ProductCode	string	Bulut hizmeti adının kısaltması.	ecs
QuotaActionCode	string	Kotanın kimliği.	q_security-groups
QuotaArn	string	Kotanın ARN'si.	acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups
QuotaCategory	string	Kota türü. Valid values: FlowControl : API hız sınırı. WhiteListLabel : Ayrıcalık. CommonQuota : Genel kota.	CommonQuota
QuotaDescription	string	Kota açıklaması.	The maximum number of security groups that can be owned by the current account.
QuotaItems	array<object>	Kota ayrıntıları.
	object	Kota ayrıntıları.
Quota	string	Kota değeri.	1009
QuotaUnit	string	Kota birimi.	Count
Type	string	Kota kategorisi. Valid values: BaseQuota : Temel kota. ReservedQuota : Ayrılmış kota.	BaseQuota
Usage	string	Kota kullanımı.	1009
QuotaName	string	Kota adı.	ecs.g5.2xlarge
QuotaType	string	Kota türü. Valid values: normal : Normal. privilege : Ayrıcalık.	privilege
QuotaUnit	string	Kota birimi.	AMOUNT
SupportedRange	array	Mevcut kota öğesi tarafından desteklenen kota değerleri aralığı; bir kota şablonu yapılandırırken referans görevi görür.
	number	Mevcut kota öğesi tarafından desteklenen kota değerleri aralığı; bir kota şablonu yapılandırırken referans görevi görür. ApplicableType sürekliyse ve değer [1009,10000] ise, 1009'dan 10000'e kadar olan tüm sayıları gösterir. ApplicableType süreksizse ve değer [10,20,50,100] ise, yalnızca 10, 20, 50 ve 100 değerlerini gösterir.	[1009,10000]
TotalQuota	number	Kota değeri.	200
TotalUsage	number	Kota kullanımı.	1009
UnadjustableDetail	string	Kotanın ayarlanabilir olmamasının nedeni. Valid values: limitReached : Kota sınırına ulaşıldı. nonactivated : Hizmet etkinleştirilmedi. applicationProcess : Kota başvurusu işleniyor.	applicationProcess
UsageMetric	object	CloudMonitor'daki kota kullanımının izleme bilgileri. Not Boş bir değer, CloudMonitor'da bu kota için izleme verisi olmadığını gösterir.
MetricDimensions	object	CloudMonitor izleme boyutları. Biçim: `anahtar:değer` çiftlerinden oluşan bir koleksiyon. Örnek: `{"productCode":"*","metricKey":"","regionId":"","label":"*"}`.
	string	CloudMonitor izleme boyutu değerleri.	ecs
MetricName	string	CloudMonitor izleme metriğinin adı.	Usage
MetricNamespace	string	CloudMonitor izleme verilerinin ad alanı.	acs_quotas_flowcontrol
RequestId	string	İstek kimliği.	D0131FD5-5397-44FE-BF5A-4B7165B813CC
TotalCount	integer	Mevcut istek için döndürülen toplam kayıt sayısı.	1

Examples

Success response

JSON format

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

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidSortOrder	Invalid SortOrder	SortOrder parametresi geçersiz.
400	INVALID.MAX.RESULTS	The maxResults parameter is invalid. Use an integer ranging from 1 to 100.	maxResults parametresi geçersiz. 1 ile 100 arasında bir tam sayı belirtin.
400	DIMENSIONGROUP.NOT.FOUND	Dimension group does not exist.	Boyut grubu parametresi geçersiz.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.