Todos os produtos
Search
Central de documentação

PolarDB:ModifyDBNodesClass

Última atualização: Jun 28, 2026

Modifica as especificações de um único nó em 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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

polardb:ModifyDBNodesClass

update

*DBCluster

acs:polardb:{#regionId}:{#accountId}:{#resource-type}/{#resource-id}

Nenhuma Nenhuma

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 modificação. Valores válidos:

  • Upgrade: Atualiza as especificações.

  • Downgrade: Realiza o downgrade das especificações.

Upgrade

DBNode

array<object>

Sim

A lista de nós do cluster.

object

Não

DBNodeId

string

Não

O ID do nó do cluster.

Nota

Se você especificar este parâmetro, também deverá especificar DBNode.N.TargetClass. N representa o índice do nó na solicitação, começando em 1.

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

TargetClass

string

Não

As especificações de destino do nó. Para obter mais informações sobre as especificações do nó, consulte especificações do nó de computação.

Nota

Se você especificar este parâmetro, também deverá especificar DBNode.N.DBNodeId. N representa o índice do nó na solicitação, começando em 1.

polar.mysql.x4.medium

ClientToken

string

Não

Um token gerado pelo cliente para garantir a idempotência da solicitação. Este token deve ser exclusivo para cada solicitação e deve ser uma string que diferencia maiúsculas de minúsculas com até 64 caracteres ASCII.

6000170000591aed949d0f54a343f1a4233c1e7d1c5c******

PlannedStartTime

string

Não

O horário mais cedo para iniciar a atualização agendada das especificações do nó. Especifique o horário em UTC usando o formato YYYY-MM-DDThh:mm:ssZ.

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

  • O horário especificado deve estar dentro das próximas 24 horas.

  • Se este parâmetro não for especificado, a tarefa de atualização será executada imediatamente.

2021-01-14T09:00:00Z

PlannedEndTime

string

Não

O horário mais tarde para iniciar a tarefa agendada. Especifique o horário em UTC usando o formato YYYY-MM-DDThh:mm:ssZ.

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

  • Se você especificar PlannedStartTime, mas não este parâmetro, a tarefa começará dentro de 30 minutos após o PlannedStartTime. Por exemplo, se você definir PlannedStartTime como 2021-01-14T09:00:00Z e deixar este parâmetro vazio, a tarefa começará até 2021-01-14T09:30:00Z.

2021-01-14T09:30:00Z

SubCategory

string

Não

A subcategoria do cluster. Valores válidos:

  • normal_exclusive: especificações dedicadas

  • normal_general: especificações de uso geral

normal_general

PlannedFlashingOffTime

string

Não

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

2021-01-14T09:30:00Z

CloudProvider

string

Não

O provedor de nuvem da instância.

ENS

AutoUseCoupon

boolean

Não

Especifica se um cupom deve ser aplicado automaticamente. Valores válidos:

  • true (Padrão): Um cupom é aplicado automaticamente.

  • false: Um cupom não é aplicado.

PromotionCode

string

Não

O código do cupom. Se você não especificar este parâmetro, um cupom padrão será aplicado.

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 InvalidModifyType.Malformed The specified parameter ModifyType is not valid. The specified ModifyType parameter is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.