特定のゾーンで使用可能なリソースのリストを取得します。インスタンスの仕様またはシステムのディスク容量をアップグレードまたはダウングレードする前に、この方法を使用できます。
リクエストパラメータ
Action |
String |
Yes |
このインタフェースの名前。値:DescribeResourcesModification。 |
RegionId |
String |
Yes |
対象リージョンの ID。詳細は、リージョンとゾーンをご参照してください。
|
ResourceId |
String |
Yes |
リソース ID。例えば、検索されたリソースがインスタンスである場合、このパラメータはInstanceId と理解できます。
|
DestinationResource |
String |
Yes |
ターゲットリソースタイプ。オプションの値:
- InstanceType:インスタンスタイプ
- SystemDisk:インスタンスのシステムディスク
|
MigrateAcrossZone |
Boolean |
No |
異なるインスタンスタイプファミリー間でインスタンスをアップグレードするかどうかを指定します。オプションの値:
- True:アップグレードする
- False:アップグレードしない
デフォルト:False。 MigrateAcrossZone がTrue に設定され、返された情報に従ってインスタンス設定を変更する場合は、次のことを確認する必要があります。
- クラシックネットワークタイプのインスタンスの場合:
- フェーズアウトされた非 I / O 最適化インスタンスを I / O 最適化インスタンスにアップグレードすると、インスタンス関連のイントラネット IP アドレス、ディスクデバイス名、インスタンスのライセンスキーが変更されることがあります。
Linux インスタンスの場合、システムは、基本クラウドディスク(
cloud )をxvda またはxvdb と認識し、Ultra クラウドディスク( cloud_efficiency )と SSD クラウドディスク(cloud_ssd )をvda またはvdb と認識します。
- 従来のネットワークインスタンスがインスタンスタイプファミリーで使用可能な場合、インスタンスのプライベート IP が変更されることがあります。
- VPC 接続インスタンスの場合: フェーズアウトされた非 I / O 最適化インスタンスを I / O 最適化インスタンスにアップグレードすると、ECS のディスクデバイス名とライセンスキーが変更されることがあります。Linux
インスタンスの場合、システムは、基本クラウドディスク(
cloud )をxvda またはxvdb と認識し、Ultra クラウドディスク(cloud_efficiency )と SSD ディスク(cloud_ssd )をvda またはvdb と認識します。
|
OperationType |
String |
No |
リソースをアップグレードするかダウングレードするかを指定します。 オプションの値:
- Upgrade: リソースのアップグレード
- Downgrade: リソースのダウングレード
- RenewDowngrade:更新してダウングレード
- RenewModify:失効インスタンスを更新してスペック変更
Default: アップグレード。
|
InstanceType |
String |
No |
インスタンスのタイプ。詳細については、DescribeInstanceTypes を呼び出して最新の型リストを取得してください。パラメーターDestinationResource の値がSystemDisk である場合、パラメーターInstanceType も指定する必要があります。
|
レスポンスパラメータ
AvailableZones |
Array of AvailableZones
|
データセンター情報 AvailableZoneType の集合 |
AvailableZoneType
RegionId |
String |
リージョン ID |
ZoneId |
String |
ゾーン ID |
Status |
String |
リソースのステータス。オプションの値:
- Available: リソースが使用可能
- SoldOut: リソースが使用不可
|
AvailableResources |
Array of AvailableResource
|
使用可能なリソースタイプの集合。 |
AvailableResourceType
Type |
String |
リソースタイプ。オプションの値:
- Zone: ゾーン
- IoOptimized: インスタンスが I/O 最適化されているかどうか。
- InstanceType: インスタンスタイプ
- SystemDisk: システムディスク
- DataDisk: データディスク
- Network: インスタンスのネットワークタイプ
|
SupportedResources |
Array of SupportedResource
|
サポートされている利用可能なリソースタイプの集合 |
SupportedResourceType
Value |
String |
リソースの名前。 |
Status |
String |
リソースのステータス。オプションの値:
- Available:リソースが使用可能
- SoldOut: リソースが使用不可
|
Min |
Integer |
リソースの下限。 パラメーターが NULL の場合、値は戻されません。 |
Max |
Integer |
リソースの上限。パラメーターが NULL の場合、値は戻されません。 |
Unit |
Integer |
リソースタイプ単位。パラメーターが NULL の場合、値は戻されません。 |
リクエストの例
https://ecs.aliyuncs.com/?Action=DescribeResourcesModification
&RegionId=cn-hangzhou
&<Common Request Parameters>
レスポンスの例
XML
形式
<DescribeResourcesModificationResponse>
<AvailableZones>
<AvailableZone>
<ZoneId>cn-hangzhou-d</ZoneId>
<RegionId>cn-hangzhou</RegionId>
<Status>Available</Status>
<AvailableResources>
<AvailableResource>
<Type>instanceType</Type>
<SupportedResources>
<SupportedResource>
<Value>ecs.d1ne.xlarge</Value>
<Status>Available</Status>
</SupportedResource>
<SupportedResource>
<Value>ecs.d1ne.2xlarge</Value>
<Status>Available</Status>
</SupportedResource>
</SupportedResources>
</AvailableResource>
</AvailableResources>
</AvailableZone>
<AvailableZone>
<ZoneId>cn-hangzhou-e</ZoneId>
<RegionId>cn-hangzhou</RegionId>
<Status>Available</Status>
<AvailableResources>
<AvailableResource>
<Type>instanceType</Type>
<SupportedResources>
<SupportedResource>
<Value>ecs.d1ne.xlarge</Value>
<Status>Available</Status>
</SupportedResource>
<SupportedResource>
<Value>ecs.d1ne.2xlarge</Value>
<Status>Available</Status>
</SupportedResource>
</SupportedResources>
</AvailableResource>
</AvailableResources>
</AvailableZone>
</AvailableZones>
<RequestId>6DB97BCC-92BA-424D-A7C8-3F6486612BAE</RequestId>
</DescribeResourcesModificationResponse>
JSON
形式
{
"RequestId": "D0233A65-7F00-4B50-8023-101427229D4F",
"AvailableZones": {
"AvailableZone": [
{
"Status": "available",
"RegionId": "cn-hangzhou",
"AvailableResources": {
"AvailableResource": [
{
"Type": "instanceType",
"SupportedResources": {
"SupportedResource": [
{
"Status": "available",
"Value": "ecs.sn1ne.xlarge"
},
{
"Status": "available",
"Value": "ecs.sn2ne.xlarge"
}
]
}
}
]
},
"ZoneId": "cn-hangzhou-e",
}
]
}
}
エラーコード
本インターフェイス固有のエラーコードを以下に示します。
Invalid.Param |
The input parameter DestinationResource that is mandatory for processing this request
is not supplied.
|
400 |
DestinationResource パラメータを指定する必要があります。
|
Unavailable.Regions |
The available regions does not exists. |
404 |
指定されたRegionId は利用できません。
|
InvalidRegionId.NotFound |
The specified RegionId does not exist. |
404 |
指定されたRegionId は存在しません。詳細については、リージョンとゾーンをご参照ください。
|