调用DescribeAccountAttributes查询您在一个阿里云地域下能创建的ECS资源配额。包括您能创建的安全组数量、弹性网卡数量、按量付费vCPU核数、抢占式实例vCPU核数、专用宿主机数量、地域网络类型以及账号是否已完成实名认证。

接口说明

注册了阿里云账号后,您可以在不同的阿里云地域中创建一定数量的ECS资源,更多详情,请参见使用限制

您也可以根据自己的需求提交工单提高资源使用配额。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeAccountAttributes

系统规定参数。对于您自行拼凑HTTP/HTTPS URL发起的API请求,该参数为必选参数。取值:DescribeAccountAttributes

RegionId String cn-hangzhou

地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

ZoneId String cn-hangzhou-b

可用区ID。

AttributeName.N RepeatList max-security-groups

查询某类资源在指定地域下的使用配额,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-dedicated-hosts:专用宿主机数量。
  • supported-postpaid-instance-types:按量付费I/O优化实例规格。
  • max-axt-command-count:云助手命令的数量。
  • max-axt-invocation-daily:每天可以执行的云助手命令次数。
  • real-name-authentication:账号是否完成了实名认证。
    说明 您只有完成了实名认证才可以在中国大陆地域中创建ECS实例。

默认值:空。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

AccountAttributeItems Array

指定地域下账号特权AccountAttributeItem的信息集合。

AttributeName String max-security-groups

资源在指定地域下的使用配额分类。可能值:

  • 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-dedicated-hosts:专用宿主机数量。
  • supported-postpaid-instance-types:按量付费I/O优化实例规格。
  • max-axt-command-count:云助手命令的数量。
  • max-axt-invocation-daily:每天可以执行的云助手命令次数。
  • real-name-authentication:账号是否完成了实名认证。
AttributeValues Array

资源的使用配额具体数值。

Value String 800

当前地域或全部地域下某类资源的使用配额具体数值。可能值:

  • 分类为max-security-groups、max-elastic-network-interfaces、max-postpaid-instance-vcpu-count、max-dedicated-hosts、max-spot-instance-vcpu-count时:返回0或正整数。
  • 分类为supported-postpay-instance-types时:返回实例规格取值。参见实例规格族
  • 分类为real-name-authentications时:返回 yes | none | unnecessary。
  • 分类为instance-network-type时:返回 vpc | classic。
ExpiredTime String 2019-01-01T12:30:00Z

特权到期时间,仅存在到期时间的账号特权会返回该参数。按照ISO8601标准表示,并使用UTC +0时间。格式为yyyy-MM-ddTHH:mm:ssZ。

ZoneId String cn-hangzhou-b

可用区ID。

InstanceChargeType String PrePaid

实例计费方式。

InstanceType String ecs.g5.large

实例规格。

Count Integer 3

特权属性类型的数量。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeAccountAttributes
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-b
&AttributeName.1=max-security-groups
&<公共请求参数>

正常返回示例

XML 格式

<DescribeAccountAttributesResponse>
    <AccountAttributeItems>
        <AccountAttributeItem>
            <AttributeName>max-security-groups</AttributeName>
            <AttributeValues>
                <ValueItem>
                    <Value>800</Value>
                <ValueItem>
            </AttributeValues>
        </AccountAttributeItem>
          <AccountAttributeItem>
            <AttributeName>instance-network-type</AttributeName>
            <AttributeValues>
                <ValueItem>
                    <Value>vpc</Value>
                    <Value>classic</Value>
                <ValueItem>
            </AttributeValues>
        </AccountAttributeItem>
     </AccountAttributeItems>
    <RequestId>675B6D89-A3EB-4987-BAF3-610591E0D019</RequestId>
</DescribeAccountAttributesResponse>

JSON 格式

{
    "AccountAttributeItems": {
        "AccountAttributeItem": [
            {
                "AttributeValues": {
                    "ValueItem": [
                        {
                            "Value": "100"
                        }
                    ]
                },
                "AttributeName": "max-security-groups"
            },
            {
                "AttributeValues": {
                    "ValueItem": [
                        {
                            "Value": "2"
                        }
                    ]
                },
                "AttributeName": "max-dedicated-hosts"
            },
            {
                "AttributeValues": {
                    "ValueItem": [
                        {
                            "Value": "1000"
                        }
                    ]
                },
                "AttributeName": "max-postpaid-instance-vcpu-count"
            },
            {
                "AttributeValues": {
                    "ValueItem": [
                        {
                            "Value": "1000"
                        }
                    ]
                },
                "AttributeName": "max-spot-instance-vcpu-count"
            },
            {
                "AttributeValues": {
                    "ValueItem": [
                        {
                            "Value": "5000"
                        }
                    ]
                },
                "AttributeName": "max-elastic-network-interfaces"
            },
            {
                "AttributeValues": {
                    "ValueItem": [
                        {
                            "Value": "yes"
                        }
                    ]
                },
                "AttributeName": "real-name-authentication"
            },
            {
                "AttributeValues": {
                    "ValueItem": [
                        {
                            "Value": "vpc"
                        }
                    ]
                },
                "AttributeName": "instance-network-type"
            },
            {
                "AttributeValues": {
                    "ValueItem": [
                        {
                            "Value": "ecs.f3-c16f1.4xlarge"
                        },
                        {
                            "Value": "ecs.g5.2xlarge"
                        }
                    ]
                },
                "AttributeName": "supported-postpaid-instance-types"
            }
        ]
    },
    "RequestId": "8CE45CD5-31FB-47C2-959D-CA8144CE9F42"
}

错误码

HttpCode 错误码 错误信息 描述
403 Invalid.Parameter The required parameter regionId must be not null. 参数“RegionId”不能为空。

访问错误中心查看更多错误码。