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.

# Creación de una configuración del agente de Amazon MQ para ActiveMQ
<a name="amazon-mq-creating-applying-configurations"></a>

Una *configuración* contiene todos los ajustes del agente de ActiveMQ en formato XML (similar al archivo `activemq.xml` de ActiveMQ). Puede crear una configuración antes de crear los agente. Luego, puede aplicar la configuración a uno o más agentes. Puede aplicar una configuración inmediatamente o durante un *período de mantenimiento*.

En el ejemplo siguiente, se muestra cómo crear y aplicar la configuración de un agente de Amazon MQ mediante la Consola de administración de AWS.

**importante**  
Solo puede **eliminar** una configuración mediante la API `DeleteConfiguration`. Para obtener más información, consulte [Configuraciones](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) en la *Referencia de la API de Amazon MQ*.

## Crear una nueva configuración
<a name="creating-configuration-from-scratch-console"></a>

Para crear una nueva configuración de un agente, cree primero la nueva configuración.

1. Inicie sesión en la [consola de Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. En el lado izquierdo, expanda el panel de navegación y elija **Configurations (Configuraciones)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. En la página **Configurations (Configuraciones)**, seleccione **Create configuration (Crear configuración)**.

1. En la página **Create configuration** (Crear configuración), en la sección **Details** (Detalles), escriba el nombre de la configuración en **Configuration name** (Nombre de configuración) (por ejemplo, `MyConfiguration`) y seleccione una versión del motor del agente en **Broker engine** (Motor del agente).
**nota**  
Para obtener más información acerca de las versiones de motor de ActiveMQ compatibles con Amazon MQ para ActiveMQ, consulte [Administración de versiones del motor de Amazon MQ para ActiveMQ](activemq-version-management.md).

1. Seleccione **Crear configuración**.

## Crear una revisión de configuración nueva
<a name="creating-new-configuration-revision-console"></a>

Tras crear una configuración de un agente, tendrá que editarla mediante una revisión de la configuración.

1. En la lista de configuraciones, elija ***MyConfiguration***.
**nota**  
La primera revisión de la configuración siempre se genera automáticamente cuando Amazon MQ crea la configuración.

   En la ***MyConfiguration***página, se muestran el tipo y la versión del motor de broker que utiliza la nueva revisión de configuración (por ejemplo, **Apache ActiveMQ** 5.15.16).

1. En la pestaña **Configuration details**, se muestra el número de revisión de la configuración, la descripción y la configuración del agente en formato XML.
**nota**  
Cuando se edita la configuración actual, se crea una nueva revisión de configuración.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Elija **Edit configuration** (Editar configuración) y realice cambios en la configuración XML.

1. Seleccione **Save**.

   Se muestra el cuadro de diálogo **Save revision** (Guardar revisión).

1. (Opcional) Escriba `A description of the changes in this revision`.

1. Seleccione **Save**.

   De este modo, guardará la nueva revisión de la configuración.
**importante**  
La consola de Amazon MQ elimina automáticamente los parámetros de configuración no válidos y prohibidos de acuerdo con un esquema. Para obtener más información y una lista completa de los parámetros XML permitidos, consulte [Configuraciones del agente de Amazon MQ para ActiveMQ](amazon-mq-broker-configuration-parameters.md).

## Aplicar una revisión de configuración al agente
<a name="apply-configuration-revision-creating-console"></a>

Tras revisar la configuración, puede aplicarla a su agente.

1. En el lado izquierdo, expanda el panel de navegación y elija **Brokers (Agentes)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. **En la lista de corredores, seleccione su corredor (por ejemplo **MyBroker**) y, a continuación, elija Editar.**

1. En la *MyBroker* página de **edición**, en la sección **Configuración**, seleccione una **configuración** y una **revisión** y, a continuación, elija **Programar modificaciones**.

1. En la sección **Schedule broker modifications (Programar modificaciones del agente)**, elija **During the next scheduled maintenance window (Durante el siguiente periodo de mantenimiento programado)** si desea aplicar las modificaciones durante el siguiente periodo de mantenimiento programado o **Immediately (Inmediatamente)** si desea aplicarlas inmediatamente.
**importante**  
Los agentes de instancia única están desconectados mientras se reinician. En el caso de los agentes de clústeres, solo un nodo está inactivo a la vez mientras el agente se reinicia.

1. Seleccione **Aplicar**.

   La revisión de la configuración se aplicará al broker en el momento especificado.