この API を呼び出して、ECS が提供するインスタンスタイプリストをクエリできます。
説明
DescribeInstanceTypes は、インスタンスが作成された後、従量課金インスタンスのリストと同じインスタンスタイプリストを返します。 詳細は、従量課金と制約をご参照ください。
詳細は、インスタンスタイプファミリー をご参照ください。
インスタンスタイプの詳細に関しては、チケットを起票してご連絡ください。
デバッグ
API Explorer でデバッグを実行できます。 API Explorer で各種操作を実行して API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。
リクエストパラメーター
名前 | データ型 | 必須/省略可能 | 例 | 説明 |
---|---|---|---|---|
Action | String | 省略可能 | DescribeInstanceTypes |
実行する操作。 値を DescribeInstanceTypes に設定します。 |
InstanceTypeFamily | String | 省略可能 | ecs.t1 |
インスタンスタイプファミリー 詳細は、インスタンスタイプファミリー をご参照ください。 |
OwnerAccount | String | 省略可能 | ECSforCloud@Alibaba.com |
RAM ユーザーのログインネーム。 |
レスポンスパラメーター
名前 | データ型 | 例 | 説明 |
---|---|---|---|
InstanceTypes |
返されたインスタンスタイプ情報。 InstanceTypeItemType データからなる配列。 |
||
└BaselineCredit | Integer | 4 |
バースト可能なパフォーマンスインスタンス(t5)の(組み合わせた)ベンチマーク vCPU コンピューティングパフォーマンス。 |
└CpuCoreCount | Integer | 8 |
vCPU の数。 |
└EniPrivateIpAddressQuantity | Integer | 2 |
インスタンスにバインドされた ENI に割り当てられたプライベート IP アドレスの数。 |
└EniQuantity | Integer | 2 |
インスタンスタイプにアタッチされた ENI の最大数。 |
└GPUAmount | Integer | 2 |
インスタンスタイプの GPU の数。 |
└GPUSpec | String | NVIDIA V100 |
インスタンスタイプの GPU のカテゴリ。 |
└InitialCredit | Integer | 120 |
バースト可能なパフォーマンスインスタンスの初期クレジット値(t5)。 |
└InstanceBandwidthRx | Integer | 2,000 |
インスタンスのインバウンド帯域幅制限。 単位:Kbit/秒 |
└InstanceBandwidthTx | Integer | 2,000 |
インスタンスのアウトバウンド帯域幅制限。 単位:Kbit/秒 |
└InstanceFamilyLevel | String | EnterpriseLevel |
インスタンスタイプのレベル。 有効値:
|
└InstancePpsRx | Long | 300 |
インスタンスのインバウンド PPS 制限。 |
└InstancePpsTx | Long | 300 |
インスタンスのアウトバウンド PPS 制限。 |
└InstanceTypeFamily | String | ecs.g5 |
インスタンスタイプファミリー。 |
└InstanceTypeId | String | ecs.g5.large |
インスタンスタイプの ID。 |
└LocalStorageAmount | Integer | 1 |
インスタンスにアタッチされているローカルディスクの数。 |
└LocalStorageCapacity | Long | 5000 |
ローカルディスクの容量。 |
└LocalStorageCategory | String | ephemeral_ssd |
インスタンスにアタッチされているローカルディスクのカテゴリ。 |
└MemorySize | Float | 1024 |
メモリーの容量 単位:GiB。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
リクエスト ID。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=DescribeInstanceTypes
&InstanceTypeFamily=ecs.t1
&<Common request parameters>
通常のレスポンスの例
XML
形式
<DescribeInstanceTypesResponse>
<InstanceTypes>
<InstanceType>
<CpuCoreCount>1</CpuCoreCount>
<InstanceTypeFamily>ecs.t1</InstanceTypeFamily>
<EniQuantity>1</EniQuantity>
<InstanceTypeId>ecs.t1.xsmall</InstanceTypeId>
<InstanceFamilyLevel>EntryLevel</InstanceFamilyLevel>
<GPUSpec/>
<MemorySize>0.5</MemorySize>
<GPUAmount>0</GPUAmount>
<LocalStorageCategory/>
</InstanceType>
<InstanceType>
<CpuCoreCount>1</CpuCoreCount>
<InstanceTypeFamily>ecs.t1</InstanceTypeFamily>
<EniQuantity>1</EniQuantity>
<InstanceTypeId>ecs.t1.small</InstanceTypeId>
<InstanceFamilyLevel>EntryLevel</InstanceFamilyLevel>
<GPUSpec/>
<MemorySize>1</MemorySize>
<GPUAmount>0</GPUAmount>
<LocalStorageCategory/>
</InstanceType>
</InstanceTypes>
<RequestId>01D5A075-FB83-4DDC-9F00-24A17AB386F6</RequestId>
</DescribeInstanceTypesResponse>
JSON
形式
{
"InstanceTypes":{
"InstanceType":[
{
"CpuCoreCount":1,
"InstanceTypeFamily":"ecs.t1",
"EniQuantity":1,
"InstanceTypeId":"ecs.t1.xsmall",
"GPUSpec":"",
"InstanceFamilyLevel":"EntryLevel",
"MemorySize":0.5,
"GPUAmount":0,
"LocalStorageCategory":""
},
{
"CpuCoreCount":1,
"InstanceTypeFamily":"ecs.t1",
"EniQuantity":1,
"InstanceTypeId":"ecs.t1.small",
"GPUSpec":"",
"InstanceFamilyLevel":"EntryLevel",
"MemorySize":1,
"GPUAmount":0,
"LocalStorageCategory":""
}
]
},
"RequestId":"01D5A075-FB83-4DDC-9F00-24A17AB386F6"
}