调用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不能为空。 |
访问错误中心查看更多错误码。