Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Amazon MQ para agentes de ActiveMQ
## ¿Qué es un agente de Amazon MQ para ActiveMQ?
Un *agente* es un entorno de agente de mensajes que se ejecuta en Amazon MQ. Es el componente básico de Amazon MQ. La descripción combinada de la instancia del agente *clase* (`m5`) y *tamaño* (`large`, `medium`) se conoce como *tipo de instancias del agente* (por ejemplo, `mq.m5.large`). Para obtener más información, consulte [Amazon MQ para tipos de instancia de agentes de ActiveMQ](broker-instance-types.md).
+ Un *agente de una sola instancia* está compuesto por un agente en una zona de disponibilidad. El agente se comunica con su aplicación y con un volumen de almacenamiento de Amazon EBS o Amazon EFS.
+ Un *agente activo/en espera* está compuesto por dos agentes en dos zonas de disponibilidad diferentes, configurados en un *par redundante*. Estos agentes se comunican de forma sincrónica con su aplicación y con Amazon EFS.
Para obtener más información, consulte [Opciones de implementación de Amazon MQ para agentes de ActiveMQ](amazon-mq-broker-architecture.md).
Puede habilitar las *actualizaciones automáticas de versiones secundarias* para obtener las nuevas versiones secundarias del motor del agente a medida que Apache las publique. Las actualizaciones automáticas se producen durante el *período de mantenimiento* definido por el día de la semana, la hora del día (en formato de 24 horas) y la zona horaria (UTC de forma predeterminada).
Para obtener más información acerca de cómo se crean y se administran los agentes, consulte los siguientes temas:
+ [Introducción: Creación y conexión con un agente de ActiveMQ](getting-started-activemq.md)
+ [Agentes](amazon-mq-limits.md#broker-limits)
+ [Estados del agente de Amazon MQ](broker-statuses.md)
### Protocolos de nivel de cable admitidos
Para obtener acceso a sus agentes, puede usar [cualquier lenguaje de programación que admita ActiveMQ](http://activemq.apache.org/cross-language-clients.html) y habilitar TLS explícitamente para los siguientes protocolos:
+ [AMQP](http://activemq.apache.org/amqp.html)
+ [MQTT](http://activemq.apache.org/mqtt.html)
+ MQTT a través de [WebSocket](http://activemq.apache.org/websockets.html)
+ [OpenWire](http://activemq.apache.org/openwire.html)
+ [STOMP](http://activemq.apache.org/stomp.html)
+ STOMP a través de WebSocket
### Atributos
Un agente de ActiveMQ tiene varios atributos, por ejemplo:
+ Un nombre (`MyBroker`)
+ Un ID (`b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Un nombre de recurso de Amazon (ARN) (`arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Una URL de ActiveMQ Web Console (`https://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:8162`)
Para obtener más información, consulte el tema sobre la [consola web](http://activemq.apache.org/web-console.html) en la documentación de Apache ActiveMQ.
**importante**
Si especifica un mapa de autorizaciones que no incluya al grupo `activemq-webconsole`, no puede utilizar la consola web de ActiveMQ porque el grupo no está autorizado a enviar mensajes al agente de Amazon MQ ni para recibir mensajes de este.
+ Puntos de enlace de protocolo de nivel de conexión:
+ `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**
Es un punto de enlace de 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 obtener más información, consulte el tema sobre la [configuración de transportes](http://activemq.apache.org/configuring-transports.html) en la documentación de Apache ActiveMQ.
**nota**
En el caso de un agente activo/en espera, Amazon MQ proporciona dos URL de la consola web de ActiveMQ, pero solo hay una URL activa a la vez. Del mismo modo, Amazon MQ proporciona dos puntos de enlace para cada protocolo de nivel de cable, pero solo hay un punto de enlace activo en cada par a la vez. Los sufijos `-1` y `-2` denotan un par redundante.
Para ver una lista completa de los atributos del agente, consulte lo siguiente en la *Referencia de la API REST de Amazon MQ*:
+ [ID de operación de REST: Broker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-broker.html)
+ [ID de operación de REST: Brokers](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-brokers.html)
+ [ID de operación de REST: Reboot](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-broker-reboot.html)
## Usuarios de agentes
Un *usuario* de ActiveMQ es una persona o una aplicación que pueden acceder a las colas y los temas de un agente de ActiveMQ. Puede configurar a los usuarios para que tengan permisos específicos. Por ejemplo, puede permitir que algunos usuarios accedan a la [consola web de ActiveMQ](http://activemq.apache.org/web-console.html).
Un *grupo* es una etiqueta semántica. Puede asignar un grupo a un usuario y configurar permisos para que los grupos envíen, reciban y administren colas y temas específicos.
**importante**
Si realiza cambios en un usuario, los cambios *no* se aplica al usuario de inmediato. Para aplicar los cambios, debe espere al próximo período de mantenimiento o [reiniciar el agente](amazon-mq-rebooting-broker.md).
Para obtener información sobre los usuarios y los grupos, consulte lo siguiente en la documentación de Apache ActiveMQ:
+ [Autorización](http://activemq.apache.org/security.html#Security-Authorization)
+ [Ejemplo de autorización](http://activemq.apache.org/security.html#Security-AuthorizationExample)
Para obtener más información acerca de cómo crear, editar y eliminar usuarios de ActiveMQ, consulte los siguientes temas:
+ [Creación de un usuario del agente de ActiveMQ](amazon-mq-listing-managing-users.md)
+ [Users](amazon-mq-limits.md#activemq-user-limits)
### Atributos de usuario
Para ver una lista completa de los atributos de usuario, consulte lo siguiente en la *Referencia de la API REST de Amazon MQ*:
+ [ID de operación de REST: User](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-user.html)
+ [ID de operación de REST: Users](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-users.html)