# Manutenção de uma instância de banco de dados
Periodicamente, o Amazon RDS realiza a manutenção em seus recursos. Os tópicos a seguir descrevem essas ações de manutenção e como aplicá-las.
## Visão geral das atualizações de manutenção da instância de banco de dados
A manutenção geralmente envolve atualizações dos seguintes atributos na instância de banco de dados:
+ Hardware subjacente
+ Sistema operacional subjacente
+ Versão do mecanismo de banco de dados
As atualizações no sistema operacional geralmente ocorrem para problemas de segurança. Recomendamos que você os faça o quanto antes. Para ter mais informações sobre os sistemas operacionais compatíveis, consulte [Aplicar atualizações para uma instânciade banco de dados](#USER_UpgradeDBInstance.OSUpgrades).
**Topics**
+ [
### Recursos off-line durante as atualizações de manutenção
](#USER_UpgradeDBInstance.Maintenance.Overview.offline)
+ [
### Modificações adiadas da instância de banco de dados
](#USER_UpgradeDBInstance.Maintenance.Overview.Deferred)
+ [
### Consistência eventual da API DescribePendingMaintenanceActions
](#USER_UpgradeDBInstance.Maintenance.Overview.eventual-consistency)
### Recursos off-line durante as atualizações de manutenção
Alguns itens de manutenção exigem que o Amazon RDS coloque a instância de banco de dados off-line por um curto período. Entre os itens de manutenção que exigem um recurso esteja offline estão sistema operacional obrigatório ou patches de banco de dados. A aplicação obrigatória de patches é automaticamente programada somente para patches relacionados à segurança e à confiabilidade da instância. Essa correção ocorre com pouca frequência, normalmente uma vez a cada poucos meses. Raramente requer mais do que uma fração de sua janela de manutenção.
### Modificações adiadas da instância de banco de dados
As modificações feitas na instância de banco de dados adiadas que você optou por não aplicar imediatamente são aplicadas durante a janela de manutenção. Por exemplo, convém optar por alterar a classe da instância de banco de dados ou o grupo de parâmetros durante a janela de manutenção. Essas modificações especificadas usando a configuração **pending reboot (reinicialização pendente)** não aparecem na lista **Pending maintenance (Manutenção pendente)**. Para mais informações sobre a modificação de uma instância de banco de dados , consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
Para ver as modificações pendentes para a próxima janela de manutenção, use o comando [describe-db-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-instances.html) da AWS CLI e verifique o campo `PendingModifiedValues`.
### Consistência eventual da API DescribePendingMaintenanceActions
A API `DescribePendingMaintenanceActions` do Amazon RDS segue o modelo de consistência eventual. Isso significa que o resultado do comando `DescribePendingMaintenanceActions` poderá não ser imediatamente visível para todos os comandos subsequentes do RDS. Lembre-se disso ao usar `DescribePendingMaintenanceActions` imediatamente após usar um comando de API anterior.
A consistência eventual pode afetar a maneira como você gerencia suas atualizações de manutenção. Por exemplo, se você executar o comando `ApplyPendingMaintenanceActions` para atualizar a versão do mecanismo de banco de dados para uma instância de banco de dados, ela ficará visível para `DescribePendingMaintenanceActions`. Nesse cenário, `DescribePendingMaintenanceActions` pode mostrar que a ação de manutenção não foi aplicada, embora tenha sido.
Para gerenciar a consistência eventual, é possível fazer o seguinte:
+ Confirme o estado da instância de banco de dados antes de executar um comando para modificá-lo. Execute o comando `DescribePendingMaintenanceActions` apropriado usando um algoritmo de recuo exponencial para garantir tempo suficiente para que o comando anterior se propague pelo sistema. Para fazer isso, execute o comando `DescribePendingMaintenanceActions` repetidamente, começando com alguns segundos de espera e aumentando gradualmente até cinco minutos de espera.
+ Adicione o tempo de espera entre os comandos subsequentes, mesmo que um comando `DescribePendingMaintenanceActions` exiba uma resposta precisa. Aplique um algoritmo de recuo exponencial começando com alguns segundos de espera e aumente gradualmente até cerca de cinco minutos de espera.
## Visualizar atualizações de manutenção pendentes
Veja se uma atualização de manutenção está disponível para sua instância de banco de dados utilizando o console do RDS, a AWS CLI ou a API do RDS. Se estiver disponível, uma atualização será indicada na coluna **Manutenção** da instância de banco de dados no console do Amazon RDS, conforme mostrado nesta figura.
![\[A ação de manutenção está disponível e será aplicada na próxima janela de manutenção.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/offlinepatchavailable.png)
Se nenhuma atualização de manutenção estiver disponível para uma instância de banco de dados, o valor da coluna será **none**.
Se uma atualização de manutenção estiver disponível para uma instância de banco de dados, os seguintes valores de coluna serão possíveis:
+ **obrigatório** – a ação de manutenção será aplicada ao recurso e não pode ser adiada indefinidamente.
+ **available (disponível)** – a ação de manutenção está disponível, mas não será aplicada automaticamente ao recurso. Você pode aplicá-la manualmente.
+ **next window (próxima janela)** – a ação de manutenção será aplicada ao recurso durante a próxima janela de manutenção.
+ **Em andamento**: a ação de manutenção está sendo aplicada ao recurso.
Se uma atualização estiver disponível, será possível executar uma das seguintes ações:
+ Se o valor de manutenção for **próxima janela**, adie as ações de manutenção escolhendo **Adiar atualização** em **Ações**. Não é possível adiar uma ação de manutenção que já tiver sido iniciada.
+ Aplicar as ações de manutenção imediatamente.
+ Aplique as ações de manutenção durante a próxima janela de manutenção.
+ Não tome nenhuma ação.
**Como realizar uma ação usando o Console de gerenciamento da AWS**
1. Escolha a instância de banco de dados para mostrar os detalhes.
1. Escolha **Maintenance & backups (Manutenção e backups)**. As ações de manutenção pendentes são exibidas.
1. Escolha a ação a ser tomada e, em seguida, escolha quando aplicá-la.
![\[Item de manutenção pendente para uma instância de banco de dados do Aurora.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pending_maintenance_rds.png)
A janela de manutenção determina quando as operações pendentes começam, mas não limita o tempo total de execução dessas operações. Não há garantia de que as operações de manutenção terminem antes de a janela de manutenção se encerrar, podendo continuar além do tempo de encerramento especificado. Para obter mais informações, consulte [Janela de manutenção do Amazon RDS](#Concepts.DBMaintenance).
Você pode ver se uma atualização de manutenção está disponível para sua instância de banco de dados executando o comando [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html) da AWS CLI.
Para ter informações sobre a aplicação de atualizações de manutenção, consulte [Aplicar atualizações para uma instânciade banco de dados](#USER_UpgradeDBInstance.OSUpgrades).
### Ações de manutenção do Amazon RDS
As ações de manutenção a seguir se aplicam a instâncias de banco de dados do RDS:
+ `server-certificate-rotation`: alterne o certificado do servidor do Amazon RDS para a instância de banco de dados.
**nota**
Mecanismos que aceitam alternância sem reinicialização não recebem essa notificação.
+ `db-upgrade`: atualize a versão do mecanismo de banco de dados para a instância de banco de dados.
+ `hardware-maintenance`: execute a manutenção no hardware subjacente da instância de banco de dados.
+ `system-update`: atualize o sistema operacional da instância de banco de dados.
## Manutenção para implantações Multi-AZ
A execução de uma instância de banco de dados como uma implantação multi-AZ pode reduzir ainda mais o impacto de um evento de manutenção. Esse resultado ocorre porque o Amazon RDS aplica atualizações do sistema operacional seguindo estas etapas:
1. Execute a manutenção no modo de espera.
1. Promova o modo de espera para o principal.
1. Execute manutenção no principal antigo, que se tornará o novo em modo de espera.
Se você atualiza o mecanismo de banco de dados de sua instância de banco de dados em uma implantação multi-AZ, o Amazon RDS modifica as instâncias de banco de dados primária e secundária ao mesmo tempo. Nesse caso, as instâncias de banco de dados primária e secundária na implantação multi-AZ não estão disponíveis durante a atualização. Essa operação causa tempo de inatividade até que a atualização seja concluída. A duração do tempo de inatividade varia de acordo com o tamanho de sua instância de banco de dados.
Se houver patches subjacentes do sistema operacional que precisem ser aplicados, será necessário um pequeno failover multi-AZ para aplicar os patches à instância de banco de dados primária. Esse failover geralmente dura menos de um minuto.
Se a instância de banco de dados executa o RDS para MySQL, o RDS para PostgreSQL ou o RDS para MariaDB, é possível minimizar o tempo de inatividade necessário para um upgrade usando uma implantação azul/verde. Para obter mais informações, consulte [Usar implantações azul/verde do Amazon RDS para atualizações de banco de dados](blue-green-deployments.md). Se você atualizar uma instância de banco de dados do RDS para SQL Server ou do RDS Custom para SQL Server em uma implantação multi-AZ, o Amazon RDS realizará atualizações contínuas, de modo que você enfrentará apenas uma interrupção durante um failover. Para obter mais informações, consulte [Considerações Multi-AZ](USER_UpgradeDBInstance.SQLServer.Considerations.md#USER_UpgradeDBInstance.SQLServer.MAZ).
Para ter mais informações sobre implantações Multi-AZ, consulte [Configurar e gerenciar uma implantação multi-AZ para o Amazon RDS](Concepts.MultiAZ.md).
## Janela de manutenção do Amazon RDS
A janela de manutenção é um intervalo de tempo semanal durante o qual todas as alterações do sistema são aplicadas. Cada instância de banco de dados tem uma janela de manutenção semanal. A janela de manutenção é uma oportunidade de controlar quando as modificações e a aplicação de patches de software ocorrem. Para ter mais informações sobre como ajustar a janela de manutenção, consulte [Ajustar a janela de manutenção da instância de banco de dados preferencial](#AdjustingTheMaintenanceWindow).
O RDS consome alguns dos recursos em sua instância de banco de dados enquanto a manutenção é aplicada. Você poderá observar um impacto mínimo na performance. Quanto a uma instância de banco de dados, em raras ocasiões, pode ser necessário realizar um failover Multi-AZ para concluir uma atualização de manutenção.
Se um evento de manutenção estiver programado para determinada semana, ele será iniciado durante a janela de manutenção de 30 minutos que você identificar. A maioria dos eventos de manutenção também é concluída durante a janela de manutenção de 30 minutos, embora os eventos de manutenção mais longos possam levar mais de 30 minutos para serem concluídos. A janela de manutenção é pausada quando a instância de banco de dados é interrompida .
A janela de manutenção de 30 minutos é selecionada aleatoriamente de um bloco de tempo de 8 horas por região. Se você não especificar uma janela de manutenção ao criar a instância de banco de dados, o RDS atribuirá uma janela de manutenção de 30 minutos em um dia da semana selecionado aleatoriamente.
A tabela a seguir mostra os blocos de tempo de cada Região da AWS dos quais as janelas de manutenção padrão são atribuídas.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html)
**Topics**
+ [
### Ajustar a janela de manutenção da instância de banco de dados preferencial
](#AdjustingTheMaintenanceWindow)
### Ajustar a janela de manutenção da instância de banco de dados preferencial
A janela de manutenção deve ser definida no horário de menor utilização e, portanto, talvez precise ser modificada de vez em quando. Seu cluster de banco de dados estará indisponível durante esse tempo somente se alterações do sistema, como uma alteração na classe de instância de banco de dados, estiverem sendo aplicadas e exigirem uma interrupção. Sua instância de banco de dados estará indisponível apenas pelo intervalo mínimo de tempo necessário para fazer as alterações necessárias.
No exemplo a seguir, ajuste a janela de manutenção preferencial para uma instância de banco de dados.
Para este exemplo, presume-se que a instância de banco de dados denominada *mydbinstance* exista e apresente uma janela de manutenção preferencial de "Sun:05:00-Sun:06:00" UTC.
#### Console
**Para ajustar a janela de manutenção preferencial**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Databases (Bancos de dados)** e selecione a instância de banco de dados que você deseja modificar.
1. Selecione **Modify**. A página **Modify DB instance (Modificar instância de banco de dados)** será exibida.
1. Na seção **Maintenance (Manutenção)**, atualize a janela de manutenção.
**nota**
A janela de manutenção e a janela de backup da instância de banco de dados não podem se sobrepor. Se você digitar um valor na janela de manutenção que sobreponha a janela de backup, será exibida uma mensagem de erro.
1. Escolha **Continue**.
Na página de confirmação, revise suas alterações.
1. Para aplicar as alterações à janela de manutenção imediatamente, selecione **Apply immediately (Aplicar imediatamente)**.
1. Selecione **Modificar instância de banco de dados** para salvar as alterações.
Como alternativa, escolha **Back (Voltar)** para editar suas alterações ou escolha **Cancel (Cancelar)** para cancelar as alterações.
#### AWS CLI
Para ajustar a janela de manutenção preferencial, use o comando [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da `modify-db-instance` com os seguintes parâmetros:
+ `--db-instance-identifier`
+ `--preferred-maintenance-window`
**Example**
O exemplo de código a seguir define a janela de manutenção para terças, das 4:00 às 4:30 AM UTC.
Para Linux, macOS ou Unix:
```
aws rds modify-db-instance \
--db-instance-identifier mydbinstance \
--preferred-maintenance-window Tue:04:00-Tue:04:30
```
Para Windows:
```
aws rds modify-db-instance ^
--db-instance-identifier mydbinstance ^
--preferred-maintenance-window Tue:04:00-Tue:04:30
```
#### API do RDS
Para ajustar a janela de manutenção de sua preferência, use a operação da API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) do Amazon RDS com os seguintes parâmetros:
+ `DBInstanceIdentifier`
+ `PreferredMaintenanceWindow`
## Aplicar atualizações para uma instânciade banco de dados
Com o Amazon RDS, você pode escolher quando aplicar operações de manutenção. Você pode decidir quando o Amazon RDS aplicará atualizações usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.
### Console
**Para gerenciar uma atualização de uma instância de banco de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Databases (Bancos de dados)**.
1. Escolha a instância de banco de dados que exige uma atualização obrigatória.
1. Em **Actions (Ações)**, escolha uma das seguinte opções:
+ **Aplicar patch agora**
+ **Aplicar patch na próxima janela**
**nota**
Se escolher **Aplicar patch na próxima janela** e depois quiser atrasar a atualização do sistema operacional, você poderá escolher **Adiar atualização**. Não é possível adiar uma ação de manutenção que já tiver sido iniciada.
Para cancelar uma ação de manutenção, modifique a instância de banco de dados e desative **Auto minor version upgrade (Atualização automática da versão secundária)**.
### AWS CLI
Para aplicar uma atualização pendente a uma instância de banco de dados, use o comando [apply-pending-maintenance-action](https://docs.aws.amazon.com/cli/latest/reference/rds/apply-pending-maintenance-action.html) da AWS CLI.
**Example**
Para Linux, macOS ou Unix:
```
aws rds apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-west-2:001234567890:db:mysql-db \
--apply-action system-update \
--opt-in-type immediate
```
Para Windows:
```
aws rds apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-west-2:001234567890:db:mysql-db ^
--apply-action system-update ^
--opt-in-type immediate
```
**nota**
Para adiar uma ação de manutenção, especifique `undo-opt-in` para `--opt-in-type`. Não será possível especificar `undo-opt-in` para `--opt-in-type` se a ação de manutenção já tiver sido iniciada.
Para cancelar uma ação de manutenção, execute o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da AWS CLI e especifique `--no-auto-minor-version-upgrade`.
Para retornar uma lista de recursos que tenham pelo menos uma atualização pendente, use o comando [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html) da AWS CLI.
**Example**
Para Linux, macOS ou Unix:
```
aws rds describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-west-2:001234567890:db:mysql-db
```
Para Windows:
```
aws rds describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-west-2:001234567890:db:mysql-db
```
Você também pode exibir uma lista de recursos para uma instância de banco de dados especificando o parâmetro `--filters` do comando `describe-pending-maintenance-actions` da AWS CLI. O formato do comando `--filters` é `Name=filter-name,Value=resource-id,...`.
Os valores a seguir são os valores aceitos para o parâmetro `Name` de um filtro:
+ `db-instance-id` – aceita uma lista de identificadores de instância de banco de dados ou nomes de recurso da Amazon (ARNs). A lista retornada inclui apenas ações de manutenção pendentes para as instâncias de bancos de dados identificadas por esses identificadores ou ARNs.
+ `db-cluster-id` – aceita uma lista de identificadores de cluster de banco de dados ou ARNs para o Amazon Aurora. A lista retornada inclui apenas ações de manutenção pendentes para os clusters de bancos de dados identificados por esses identificadores ou ARNs.
Por exemplo, o exemplo a seguir retorna as ações de manutenção pendentes para as instâncias de banco de dados `sample-instance1` e `sample-instance2`.
**Example**
Para Linux, macOS ou Unix:
```
aws rds describe-pending-maintenance-actions \
--filters Name=db-instance-id,Values=sample-instance1,sample-instance2
```
Para Windows:
```
aws rds describe-pending-maintenance-actions ^
--filters Name=db-instance-id,Values=sample-instance1,sample-instance2
```
### API do RDS
Para aplicar uma atualização a uma instância de banco de dados, chame a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ApplyPendingMaintenanceAction.html) da API do Amazon RDS.
Para retornar uma lista de recursos que tenham pelo menos uma atualização pendente, chame a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribePendingMaintenanceActions.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribePendingMaintenanceActions.html) da API do Amazon RDS.
## Atualizações do sistema operacional para instâncias de banco de dados do RDS
Ocasionalmente, as instâncias de banco de dados do RDS para Db2, RDS para MariaDB, RDS para MySQL, RDS para PostgreSQL, RDS para SQL Server, RDS para Oracle e RDS Custom para SQL Server exigem atualizações do sistema operacional. O Amazon RDS faz upgrade do sistema operacional para uma versão mais recente para melhorar o desempenho do banco de dados e o procedimento de segurança geral dos clientes. Em geral, essas atualizações demoram cerca de dez minutos. As atualizações do sistema operacional não alteram a versão do mecanismo de banco de dados nem a classe de uma instância de banco de dados.
As atualizações do sistema operacional podem ser opcionais ou obrigatórias:
+ Uma **atualização opcional** pode ser aplicada a qualquer momento. Embora essas atualizações sejam opcionais, recomendamos que você as aplique periodicamente para manter sua frota do RDS atualizada. O RDS *não* aplica essas atualizações automaticamente.
Para ser notificado quando um novo patch opcional do sistema operacional estiver disponível, você poderá assinar o [RDS-EVENT-0230](USER_Events.Messages.md#RDS-EVENT-0230) na categoria de evento de aplicação de patch de segurança. Para obter informações sobre como se inscrever em eventos do RDS, consulte [Inscrever-se em notificações de eventos do Amazon RDS](USER_Events.Subscribing.md).
**nota**
`RDS-EVENT-0230` não se aplica às atualizações de distribuição do sistema operacional.
+ Uma **atualização obrigatória** é necessária e tem data de aplicação. Agende sua atualização para antes dessa data de aplicação. Após a data de aplicação especificada, o Amazon RDS atualiza automaticamente o sistema operacional de sua instância de banco de dados para a versão mais recente durante uma das janelas de manutenção atribuídas.
**nota**
A aplicação de todas as atualizações opcionais e obrigatórias pode ser necessária para cumprir várias obrigações de conformidade. Recomendamos que você aplique todas as atualizações disponibilizadas pelo RDS rotineiramente durante suas janelas de manutenção.
É possível usar o Console de gerenciamento da AWS ou a AWS CLI para obter informações sobre o tipo de atualização do sistema operacional.
### Console
**Como obter informações de atualização usando o Console de gerenciamento da AWS**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Databases** (Bancos de dados) e, depois, a instância de banco de dados.
1. Escolha **Maintenance & backups (Manutenção e backups)**.
1. Na seção **Pending maintenance** (Manutenção pendente), encontre a atualização do sistema operacional e confira o valor **Status**.
No Console de gerenciamento da AWS, uma atualização opcional tem o **Status** de sua manutenção definido como **disponível** e não tem uma **data de aplicação**, conforme mostrado na imagem a seguir.
![\[Atualização opcional do sistema operacional.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/os-update-optional.png)
Uma atualização obrigatória tem o **Status** de sua manutenção definido como **required** (obrigatória) e tem uma **Apply date** (Data de aplicação), conforme mostrado na imagem a seguir.
![\[Atualização obrigatória do sistema operacional.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/os-update-required.png)
### AWS CLI
Para obter informações de atualização da AWS CLI, use o comando [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html).
```
aws rds describe-pending-maintenance-actions
```
Uma atualização obrigatória do sistema operacional inclui um valor `AutoAppliedAfterDate` e um valor `CurrentApplyDate`. Uma atualização opcional do sistema operacional não inclui esses valores.
A saída a seguir mostra uma atualização obrigatória do sistema operacional.
```
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:db:mydb1",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"AutoAppliedAfterDate": "2022-08-31T00:00:00+00:00",
"CurrentApplyDate": "2022-08-31T00:00:00+00:00",
"Description": "New Operating System update is available"
}
]
}
```
A saída a seguir mostra uma atualização opcional do sistema operacional.
```
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:db:mydb2",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "New Operating System update is available"
}
]
}
```
### Disponibilidade de atualizações do sistema operacional
As atualizações do sistema operacional são específicas da versão do mecanismo de banco de dados e da classe de instância de banco de dados. Portanto, as instâncias de banco de dados recebem ou exigem atualizações em momentos diferentes. Quando uma atualização do sistema operacional estiver disponível para sua instância de banco de dados com base na versão do mecanismo e na classe de instância de banco de dados, essa atualização aparecerá no console. Ela também pode ser visualizada executando o comando [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html) AWS CLI ou chamando a operação [DescribePendingMaintenanceActions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribePendingMaintenanceActions.html) da API do RDS. Se houver uma atualização disponível para sua instância, você poderá atualizar o sistema operacional seguindo as instruções em [Aplicar atualizações para uma instânciade banco de dados](#USER_UpgradeDBInstance.OSUpgrades).
# Usar a política de implementação de atualização do AWS Organizations para atualizações automáticas de versões secundárias
O Amazon RDS comporta a política de implementação de atualizações do AWS Organizations para gerenciar atualizações automáticas de versões secundárias em vários recursos de banco de dados e Contas da AWS. Essa política ajuda você a implementar uma estratégia de atualização controlada para suas instâncias da seguinte maneira:
**Como funciona a política de implementação de atualizações**
Quando uma nova versão secundária do mecanismo se torna elegível para atualização automática, a política controla a sequência de atualização com base em ordens definidas:
+ Os recursos marcados como [primeiros] (normalmente ambientes de desenvolvimento) se tornam elegíveis para atualizações durante suas janelas de manutenção.
+ Depois de um tempo de incorporação designado, os recursos marcados como [segundo] se tornam elegíveis.
+ Depois de outro tempo de incorporação designado, os recursos marcados como [últimos] (normalmente ambientes de produção) se tornam elegíveis.
+ Monitorar o andamento da atualização por meio de notificações de integridade da AWS.
Você pode definir a ordem das atualizações da seguinte forma:
+ Políticas em nível de conta: aplicam-se a todos os recursos elegíveis em contas específicas.
+ Tags de recursos: aplicam-se a recursos específicos com base em tags.
**nota**
Os recursos não configurados com uma política de atualização ou excluídos da política recebem automaticamente uma ordem de atualização de [segundo].
**Pré-requisitos**
+ Sua Conta da AWS deve fazer parte de uma organização em Organizations com a política de implementação de atualizações habilitada.
+ Habilitar atualizações automáticas de versão secundária para suas instâncias
+ As tags não são estritamente necessárias para a política de implementação de atualizações. Se quiser definir ordens de atualização específicas para diferentes ambientes (por exemplo, desenvolvimento, teste, controle de qualidade e produção), você pode usar tags. Se você não incluir configurações de tag em sua política, todos os recursos dela seguirão a ordem de atualização padrão.
**Pré-requisitos**
+ Sua Conta da AWS deve fazer parte de uma organização em Organizations com a política de implementação de atualizações habilitada.
+ Habilitar atualizações automáticas de versão secundária para suas instâncias
+ Marcar seus recursos para identificar o ambiente (por exemplo, desenvolvimento, teste, produção)
**Como marcar seus recursos**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Bancos de dados**.
1. Escolha a instância que você deseja marcar.
1. Escolha **Actions** e, em seguida, escolha **Manage tags**.
1. Escolha **Adicionar Tag**.
1. Insira a chave da tag (por exemplo, “Ambiente”) e o valor (por exemplo, “Desenvolvimento”).
1. Escolha **Adicionar tag** e, depois, **Salvar**.
Você também pode adicionar tags usando a AWS CLI:
```
aws rds add-tags-to-resource \
--resource-name arn:aws:rds:region:account-number:db:instance-name \
--tags Key=Environment,Value=Development
```
## Ordem e fases de atualização
A política de implementação de atualizações aceita três ordens de atualização:
+ [primeiro]: normalmente usado para ambientes de desenvolvimento ou teste.
+ [segundo]: normalmente usado para ambientes de controle de qualidade. Ordem padrão dos recursos não configurados especificamente.
+ [último]: normalmente reservado para ambientes de produção.
Quando uma nova versão secundária do mecanismo se torna elegível para atualização automática:
+ Os recursos com ordem de atualização [primeiro] se tornam elegíveis para atualizações durante as janelas de manutenção configuradas.
+ Após um tempo de incorporação, os recursos com ordem de atualização [primeiro] se tornam elegíveis para atualizações durante as janelas de manutenção.
+ Após outro tempo de incorporação, os recursos com ordem de atualização [último] se tornam elegíveis para atualizações durante as janelas de manutenção.
+ A campanha automática de atualização de versão secundária é encerrada após todos os recursos elegíveis com ordens de atualização [primeiro], [segundo] e [último] terem sido atualizados, ou quando a campanha atinge a data de término programada, o que ocorrer primeiro.
**nota**
Todas as atualizações automáticas de versões secundárias são realizadas durante a janela de manutenção configurada de cada instância para minimizar o possível impacto em suas aplicações.
## Observabilidade
### Integridade e monitoramento da AWS
Você recebe notificações de integridade da AWS:
+ Antes de iniciar uma campanha de atualização automática de versão secundária.
+ Entre cada transição de fase para ajudar a acompanhar e monitorar o andamento da atualização.
+ Atualizações de andamento mostrando o número de recursos atualizados em sua frota no console de integridade da AWS.
Notificações de eventos do Amazon RDS:
+ Notificações de recursos habilitados para atualizações automáticas de versões secundárias, incluindo:
+ Quando seu recurso se torna elegível para atualização com base em sua ordem de atualização ([primeiro], [segundo] ou [último]).
+ Cronograma de atualizações programadas durante a janela de manutenção
+ Status de conclusão e início de atualização de banco de dados individual
+ Assine esses eventos por meio do Amazon EventBridge0 para monitoramento automatizado.
### Considerações
Algumas questões a serem levadas em consideração:
+ A política se aplica a todas as futuras campanhas automáticas de atualização de versões secundárias, incluindo alterações de política feitas durante campanhas ativas.
+ Se você participar de uma campanha de atualização em andamento, seus recursos seguirão a ordem atual de atualização em execução e não esperarão por uma política configurada.
+ Os recursos não configurados com uma política de atualização recebem automaticamente uma ordem de atualização de [segundo].
+ A política fornece períodos de validação entre as fases de atualização antes de prosseguir para a próxima fase.
+ As alterações na política ou nas tags de recursos exigem tempo para serem propagadas antes que a nova ordem de atualização seja aplicada.
+ A política se aplica somente aos recursos do Amazon RDS com atualizações automáticas de versões secundárias habilitadas.
+ Se você detectar um problema em um ambiente, poderá desativar as atualizações automáticas de versões secundárias para ambientes subsequentes ou usar o período de validação para resolver problemas antes que as atualizações prossigam para a próxima ordem de atualização.
**nota**
Esse recurso aceita atualizações automáticas de versões secundárias para versões do mecanismo de banco de dados Oracle lançadas após janeiro de 2026.
Para acessar mais informações sobre como marcar recursos do RDS, consulte [Marcar recursos do do Amazon RDS](USER_Tagging.md). Para acessar instruções detalhadas sobre como configurar e usar a política de implementação de atualizações, consulte [Introdução ao AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started.html) no *Guia do usuário do AWS Organizations*.