

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione di una configurazione del broker Amazon MQ per ActiveMQ
<a name="amazon-mq-creating-applying-configurations"></a>

Una *configurazione* contiene tutte le impostazioni per il broker ActiveMQ nel formato XML (simile al file `activemq.xml` di ActiveMQ). È possibile creare una configurazione prima di creare qualsiasi broker. È quindi possibile applicare la configurazione a uno o più broker È possibile applicare una configurazione immediatamente o durante una *finestra di manutenzione*.

L'esempio seguente mostra come è possibile creare e applicare una configurazione del broker Amazon MQ utilizzando la Console di gestione AWS.

**Importante**  
È possibile **eliminare** una configurazione solo utilizzando l'`DeleteConfiguration`API. Per ulteriori informazioni, consulta [Configurazioni](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) nell'*Amazon MQ API Reference.*

## Creazione di una nuova configurazione
<a name="creating-configuration-from-scratch-console"></a>

Per creare una nuova configurazione del broker, crea innanzitutto la nuova configurazione.

1. Accedere alla [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Nel riquadro a sinistra, espandere il pannello di navigazione e scegliere **Configurations (Configurazioni)**.  
![Amazon MQ pannello di navigazione che mostra le opzioni Broker e Configurazioni.](http://docs.aws.amazon.com/it_it/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. Nella pagina **Configurations (Configurazioni)**, scegliere **Create configuration (Crea configurazione)**.

1. Nella pagina **Create configuration (Crea configurazione)**, nella sezione **Details (Dettagli)**, digitare il nome in **Configuration name (Nome configurazione)** (ad esempio, `MyConfiguration`) e selezionare una versione **Broker engine (Motore del broker)**.
**Nota**  
Per ulteriori informazioni sulle versioni del motore ActiveMQ supportate da Amazon MQ per ActiveMQ, consultare [Gestione di Amazon MQ per le versioni del motore ActiveMQ](activemq-version-management.md).

1. Scegli **Crea configurazione**.

## Creazione di una nuova revisione di configurazione
<a name="creating-new-configuration-revision-console"></a>

Dopo aver creato una configurazione del broker, dovrai modificare la configurazione utilizzando una revisione della configurazione.

1. Dall'elenco di configurazione, scegli **{{MyConfiguration}}**.
**Nota**  
La prima revisione di configurazione viene sempre creata automaticamente quando Amazon MQ crea la configurazione.

   **{{MyConfiguration}}**Nella pagina vengono visualizzati il tipo di motore del broker e la versione utilizzati dalla nuova revisione della configurazione (ad esempio, **Apache ActiveMQ 5.15.16**).

1. Nella scheda **Configuration details** (Dettagli configurazione) vengono visualizzati il numero di revisione della configurazione, la descrizione e la configurazione del broker in formato XML.
**Nota**  
La modifica della configurazione corrente crea una nuova revisione della configurazione.  
![Frammento di configurazione XML per il broker ActiveMQ con commento esplicativo.](http://docs.aws.amazon.com/it_it/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Scegliere **Edit configuration** (Modifica configurazione) e apportare modifiche alla configurazione XML.

1. Scegli **Save** (Salva).

   Viene visualizzata la finestra di dialogo **Save revision** (Salva revisione).

1. (Opzionale) Digitare `A description of the changes in this revision`.

1. Scegli **Save** (Salva).

   La nuova revisione della configurazione viene salvata.
**Importante**  
La console Amazon MQ sterilizza automaticamente parametri di configurazione non validi e non consentiti in base a uno schema. Per ulteriori informazioni e un elenco completo dei parametri XML consentiti, consultare [Configurazioni del broker Amazon MQ per ActiveMQ](amazon-mq-broker-configuration-parameters.md).

## Applicazione di una revisione di configurazione al broker
<a name="apply-configuration-revision-creating-console"></a>

Dopo aver rivisto la configurazione, puoi applicare la revisione della configurazione al tuo broker.

1. Nel riquadro a sinistra, espandere il pannello di navigazione e scegliere **Brokers (Broker)**.  
![Amazon MQ pannello di navigazione che mostra le opzioni Broker e Configurazioni.](http://docs.aws.amazon.com/it_it/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. **Dall'elenco dei broker, seleziona il tuo broker (ad esempio **MyBroker**), quindi scegli Modifica.**

1. Nella {{MyBroker}} pagina **Modifica**, nella sezione **Configurazione**, seleziona una **configurazione** e una **revisione**, quindi scegli **Pianifica modifiche**.

1. Nella sezione **Schedule broker modifications** (Pianifica modifiche broker) seleziona se applicare le modifiche **During the next scheduled maintenance window** (Nel corso della finestra di manutenzione pianificata successiva) oppure **Immediately** (Immediatamente).
**Importante**  
I broker a istanza singola sono offline durante il riavvio. Per i broker di cluster, durante il riavvio del broker viene interrotto solo un nodo alla volta.

1. Scegli **Applica**.

   La revisione della configurazione viene applicata al tuo broker nel momento specificato.