edit-icon download-icon

DescribeResourcesModification

最終更新日: Dec 10, 2018

説明

特定のゾーンで使用可能なリソースのリストを取得します。インスタンスの仕様またはシステムのディスク容量をアップグレードまたはダウングレードする前に、この方法を使用できます。

リクエストパラメータ

必須 説明
Action String Yes このインタフェースの名前。値:DescribeResourcesModification。
RegionId String Yes 対象リージョンの ID。詳細は、リージョンとゾーンをご参照してください。
ResourceId String Yes リソース ID。例えば、検索されたリソースがインスタンスである場合、このパラメータはInstanceIdと理解できます。
DestinationResource String Yes ターゲットリソースタイプ。オプションの値:
  • InstanceType:インスタンスタイプ
  • SystemDisk:インスタンスのシステムディスク
MigrateAcrossZone Boolean No 異なるインスタンスタイプファミリー間でインスタンスをアップグレードするかどうかを指定します。オプションの値:
  • True:アップグレードする
  • False:アップグレードしない
デフォルト:False。
MigrateAcrossZoneTrueに設定され、返された情報に従ってインスタンス設定を変更する場合は、次のことを確認する必要があります。
  • クラシックネットワークタイプのインスタンスの場合:
    • フェーズアウトされた非 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 の場合、値は戻されません。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=DescribeResourcesModification
  2. &RegionId=cn-hangzhou
  3. &<Common Request Parameters>

レスポンスの例

XML 形式

  1. <DescribeResourcesModificationResponse>
  2. <AvailableZones>
  3. <AvailableZone>
  4. <ZoneId>cn-hangzhou-d</ZoneId>
  5. <RegionId>cn-hangzhou</RegionId>
  6. <Status>Available</Status>
  7. <AvailableResources>
  8. <AvailableResource>
  9. <Type>instanceType</Type>
  10. <SupportedResources>
  11. <SupportedResource>
  12. <Value>ecs.d1ne.xlarge</Value>
  13. <Status>Available</Status>
  14. </SupportedResource>
  15. <SupportedResource>
  16. <Value>ecs.d1ne.2xlarge</Value>
  17. <Status>Available</Status>
  18. </SupportedResource>
  19. </SupportedResources>
  20. </AvailableResource>
  21. </AvailableResources>
  22. </AvailableZone>
  23. <AvailableZone>
  24. <ZoneId>cn-hangzhou-e</ZoneId>
  25. <RegionId>cn-hangzhou</RegionId>
  26. <Status>Available</Status>
  27. <AvailableResources>
  28. <AvailableResource>
  29. <Type>instanceType</Type>
  30. <SupportedResources>
  31. <SupportedResource>
  32. <Value>ecs.d1ne.xlarge</Value>
  33. <Status>Available</Status>
  34. </SupportedResource>
  35. <SupportedResource>
  36. <Value>ecs.d1ne.2xlarge</Value>
  37. <Status>Available</Status>
  38. </SupportedResource>
  39. </SupportedResources>
  40. </AvailableResource>
  41. </AvailableResources>
  42. </AvailableZone>
  43. </AvailableZones>
  44. <RequestId>6DB97BCC-92BA-424D-A7C8-3F6486612BAE</RequestId>
  45. </DescribeResourcesModificationResponse>

JSON 形式

  1. {
  2. "RequestId": "D0233A65-7F00-4B50-8023-101427229D4F",
  3. "AvailableZones": {
  4. "AvailableZone": [
  5. {
  6. "Status": "available",
  7. "RegionId": "cn-hangzhou",
  8. "AvailableResources": {
  9. "AvailableResource": [
  10. {
  11. "Type": "instanceType",
  12. "SupportedResources": {
  13. "SupportedResource": [
  14. {
  15. "Status": "available",
  16. "Value": "ecs.sn1ne.xlarge"
  17. },
  18. {
  19. "Status": "available",
  20. "Value": "ecs.sn2ne.xlarge"
  21. }
  22. ]
  23. }
  24. }
  25. ]
  26. },
  27. "ZoneId": "cn-hangzhou-e",
  28. }
  29. ]
  30. }
  31. }

エラーコード

本インターフェイス固有のエラーコードを以下に示します。

エラーコード エラー情報 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は存在しません。詳細については、リージョンとゾーンをご参照ください。