Todos os produtos
Search
Central de documentação

PolarDB:DescribeDBClusterPrice

Última atualização: Jul 10, 2026

Consulta o preço de um cluster.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

DBNodeClass

string

Não

As especificações do nó. Obrigatório para o cenário BUY. Formato de exemplo: polar.mysql.x4.large.

polar.mysql.x4.large

DBType

string

Não

O tipo de mecanismo de banco de dados. Obrigatório para o cenário BUY. Valores válidos: MySQL, PostgreSQL e Oracle.

MySQL

DBVersion

string

Não

A versão do mecanismo de banco de dados. Obrigatório para o cenário BUY. Valores válidos para MySQL: 5.6, 5.7 e 8.0. Valores válidos para PostgreSQL: 11 e 14. Valores válidos para Oracle: 11 e 14.

8.0

PayType

string

Não

O método de cobrança. Obrigatório para os cenários BUY e CONVERT. Valores válidos:

  • Prepaid: assinatura.

  • Postpaid: pago conforme o uso.

Prepaid

OrderType

string

Sim

O tipo de pedido. Valores válidos:

  • BUY: nova compra.

  • CONVERT: conversão de método de cobrança.

  • RENEW: renovação.

  • UPGRADE: upgrade de especificações ou adição de nós.

  • DOWNGRADE: downgrade de especificações ou remoção de nós.

BUY

RegionId

string

Sim

O ID da região.

cn-hangzhou

ZoneId

string

Não

O ID da zona. Recomendamos que você especifique este parâmetro para o cenário BUY.

cn-hangzhou-h

DBNodeNum

integer

Não

O número de nós. Válido para o cenário BUY. Este valor inclui o nó de leitura/gravação. Valor mínimo: 1. Valor padrão: 1.

2

CreationCategory

string

Não

A edição do cluster. Valores válidos:

  • Normal: Cluster Edition.

  • Basic: Single Node Edition.

  • ArchiveNormal: Archive Database.

  • SENormal: Standard Edition.

  • NormalMultimaster: Multi-master Cluster.

Normal

StorageSpace

string

Não

O espaço de armazenamento, em GB. Usado para cenários de armazenamento pré-pago ou alteração de especificação de armazenamento.

50

StorageType

string

Não

O tipo de armazenamento. Valores válidos:

  • PSL5: alta performance.

  • PSL4: padrão.

  • ESSDPL0

  • ESSDPL1

  • ESSDPL2

  • ESSDPL3

  • ESSDAUTOPL

PSL5

StorageChargeType

string

Não

O tipo de cobrança de armazenamento. Valores válidos:

  • Prepaid: assinatura.

  • Postpaid: pago conforme o uso.

Prepaid

ProvisionedIops

string

Não

Os IOPS provisionados. Usado para o cenário Standard Edition (SENormal).

1000

HotStandbyCluster

string

Não

Especifica se o cluster hot standby deve ser ativado. Valores válidos:

  • ON: Ativar.

  • OFF: Desativar.

Válido para os cenários BUY e de alteração de especificação.

ON

ServerlessType

string

Não

O tipo serverless. Valores válidos: AgileServerless.

AgileServerless

DBClusterId

string

Não

O ID do cluster. Obrigatório para cenários não-BUY.

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

UsedTime

string

Não

A duração da assinatura. Usado em conjunto com Period. Válido para os cenários BUY, CONVERT e RENEW quando o método de cobrança é Prepaid.

1

Period

string

Não

O ciclo de assinatura. Valores válidos:

  • Month: mensal.

  • Year: anual.

Month

DBNodes

array<object>

Não

A lista de nós de alteração de especificação heterogênea. Usado para cenários de alteração de especificação para definir as especificações alvo de cada nó.

object

Não

As informações do nó.

DBNodeId

string

Não

O ID do nó.

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

DBNodeClass

string

Não

As especificações alvo do nó.

polar.mysql.x4.large

ModifyType

string

Não

A direção da alteração de especificação. Valores válidos:

  • ADD: adicionar nós.

  • DELETE: remover nós.

  • UPGRADE: upgrade de especificações.

  • DOWNGRADE: downgrade de especificações.

  • HOT_STANDBY: alteração de hot standby.

  • STORAGE: alteração de espaço de armazenamento.

  • STORAGE_TYPE: alteração de tipo de armazenamento.

UPGRADE

DBNodeIds

array

Não

A lista de IDs de nós a serem excluídos. Usado quando ModifyType está definido como DELETE.

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

string

Não

O ID do nó.

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

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

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

ShowDiscount

boolean

Indica se descontos são permitidos.

False

OrderType

string

O tipo de pedido. Valores válidos:

  • BUY: nova compra.

  • UPGRADE: alteração de especificação.

  • RENEW: renovação.

  • CONVERT: conversão de método de cobrança.

BUY

PriceInfo

object

Os detalhes do preço.

Currency

string

A unidade monetária.

CNY

OriginalPrice

number

O preço original.

1099.0

TradePrice

number

O preço final, que é o preço original menos o desconto.

165.0

DiscountPrice

number

O valor do desconto.

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>

A regra de promoção.

object

A regra de promoção.

RuleId

integer

rule-xxx

Name

string

rule-xxx

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.