As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atualização da versão secundária do Amazon DocumentDB
<a name="docdb-minor-version-upgrade"></a>

**nota**  
Este tópico aborda atualizações de versões *secundárias* dentro da mesma versão principal (por exemplo, atualização da 5.0.0 para a 5.0.1). Para obter informações sobre a atualização para uma versão principal diferente, consulte[Atualização da versão principal implementada do Amazon DocumentDB no local](docdb-mvu.md).

Você pode atualizar a versão secundária do mecanismo do seu cluster Amazon DocumentDB (por exemplo, de 5.0.0 para 5.0.1) modificando o cluster. Atualizações de versões menores podem ser aplicadas imediatamente ou durante a próxima janela de manutenção.

## Antes de realizar um upgrade da versão secundária
<a name="docdb-minor-version-upgrade-before"></a>

Antes de realizar uma pequena atualização de versão, as seguintes ações podem ser úteis:
+ Execute a atualização durante um período de baixo tráfego para reduzir o impacto de qualquer breve tempo de inatividade.
+ Verifique se a versão secundária de destino é uma meta de atualização válida para sua versão atual usando o `describe-db-engine-versions` comando.
+ Para clusters globais, os clusters secundários devem ser atualizados antes do cluster primário. Para obter mais informações, consulte [Correção de clusters globais](db-instance-maintain.md#global-clusters-patching).

**Importante**  
Os upgrades são **operações unidirecionais** — você não pode fazer o downgrade após o upgrade.
Seu cluster passará por um breve período de inatividade durante o processo de atualização.

## Realizar uma atualização da versão secundária
<a name="docdb-minor-version-upgrade-perform"></a>

------
#### [ Using the Console de gerenciamento da AWS ]

Para realizar uma atualização de versão secundária usando o Console de gerenciamento da AWS:

1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) e abra o console do Amazon DocumentDB.

1. Na tabela **Clusters**, selecione o cluster que você deseja atualizar, escolha **Ações** e, em seguida, escolha **Modificar**.

1. Na caixa de diálogo **Modificar cluster****, na seção Especificações** do cluster, escolha a versão secundária de destino no menu suspenso **Versão do mecanismo**.

1. Role para baixo e escolha **Continuar**.

1. Na seção **Programação de modificações**, escolha aplicar a alteração imediatamente ou durante a próxima janela de manutenção.

   Depois, selecione **Modify Cluster (Modificar cluster)**.

------
#### [ Using the AWS CLI ]

Use o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/modify-db-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/modify-db-cluster.html) com o parâmetro `--engine-version`:

```
aws docdb modify-db-cluster \
    --db-cluster-identifier {{mydocdbcluster}} \
    --engine-version {{5.0.1}} \
    --apply-immediately \
    --region {{us-east-1}}
```

No exemplo acima, substitua cada um {{user input placeholder}} pelas informações do seu cluster.

**nota**  
Para aplicar a atualização durante a próxima janela de manutenção, em vez de imediatamente, use `--no-apply-immediately` no lugar de`--apply-immediately`.

------

## Verificando a atualização da versão secundária
<a name="docdb-minor-version-upgrade-verify"></a>

Depois que a atualização for concluída, verifique a versão do mecanismo usando: AWS CLI

```
aws docdb describe-db-clusters \
    --db-cluster-identifier {{mydocdbcluster}} \
    --query 'DBClusters[0].EngineVersion'
```

A saída dessa operação é semelhante à seguinte:

```
"5.0.1"
```