阿里云服务器DescribeAccountAttributes-[云淘科技_教程]

调用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 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:每天可以执行的云助手命令次数。
  • max-cloud-assistant-activation-count:可创建的云助手托管实例激活码数量上限。
  • real-name-authentication:账号是否完成了实名认证。


    说明 您只有完成了实名认证才可以在中国内地地域中创建ECS实例。

默认值为空。

返回数据

名称 类型 示例值 描述
RequestId String 8CE45CD5-31FB-47C2-959D-CA8144CE****

请求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:账号是否完成了实名认证。
  • max-cloud-assistant-activation-count:可创建的云助手托管实例激活码数量上限。
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
  • max-cloud-assistant-activation-count

分类为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


    
        
            
                
                    100
                
            
            max-security-groups
        
        
            
                
                    2
                
            
            max-dedicated-hosts
        
        
            
                
                    1000
                
            
            max-postpaid-instance-vcpu-count
        
        
            
                
                    1000
                
            
            max-spot-instance-vcpu-count
        
        
            
                
                    5000
                
            
            max-elastic-network-interfaces
        
        
            
                
                    yes
                
            
            real-name-authentication
        
        
            
                
                    vpc
                
            
            instance-network-type
        
        
            
                
                    229376
                    cloud_efficiency
                
                
                    204800
                    cloud_ssd
                
                
                    204800
                    cloud_essd
                
            
            max-postpaid-yundisk-capacity
        
        
            
                
                    ecs.f3-c16f1.4xlarge
                
                
                    ecs.g5.2xlarge
                
            
            supported-postpaid-instance-types
        
    
    8CE45CD5-31FB-47C2-959D-CA8144CE****

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-CA8144CE****"
}

错误码

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

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

关于阿里云ecs服务器的内容没看懂? 不太想学习?想快速解决? 有偿解决: 联系专家

阿里云企业补贴进行中: 马上申请

腾讯云限时活动1折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心。

购买腾讯云产品享受折上折,更有现金返利:同意关联,立享优惠

本文来自投稿,不代表新手站长_郑州云淘科技有限公司立场,如若转载,请注明出处:https://www.cnzhanzhang.com/9753.html

(0)
匿名
上一篇 2022年12月29日 上午9:39
下一篇 2022年12月30日

相关推荐

新手站长从“心”出发,感谢16年您始终不离不弃。