DescribeAccountAttributes - API参考| 阿里云

接口说明

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

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

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeAccountAttributes	系统规定参数。取值：DescribeAccountAttributes。
RegionId	String	是	cn-hangzhou	地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
ZoneId	String	否	cn-hangzhou-b	可用区ID。
AttributeName.N	String	否	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-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实例。默认值为空。

返回数据


名称	类型	示例值	描述
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求ID。
AccountAttributeItems	Array of AccountAttributeItem		指定地域下账号特权AccountAttributeItem的信息集合。
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-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：账号是否完成了实名认证。
AttributeValues	Array of ValueItem		资源的使用配额具体数值。
ValueItem
DiskCategory	String	cloud_ssd	数据盘的云盘种类。可能值： cloud_efficiency：高效云盘。 cloud_ssd：SSD云盘。 cloud_essd：ESSD云盘。
Value	String	800	当前地域或全部地域下某类资源的使用配额具体数值。可能值：以下分类返回值为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 分类为supported-postpay-instance-types时返回值：实例规格取值。参见实例规格族。分类为real-name-authentications时返回值： yes none unnecessary 分类为instance-network-type时返回值： vpc classic
ExpiredTime	String	2019-01-01T12:30:00Z	特权到期时间，仅存在到期时间的账号特权会返回该参数。按照ISO 8601标准表示，并使用UTC +0时间。格式为yyyy-MM-ddTHH:mm:ssZ。
ZoneId	String	cn-hangzhou-b	可用区ID。
InstanceType	String	ecs.g5.large	实例规格。
Count	Integer	3	特权属性类型的数量。
InstanceChargeType	String	PrePaid	实例计费方式。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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不能为空。

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