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

Atualiza a versão secundária 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

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

update

*All Resource

*

Nenhuma

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBClusterId	string	Sim	O ID do cluster.	pc-a************
UpgradePolicy	string	Não	A política de atualização para a versão do kernel. Valores válidos: HOT: atualização a quente COLD: atualização a frio. Este método de atualização é suportado apenas para clusters PolarDB for MySQL 8.0.	HOT
UpgradeLabel	string	Não	O rótulo para a atualização da versão do kernel. Defina o valor como INNOVATE. Nota Este parâmetro é aplicável apenas quando você atualiza um cluster PolarDB for MySQL 8.0.1 para PolarDB for MySQL 8.0.2. Se você especificar este parâmetro, deverá definir `UpgradePolicy` como COLD.	INNOVATE
PlannedStartTime	string	Não	O horário mais cedo para iniciar a atualização agendada do kernel. Especifique o horário no formato `YYYY-MM-DDThh:mm:ssZ`. O horário está em UTC. Nota O horário de início pode ser qualquer momento dentro das próximas 24 horas. Por exemplo, se o horário atual for `2021-01-14T09:00:00Z`, você pode especificar um horário no intervalo de `2021-01-14T09:00:00Z` a `2021-01-15T09:00:00Z`. Se você não especificar este parâmetro, a tarefa de atualização será executada imediatamente.	2022-04-28T14:00:00Z
PlannedEndTime	string	Não	O horário mais tarde para iniciar a tarefa agendada. Especifique o horário no formato `YYYY-MM-DDThh:mm:ssZ`. O horário está em UTC. 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, o horário de início mais tarde será 30 minutos após o valor de `PlannedStartTime` por padrão. Por exemplo, se você definir `PlannedStartTime` como `2021-01-14T09:00:00Z` e deixar este parâmetro vazio, a tarefa começará no máximo às `2021-01-14T09:30:00Z`.	2021-01-14T09:30:00Z
FromTimeService	boolean	Não	Especifica se a atualização do kernel deve ser executada imediatamente ou agendada. Valores válidos: false (padrão): Agenda a atualização. true: Executa a atualização imediatamente. Nota Você não precisa especificar este parâmetro ao chamar esta operação.	false
UpgradeType	string	Não	O tipo de atualização. Valores válidos: PROXY: Atualiza apenas o proxy de banco de dados (PolarProxy). DB: Atualiza apenas o kernel. ALL (padrão): Atualiza tanto o proxy de banco de dados (PolarProxy) quanto o kernel.	PROXY
TargetDBRevisionVersionCode	string	Não	O código da versão do banco de dados de destino. Você pode obter esse valor chamando a operação DescribeDBClusterVersion.	20230707
TargetProxyRevisionVersionCode	string	Não	O código da versão do proxy de destino. Você pode obter esse valor chamando a operação DescribeDBClusterVersion.	20240702
ClientToken	string	Não	Um token exclusivo e sensível a maiúsculas e minúsculas que você fornece para garantir a idempotência da solicitação. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento.	6000170000591aed949d0f54a343f1a4233c1e7d1c5c******

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	CAE6755F-B79A-4861-B227-801FE8******

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CAE6755F-B79A-4861-B227-801FE8******"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ScheduleTaskExist	The specified dbCluster already has a scheduled task.	The specified cluster already has a scheduled task.
400	InvalidUpgradeLabel.Malformed	The specified parameter UpgradeLabel is not valid.	The specified UpgradeLabel parameter is invalid.
400	InvalidEngine.Unsupported	The specified Engine does not support this feature.	This feature is not supported by the specified engine.
400	InvalidEngineMinorVersion.Malformed	The specified parameter MinorVersion is not valid.	The specified MinorVersion parameter is invalid.
400	InvalidEngineVersion.Unsupported	The specified engineVersion is not supported.	The specified engineVersion parameter is not supported.
400	InvalidUpgradePolicy.Malformed	The specified parameter UpgradePolicy is not valid.	The specified UpgradePolicy parameter is invalid.
400	InvalidSwitchTimeMode.Malformed	The specified parameter SwitchTimeMode is not valid.	The specified SwitchTimeMode parameter is invalid.
403	OperationDenied.UpgradeType	The operation is not permitted due to gdn limit	The current upgrade is not supported due to GDN limits.
403	IncorrectGdnStandbyDBVersion	Current gdn standby cluster is not the latest db version.	The current secondary cluster of the GDN does not run the latest database version.
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	The specified DBClusterId parameter does not exist in the current record.
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	The specified DBClusterId 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.