TempModifyDBNode - PolarDB: Central de Documentação do Alibaba Cloud

Modifica temporariamente a configuração de um nó.

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:TempModifyDBNode

update

*DBCluster

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	Um token de cliente para garantir a idempotência da solicitação. Gere um token exclusivo para cada solicitação. O token diferencia maiúsculas de minúsculas e pode ter até 64 caracteres ASCII.	6000170000591aed949d0f5********************
DBClusterId	string	Sim	O ID do cluster.	pc-xxxxxxxxxx
OperationType	string	Sim	O tipo de operação. Valores válidos: Modify: atualização temporária Add: adicionar temporariamente um nó	Modify
ModifyType	string	Sim	O tipo de modificação. O valor é fixo como TempUpgrade.	TempUpgrade
DBNode	array<object>	Sim	As informações sobre os nós a serem atualizados ou adicionados.
	object	Não
TargetClass	string	Não	As especificações do nó a ser atualizado ou adicionado. Nota Ao adicionar um nó, as especificações do nó devem ser iguais às especificações dos nós existentes. Para obter mais informações sobre as especificações dos nós de cluster existentes, consulte DescribeDBClusters.	polar.mysql.x4.medium
ZoneId	string	Não	A zona para o novo nó. A zona deve ser a mesma dos nós existentes.	cn-hangzhou-i
RestoreTime	string	Sim	O horário para reverter a atualização temporária. O formato é AAAA-MM-DD hh:mm:ss. Nota O horário de reversão deve ser pelo menos 1 hora após o horário atual. Também deve ser pelo menos 1 dia antes da expiração do cluster.	2021-09-23 18:16:00
AutoUseCoupon	boolean	Não
PromotionCode	string	Não		727xxxxxx934

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
DBClusterId	string	O ID do cluster.	pc-xxxxxxxxxxxxxxxxx
DBNodeIds	array	A lista de nós.
	string	A lista de nós. Nota Este parâmetro é retornado apenas quando OperationType é definido como Add. Se OperationType for definido como Modify, um valor vazio será retornado.	pi-***************
OrderId	string	O ID do pedido.	2035638*******
RequestId	string	O ID da solicitação.	69A85BAF-1089-4CDF-A82F-0A140F******

Exemplos

Resposta de sucesso

JSON formato

{
  "DBClusterId": "pc-xxxxxxxxxxxxxxxxx",
  "DBNodeIds": [
    "pi-***************"
  ],
  "OrderId": "2035638*******",
  "RequestId": "69A85BAF-1089-4CDF-A82F-0A140F******"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDBType.Malformed	The Specified DBType is not valid.	The specified database type is invalid.
400	InvalidDBNodeNum.Malformed	The number of parameter DBNode.N is not valid.	The specified number of database nodes is invalid.
400	InvalidDBNode.Malformed	The specified parameter DBNode.N is not valid.	The specified DBNode.N parameter is invalid.
400	InvalidModifyType.Malformed	The specified parameter ModifyType is not valid.	The specified ModifyType parameter is invalid.
400	InvalidZoneId.Malformed	The specified parameter ZoneId is not valid.	The specified ZoneId parameter is invalid.
400	InvalidDBNodeClass.Malformed	The specified parameter DBNodeClass is not valid.	The specified DBNodeClass parameter is invalid.
403	OperationDenied.TempAddNodeDuring	This operation is not allowed during the temporary add node of the cluster.	This operation is not supported during temporary node addition.
404	InvalidDBCluster.NotFound	The specified DBClusterId is not found.	The specified cluster ID does not exist.
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	The specified DBClusterId parameter is invalid.
404	InvalidRestoreTimeExceedsExpirationTime.Malformed	The RestoreTime cannot be later than 1 day before the cluster ExpirationTime.	The value of RestoreTime can be up to 1 day earlier than the expiration time of the cluster.
404	InvalidCurrentTimeExceedsRestoreTime.Malformed	The RestoreTime cannot be 1 hour later than the CurrentTime.	The value of RestoreTime cannot be 1 hour later than the value of CurrentTime.
404	InvalidRestoreTime.Malformed	The specified RestoreTime is not valid.	The specified RestoreTime parameter is invalid.
404	InvalidOperationType.Malformed	The specified OperationType is not valid.	The specified OperationType 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.