GetProductQuota - 查詢目標雲產品的配額詳情 - Quota Center

查詢目標雲產品的配額詳情。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

quotas:GetProductQuota

get

*Quota

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

無

請求參數

名稱	類型	必填	描述	樣本值
ProductCode	string	是	雲產品的縮寫名稱。說明關於如何擷取雲產品的縮寫名稱，請參見 ListProducts 中的`ProductCode`。	ecs
QuotaActionCode	string	是	配額 ID。說明關於如何擷取目標雲產品的配額 ID，請參見 ListProductQuotas 中的`QuotaActionCode`。	q_security-groups
Dimensions	array<object>	否	配額維度。配額項的屬性，維度（Dimensions）+配額 ID（QuotaActionCode）確定唯一的配額項。說明部分雲產品維度必填。雲產品的配額是什麼，以及配額是否必填可以從 ListProductQuotaDimensions 擷取，返回參數`Requisite`表示該維度是否必填。	{\"regionId\":\"cn-beijing\"}
	object	否	配額維度。
Key	string	否	配額維度 Key。說明 `Dimensions.N.Key`和`Dimensions.N.Value`必須同時設定。N 的取值範圍取決於對應雲產品支援的維度個數。您可以通過 ListProductQuotaDimensions 查詢雲產品支援的配額維度，返回數組長度就是 N。	regionId
Value	string	否	配額維度 Value。說明 `Dimensions.N.Key`和`Dimensions.N.Value`必須同時設定。N 的取值範圍取決於對應雲產品支援的維度個數。您可以通過 ListProductQuotaDimensions 查詢雲產品支援的配額維度，返回數組長度就是 N。	cn-hangzhou

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
Quota	object	配額詳情。
Adjustable	boolean	配額是否可調整。取值： true：可調整。 false：不可調整。	true
ApplicableRange	array	配額調整範圍。
	number	配額調整範圍。例如：`[802,10000]`。	802
ApplicableType	string	配額調整類型。取值： continuous：連續。 discontinuous：間斷。	continuous
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:06:00Z
ExpireTime	string	配額失效的 UTC 時間。	2022-09-29T06:06:00Z
GlobalQuota	boolean	是否為全域配額。取值： true：該配額項為所有 Region 共用。 false：該配額項為每個 Region 獨立。	true
Period	object	配額周期。
PeriodUnit	string	配額周期的單位。取值： second：秒。 minute：分鐘。 hour：小時。 day：天。 week：周。	day
PeriodValue	integer	配額周期的取值。	1
ProductCode	string	雲產品名稱縮寫。	ecs
QuotaActionCode	string	配額 ID。	q_security-groups
QuotaArn	string	配額 ARN。	acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups/
QuotaCategory	string	配額種類。取值： CommonQuota：通用配額。 FlowControl：API 速率配額。 WhiteListLabel：權益配額。	CommonQuota
QuotaDescription	string	配額描述。	The maximum number of security groups that can be owned by the current account.
QuotaItems	array<object>	配額詳情。
	object	配額類別。
Quota	string	配額值。	801
QuotaUnit	string	配額單位。說明每個配額的單位不同。例如：Container Service Kubernetes 版的配額`q_cbdch3`（最大叢集數）單位為 Cluster，Elastic Compute Service 的配額`q_security-groups`（安全性群組總數量上限）單位為個。	Count
Type	string	配額類別。取值： BaseQuota：保障配額。 ReservedQuota：預留配額。	BaseQuota
Usage	string	配額用量。	26
QuotaName	string	配額名稱。	Maximum Number of Security Groups
QuotaType	string	配額類型。取值： privilege：特權。 normal：普通。	normal
QuotaUnit	string	配額單位。說明每個配額的單位不同。例如：Container Service Kubernetes 版的配額`q_cbdch3`（最大叢集數）單位為 Cluster，Elastic Compute Service 的配額`q_security-groups`（安全性群組總數量上限）單位為個。	Count
SupportedRange	array	當前配額項支援的配額值區間，用於配置配額範本時進行參考。
	number	當前配額項支援的配額值區間，用於配置配額範本時進行參考。當 ApplicableType 為 continuous 時，如果取值為[802,1000]，則表示取值為 802~1000 中的所有整數。當 ApplicableType 為 discontinuous 時，如果取值為[10,20,50,100]，則表示取值僅為 10、20、50 和 100。	[802,1000]
TotalQuota	number	配額值。	801
TotalUsage	number	配額用量。	26
UnadjustableDetail	string	配額不可調整原因。取值： nonactivated：未開通服務。 applicationProcess：配額申請處理中。 limitReached：已達配額上限。 supportTicketRequired：需要提工單申請。	limitReached
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。	8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3

樣本

正常返回樣本

JSON格式

{
  "Quota": {
    "Adjustable": true,
    "ApplicableRange": [
      802
    ],
    "ApplicableType": "continuous",
    "ApplyReasonTips": "The business xxx is expected to grow by 50%.",
    "Consumable": true,
    "Dimensions": {
      "regionId": "cn-hangzhou"
    },
    "EffectiveTime": "2022-09-28T06:06:00Z",
    "ExpireTime": "2022-09-29T06:06:00Z",
    "GlobalQuota": true,
    "Period": {
      "PeriodUnit": "day",
      "PeriodValue": 1
    },
    "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": "801",
        "QuotaUnit": "Count",
        "Type": "BaseQuota",
        "Usage": "26"
      }
    ],
    "QuotaName": "Maximum Number of Security Groups",
    "QuotaType": "normal",
    "QuotaUnit": "Count",
    "SupportedRange": [
      0
    ],
    "TotalQuota": 801,
    "TotalUsage": 26,
    "UnadjustableDetail": "limitReached",
    "UsageMetric": {
      "MetricDimensions": {
        "key": "ecs"
      },
      "MetricName": "Usage",
      "MetricNamespace": "acs_quotas_flowcontrol"
    }
  },
  "RequestId": "8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3"
}

錯誤碼

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

變更歷史

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