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

# Agentes do Amazon MQ para ActiveMQ
<a name="amazon-mq-basic-elements"></a>

## O que é um agente do Amazon MQ para ActiveMQ?
<a name="broker"></a>

Um *agente* é um ambiente de agente de mensagens em execução no Amazon MQ. É o bloco de criação básico do Amazon MQ. A descrição combinada da *classe* (`m5`) e do tamanho (`large`, `medium`) da instância do agente é um tipo de instância de agente (por exemplo,`mq.m5.large`). Para obter mais informações, consulte [Tipos de instância do Amazon MQ para agentes do ActiveMQ](broker-instance-types.md).
+ Um *agente de instância única* é composto por um agente em uma Zona de disponibilidade. O agente se comunica com sua aplicação e com um volume de armazenamento do Amazon EBS ou Amazon EFS.
+ Uma *agente ativo/em espera* é composto por dois agentes em duas zonas de disponibilidade diferentes, configuradas em um *Par redundante*. Esses agentes se comunicam de forma síncrona com sua aplicação e com o Amazon EFS.

Para obter mais informações, consulte [Opções de implantação de agentes do Amazon MQ para ActiveMQ](amazon-mq-broker-architecture.md).

É possível habilitar as *atualizações secundárias de versão automáticas* para novas versões secundárias do mecanismo de agente à medida que o Apache lança novas versões. Atualizações automáticas ocorrem durante a *janela de manutenção* definida pelo dia da semana, a hora do dia (no formato de 24 horas) e o fuso horário (UTC, por padrão).

Para obter informações sobre a criação e o gerenciamento de agentes, consulte o seguinte:
+ [Conceitos básicos: criar e conectar a um agente do ActiveMQ](getting-started-activemq.md)
+ [Operadores](amazon-mq-limits.md#broker-limits)
+ [Status do agente do Amazon MQ](broker-statuses.md)

### Protocolos de nível de conexão compatíveis
<a name="broker-protocols"></a>

Você pode acessar seus agentes usando [qualquer linguagem de programação compatível com o ActiveMQ](http://activemq.apache.org/cross-language-clients.html) e habilitando o TLS explicitamente para os seguintes protocolos:
+ [AMQP](http://activemq.apache.org/amqp.html)
+ [MQTT](http://activemq.apache.org/mqtt.html)
+ MQTT pelo [WebSocket](http://activemq.apache.org/websockets.html)
+ [OpenWire](http://activemq.apache.org/openwire.html)
+ [STOMP](http://activemq.apache.org/stomp.html)
+ STOMP pelo WebSocket

### Atributos
<a name="broker-attributes"></a>

Um agente ActiveMQ tem vários atributos, por exemplo:
+ Um nome (`MyBroker`)
+ Um ID (`b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Um Nome do Recurso da Amazon (ARN) (`arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Uma URL do Console da Web ActiveMQ (`https://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:8162`)

  Para obter mais informações, consulte o [console da Web](http://activemq.apache.org/web-console.html) na documentação do Apache ActiveMQ.
**Importante**  
Se você especificar um mapa de autorização que não inclua o `activemq-webconsole`, você não poderá usar o Console da Web do ActiveMQ porque o grupo não estará autorizado a enviar mensagens ou receber mensagens do agente do Amazon MQ.
+ Endpoints de protocolos de nível de conexão:
  + `amqp+ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:5671`
  + `mqtt+ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:8883`
  + `ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617`
**nota**  
Este é um endpoint do OpenWire.
  + `stomp+ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61614`
  + `wss://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61619`

  Para obter mais informações, consulte [Configuração de transportes](http://activemq.apache.org/configuring-transports.html) na documentação do Apache ActiveMQ.

**nota**  
Para um agente ativo/em espera, o Amazon MQ fornece duas URLs do Console da Web do ActiveMQ, mas apenas uma URL está ativo de cada vez. Da mesma forma, o Amazon MQ fornece dois endpoints para cada protocolo de nível de conexão, mas apenas um endpoint está ativo em cada par de cada vez. Os sufixos `-1` e `-2` denotam um par redundante.

Para obter uma lista completa de atributos do agente, consulte o seguinte na *Referência de API Amazon MQ REST*:
+ [ID da operação REST: Agente](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-broker.html)
+ [ID da operação REST: Agentes](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-brokers.html)
+ [ID da operação REST: Reinicialização do agente](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-broker-reboot.html)

## usuários do agente
<a name="user"></a>

Um *usuário* do ActiveMQ é uma pessoa ou uma aplicação que pode acessar as filas e tópicos de um agente ActiveMQ. Você pode configurar usuários para que tenham permissões específicas. Por exemplo, é possível permitir que alguns usuários acessem o [Console da Web ActiveMQ](http://activemq.apache.org/web-console.html).

Um *grupo* é um rótulo semântico. Você pode atribuir um grupo a um usuário e configurar permissões para grupos para enviar, receber e administrar filas e tópicos específicos.

**Importante**  
Fazer alterações em um usuário *não* aplica as alterações ao usuário imediatamente. Para aplicar as alterações, você deve aguardar a próxima janela de manutenção ou [reiniciar o agente](amazon-mq-rebooting-broker.md).

Para obter informações sobre usuários e grupos, consulte a documentação do Apache ActiveMQ a seguir:
+ [Autorização](http://activemq.apache.org/security.html#Security-Authorization)
+ [Exemplo de autorização](http://activemq.apache.org/security.html#Security-AuthorizationExample)

Para obter informações sobre a criação, edição e exclusão de usuários do ActiveMQ, consulte o seguinte:
+ [Criar um usuário do agente do ActiveMQ](amazon-mq-listing-managing-users.md)
+ [Usuários](amazon-mq-limits.md#activemq-user-limits)

### Atributos de usuário
<a name="user-attributes"></a>

Para obter uma lista completa de atributos do usuário, consulte o seguinte na *Referência de API Amazon MQ REST*:
+ [ID da operação REST: Usuário](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-user.html)
+ [ID da operação REST: Usuários](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-users.html)