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á.
# Atualização de um tipo de instância do agente do Amazon MQ
**Importante**
As instância de `mq.m7g.x` só estão disponíveis no Amazon MQ para agentes do RabbitMQ. Os agentes do Amazon MQ para ActiveMQ só usam as instância de `mq.m5.x`.
A descrição combinada da classe (`m7g`) e do tamanho (`large`) da instância do agente é chamada de tipo de instância de agente (por exemplo, `mq.m7g.large`). Quando se escolhe um tipo de instância, é importante considerar os fatores que afetarão o desempenho do agente:
+ o número de clientes e filas
+ o volume de mensagens enviadas
+ mensagens mantidas na memória
+ mensagens redundantes
Tipos menores de instância do agente (`mq.m7g.medium`) são recomendados somente para testar o desempenho da aplicação. Recomendamos tipos maiores de instância do agente (`mq.m7g.large ` e superiores) para níveis de produção de clientes e filas, alto throughput, mensagens na memória e mensagens redundantes.
Recomendamos a atualização para um tipo de instância maior (ou seja, de `micro` para`large`) se você estiver enfrentando problemas de desempenho ou se estiver migrando de um ambiente de teste para um ambiente de produção. Para atualizar o tipo de instância, você pode usar o Console de gerenciamento da AWS, a AWS CLI ou a API do Amazon MQ.
## Console de gerenciamento da AWS
**Para atualizar para um tipo de instância maior usando oConsole de gerenciamento da AWS, faça o seguinte:**
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 **Specifications (Especificações)**, para **Broker instance type (Tipo de instância do agente)**, escolha o novo tipo de instância 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 durante a próxima janela de manutenção programada.
+ Selecione **Immediately (Imediatamente)** se você quiser reiniciar o agente e atualizar o tipo de instância 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 o tipo de instância de um agente usando o AWS CLI**
1. Usar o comando da CLI [modify-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) e especifique os parâmetros a seguir, conforme mostrado no exemplo.
+ `--broker-id` — O ID exclusivo que o Amazon MQ gera para o agente.
+ `--host-instance-type` — O número da versão do mecanismo para a qual o a atualização do mecanismo de agente será feita.
```
aws mq modify-broker --broker-id {{broker-id}} --host-instance-type {{instance-type}}
```
1. (Opcional) Use o comando CLI [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) para reiniciar o agente, se você quiser atualizar o tipo de instância 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. Para agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.
## API do Amazon MQ
**Para atualizar o tipo de instância de um 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: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: {{authorization-string}}
```
Use o `host-instance-type` na carga útil da solicitação para especificar o tipo de instância para o qual o agente será atualizado.
```
{
"host-instance-type": "{{host-instance-type}}"
}
```
1. (Opcional) Use a operação de API [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker) para reiniciar seu agente, se você 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.