调用DescribeAccountAttributes查询您在一个阿里云地域下能创建的ECS资源配额。包括您能创建的安全组数量、弹性网卡数量、按量付费vCPU核数、抢占式实例vCPU核数、按量付费云盘总容量配额、专用宿主机数量、地域网络类型以及账号是否已完成实名认证。
接口说明
注册了阿里云账号后,您可以在不同的阿里云地域中创建一定数量的ECS资源,更多详情,请参见使用限制。
您也可以根据自己的需求提交工单提高资源使用配额。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeAccountAttributes | 系统规定参数。取值:DescribeAccountAttributes |
RegionId | String | 是 | cn-hangzhou | 地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
ZoneId | String | 否 | cn-hangzhou-b | 可用区ID。 |
AttributeName.N | RepeatList | 否 | max-security-groups | 查询某类资源在指定地域下的使用配额,N的取值范围为1~8。取值范围:
默认值:空 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
AccountAttributeItems | Array of AccountAttributeItem | 指定地域下账号特权AccountAttributeItem的信息集合。 |
|
AccountAttributeItem | |||
AttributeName | String | max-security-groups | 资源在指定地域下的使用配额分类。可能值:
|
AttributeValues | Array of ValueItem | 资源的使用配额具体数值。 |
|
ValueItem | |||
Count | Integer | 3 | 特权属性类型的数量。 |
DiskCategory | String | cloud_ssd | 数据盘的云盘种类。可能值:
|
ExpiredTime | String | 2019-01-01T12:30:00Z | 特权到期时间,仅存在到期时间的账号特权会返回该参数。按照ISO8601标准表示,并使用UTC +0时间。格式为yyyy-MM-ddTHH:mm:ssZ。 |
InstanceChargeType | String | PrePaid | 实例计费方式。 |
InstanceType | String | ecs.g5.large | 实例规格。 |
Value | String | 800 | 当前地域或全部地域下某类资源的使用配额具体数值。可能值: 以下分类返回值为0或正整数:
分类为supported-postpay-instance-types时返回值:实例规格取值。参见实例规格族。 分类为real-name-authentications时返回值:
分类为instance-network-type时返回值:
|
ZoneId | String | cn-hangzhou-b | 可用区ID。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | 请求ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeAccountAttributes &RegionId=cn-hangzhou &ZoneId=cn-hangzhou-b &AttributeName.1=max-security-groups &<公共请求参数>
正常返回示例
XML
格式
<DescribeAccountAttributesResponse> <AccountAttributeItems> <AccountAttributeItem> <AttributeValues> <ValueItem> <Value>100</Value> </ValueItem> </AttributeValues> <AttributeName>max-security-groups</AttributeName> </AccountAttributeItem> <AccountAttributeItem> <AttributeValues> <ValueItem> <Value>2</Value> </ValueItem> </AttributeValues> <AttributeName>max-dedicated-hosts</AttributeName> </AccountAttributeItem> <AccountAttributeItem> <AttributeValues> <ValueItem> <Value>1000</Value> </ValueItem> </AttributeValues> <AttributeName>max-postpaid-instance-vcpu-count</AttributeName> </AccountAttributeItem> <AccountAttributeItem> <AttributeValues> <ValueItem> <Value>1000</Value> </ValueItem> </AttributeValues> <AttributeName>max-spot-instance-vcpu-count</AttributeName> </AccountAttributeItem> <AccountAttributeItem> <AttributeValues> <ValueItem> <Value>5000</Value> </ValueItem> </AttributeValues> <AttributeName>max-elastic-network-interfaces</AttributeName> </AccountAttributeItem> <AccountAttributeItem> <AttributeValues> <ValueItem> <Value>yes</Value> </ValueItem> </AttributeValues> <AttributeName>real-name-authentication</AttributeName> </AccountAttributeItem> <AccountAttributeItem> <AttributeValues> <ValueItem> <Value>vpc</Value> </ValueItem> </AttributeValues> <AttributeName>instance-network-type</AttributeName> </AccountAttributeItem> <AccountAttributeItem> <AttributeValues> <ValueItem> <Value>229376</Value> <DiskCategory>cloud_efficiency</DiskCategory> </ValueItem> <ValueItem> <Value>204800</Value> <DiskCategory>cloud_ssd</DiskCategory> </ValueItem> <ValueItem> <Value>204800</Value> <DiskCategory>cloud_essd</DiskCategory> </ValueItem> </AttributeValues> <AttributeName>max-postpaid-yundisk-capacity</AttributeName> </AccountAttributeItem> <AccountAttributeItem> <AttributeValues> <ValueItem> <Value>ecs.f3-c16f1.4xlarge</Value> </ValueItem> <ValueItem> <Value>ecs.g5.2xlarge</Value> </ValueItem> </AttributeValues> <AttributeName>supported-postpaid-instance-types</AttributeName> </AccountAttributeItem> </AccountAttributeItems> <RequestId>8CE45CD5-31FB-47C2-959D-CA8144CE9F42</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": "229376", "DiskCategory": "cloud_efficiency" }, { "Value": "204800", "DiskCategory": "cloud_ssd" }, { "Value": "204800", "DiskCategory": "cloud_essd" } ] }, "AttributeName": "max-postpaid-yundisk-capacity" }, { "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不能为空。 |
访问错误中心查看更多错误码。