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

PolarDB:DescribeDBClusterPrice

最終更新日:Jul 10, 2026

クラスターの価格を照会します。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

DBNodeClass

string

任意

ノードスペック。BUY シナリオで必須です。例のフォーマット: polar.mysql.x4.large。

polar.mysql.x4.large

DBType

string

任意

データベースエンジンタイプ。BUY シナリオで必須です。有効な値: MySQL、PostgreSQL、Oracle。

MySQL

DBVersion

string

任意

データベースエンジンバージョン。BUY シナリオで必須です。MySQL の有効な値: 5.6、5.7、8.0。PostgreSQL の有効な値: 11、14。Oracle の有効な値: 11、14。

8.0

PayType

string

任意

課金方法。BUY および CONVERT シナリオで必須です。有効な値:

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

  • Postpaid: 従量課金。

Prepaid

OrderType

string

必須

注文タイプ。有効な値:

  • BUY: 新規購入。

  • CONVERT: 課金方法の変更。

  • RENEW: 更新。

  • UPGRADE: スペックアップまたはノード追加。

  • DOWNGRADE: スペックダウンまたはノード削除。

BUY

RegionId

string

必須

リージョン ID。

cn-hangzhou

ZoneId

string

任意

ゾーン ID。BUY シナリオではこのパラメーターを指定することを推奨します。

cn-hangzhou-h

DBNodeNum

integer

任意

ノード数。BUY シナリオで有効です。この値には読み取り/書き込みノードが含まれます。最小値: 1。デフォルト値: 1。

2

CreationCategory

string

任意

クラスターエディション。有効な値:

  • Normal: Cluster Edition。

  • Basic: Single Node Edition。

  • ArchiveNormal: アーカイブデータベース。

  • SENormal: Standard Edition。

  • NormalMultimaster: マルチマスタークラスター。

Normal

StorageSpace

string

任意

ストレージ容量 (GB)。前払いストレージまたはストレージ仕様変更シナリオで使用します。

50

StorageType

string

任意

ストレージタイプ。有効な値:

  • PSL5: 高パフォーマンス。

  • PSL4: 標準。

  • ESSDPL0

  • ESSDPL1

  • ESSDPL2

  • ESSDPL3

  • ESSDAUTOPL

PSL5

StorageChargeType

string

任意

ストレージ課金タイプ。有効な値:

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

  • Postpaid: 従量課金。

Prepaid

ProvisionedIops

string

任意

プロビジョニング済み IOPS。Standard Edition (SENormal) シナリオで使用します。

1000

HotStandbyCluster

string

任意

ホットスタンバイクラスターを有効にするかどうかを指定します。有効な値:

  • ON: 有効。

  • OFF: 無効。

BUY および仕様変更シナリオで有効です。

ON

ServerlessType

string

任意

サーバーレスタイプ。有効な値: AgileServerless。

AgileServerless

DBClusterId

string

任意

クラスター ID。非 BUY シナリオで必須です。

pc-**************

UsedTime

string

任意

サブスクリプション期間。Period と併用します。課金方法が Prepaid の場合、BUY、CONVERT、RENEW シナリオで有効です。

1

Period

string

任意

サブスクリプションサイクル。有効な値:

  • Month: 月額。

  • Year: 年額。

Month

DBNodes

array<object>

任意

異種仕様変更ノードのリスト。仕様変更シナリオで各ノードのターゲット仕様を指定するために使用します。

object

任意

ノード情報。フォーマットに従って指定します。

DBNodeId

string

任意

ノードの ID。

pi-**************

DBNodeClass

string

任意

ターゲットノードスペック。

polar.mysql.x4.large

ModifyType

string

任意

仕様変更の方向。有効な値:

  • ADD: ノード追加。

  • DELETE: ノード削除。

  • UPGRADE: スペックアップ。

  • DOWNGRADE: スペックダウン。

  • HOT_STANDBY: ホットスタンバイ変更。

  • STORAGE: ストレージ容量変更。

  • STORAGE_TYPE: ストレージタイプ変更。

UPGRADE

DBNodeIds

array

任意

削除するノード ID のリスト。ModifyType が DELETE に設定されている場合に使用します。

pi-**************

string

任意

ノードの ID。

pi-***************

レスポンスフィールド

フィールド

型

説明

例

object

RequestId

string

リクエスト ID。

7E2FE3BB-C677-5FF9-9FC5-XXX

ShowDiscount

boolean

割引が適用されるかどうかを示します。

False

OrderType

string

注文タイプ。有効な値:

  • BUY: 新規購入。

  • UPGRADE: 仕様変更。

  • RENEW: 更新。

  • CONVERT: 課金方法の変更。

BUY

PriceInfo

object

価格の詳細。

Currency

string

通貨単位。

CNY

OriginalPrice

number

元の価格。

1099.0

TradePrice

number

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

165.0

DiscountPrice

number

割引額。

1978.2

RuleIds

object

RuleId

array

string

[8]

Coupons

object

Coupon

array<object>

object

CouponNo

string

779643240541

Name

string

coupon

IsSelected

string

false

Rules

object

Rule

array<object>

プロモーションルール。

object

プロモーションルール。

RuleId

integer

rule-xxx

Name

string

rule-xxx

例

成功レスポンス

JSONJSON

{
  "RequestId": "7E2FE3BB-C677-5FF9-9FC5-XXX",
  "ShowDiscount": true,
  "OrderType": "BUY",
  "PriceInfo": {
    "Currency": "CNY",
    "OriginalPrice": 1099,
    "TradePrice": 165,
    "DiscountPrice": 1978.2,
    "RuleIds": {
      "RuleId": [
        "[8]"
      ]
    },
    "Coupons": {
      "Coupon": [
        {
          "CouponNo": "779643240541",
          "Name": "coupon",
          "IsSelected": "false"
        }
      ]
    }
  },
  "Rules": {
    "Rule": [
      {
        "RuleId": 0,
        "Name": "rule-xxx"
      }
    ]
  }
}

エラーコード

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

変更履歴

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