Atualizar a versão principal do mecanismo de uma instância do ApsaraDB RDS for MySQL - : Central de Documentação do Alibaba Cloud

Nota

O custo após a atualização varia conforme os tipos de instância e de armazenamento da instância original e da nova instância.

Se a instância for primária e tiver instâncias somente leitura ou de recuperação de desastres associadas, atualize as versões principais do mecanismo dessas instâncias antes de atualizar a versão da instância primária.

Antes de usar esta operação, verifique se os seguintes requisitos foram atendidos:

A instância original está no estado Running.
A instância executa uma das seguintes versões de banco de dados:
- MySQL 5.7
- MySQL 5.6
- MySQL 5.5

Para atualizar a versão principal do mecanismo de uma instância do ApsaraDB RDS for PostgreSQL, use a operação UpgradeDBInstanceMajorVersion.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	UpgradeDBInstanceEngineVersion	Operação a ser executada. Defina o valor como UpgradeDBInstanceEngineVersion.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxxxxx	Token do cliente usado para garantir a idempotência da solicitação. Gere o valor com o cliente, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	ID da instância.
EngineVersion	String	Yes	5,7	Versão principal do mecanismo que a nova instância executará. Valores válidos: 8,0 5,7 5,6
EffectiveTime	String	No	Immediate	Momento em que a alteração entra em vigor. Valores válidos: Immediate: a alteração entra em vigor imediatamente. MaintainTime: a alteração entra em vigor durante a janela de manutenção especificada. Para obter mais informações, consulte ModifyDBInstanceMaintainTime. Valor padrão: Immediate.

Parâmetros de resposta

Parameter	Type	Example	Description
TaskId	String	10254125	ID da tarefa.
RequestId	String	65BDA532-28AF-4122-AA39-B382721EEE64	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=UpgradeDBInstanceEngineVersion
&DBInstanceId=rm-uf6wjk5xxxxxxx
&EngineVersion=5.7
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<UpgradeDBInstanceEngineVersionResponse>
	<RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
	<TaskId>10254125</TaskId></UpgradeDBInstanceEngineVersionResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : " 65BDA532-28AF-4122-AA39-B382721EEE64",
  "TaskId" : "10254125"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	InvalidOrderTask.NotSupport	The Current InstanceId exist Order Task in RDS.	Erro retornado porque a instância possui pedidos pendentes. Tente novamente mais tarde.
400	InvalidSSLstatus	Current DB instance has SSL enabled, this operation is not supported.	Erro retornado porque a criptografia SSL está ativada na instância.
400	InvalidDBInstanceConnType.Format	Specified DB instance conn type is not valid.	Erro retornado porque o tipo de rede da instância não oferece suporte a esta operação.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	Erro retornado porque o estado atual da instância não oferece suporte a esta operação.
403	IncorrectEngineVersion	The engine version does not support the operation.	Erro retornado porque a versão do mecanismo de banco de dados da instância não oferece suporte a esta operação.
403	IncorrectEngineTypeMyisam	Current DB instance has MyISAM table, and it does not support this operation.	Erro retornado porque existem tabelas MyISAM na instância.
403	InvalidInstanceLevel.Malformed	Current DB instance level does not support this operation.	Erro retornado porque a instância não oferece suporte a esta operação.
403	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	Erro retornado porque a instância está bloqueada.
404	InvalidDBInstance.NotFound	The specified instance does not exist or is not supported.	Erro retornado porque a instância especificada não foi encontrada. Verifique o ID da instância.

Para obter uma lista de códigos de erro, visite o Error Center.