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á.
# Atualizando uma versão do mecanismo de agente do Amazon MQ
O Amazon MQ fornece regularmente novas versões do mecanismo do agente para todos os tipos de mecanismo de agente compatíveis. As novas versões do mecanismo incluem patches de segurança, correções de bugs e outras melhorias no mecanismo do agente.
O Amazon MQ organiza os números das versões de acordo com a especificação de versionamento semântico como `X.Y.Z`. Nas implementações do Amazon MQ, `X` denota a versão principal, `Y` representa a versão secundária e `Z` denota o número da versão de patch. O Amazon MQ oferece suporte a dois tipos de atualizações:
+ **Atualização da versão principal**: ocorre quando os números de versão do mecanismo principal mudam. Por exemplo, a atualização do RabbitMQ versão **3.13** para a versão **4.2** é considerada uma atualização principal da versão.
+ **Atualização de versão secundária**: ocorre quando apenas os números de versão secundários do mecanismo mudam. Por exemplo, atualizando a partir da versão 3. **11** para a versão 3. **12** é considerado um pequeno upgrade de versão.
Você pode atualizar seu agente manualmente a qualquer momento para a próxima versão principal ou secundária compatível. [O Amazon MQ gerencia a atualização para a última versão de patch compatível com todos os corretores durante a janela de manutenção programada.](maintaining-brokers.md) As atualizações manuais e automáticas da versão ocorrem durante a janela de manutenção programada ou após a [reinicialização](amazon-mq-rebooting-broker.md) do broker. O Amazon MQ atualiza seu agente para a próxima versão secundária quando a versão secundária atual chega ao fim do suporte.
## Atualizar manualmente a versão do mecanismo
Você pode atualizar a versão do mecanismo de um corretor usando a API Console de gerenciamento da AWS AWS CLI, a ou a API do Amazon MQ.
### Console de gerenciamento da AWS
**Para atualizar a versão do mecanismo de um corretor usando o Console de gerenciamento da AWS**
1. Na página de detalhes do agente, selecione **Edit** (Editar).
1. Em **Especificações**, para **Versão do mecanismo de agente** escolha o novo número de versão na lista suspensa.
1. Role até o final da página e selecione **Programar modificações**.
1. Em **Programar modificações do agente**, para **Quando aplicar modificações**, escolha uma das seguintes opções.
+ Selecione **After the next reboot (Depois da próxima reinicialização)** se você quiser que o Amazon MQ conclua a atualização da versão durante a próxima janela de manutenção programada.
+ Selecione **Imediatamente** se você quiser reiniciar o agente e atualizar a versão do mecanismo imediatamente.
**Importante**
Os agentes de instância única ficarão offline durante a reinicialização. Para agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.
1. Selecione **Apply (Aplicar)** para concluir a aplicação das alterações.
### AWS CLI
**Para atualizar a versão do mecanismo de um corretor 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`.
+ `--engine-version` — O número da versão do mecanismo para a qual o a atualização do mecanismo de agente será feita.
```
aws mq update-broker --broker-id {{broker-id}} --engine-version {{version-number}}
```
1. (Opcional) Use o comando da CLI [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) para reinicializar seu broker se quiser atualizar a versão do mecanismo imediatamente.
```
aws mq reboot-broker --broker-id {{broker-id}}
```
Se você não quiser reiniciar seu agente e aplicar as alterações imediatamente, o Amazon MQ atualizará o agente durante a próxima janela de manutenção agendada.
**Importante**
Os agentes de instância única ficarão offline durante a reinicialização. Em agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.
### API do Amazon MQ
**Para atualizar a versão do mecanismo de um agente usando a API do Amazon MQ**
1. Use a operação de 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: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: {{authorization-string}}
```
Use o `engineVersion` na carga útil da solicitação para especificar o número da versão para a qual o agente será atualizado.
```
{
"engineVersion": "{{engine-version-number}}"
}
```
1. (Opcional) Use a operação de [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker)API para reinicializar seu broker se quiser atualizar a versão do mecanismo imediatamente. `broker-id`é especificado como um parâmetro de caminho.
```
POST /v1/brokers/{{broker-id}}/reboot-broker HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: {{authorization-string}}
```
Se você não quiser reiniciar seu agente e aplicar as alterações imediatamente, o Amazon MQ atualizará o agente durante a próxima janela de manutenção agendada.
**Importante**
Os agentes de instância única ficarão offline durante a reinicialização. Para agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.