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

Atualiza a versão do kernel de um cluster do PolarDB for MySQL.

Descrição da operação

Nota

Você pode atualizar apenas a versão de revisão de um cluster do PolarDB for MySQL, por exemplo, de 8.0.1.1.3 para 8.0.1.1.4.
Você pode usar apenas sua conta Alibaba Cloud para criar tarefas agendadas que atualizam a versão do kernel de um cluster do PolarDB for MySQL. Usuários RAM não estão autorizados a atualizar a versão do kernel de um cluster do PolarDB for MySQL.

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

update

*dbcluster

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBClusterId	string	Sim	O ID do cluster.	pc-****************
UpgradePolicy	string	Não	A política de atualização da versão do mecanismo. Valores válidos: HOT: atualização a quente. COLD: atualização a frio. Apenas o PolarDB for MySQL 8.0 Cluster Edition oferece suporte a este método de atualização.	HOT
UpgradeLabel	string	Não	A tag de atualização. O valor é fixo como INNOVATE. Nota Este parâmetro é aplicável apenas quando você atualiza o PolarDB for MySQL 8.0.1 para o 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 de início mais cedo para executar a tarefa que atualiza a versão do kernel do cluster. Especifique o horário no formato `YYYY-MM-DDThh:mm:ssZ`. O horário deve estar em UTC. Nota O horário de início mais cedo da tarefa pode ser um momento dentro das próximas 72 horas. Por exemplo, se o horário atual for `2021-01-14T09:00:00Z`, você pode especificar um horário de `2021-01-14T09:00:00Z` a `2021-01-17T09:00:00Z`. Se você não especificar este parâmetro, a tarefa de atualização do kernel será executada imediatamente após o envio da solicitação.	2021-01-14T09:00:00Z
PlannedEndTime	string	Não	O horário de início mais tarde para executar a tarefa que atualiza a versão do kernel do cluster. Especifique o horário no formato `YYYY-MM-DDThh:mm:ssZ`. O horário deve estar em UTC. Nota O valor deste parâmetro deve ser pelo menos 30 minutos posterior ao valor de PlannedStartTime. Se você especificar `PlannedStartTime`, mas não especificar PlannedEndTime, o horário de início mais tarde da tarefa será `PlannedEndTime + 30 minutos`. Por exemplo, se você definir `PlannedStartTime` como `2021-01-14T09:00:00Z` e não especificar PlannedEndTime, o horário de início mais tarde da tarefa será definido como `2021-01-14T09:30:00Z`.	2021-01-14T09:30:00Z
FromTimeService	boolean	Não	Especifica se a tarefa de atualização do kernel deve ser executada imediatamente. Valores válidos: false (padrão) true Nota Este parâmetro não é obrigatório ao chamar a operação.	false
UpgradeType	string	Não	O tipo de atualização. Valores válidos: PROXY: especifica a atualização do PolarProxy. DB: especifica a atualização da versão do kernel. ALL: especifica a atualização do PolarProxy e da versão do kernel.	PROXY
TargetDBRevisionVersionCode	string	Não	O código da versão do banco de dados para a qual você deseja atualizar o cluster. Você pode chamar a operação DescribeDBClusterVersion para consultar o código da versão.	20230707
TargetProxyRevisionVersionCode	string	Não	O código da versão do proxy para a qual você deseja atualizar o cluster. Você pode chamar a operação DescribeDBClusterVersion para consultar o código da versão.	20240702

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.