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á.
# Agendar a janela de manutenção para um agente do Amazon MQ
Periodicamente, o Amazon MQ realiza a manutenção do hardware, do sistema operacional ou do software do mecanismo de um agente de mensagens durante a janela de manutenção. Por exemplo, se você alterou o tipo de instância do agente, o Amazon MQ aplicará as alterações durante a próxima janela de manutenção programada. A manutenção pode durar até duas horas, dependendo das operações agendadas para o agente de mensagens. Você pode minimizar o tempo de inatividade durante uma janela de manutenção selecionando um modo de implantação do agente com alta disponibilidade em várias zonas de disponibilidade (AZs).
O Amazon MQ para o ActiveMQ fornece implantações em modo [ativo/em espera](amazon-mq-broker-architecture.md#active-standby-broker-deployment) para alta disponibilidade. No modo ativo/em espera, o Amazon MQ executa operações de manutenção uma instância de cada vez, e pelo menos uma instância permanece disponível. Além disso, você pode configurar uma [rede de agentes](network-of-brokers.md) com janelas de manutenção espalhadas por toda a semana. O Amazon MQ para o RabbitMQ fornece implantações de [cluster](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster) para alta disponibilidade. Em implantações de cluster, o Amazon MQ executa operações de manutenção um nó de cada vez ao manter pelo menos dois nós em execução o tempo todo.
Ao criar seu agente pela primeira vez, você pode programar a janela de manutenção para ocorrer uma vez por semana em um horário especificado. Você só pode ajustar a janela de manutenção de um agente até quatro vezes antes da próxima janela de manutenção programada. Quando uma janela de manutenção do agente é concluída, o Amazon MQ redefine o limite, e você pode ajustar a programação antes da próxima janela de manutenção. A disponibilidade do agente não é afetada ao ajustar sua janela de manutenção.
Para ajustar a janela de manutenção do agente, você pode usar o Console de gerenciamento da AWS, o AWS CLI ou a API do Amazon MQ.
## Programar a janela de manutenção do agente usando o Console de gerenciamento da AWS
**Para ajustar a janela de manutenção do agente usando o Console de gerenciamento da AWS**
1. Faça login no [console do Amazon MQ](https://console.aws.amazon.com/amazon-mq/).
1. No painel de navegação à esquerda, selecione **Brookers** (Agentes) e depois escolha o agente que você deseja atualizar na lista.
1. Na página de detalhes do agente, selecione **Edit** (Editar).
1. Em **Manutenção**, faça o seguinte.
1. Para **Start day** (Dia de início), escolha um dia da semana, por exemplo, **Sunday** (domingo), da lista suspensa.
1. Para **Start time** (Hora de início), escolha o horário (horas e minutos) do dia para o qual deseja agendar a próxima janela de manutenção do agente, por exemplo, **12**:**00**.
**nota**
As opções de **Hora de início** são configuradas no fuso horário UTC\$10.
1. Em seguida, selecione **Programar modificações**. Depois, escolha **Após a próxima reinicialização** ou **Imediatamente**. Escolher **After the next reboot (Depois da próxima reinicialização)** atualizará imediatamente a janela de manutenção sem reinicializar o agente. Ao escolher **Imediatamente**, o agente será reiniciado de imediato.
1. Na página de detalhes do agente, em **Maintenance window** (Janela de manutenção), verifique se sua nova programação preferencial é exibida.
## Programar a janela de manutenção do agente usando o AWS CLI
**Para ajustar a janela de manutenção do agente usando o AWS CLI**
1. Usar o comando CLI [update-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) e especifique os seguintes parâmetros, conforme mostrado no exemplo.
+ `--broker-id` — O ID exclusivo que o Amazon MQ gera para o agente. Você pode analisar o ID do ARN do seu agente. Por exemplo, considerando o seguinte ARN, `arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`, o ID do agente seria `b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`.
+ `--maintenance-window-start-time` — Os parâmetros que determinam a hora de início da janela de manutenção semanal fornecida na estrutura a seguir.
+ `DayOfWeek` – O dia da semana, na sintaxe a seguir: `MONDAY| TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY`
+ `TimeOfDay` — A hora, no formato de 24 horas.
+ `TimeZone` — (Opcional) O fuso horário, no formato País/Cidade ou no formato de deslocamento de UTC. Definido como UTC por padrão.
```
aws mq update-broker --broker-id broker-id \
--maintenance-window-start-time DayOfWeek=SUNDAY,TimeOfDay=13:00,TimeZone=America/Los_Angeles
```
1. (Opcional) Use o comando CLI [describe-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) para verificar se a janela de manutenção foi atualizada com sucesso.
```
aws mq describe-broker --broker-id broker-id
```
## Programar a janela de manutenção do agente usando a API do Amazon MQ
**Para ajustar a janela de manutenção do agente usando a API do Amazon MQ**
1. Use a operação da API [UpdateBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#UpdateBroker). Especifique `broker-id` como um parâmetro de caminho. Os exemplos a seguir pressupõem um agente na região `us-west-2`. Para ter mais informações sobre os endpoints do Amazon MQ disponíveis, consulte [Endpoints e cotas do Amazon MQ](https://docs.aws.amazon.com/general/latest/gr/amazon-mq.html#amazon-mq_region) na *Referência geral da AWS*.
```
PUT /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Wed, 7 July 2021 12:00:00 GMT
x-amz-date: Wed, 7 July 2021 12:00:00 GMT
Authorization: authorization-string
```
Use o parâmetro `maintenanceWindowStartTime` e o tipo de recurso [https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-model-weeklystarttime](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-model-weeklystarttime) na carga útil da solicitação.
```
{
"maintenanceWindowStartTime": {
"dayOfWeek": "SUNDAY",
"timeZone": "America/Los_Angeles",
"timeOfDay": "13:00"
}
}
```
1. (Opcional) Use a operação [DescribeBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-http-methods) da API para verificar se a janela de manutenção foi atualizada com sucesso. `broker-id` é especificado como um parâmetro de caminho.
```
GET /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Wed, 7 July 2021 12:00:00 GMT
x-amz-date: Wed, 7 July 2021 12:00:00 GMT
Authorization: authorization-string
```