

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

# Gerenciar as versões do mecanismo do Amazon MQ para ActiveMQ
<a name="activemq-version-management"></a>

 O Apache ActiveMQ organiza números de versão de acordo com a especificação de versionamento semântico como `X.Y.Z`. Nas implementações do Amazon MQ para ActiveMQ, `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 considera que uma alteração de versão é principal se os números de versão principais mudarem. Por exemplo, a atualização da versão **5**.17 para a **6**.0 é considerada uma *atualização de versão principal*. Uma alteração da versão é considerada secundária se apenas o número da versão secundária ou de patch for alterado. Por exemplo, atualizando a partir da versão 5. **18** a 5. **19** é considerado um *pequeno upgrade de versão*. Quando `autoMinorVersionUpgrade` está ativado, o Amazon MQ atualiza o agente para a versão de patch mais recente disponível. 

 O Amazon MQ para ActiveMQ recomenda que todos os agentes usem a versão secundária mais recente compatível. Para obter instruções de como atualizar a versão do mecanismo do agente, consulte [Upgrading an Amazon MQ broker engine version](upgrading-brokers.md). 

## Versões do mecanismo compatíveis no Amazon MQ para ActiveMQ
<a name="activemq-version-management-calendar"></a>

 O calendário de suporte da versão do Amazon MQ indica quando uma versão do mecanismo do agente chegará ao fim do suporte. Quando uma versão chega ao fim do suporte, o Amazon MQ atualiza automaticamente todos os agentes dessa versão para a próxima versão compatível. Essa atualização ocorre durante as janelas de manutenção programada da sua corretora, dentro dos 45 dias após a end-of-support data. 

 O Amazon MQ avisa com pelo menos noventa dias de antecedência quando uma versão chegará ao fim do suporte. Recomendamos atualizar seu corretor antes da end-of-support data para evitar interrupções. Além disso, não é possível criar agentes em versões programadas para o fim do suporte dentro de trinta dias da data do fim do suporte. 


| Versão do Apache ActiveMQ | Fim do suporte no Amazon MQ | 
| --- | --- | 
| ActiveMQ 5.19 (recomendado) |   | 
| ActiveMQ 5.18 |   | 
| ActiveMQ 5.17 | 16 de junho de 2025 | 
| ActiveMQ 5.16 | 15 de novembro de 2024 | 
| ActiveMQ 5.15 | 16 de setembro de 2024 | 

 Ao criar um novo agente do Amazon MQ para ActiveMQ, você pode especificar qualquer versão do mecanismo do ActiveMQ compatível. Se você não especificar o número da versão do mecanismo ao criar um agente, o Amazon MQ automaticamente definirá como padrão o número da versão mais recente do mecanismo. 

## Atualizações da versão do mecanismo
<a name="activemq-version-management-upgrading"></a>

 Você pode atualizar seu agente manualmente a qualquer momento para a próxima versão principal ou secundária compatível. Quando você ativa [Atualizações automáticas de versões secundárias](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-prop-updatebrokerinput-autominorversionupgrade), o Amazon MQ atualiza seu agente para a versão de patch mais recente compatível durante a [janela de manutenção](maintaining-brokers.md). 

 Para obter mais informações sobre como atualizar seu agente manualmente, consulte [Atualizando uma versão do mecanismo de agente do Amazon MQ](upgrading-brokers.md). 

## Listando as versões compatíveis do mecanismo
<a name="activemq-version-management-listing-versions"></a>

 Você pode listar todas as versões de mecanismos secundários e principais compatíveis usando o [https://docs.aws.amazon.com/cli/latest/reference/mq/describe-broker-instance-options.html](https://docs.aws.amazon.com/cli/latest/reference/mq/describe-broker-instance-options.html) AWS CLI comando. 

```
aws mq describe-broker-instance-options
```

Para filtrar os resultados por mecanismo e tipo de instância, use a opção `--engine-type` e `--host-instance-type`, conforme mostrado a seguir.

```
aws mq describe-broker-instance-options --engine-type engine-type --host-instance-type instance-type
```

Por exemplo, para filtrar os resultados do ActiveMQ e do tipo de instância, *engine-type* `ACTIVEMQ` substitua por `mq.m5.large` e com. *instance-type* `mq.m5.large`