説明
特定のゾーンで使用可能なリソースのリストを取得します。インスタンスの仕様またはシステムのディスク容量をアップグレードまたはダウングレードする前に、この方法を使用できます。
リクエストパラメータ
名 | 型 | 必須 | 説明 |
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",
}
]
}
}
エラーコード
本インターフェイス固有のエラーコードを以下に示します。
エラーコード | エラー情報 | HTTP ステータスコード | 説明 |
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 は存在しません。詳細については、リージョンとゾーンをご参照ください。 |