# Atualizar o Aurora MySQL modificando a versão do mecanismo
<a name="AuroraMySQL.Updates.Patching.ModifyEngineVersion"></a>

O upgrade da versão secundária de um cluster do Aurora MySQL aplica correções adicionais e novos recursos a um cluster existente.

Esse tipo de upgrade se aplica a clusters do Aurora MySQL em que tanto a versão original como a versão atualizada têm a mesma versão principal do Aurora MySQL, a 2 ou a 3. O processo é rápido e direto porque não envolve uma conversão para os metadados do Aurora MySQL ou a reorganização de seus dados de tabela.

Execute esse tipo de atualização modificando a versão do mecanismo do cluster de banco de dados usando o Console de gerenciamento da AWS, a AWS CLI, ou a API do RDS. Por exemplo, se o cluster estiver executando o Aurora MySQL 3.x, escolha uma versão 3.x posterior.

Se você estiver executando uma atualização secundária em um Aurora Global Database, atualize todos os clusters secundários antes de atualizar o cluster primário.

**nota**  
Para atualizar a versão secundária para o Aurora MySQL versão 3.04.\$1 ou posterior ou a versão 2.12.\$1, use o seguinte processo:  
Remova todas as regiões secundárias do cluster global. Siga as etapas em [Remover um cluster de um banco de dados global do Amazon Aurora](aurora-global-database-detaching.md).
Atualize a versão do mecanismo da região primária para a versão 3.04.\$1 ou posterior, ou versão 2.12.\$1, conforme aplicável. Siga as etapas em [To modify the engine version of a DB cluster](#modify-db-cluster-engine-version).
Adicione regiões secundárias ao cluster global. Siga as etapas em [Adicionar uma Região da AWS a um Amazon Aurora Global Database](aurora-global-database-attaching.md).

 **Como modificar a versão do mecanismo de um cluster de banco de dados** 
+ **Usando o console**: modifique as propriedades de seu cluster. Na janela **Modify DB cluster (Modificar o cluster de banco de dados)**, altere a versão do mecanismo do Aurora MySQL na caixa **DB engine version (Versão do mecanismo de banco de dados)**. Se você não estiver familiarizado com o procedimento geral para modificar um cluster, siga as instruções em [Modificar o cluster de banco de dados usando o console, a CLI e a API](Aurora.Modifying.md#Aurora.Modifying.Cluster).
+ **Usando a AWS CLI**: chame o comando [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) da AWS CLI e especifique o nome do cluster de banco de dados para a opção `--db-cluster-identifier` e a versão do mecanismo para a opção `--engine-version`.

  Por exemplo, para fazer upgrade para o Aurora MySQL versão 3.04.1, defina a opção `--engine-version` como `8.0.mysql_aurora.3.04.1`. Especifique a opção `--apply-immediately` para atualizar imediatamente a versão de banco de dados para o cluster de banco de dados.
+ **Usando a API do RDS** – Call the [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) API operation (Chame a operação de API ModifyDBCluster) e especifique o nome do cluster de banco de dados do parâmetro `DBClusterIdentifier` e a versão do mecanismo do parâmetro `EngineVersion`. Defina o parâmetro `ApplyImmediately` como `true` para atualizar imediatamente a versão do mecanismo do cluster de banco de dados.