DescribeResourcesModification - API レファレンス| Alibaba Cloud ドキュメントセンター

説明

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

リクエストパラメータ

名	型	必須	説明
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`は存在しません。詳細については、リージョンとゾーンをご参照ください。