Todos os produtos
Search
Central de documentação

PolarDB:ModifyDBNodeClass

Última atualização: Jun 26, 2026

Altera as especificações dos nós de um cluster PolarDB.

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

DBClusterId

string

Sim

O ID do cluster.

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

ModifyType

string

Sim

O tipo de alteração de especificação. Valores válidos:

  • Upgrade: atualiza as especificações.

  • Downgrade: reduz as especificações.

Upgrade

DBNodeTargetClass

string

Sim

As especificações de destino para todos os nós. Para mais informações, consulte Especificações de nós de computação.

polar.mysql.x4.large

ClientToken

string

Não

O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor. Certifique-se de que o valor seja exclusivo entre diferentes solicitações. O token diferencia maiúsculas de minúsculas e pode conter no máximo 64 caracteres ASCII.

6000170000591aed949d0f54a343f1a4233c1e7d1c5c******

PlannedStartTime

string

Não

O horário de início mais cedo da tarefa agendada de alteração de especificação. Especifique o horário no formato YYYY-MM-DDThh:mm:ssZ (UTC).

Nota
  • Este parâmetro entra em vigor quando ModifyType é definido como Upgrade ou Downgrade.

  • O horário de início deve estar dentro das próximas 24 horas. Por exemplo, se o horário atual for 2021-01-14T09:00:00Z, o intervalo válido para o horário de início é de 2021-01-14T09:00:00Z a 2021-01-15T09:00:00Z.

  • Se este parâmetro for deixado em branco, a tarefa de alteração de especificação será executada imediatamente.

2021-01-14T09:00:00Z

PlannedEndTime

string

Não

O horário de início mais tarde da tarefa agendada de alteração de especificação. Especifique o horário no formato YYYY-MM-DDThh:mm:ssZ (UTC).

Nota
  • O horário mais tarde deve ser pelo menos 30 minutos após o horário de início.

  • Se PlannedStartTime for definido, mas este parâmetro não for especificado, o horário mais tarde terá como padrão horário de início + 30 minutos. Por exemplo, se PlannedStartTime for definido como 2021-01-14T09:00:00Z e este parâmetro for deixado em branco, a tarefa começará no máximo às 2021-01-14T09:30:00Z.

2021-01-14T09:30:00Z

SubCategory

string

Não

A sub-série do cluster. Valores válidos:

  • normal_exclusive: Dedicado

  • normal_general: Uso geral

Este parâmetro é obrigatório quando você altera as especificações entre Dedicado e Uso geral.

normal_general

DBNodeType

string

Não

O tipo de nó. Defina este parâmetro como DLNode apenas quando alterar as especificações de um nó de IA.

Valores válidos:

  • DLNode :

    Nó de IA.

DLNode

PlannedFlashingOffTime

string

Não

O horário planejado de desconexão transitória.

2021-01-14T09:30:00Z

CloudProvider

string

Não

O provedor de serviços de nuvem da instância.

ENS

AutoUseCoupon

boolean

Não

Especifica se deve usar cupons automaticamente. Valores válidos:

  • true (padrão): Usa cupons.

  • false: Não usa cupons.

true

PromotionCode

string

Não

O código do cupom. Se este parâmetro não for especificado, o cupom padrão será usado.

727xxxxxx934

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

685F028C-4FCD-407D-A559-072D63******

DBClusterId

string

O ID do cluster de banco de dados.

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

OrderId

string

O ID do pedido.

2035629******

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "685F028C-4FCD-407D-A559-072D63******",
  "DBClusterId": "pc-*************",
  "OrderId": "2035629******"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 ORDER.ARREARAGE 您有欠费账单,不符合购买条件,请先结清账单后再购买 You must settle the overdue payments for your account before you can make a purchase.
400 InsufficientResourceCapacity The resource is insufficient. Insufficient resources.
400 InvalidModifyType.Malformed The specified parameter ModifyType is not valid. The specified ModifyType parameter is invalid.
403 OperationDenied.RoEqualSpec must exist at least ro class equal with rw The number of read-only nodes must be equal to or greater than that of primary nodes.
403 OperationDenied.DBClusterStatus The operation is not permitted due to status of cluster. The PolarDB cluster does not support this operation in the current state.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.