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 o Console de gerenciamento da AWS 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 algum 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 [Atualização da versão principal implementada do Amazon DocumentDB no local](docdb-mvu.md) ou[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.](https://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/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](https://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/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 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. Use `system-update` para aplicar uma atualização de patch do mecanismo ao cluster.
+ **--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 aplica a atualização do patch do mecanismo `sample-cluster` a.  
Para Linux, macOS ou Unix:  

```
aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:{{aa-example-1}}:{{111122223333}}:cluster:{{sample-cluster}} \
   --apply-action system-update \
   --opt-in-type immediate
```
Para Windows:  

```
aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:{{aa-example-1}}:{{111122223333}}:cluster:{{sample-cluster}} ^
   --apply-action system-update ^
   --opt-in-type immediate
```
A saída dessa operação é semelhante à seguinte.  

```
{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:aa-example-1:111122223333:cluster:sample-cluster",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "system-update",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}
```

------