すべてのプロダクト
Search
ドキュメントセンター

:DescribeContainerGroupPrice

最終更新日:Oct 17, 2025

Elastic Container Instance (ECI) インスタンスの価格を照会します。

操作説明

  • この操作は、リソースグループベースの認証をサポートしていません。

  • ECI インスタンスは、vCPU の数とメモリサイズを指定するか、ECS インスタンスタイプを指定して作成できます。この操作を呼び出して価格を照会するときは、サポートされている仕様を指定してください。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

eci:DescribeContainerGroupPrice

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

リージョン ID。 DescribeRegions を呼び出して、リージョンとゾーンに関する最新情報を照会できます。

cn-hangzhou

RegionId

string

必須

リージョン ID。 DescribeRegions を呼び出して、リージョンとゾーンに関する最新情報を照会できます。

cn-hangzhou

Cpu

number

任意

vCPU の数。 ECI でサポートされている vCPU とメモリの仕様の詳細については、「vCPU とメモリの仕様」をご参照ください。

2.0

Memory

number

任意

メモリサイズ。 単位: GiB。 ECI でサポートされている vCPU とメモリの仕様の詳細については、「vCPU とメモリの仕様」をご参照ください。

4.0

InstanceType

string

任意

ECS インスタンスタイプ。 ECI でサポートされている ECS インスタンスタイプの詳細については、「ECI でサポートされる ECS インスタンスタイプ」をご参照ください。

説明

このパラメーターを設定すると、Cpu および Memory パラメーターに指定した値は無視されます。 ECS インスタンスタイプの価格のみが返されます。

ecs.c5.large

SpotStrategy

string

任意

インスタンスのプリエンプションポリシー。 有効な値:

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

  • SpotWithPriceLimit: 1 時間あたりの最大価格を指定するスポットインスタンス。

  • SpotAsPriceGo: 現在の市場価格に基づいてシステムが自動的に入札するスポットインスタンス。

デフォルト値: NoSpot。

SpotWithPriceLimit

ZoneId

string

任意

ゾーン ID。 DescribeRegions を呼び出して、リージョンとゾーンに関する最新情報を照会できます。

cn-hangzhou-g

SpotPriceLimit

number

任意

スポットインスタンスの 1 時間あたりの最大価格。 値は小数点以下 3 桁まで正確に指定できます。 このパラメーターは、SpotStrategy が SpotWithPriceLimit に設定されている場合に必要です。

0.2

EphemeralStorage

integer

任意

一時記憶領域のサイズ。 単位: GiB。

20

SpotDuration

integer

任意

スポットインスタンスの保護期間。 単位: 時間。 デフォルト値: 1。 値 0 は、保護期間が指定されていないことを示します。

1

ComputeCategory

string

任意

計算能力のカテゴリ。 値を `economy` に設定して、エコノミー型インスタンスタイプの価格を照会します。

economy

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

7A872585-33C7-4D69-AB8E-412E81EBA387

PriceInfo

object

価格とプロモーションルールを含む価格情報。

SpotPrices

object

SpotPrice

array<object>

スポットインスタンスの価格情報。

object

ZoneId

string

ゾーン ID。

cn-hangzhou-i

SpotPrice

number

スポットインスタンスの価格。

0.056

InstanceType

string

インスタンスタイプ。

ecs.c5.large

OriginPrice

number

元の価格。

0.622

Price

object

価格。

DiscountPrice

number

割引価格。

0

TradePrice

number

最終価格。元の価格から割引額を引いたものです。

0.00012252

OriginalPrice

number

元の価格。

0.00012252

DetailInfos

object

DetailInfo

array<object>

価格の詳細。

array<object>

Resource

string

リソース名。

cpu

DiscountPrice

number

割引価格。

0

TradePrice

number

取引価格。

0.000098

OriginalPrice

number

元の価格。

0.000098

Rules

object

Rule

array<object>

価格ルール。

object

Description

string

ルールの説明。

*****

RuleId

integer

ルール ID。

123456

Currency

string

通貨。 有効な値:

  • CNY: この値は、中国サイト (aliyun.com) でのみ使用できます。

  • USD: この値は、国際サイト (alibabacloud.com) でのみ使用できます。

CNY

Rules

object

Rule

array<object>

プロモーションルール。

object

Description

string

プロモーションルールの説明。

*****

RuleId

integer

プロモーション ID。

123456

成功レスポンス

JSONJSON

{
  "RequestId": "7A872585-33C7-4D69-AB8E-412E81EBA387",
  "PriceInfo": {
    "SpotPrices": {
      "SpotPrice": [
        {
          "ZoneId": "cn-hangzhou-i",
          "SpotPrice": 0.056,
          "InstanceType": "ecs.c5.large",
          "OriginPrice": 0.622
        }
      ]
    },
    "Price": {
      "DiscountPrice": 0,
      "TradePrice": 0.00012252,
      "OriginalPrice": 0.00012252,
      "DetailInfos": {
        "DetailInfo": [
          {
            "Resource": "cpu",
            "DiscountPrice": 0,
            "TradePrice": 0.000098,
            "OriginalPrice": 0.000098,
            "Rules": {
              "Rule": [
                {
                  "Description": "*****",
                  "RuleId": 123456
                }
              ]
            }
          }
        ]
      },
      "Currency": "CNY"
    },
    "Rules": {
      "Rule": [
        {
          "Description": "*****",
          "RuleId": 123456
        }
      ]
    }
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParam.CpuOrMemorySpec The specified specification is invalid.
400 TradeBidCommodityNotMatch The trade ID and the commodity do not match.
400 InvalidSpotCpuMemorySpec The specified CPU and memory are not allowed. You must create spot ECI using standard ECS specifications for CPU and memory.
400 FeatureBasedConstraintConflict A conflict occurs in specified feature constraints: [%s].
403 Spot.NotMatched %s. We recommend that you use the create multi-zone function to avoid insufficient inventory. For more information, see https://www.alibabacloud.com/help/document_detail/157290.html
403 FeatureAccessRestricted Access to this feature:[%s] is restricted. Please contact Alibaba Cloud ECI support to request access.

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

変更履歴

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