すべてのプロダクト
Search

このプロダクト

    Elastic Compute Service:DescribeAvailableResource

    ドキュメントセンター

    Elastic Compute Service:DescribeAvailableResource

    最終更新日:Jun 29, 2026

    指定されたゾーンのリソースの在庫ステータスを照会します。この操作は、インスタンスの作成 (RunInstances) やインスタンスの仕様の変更 (ModifyInstanceSpec) の前に、インスタンスタイプやシステムクラウドディスクタイプなどのターゲットリソースが特定のゾーンで利用可能かどうかを確認するために主に使用されます。

    操作説明

    DestinationResource パラメーターは、その値に応じて異なるロジックと要件があります。以下の順序付きリストでは、ランクが低い値ほど、より多くのパラメーターをセットする必要があります。ランクが低い値を使用して、ランクが高いカテゴリのリソースをフィルターすることはできません。

    • 値の注文: Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk

    • 例:

      • DestinationResource が DataDisk に設定されている場合:

        • ResourceType が disk に設定されている場合、この操作は特定の ECS インスタンスタイプに関連付けられていないデータディスクタイプを照会します。この場合、InstanceType パラメーターは省略可能です。

        • ResourceType が instance に設定されている場合、この操作は ECS インスタンスにアタッチできるデータディスクタイプを照会します。インスタンスタイプはデータディスクに制限を課すため、InstanceType と DataDiskCategory の両方を指定する必要があります。

      • DestinationResource が SystemDisk に設定され、ResourceType が instance に設定されている場合、ECS インスタンスタイプがシステムディスクに制限を課すため、InstanceType パラメーターを指定する必要があります。

      • DestinationResource が InstanceType に設定されている場合、IoOptimized および InstanceType パラメーターを指定します。

      • 指定されたリージョンのすべてのゾーンで ecs.g5.large の在庫を照会する: RegionId=ap-southeast-1 &DestinationResource=InstanceType &IoOptimized=optimized &InstanceType=ecs.g5.large。

      • 指定されたリージョンで ecs.g5.large が利用可能なゾーンを照会する: RegionId=ap-southeast-1 &DestinationResource=Zone &IoOptimized=optimized &InstanceType=ecs.g5.large。

    中国 (杭州) リージョンで ecs.g5.large インスタンスタイプが利用可能なゾーンを照会します。

    "RegionId": "cn-hangzhou",
"DestinationResource": "Zone"，
"InstanceType": "ecs.g5.large"

    詳細については上記を参照してください。

    中国 (杭州) リージョンのすべてのゾーンで ecs.g5.large インスタンスタイプの在庫を照会します。

    "RegionId": "cn-hangzhou",
"DestinationResource": "InstanceType"，
"InstanceType": "ecs.g5.large"

    詳細については上記を参照してください。

    [データディスクのみを購入] 中国 (杭州) リージョンのゾーン B で cloud_efficiency データディスクタイプの在庫を照会します。

    "RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-b",
"ResourceType": "disk",
"DestinationResource": "DataDisk"

    詳細については上記を参照してください。

    [ECS インスタンスとシステムディスクを購入] 中国 (杭州) リージョンのゾーン B で cloud_essd システムディスクタイプの ecs.g7.large インスタンスタイプの在庫を照会します。

    "RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-b",
