全部產品
Search

搜尋本產品

    Elastic Compute Service：DescribeAccountAttributes - 查詢資源配額

    文件中心

    Elastic Compute Service：DescribeAccountAttributes - 查詢資源配額

    更新時間：Apr 04, 2026

    查詢您在一個阿里雲地區下能建立的ECS資源配額。包括您能建立的安全性群組數量、彈性網卡數量、隨用隨付vCPU核心數、搶佔式執行個體vCPU核心數、隨用隨付雲端硬碟總容量配額、專用宿主機數量、網路類型以及帳號是否已完成實名認證。

    介面說明

    註冊了阿里雲帳號後，您可以在不同的阿里雲地區中建立一定數量的 ECS 資源，更多資訊，請參見使用限制。

    您也可以根據自己的需求，在配額中心申請提高資源使用配額。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ecs:DescribeAccountAttributes

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。

    cn-hangzhou
    ZoneId

    string

    否

    可用性區域 ID。

    cn-hangzhou-b
    AttributeName

    array

    否

    查詢某類資源在指定地區下的使用配額，N 的取值範圍為 1~8。取值範圍：

    • instance-network-type：可選擇的網路類型。

    • max-security-groups：安全性群組數量。

    • max-elastic-network-interfaces：彈性網卡的數量。

    • max-postpaid-instance-vcpu-count：隨用隨付執行個體的 vCPU 核心數上限。

    • max-spot-instance-vcpu-count：搶佔式執行個體 vCPU 核心數上限。

    • used-postpaid-instance-vcpu-count：已使用隨用隨付執行個體的 vCPU 核心數。

    • used-spot-instance-vcpu-count：已使用搶佔式執行個體 vCPU 核心數。

    • max-postpaid-yundisk-capacity：用作資料盤的隨用隨付雲端硬碟的總容量上限。（該參數值已棄用）

    • used-postpaid-yundisk-capacity：已使用的用作資料盤的隨用隨付雲端硬碟容量。（該參數值已棄用）

    • max-dedicated-hosts：專用宿主機數量。

    • supported-postpaid-instance-types：隨用隨付 I/O 最佳化執行個體規格。

    • max-axt-command-count：雲助手命令的數量。

    • max-axt-invocation-daily：每天可以執行的雲助手命令次數。

    • real-name-authentication：帳號是否完成了實名認證。

      說明

      您只有完成了實名認證才可以在中國內地地區中建立 ECS 執行個體。

    • max-cloud-assistant-activation-count：可建立的雲助手受管理的執行個體啟用碼數量上限。

    預設值為空白。

    max-security-groups

    string

    否

    查詢某類資源在指定地區下的使用配額，N 的取值範圍為 1~8。取值範圍：

    • instance-network-type：可選擇的網路類型。

    • max-security-groups：安全性群組數量。

    • max-elastic-network-interfaces：彈性網卡的數量。

    • max-postpaid-instance-vcpu-count：隨用隨付執行個體的 vCPU 核心數上限。

    • max-spot-instance-vcpu-count：搶佔式執行個體 vCPU 核心數上限。

    • used-postpaid-instance-vcpu-count：已使用隨用隨付執行個體的 vCPU 核心數。

    • used-spot-instance-vcpu-count：已使用搶佔式執行個體 vCPU 核心數。

    • max-postpaid-yundisk-capacity：用作資料盤的隨用隨付雲端硬碟的總容量上限。（該參數值已棄用）

    • used-postpaid-yundisk-capacity：已使用的用作資料盤的隨用隨付雲端硬碟容量。（該參數值已棄用）

    • max-dedicated-hosts：專用宿主機數量。

    • supported-postpaid-instance-types：隨用隨付 I/O 最佳化執行個體規格。

    • max-axt-command-count：雲助手命令的數量。

    • max-axt-invocation-daily：每天可以執行的雲助手命令次數。

    • max-cloud-assistant-activation-count：可建立的雲助手受管理的執行個體啟用碼數量上限。

    • real-name-authentication：帳號是否完成了實名認證。

      說明

      您只有完成了實名認證才可以在中國內地地區中建立 ECS 執行個體。

    預設值為空白。

    max-security-groups

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    8CE45CD5-31FB-47C2-959D-CA8144CE****
    AccountAttributeItems

    object

    AccountAttributeItem

    array<object>

    指定地區下帳號特權 AccountAttributeItem 的資訊集合。

    array<object>

    AttributeName

    string

    資源在指定地區下的使用配額分類。可能值：

    • instance-network-type：可選擇的網路類型。

    • max-security-groups：安全性群組數量。

    • max-elastic-network-interfaces：彈性網卡的數量。

    • max-postpaid-instance-vcpu-count：隨用隨付執行個體的 vCPU 核心數上限。

    • max-spot-instance-vcpu-count：搶佔式執行個體 vCPU 核心數上限。

    • used-postpaid-instance-vcpu-count：已使用隨用隨付執行個體的 vCPU 核心數。

    • used-spot-instance-vcpu-count：已使用搶佔式執行個體 vCPU 核心數。

    • max-postpaid-yundisk-capacity：用作資料盤的隨用隨付雲端硬碟的總容量上限。（該參數值已棄用）

    • used-postpaid-yundisk-capacity：已使用的用作資料盤的隨用隨付雲端硬碟容量。（該參數值已棄用）

    • max-dedicated-hosts：專用宿主機數量。

    • supported-postpaid-instance-types：隨用隨付 I/O 最佳化執行個體規格。

    • max-axt-command-count：雲助手命令的數量。

    • max-axt-invocation-daily：每天可以執行的雲助手命令次數。

    • real-name-authentication：帳號是否完成了實名認證。

    • max-cloud-assistant-activation-count：可建立的雲助手受管理的執行個體啟用碼數量上限。

    max-security-groups
    AttributeValues

    object

    ValueItem

    array<object>

    資源的使用配額具體數值。

    object

    DiskCategory

    string

    資料盤的雲端硬碟種類。可能值：

    • cloud_efficiency：高效雲端硬碟。

    • cloud_ssd：SSD 雲端硬碟。

    • cloud_essd：ESSD 雲端硬碟。

    cloud_ssd
    Value

    string

    當前地區下某類資源的使用配額具體數值。可能值：

    以下分類傳回值為 0 或正整數：

    • max-security-groups

    • max-elastic-network-interfaces

    • max-postpaid-instance-vcpu-count

    • max-spot-instance-vcpu-count

    • used-postpaid-instance-vcpu-count

    • used-spot-instance-vcpu-count

    • max-postpaid-yundisk-capacity（該參數值已棄用）

    • used-postpaid-yundisk-capacity（該參數值已棄用）

    • max-dedicated-hosts

    • max-axt-command-count

    • max-axt-invocation-daily

    • max-cloud-assistant-activation-count

    分類為 supported-postpay-instance-types 時傳回值：執行個體規格取值。參見執行個體規格類型系列。

    分類為 real-name-authentications 時傳回值：

    • yes

    • none

    • unnecessary

    分類為 instance-network-type 時傳回值：

    • vpc

    • classic

    800
    ExpiredTime

    string

    特權到期時間，僅存在到期時間的帳號特權會返回該參數。按照ISO 8601標準表示，並使用 UTC +0 時間。格式為 yyyy-MM-ddTHH:mm:ssZ。

    2019-01-01T12:30:00Z
    ZoneId

    string

    可用性區域 ID。

    cn-hangzhou-b
    InstanceType

    string

    執行個體規格。

    ecs.g5.large
    Count

    integer

    特權屬性類型的數量。

    3
    InstanceChargeType

    string

    執行個體計費方式。

    PrePaid

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "8CE45CD5-31FB-47C2-959D-CA8144CE****",
  "AccountAttributeItems": {
    "AccountAttributeItem": [
      {
        "AttributeName": "max-security-groups",
        "AttributeValues": {
          "ValueItem": [
            {
              "DiskCategory": "cloud_ssd",
              "Value": "800",
              "ExpiredTime": "2019-01-01T12:30:00Z",
              "ZoneId": "cn-hangzhou-b",
              "InstanceType": "ecs.g5.large",
              "Count": 3,
              "InstanceChargeType": "PrePaid"
            }
          ]
        }
      }
    ]
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    500 InternalError The process of creating snapshot has failed due to some unknown error. 建立快照失敗。
    500 ServiceUnavailable The service is unavailable, please try again later. 服務暫時不可用，請稍候重試。
    403 Invalid.Parameter The required parameter regionId must be not null. 參數 RegionId 不可為空。

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

    變更歷史

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