ListProductQuotas - 查詢目標雲產品的配額列表 - Quota Center

查詢目標雲產品的配額列表。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

quotas:ListProductQuotas

list

*Quota

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

無

請求參數

名稱	類型	必填	描述	樣本值
NextToken	string	否	是否擁有下一次查詢的令牌（Token）。第一次查詢和沒有下一次查詢時，均無需填寫。如果有下一次查詢，取值為上一次 API 呼叫返回的 NextToken 值。	AAAAAd****
MaxResults	integer	否	本次查詢的最大記錄條數。取值範圍：1~100。預設值：30。	30
ProductCode	string	是	雲產品的縮寫名稱。說明關於如何擷取雲產品的縮寫名稱，請參見 ListProducts 中的`ProductCode`。	ecs
QuotaActionCode	string	否	配額 ID。	q_security-groups
KeyWord	string	否	配額的搜尋索引鍵。說明該參數僅針對Elastic Compute Service 規格配額（ecs-spec），搜尋範圍：`QuotaName`，`QuotaActionCode`。	security
SortField	string	否	配額支援的排序方式。說明該參數僅針對Elastic Compute Service 規格配額（ecs-spec），如果不設定，則為空白。枚舉值： TOTAL : 按總配額用量排序 TIME : 按最新動向時間排序 RESERVED : 按預留配額用量排序	TIME
SortOrder	string	否	配額支援的排序方式。說明該參數僅針對Elastic Compute Service 規格配額（ecs-spec），如果不設定，則為空白。枚舉值： Descending : 降序 Ascending : 升序	Ascending
Dimensions	array<object>	否	配額維度。
	object	否	配額維度。
Key	string	否	配額維度 Key。說明 N 的取值範圍取決於對應雲產品支援的維度個數。	regionId
Value	string	否	配額維度 Value。說明 N 的取值範圍取決於對應雲產品支援的維度個數。	cn-hangzhou
QuotaCategory	string	否	配額種類。預設值：CommonQuota。枚舉值： FlowControl : API 速率配額 WhiteListLabel : 權益配額 CommonQuota : 通用配額	FlowControl
GroupCode	string	否	維度組代碼。	entconsole_w1j3ms****

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
MaxResults	integer	本次查詢返回的最大記錄條數。	1
NextToken	string	是否擁有下一次查詢的令牌（Token）。如果 NextToken 為空白表示沒有下一次查詢。如果 NextToken 有傳回值，該取值表示下一次查詢開始的令牌。	AAAAAd****
Quotas	array<object>	配額詳情。
	array<object>	配額詳情。
Adjustable	boolean	配額是否可調整。枚舉值： true : 配額可調整 false : 配額不可調整	true
ApplicableRange	array	當前配額項可申請的配額值區間，用於配額申請時進行參考。
	number	當前配額項可申請的配額值區間。排除目前使用者已有區間，用於申請配額時進行參考，例如：`[1010,10000]`。	[1010,10000]
ApplicableType	string	配額調整類型。枚舉值： continuous : 連續 discontinuous : 間斷	discontinuous
ApplyReasonTips	string	申請配額調整理由樣本。	The business xxx is expected to grow by 50%.
Consumable	boolean	是否顯示“已使用”的配額。枚舉值： true : 顯示“已使用”的配額 false : 不顯示“已使用”的配額	true
Dimensions	object	配額維度。格式：`{"regionId":"地區"}`。	{"regionId":"cn-hangzhou"}
EffectiveTime	string	配額生效的 UTC 時間。	2022-09-28T06:07:00Z
ExpireTime	string	配額失效的 UTC 時間。	2022-09-29T06:07:00Z
GlobalQuota	boolean	是否為全域配額。枚舉值： true : 該配額項為所有 Region 共用 false : 該配額項為每個 Region 獨立	true
Period	object	配額計算周期。
PeriodUnit	string	配額計算周期的單位。枚舉值： week : 周 hour : 小時 day : 天 second : 秒 minute : 分鐘	day
PeriodValue	integer	配額計算周期的取值。	{}
ProductCode	string	雲產品名稱縮寫。	ecs
QuotaActionCode	string	配額 ID。	q_security-groups
QuotaArn	string	配額 ARN。	acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups
QuotaCategory	string	配額類型。枚舉值： FlowControl : API 速率配額 WhiteListLabel : 權益配額 CommonQuota : 通用配額	CommonQuota
QuotaDescription	string	配額描述。	The maximum number of security groups that can be owned by the current account.
QuotaItems	array<object>	配額詳情。
	object	配額詳情。
Quota	string	配額值。	1009
QuotaUnit	string	配額單位。	Count
Type	string	配額類別。枚舉值： BaseQuota : 保障配額 ReservedQuota : 預留配額	BaseQuota
Usage	string	配額用量。	1009
QuotaName	string	配額名稱。	ecs.g5.2xlarge
QuotaType	string	配額類型。枚舉值： normal : 普通 privilege : 特權	privilege
QuotaUnit	string	配額單位。	AMOUNT
SupportedRange	array	當前配額項支援的配額值區間，用於配置配額範本時進行參考。
	number	當前配額項支援的配額值區間，用於配置配額範本時進行參考。當 ApplicableType 為 continuous 時，如果取值為[1009,10000]，則表示取值為 1009~10000 中的所有數。當 ApplicableType 為 discontinuous 時，如果取值為[10,20,50,100]，則表示取值僅為 10、20、50 和 100。	[1009,10000]
TotalQuota	number	配額值。	200
TotalUsage	number	配額用量。	1009
UnadjustableDetail	string	配額不可調整原因。枚舉值： limitReached : 已達配額上限 nonactivated : 未開通服務 applicationProcess : 配額申請處理中	applicationProcess
UsageMetric	object	配額用量在CloudMonitor（CloudMonitor）中的監控資訊。說明空表示CloudMonitor中無此配額監控資料。
MetricDimensions	object	CloudMonitor 監控維度。格式：`key:value`索引值對形式的集合，例如： `{"productCode":"*","metricKey":"","regionId":"","label":"*"}`。
	string	CloudMonitor 監控維度值。	ecs
MetricName	string	CloudMonitor 監控項名稱。	Usage
MetricNamespace	string	CloudMonitor 監控資料命名空間。	acs_quotas_flowcontrol
RequestId	string	請求 ID。	D0131FD5-5397-44FE-BF5A-4B7165B813CC
TotalCount	integer	本次請求返回的全部記錄條數。	1

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidSortOrder	Invalid SortOrder	參數SortOrder無效。
400	INVALID.MAX.RESULTS	The maxResults parameter is invalid. Use an integer ranging from 1 to 100.	maxResults參數不合法，請使用1~100範圍內的整數。
400	DIMENSIONGROUP.NOT.FOUND	Dimension group does not exist.	維度組參數不正確

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。