全部產品
Search
文件中心

PolarDB:DescribeDBClusterPrice

更新時間:Jul 10, 2026

查詢叢集價格。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

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(叢集版)、Basic(單節點)、ArchiveNormal(歸檔版)、SENormal(標準版)、NormalMultimaster(多主叢集)。

Normal

StorageSpace

string

儲存空間,單位為 GB。預付費儲存或儲存變配場景使用。

50

StorageType

string

儲存類型。取值:PSL5(高效能)、PSL4(標準)、ESSDPL0、ESSDPL1、ESSDPL2、ESSDPL3、ESSDAUTOPL。

PSL5

StorageChargeType

string

儲存計費類型。取值:Prepaid(預付費)、Postpaid(按量付費)。

Prepaid

ProvisionedIops

string

預配置 IOPS。標準版(SENormal)場景使用。

1000

HotStandbyCluster

string

是否開啟熱備叢集。取值:ON(開啟)、OFF(關閉)。BUY 場景和變更場景有效。

ON

ServerlessType

string

Serverless 類型。取值:AgileServerless。

AgileServerless

DBClusterId

string

叢集 ID。非 BUY 場景必填。

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

UsedTime

string

購買時長。與 Period 配合使用,BUY/CONVERT/RENEW 場景且付費類型為 Prepaid 時有效。

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

樣本

正常返回樣本

JSON格式

{
  "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"
      }
    ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情