この操作を呼び出して、リージョンで作成できる ECS リソースの上限を照会できます。 セキュリティグループ、ENI、従量課金インスタンス vCPU、プリエンプティブルインスタンス vCPU、Dedicated Host (DDH) の最大数を照会できます。 また、リージョンで利用可能なネットワークタイプや、アカウントが実名認証に合格したかどうかなどの情報を取得することもできます。

説明

Alibaba Cloud アカウントに登録後、異なるリージョンに特定の数の ECS リソースを作成できます。 詳細は、「制限事項」をご参照ください。

また、チケットを送信して、リソースの使用制限を引き上げることもできます。

デバッグ

API の使用を簡単にするため、Alibaba Cloud では、OpenAPI Explorer を提供しています。 OpenAPI Explorer を使用して、API の検索、API の呼び出し、および SDK サンプルコードの動的な生成を行うことができます。

リクエストパラメーター

パラメーター データ型 必須/任意 例 説明
RegionId String 必須 cn-hangzhou

ECS リソースの上限を照会するリージョンの ID。 DescribeRegions 操作を呼び出して最新のリージョン一覧を照会できます。

Action String 任意 DescribeAccountAttributes

操作の実行に使用する API。 HTTP および HTTPS メソッドを使用した API リクエストの場合、Action が必要です。 この値を DescribeAccountAttributes に設定します。

ZoneId String 任意 cn-hangzhou

ゾーンの ID 。
AttributeName.N RepeatList 任意 max-security-groups

上限が照会されるリソースのタイプ。 N の有効値 : 1~8 。 有効な値：

  • instance-network-type：現在のリージョンで利用可能なネットワークタイプ
  • max-security-groups：セキュリティグループの数
  • max-elastic-network-interfaces：現在のリージョンの ENI の数
  • max-postpaid-instance-vcpu-count：現在のリージョンの従量課金インスタンスの vCPU コアの数
  • max-spot-instance-vcpu-count：現在のリージョンのプリエンプティブルインスタンスの vCPU コアの数
  • max-dedicated-hosts：現在のリージョンの DDH の数
  • supported-postpaid-instance-types：現在のリージョンの従量課金 I/O 最適化インスタンスのタイプ
  • max-axt-command-count：現在のリージョンの Cloud Assistant コマンドの数
  • max-axt-invocation-daily：現在のリージョンで 1 日に実行できる Cloud Assistant コマンドの数
  • real-name-authentication：アカウントが実名認証に合格したかどうか
    注 ECS インスタンスを作成する前に、実名認証に合格する必要があります。

デフォルト値: null。

レスポンスパラメーター

パラメーター データ型 例 説明
AccountAttributeItems

指定されたリージョンのアカウント権限に関する一連の情報。
└AttributeName String max-security-groups

返されるリソースタイプ。 有効な値：

  • instance-network-type：現在のリージョンで利用可能なネットワークタイプ
  • max-security-groups：セキュリティグループの数
  • max-elastic-network-interfaces：現在のリージョンの ENI の数
  • max-postpaid-instance-vcpu-count：現在のリージョンの従量課金インスタンスの vCPU コアの数
  • max-spot-instance-vcpu-count：現在のリージョンのプリエンプティブルインスタンスの vCPU コアの数
  • max-dedicated-hosts：現在のリージョンの DDH の数
  • supported-postpaid-instance-types：現在のリージョンの従量課金 I/O 最適化インスタンスのタイプ
  • real-name-authentication：アカウントが実名認証に合格したかどうか
  • max-axt-command-count：現在のリージョンの Cloud Assistant コマンドの数
  • max-axt-invocation-daily：現在のリージョンで 1 日に実行できる Cloud Assistant コマンドの数
└AttributeValues

リソースの上限。
└Count Integer 3

リソースタイプの数。
└ExpiredTime String 2019-01-01T12:30:00Z

権限の期限が切れる時刻。 このパラメーターは、アカウント権限に有効期限がある場合にのみ返されます。 時間は yyyy-MM-ddThh:mmZ 形式で、ISO 8601 標準に従います。 時刻は UTC で表示されます。

└InstanceChargeType String PrePaid

インスタンスの課金方法を示します。
└InstanceType String ["ecs.g5.large"]

インスタンスタイプを示します。
└Value String 800

現在のリージョンまたはすべてのリージョンのリソースタイプの上限。 有効な値：

  • AttributeName パラメーターの値が max-security-groups、max-elastic-network-interfaces、max-postpaid-instance-vcpu-count、max-dedicated-hosts、または max-spot-instance-vcpu-count の場合、0、または正の整数が返されます。
  • AttributeName パラメーターの値が supported-postpaid-instance-types の場合、インスタンスタイプが返されます。 詳細については、「インスタンスタイプファミリー」をご参照ください。
  • AttributeName パラメーターの値が real-name-authentications の場合、yes、none、または unnecessary が返されます。
  • AttributeName パラメーターの値が instance-network-type の場合、vpc または classic が返されます。
└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
&<Common request parameters>

レスポンスの成功例

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

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
403 Invalid.Parameter The required parameter regionId must be not null. 必須パラメーターが指定されていない場合に返されるエラーメッセージ。

エラーコードの表示