"ResourceType": "instance",
"InstanceType": "ecs.g7.large",
"DestinationResource": "SystemDisk",
"SystemDiskCategory": "cloud_essd"

    詳細については上記を参照してください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    ターゲットリージョンの ID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

    cn-hangzhou
    InstanceChargeType

    string

    任意

    リソースの支払い方法。詳細については、課金概要 を参照してください。有効な値:

    • PrePaid: サブスクリプション。

    • PostPaid: 従量課金。

    デフォルト値: PostPaid。

    PrePaid
    SpotStrategy

    string

    任意

    従量課金インスタンスの入札ポリシー。有効な値:

    • NoSpot: 通常の従量課金インスタンス。

    • SpotWithPriceLimit: 最大値の値幅制限付きのスポットインスタンス。

    • SpotAsPriceGo: 従量課金価格を上限とする市場価格のスポットインスタンス。

    デフォルト値: NoSpot。

    このパラメーターは、InstanceChargeType が PostPaid にセットされている場合にのみ効果があります。

    NoSpot
    SpotDuration

    integer

    任意

    スポットインスタンスの保護期間。単位: 時間。デフォルト値: 1。有効な値:

    • 1: スポットインスタンスの作成後、Alibaba Cloud はインスタンスが 1 時間以内に自動的にリリースされないことを保証します。1 時間後、システムは入札価格と市場価格を比較し、在庫を確認してインスタンスを保持するか自動リリースするかを決定します。

    • 0: スポットインスタンスの作成後、Alibaba Cloud はインスタンスが 1 時間実行されることを保証しません。システムは入札価格と市場価格を比較し、在庫を確認してインスタンスを保持するか自動リリースするかを決定します。

    Alibaba Cloud はインスタンスがリリースされる 5 分前に ECS システムイベント通知を送信します。スポットインスタンスは秒単位で課金されます。予想されるタスクの実行時間に基づいて適切な保護期間を選択してください。

    説明

    このパラメーターは、InstanceChargeType が PostPaid にセットされ、SpotStrategy が SpotWithPriceLimit または SpotAsPriceGo にセットされている場合にのみ効果があります。

    1
    DestinationResource

    string

    必須

    クエリするリソースのタイプ。有効な値:

    • Zone: ゾーン。

    • IoOptimized: I/O 最適化。

    • InstanceType: インスタンスタイプ。

    • Network: ネットワークタイプ。

    • ddh: 専用ホスト。

    • SystemDisk: システムディスク。

    • DataDisk: データディスク。

    説明

    DestinationResource が SystemDisk にセットされている場合、システムディスクはインスタンスタイプによって制限されるため、InstanceType を指定する必要があります。

    DestinationResource パラメーターのセット方法の詳細については、この Topic の操作の説明セクションを参照してください。

    InstanceType
    ZoneId

    string

    任意

    ゾーン ID。

    デフォルト値: null。この操作は、指定されたリージョン (RegionId) のすべてのゾーンでクエリ条件に一致するリソースを返します。

    cn-hangzhou-e
    IoOptimized

    string

    任意

    インスタンスが I/O 最適化インスタンスかどうかを指定します。有効な値:

    • none: 非 I/O 最適化インスタンス。

    • optimized: I/O 最適化インスタンス。

    デフォルト値: optimized。

    optimized
    DedicatedHostId

    string

    任意

    専用ホストの ID。

    dh-bp165p6xk2tlw61e****
    InstanceType

    string

    任意

    インスタンスタイプ。詳細については、インスタンスファミリー を参照してください。 DescribeInstanceTypes を呼び出して、最新のインスタンスタイプリストをクエリすることもできます。

    InstanceType パラメーターのセット方法の詳細については、この Topic の冒頭にある操作の説明セクションを参照してください。

    ecs.g5.large
    SystemDiskCategory

    string

    任意

    システムディスクのカテゴリ。有効な値:

    • cloud: 基本ディスク。

    • cloud_efficiency: Ultra ディスク。

    • cloud_ssd: 標準 SSD。

    • ephemeral_ssd: ローカル SSD。

    • cloud_essd: ESSD (エンタープライズ SSD)。

    • cloud_auto: ESSD AutoPL ディスク。

    デフォルト値の説明:

    • InstanceType が廃止されたインスタンスタイプにセットされている場合、デフォルト値は cloud です。

    • その他の場合、デフォルト値は cloud_efficiency です。

    説明

    ResourceType が instance にセットされ、DestinationResource が DataDisk にセットされている場合、SystemDiskCategory パラメーターは必須です。このパラメーターを指定しない場合、デフォルト値が効果を持ちます。

    cloud_ssd
    DataDiskCategory

    string

    任意

    データディスクのカテゴリ。有効な値:

    • cloud: 基本ディスク。

    • cloud_efficiency: Ultra ディスク。

    • cloud_ssd: 標準 SSD。

    • ephemeral_ssd: ローカル SSD。

    • cloud_essd: ESSD (エンタープライズ SSD)。

    • cloud_auto: ESSD AutoPL ディスク。

    cloud_ssd
    NetworkCategory

    string

    任意

    ネットワークタイプ。有効な値:

    • vpc: 仮想プライベートクラウド (VPC)。

    • classic: クラシックネットワーク。クラシックネットワークは非推奨です。詳細については、廃止通知 を参照してください。

    vpc
    Cores

    integer

    任意

    インスタンスタイプの vCPU コア数。有効な値については、インスタンスファミリー を参照してください。

    このパラメーターは、DestinationResource が InstanceType にセットされている場合にのみ効果があります。

    2
    Memory

    number

    任意

    インスタンスタイプのメモリサイズ。単位: GiB。有効な値については、インスタンスファミリー を参照してください。

    このパラメーターは、DestinationResource が InstanceType にセットされている場合にのみ効果があります。

    8.0
    ResourceType

    string

    任意

    リソースのタイプ。有効な値:

    • instance: ECS インスタンス。

    • disk: クラウドディスク。

    • reservedinstance: リザーブドインスタンス。

    • ddh: 専用ホスト。

    instance
    Scope

    string

    任意

    リザーブドインスタンスの範囲。有効な値:

    • Region: リージョン。

    • Zone: ゾーン。

    Region

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID

    0041D94C-FB92-4C49-B115-259DA1C*****
    AvailableZones

    object

    AvailableZone

    array<object>

    ゾーンの在庫情報のコレクション。

    array<object>

    ゾーンの在庫情報。

    ZoneId

    string

    アベイラビリティゾーンの ID。

    cn-hangzhou-e
    Status

    string

    アベイラビリティゾーンのステータス。 取りうる値：

    • Available：ゾーン内でリソースを購入できます。 このステータスは、クエリした特定のリソースだけでなく、少なくとも 1 つのリソースタイプが利用可能であることを示します。

    • SoldOut：アベイラビリティゾーン内のすべてのリソースが売り切れです。

    Available
    StatusCategory

    string

    在庫に基づいたアベイラビリティゾーンの詳細なステータス。 取りうる値：

    • WithStock：在庫があり、再入荷されます。

    • ClosedWithStock：在庫はありますが、再入荷されません。

    • WithoutStock：在庫は売り切れですが、再入荷されます。 WithStock 状態の製品仕様を選択することを推奨します。

    • ClosedWithoutStock：在庫は売り切れで、再入荷されません。 WithStock 状態の製品仕様を選択することを推奨します。

    WithStock
    RegionId

    string

    リージョン ID。

    cn-hangzhou
    AvailableResources

    object

    利用可能なリソース。

    AvailableResource

    array<object>

    作成可能な特定のリソースの配列。

    array<object>

    作成可能な特定のリソースの詳細。

    Type

    string

    リソースタイプ。 取りうる値：

    • Zone：アベイラビリティゾーン。

    • IoOptimized：I/O 最適化。

    • InstanceType：インスタンスタイプ。

    • SystemDisk：システムディスク。

    • DataDisk：データディスク。

    • Network：ネットワークタイプ。

    • ddh：専用ホスト。

    InstanceType
    SupportedResources

    object

    サポートされているリソース。

    SupportedResource

    array<object>

    作成可能なサポートされているリソースの配列。

    object

    作成可能なサポートされているリソースの詳細。

    Status

    string

    リソースのステータス。 取りうる値：

    • Available：リソースは利用可能です。

    • SoldOut：リソースは売り切れです。

    Available
    Value

    string

    リソースの値。

    ecs.d1ne.xlarge
    Max

    integer

    クラウドディスクの最大容量。

    説明

    このパラメーターは、DestinationResource が SystemDisk または DataDisk に設定されている場合にのみ返されます。

    2048
    Unit

    string

    クラウドディスクの容量単位。

    説明

    このパラメーターは、DestinationResource が SystemDisk または DataDisk に設定されている場合にのみ返されます。

    GiB
    StatusCategory

    string

    在庫に基づいたリソースの詳細なステータス。 取りうる値：

    • WithStock：在庫があり、再入荷されます。

    • ClosedWithStock：在庫はありますが、再入荷されません。

    • WithoutStock：在庫は売り切れですが、再入荷されます。 WithStock 状態の製品仕様を選択することを推奨します。

    • ClosedWithoutStock：在庫は売り切れで、再入荷されません。 WithStock 状態の製品仕様を選択することを推奨します。

    WithStock
    Min

    integer

    クラウドディスクの最小容量。

    説明

    このパラメーターは、DestinationResource が SystemDisk または DataDisk に設定されている場合にのみ返されます。

    20

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "0041D94C-FB92-4C49-B115-259DA1C*****",
  "AvailableZones": {
    "AvailableZone": [
      {
        "ZoneId": "cn-hangzhou-e",
        "Status": "Available",
        "StatusCategory": "WithStock",
        "RegionId": "cn-hangzhou",
        "AvailableResources": {
          "AvailableResource": [
            {
              "Type": "InstanceType",
              "SupportedResources": {
                "SupportedResource": [
                  {
                    "Status": "Available",
                    "Value": "ecs.d1ne.xlarge",
                    "Max": 2048,
                    "Unit": "GiB",
                    "StatusCategory": "WithStock",
                    "Min": 20
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 Invalid.InstanceChargeType The specified InstanceChargeType is not valid.
    400 Invalid.Param The input parameter DestinationResource that is mandatory for processing this request is not supplied.
    400 InvalidRegionId.MalFormed The specified parameter RegionId is not valid.
    403 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist.
    403 InvalidParam.TypeAndCpuMem.Conflict The specified 'InstanceType' and 'Cores','Memory' are not blank at the same time.
    403 InvalidParam.Cores The specified parameter 'Cores' should be empty.
    403 InvalidParam.Memory The specified parameter 'Memory' should be empty.
    403 InvalidParameter.Scope The specified parameter Scope is invalid.
    403 OperationDenied.RegionIdNotSupported The region does not support preemptible instances.
    403 OperationDenied.FlavorNotSupported The flavor does not support preemptible instances.
    403 OperationDenied.TimestampNotSupported Preemptible instances are not for sale for current time.
    403 InvalidParameter.ResourceOwnerId The specified parameter ResourceOwnerId is not available anymore.
    404 Invalid.RegionId The specified RegionId does not exist.
    404 Unavailable.Regions The available region does not exist.
    404 Invalid.ResourceType The ResourceType provided does not exist in our records.
    404 Invalid.DestinationResource The specified DestinationResource is not valid.
    404 Invalid.IoOptimized The specified IoOptimized is not valid.
    404 Invalid.NetworkCategory The specified NetworkCategory is not valid.
    404 Invalid.SpotStrategy The specified SpotStrategy is not valid.
    404 Invalid.NetworkType The specified NetworkType is not valid.
    404 InvalidResourceId.NotFound The specified ResourceId is not found in our records.
    404 InvalidRegionId.NotFound The RegionId provided does not exist in our records.
    404 InvalidDedicatedHostId.NotFound The specified Dedicated Host does not exist.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。