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á.

# Executar uma atualização de patch para a versão do mecanismo de um cluster
<a name="db-cluster-version-upgrade"></a>

Nesta seção, explicaremos como implantar uma atualização de patch usando Console de gerenciamento da AWS o. ou AWS CLI o. Uma atualização de patch é uma atualização dentro da mesma versão do mecanismo (por exemplo, uma versão do mecanismo 3.6 para uma versão mais recente). É possível atualizá-la imediatamente ou durante a próxima janela de manutenção do cluster. Para determinar se seu mecanismo precisa de uma atualização, consulte [Determinar manutenção pendente](db-cluster-determine-pending-maintenance.md). Observe que, ao aplicar a atualização, seu cluster passará por um tempo de inatividade.

**nota**  
Se você estiver tentando atualizar de uma versão principal do mecanismo para outra, como 3.6 para 5.0 ou 5.0 para 8.0, consulte ou[Atualização da versão principal implementada do Amazon DocumentDB no local](docdb-mvu.md). [Atualizando seu cluster Amazon DocumentDB usando AWS Database Migration Service](docdb-migration.versions.md)

Há dois requisitos de configuração para obter as atualizações de patch mais recentes para a versão do mecanismo de um cluster:
+ O status do cluster precisa ser *disponível*.
+ O cluster deve estar executando uma versão de mecanismo mais antiga.

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

O procedimento a seguir atualiza a versão de mecanismo do seu cluster para uma versão mais recente usando o console. Você tem a opção de atualizar imediatamente ou durante a próxima janela de manutenção do cluster.

1. Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)

1. No painel de navegação, escolha **Clusters**. Na lista de clusters, escolha o botão à esquerda do cluster que você deseja atualizar. O status do cluster precisa ser *disponível*.
**dica**  
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![Menu button.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.

1. No menu **Ações**, escolha uma das opções a seguir. Essas opções de menu são selecionáveis somente se o cluster que você escolheu não está executando a versão mais recente do mecanismo.  
![Imagem: ações de atualização do Amazon DocumentDB](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
   + **Atualizar agora**— inicia imediatamente o processo de atualização. Seu cluster ficará offline por um momento, enquanto é atualizado para a versão mais recente do mecanismo.
   + **Atualizar na próxima janela**— inicia o processo de atualização durante a próxima janela de manutenção do cluster. O cluster ficará offline por um momento, enquanto é atualizado para a versão mais recente do mecanismo.

1. Quando a janela de confirmação for aberta, escolha uma das seguintes opções:
   + **Atualizar**— para atualizar seu cluster para a versão mais recente do mecanismo, de acordo com a programação escolhida na etapa anterior.
   + **Cancelar**— para cancelar a atualização do mecanismo do cluster e continuar com a versão atual.

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

Você pode aplicar atualizações de patch ao seu cluster usando a `apply-pending-maintenance-action` operação AWS CLI e a com os parâmetros a seguir.

**Parâmetros**
+ **--resource-identifier**—Obrigatório. O ARN do cluster do Amazon DocumentDB que você vai atualizar.
+ **--apply-action**—Obrigatório. Os valores a seguir são permitidos. Para atualizar a versão de mecanismo do cluster, use `db-upgrade`.
  + **db-upgrade**
  + **system-update**
+ **--opt-in-type**—Obrigatório. Os valores a seguir são permitidos.
  + `immediate`— aplique a ação de manutenção imediatamente.
  + `next-maintenance`— aplique a ação de manutenção durante a próxima janela de manutenção.
  + `undo-opt-in`— cancele quaisquer solicitações de inclusão `next-maintenance` existentes.

**Example**  
O exemplo a seguir atualiza a versão do mecanismo `sample-cluster` para a versão 4.0.0.  
Para Linux, macOS ou Unix:  

```
aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate
```
Para Windows:  

```
aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate
```
A saída dessa operação é semelhante à seguinte.  

```
{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}
```

------