この API を呼び出して、ECS が提供するインスタンスタイプファミリーリストをクエリできます。

デバッグ

API Explorer でデバッグを実行できます。 API Explorer で各種操作を実行して API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。

リクエストパラメーター

名前 データ型 必須/省略可能 説明
RegionId String 必須 cn-hangzhou

インスタンスのリージョン ID 。 DescribeRegionsを実行すると、最新のリージョンリストが表示されます。

Action String 省略可能 DescribeInstanceTypeFamilies

実行する操作。 値を DescribeInstanceTypeFamilies に設定します。

Generation String 省略可能 ecs-3

インスタンスタイプファミリーのジェネレーション。 詳細は、インスタンスタイプファミリー をご参照ください。 有効値:

  • ecs-1:ジェネレーション I。初代インスタンスタイプファミリ。費用対効果の高いインスタンスタイプで構成されています。
  • ecs-2:ジェネレーションII。第 2 世代のインスタンスタイプファミリ。
  • ecs-3:ジェネレーションIII。クイックレスポンスおよび高性能インスタンスタイプで構成されています。
  • ecs-4:ジェネレーションIV。最新、低遅延、およびワイドアプリケーションのインスタンスタイプで構成されます。
OwnerAccount String 省略可能 ECSforCloud@Alibaba.com

RAM ユーザーのログインネーム。

レスポンスパラメーター

名前 データ型 説明
InstanceTypeFamilies

返されるインスタンスタイプファミリーの情報。 InstanceTypeFamilyItemType データからなる配列。

└Generation String ecs-1

インスタンスタイプファミリーのジェネレーション。

└InstanceTypeFamilyId String ecs.g5

インスタンスタイプファミリーの ID。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエスト ID 。 API 操作の結果にかかわらず、各 API リクエストに対してシステムから固有の RequestId が返されます。

リクエストの例


https://ecs.aliyuncs.com/?Action=DescribeInstanceTypeFamilies
&RegionId=cn-hangzhou 
&Generation=ecs-3
&<Common request parameters>

通常のレスポンスの例

XML 形式

<DescribeInstanceTypeFamiliesResponse>
  <InstanceTypeFamilies>
    <InstanceTypeFamily>
      <InstanceTypeFamilyId>ecs.t1</InstanceTypeFamilyId>
      <Generation>ecs-1</Generation>
    </InstanceTypeFamily>
    <InstanceTypeFamily>
      <InstanceTypeFamilyId>ecs.s2</InstanceTypeFamilyId>
      <Generation>ecs-1</Generation>
    </InstanceTypeFamily>
    <InstanceTypeFamily>
      <InstanceTypeFamilyId>ecs.s3</InstanceTypeFamilyId>
      <Generation>ecs-1</Generation>
    </InstanceTypeFamily>
  </InstanceTypeFamilies>
  <RequestId>6B187E0A-C075-4D08-8B6F-6213950E8733</RequestId>
</DescribeInstanceTypeFamiliesResponse>

JSON 形式

{
	"InstanceTypeFamilies":{
		"InstanceTypeFamily":[
			{
				"InstanceTypeFamilyId":"ecs.t1",
				"Generation":"ecs-1"
			},
			{
				"InstanceTypeFamilyId":"ecs.s2",
				"Generation":"ecs-1"
			},
			{
				"InstanceTypeFamilyId":"ecs.s3",
				"Generation":"ecs-1"
			}
		]
	},
	"RequestId":"6B187E0A-C075-4D08-8B6F-6213950E8733"
}

エラーコード

エラーコードの表示