Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Attributs d'élément enfant Amazon MQ
<a name="child-element-details"></a>

Voici une explication détaillée des attributs d'élément enfant. Pour plus d'informations, consultez la page [Configuration XML](http://activemq.apache.org/xml-configuration.html) dans la documentation ActiveMQ Apache.

**Topics**
+ [authorizationEntry](#authorizationEntry)
+ [networkConnector](#networkConnector)
+ [kahaDB](#kahaDB)
+ [systemUsage](#systemUsage)

## authorizationEntry
<a name="authorizationEntry"></a>

`authorizationEntry` est un enfant de la collection d'élément enfant `authorizationEntries`.

### Attributes
<a name="admin-read-write-attributes"></a>

#### admin\$1read\$1write
<a name="admin-read-write"></a>

Les autorisations accordées à un groupe d'utilisateurs. Pour de plus amples informations, veuillez consulter [Toujours configurer un plan d'autorisation](using-amazon-mq-securely.md#always-configure-authorization-map).

Si vous spécifiez un plan d'autorisation qui n'inclut pas le groupe `activemq-webconsole`, vous ne pouvez pas utiliser la console web ActiveMQ car le groupe n'est pas autorisé à envoyer des messages à l'agent Amazon MQ ou à recevoir des messages de ce dernier.

**Par défaut** : `null`

### Exemple de configuration
<a name="admin-read-write-example"></a>

```
<authorizationPlugin>
                                <map>
                                    <authorizationMap>
                                        <authorizationEntries>
                                            <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" queue=">"/>
                                            <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" topic=">"/>
                                        </authorizationEntries>
                                    </authorizationMap>
                                </map>
                                </authorizationPlugin>
```

**Note**  
 Le `activemq-webconsole` groupe dans ActiveMQ sur Amazon MQ possède des autorisations d'administrateur sur toutes les files d'attente et sur tous les sujets. Tous les utilisateurs de ce groupe auront un accès administrateur. 

## networkConnector
<a name="networkConnector"></a>

`networkConnector` est un enfant de la collection d'élément enfant `networkConnectors`.

**Topics**
+ [Attributes](#networkConnector-attributes)
+ [Exemples de configuration](#networkConnector-example)

### Attributes
<a name="networkConnector-attributes"></a>

#### conduitSubscriptions
<a name="conduitSubscriptions"></a>

Indique si une connexion réseau dans un réseau d'agents traite plusieurs consommateurs abonnés à la même destination comme un seul consommateur. Par exemple, si `conduitSubscriptions` est défini comme `true` et que deux consommateurs se connectent à l'agent B et consomment à partir d'une destination, l'agent B combine les abonnements en un seul abonnement logique sur la connexion réseau de l'agent A, afin qu'une seule copie d'un message soit transférée de l'agent A à l'agent B. 

**Note**  
Définir `conduitSubscriptions` comme `true` peut réduire le trafic réseau redondant. Cependant, utiliser cet attribut peut avoir des conséquences pour l'équilibrage de charge des messages entre des consommateurs et cela peut entraîner un comportement incorrect dans certains scénarios (par exemple, avec des sélecteurs de messages JMS ou avec des rubriques durables).

**Par défaut** : `true`

#### duplex
<a name="duplex"></a>

Indique si la connexion dans le réseau d'agents est utilisée pour produire *et* consommer des messages. Par exemple, si l'agent A crée une connexion avec l'agent B en mode non duplex, les messages peuvent être uniquement transférés de l'agent A vers l'agent B. Toutefois, si l'agent A crée une connexion en duplex vers l'agent B, l'agent B peut alors transférer des messages vers l'agent A sans avoir à configurer de `<networkConnector>`.

**Par défaut** : `false`

#### name
<a name="name"></a>

Le nom du pont dans le réseau d'agents.

**Par défaut** : `bridge`

#### uri
<a name="uri"></a>

Le point de terminaison de protocole de niveau filaire pour l'un des deux agents (ou pour plusieurs agents) dans un réseau d'agents.

**Par défaut** : `null`

#### nom d’utilisateur
<a name="username"></a>

Le nom d'utilisateur commun aux agents dans un réseau d'agents.

**Par défaut** : `null`

### Exemples de configuration
<a name="networkConnector-example"></a>

**Note**  
Lorsque vous utilisez un `networkConnector` pour définir un réseau d'agents, n'incluez pas le mot de passe pour l'utilisateur commun à vos agents.

#### Un réseau d'agents avec deux agents
<a name="example-network-of-brokers-two-brokers"></a>

Dans cette configuration, les deux agents sont connectés dans un réseau d'agents. Le nom du connecteur réseau est`connector_1_to_2`, le nom d'utilisateur commun aux courtiers est`myCommonUser`, la connexion est`duplex`, et l'URI du OpenWire point de terminaison est préfixé par`static:`, indiquant une one-to-one connexion entre les courtiers.

```
<networkConnectors>
                                    <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
                                        uri="static:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617)"/>
                                    </networkConnectors>
```

Pour de plus amples informations, veuillez consulter [Étape 2 : Configurer le réseau de connecteurs pour votre agent](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors).

#### Un réseau d'agents avec plusieurs agents
<a name="example-network-of-brokers-multiple-brokers"></a>

Dans cette configuration, plusieurs agents sont connectés dans un réseau d'agents. Le nom du connecteur réseau est`connector_1_to_2`, le nom d'utilisateur commun aux courtiers est`myCommonUser`, la connexion est`duplex`, et la liste des points de OpenWire terminaison séparés par des virgules URIs est préfixée par`masterslave:`, indiquant une connexion de basculement entre les courtiers. Le basculement d'un agent à un autre n'est pas aléatoire et les tentatives de reconnexion continuent indéfiniment.

```
<networkConnectors>
                                    <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
                                        uri="masterslave:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617,
                                        ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-west-2.amazonaws.com:61617)"/>
                                    </networkConnectors>
```

**Note**  
Nous vous recommandons d'utiliser le préfixe `masterslave:` pour le réseau d'agents. Le préfixe est identique à la syntaxe `static:failover:()?randomize=false&maxReconnectAttempts=0` plus explicite.

**Note**  
Cette configuration XML n'autorise pas les espaces.

## kahaDB
<a name="kahaDB"></a>

`kahaDB` est un enfant de la collection d'élément enfant `persistenceAdapter`.

### Attributes
<a name="kahaDB-attributes"></a>

#### concurrentStoreAndDispatchQueues
<a name="concurrentStoreAndDispatchQueues"></a>

Indique s'il convient d'utiliser la répartition et le stockage simultanés pour les files d'attente. Pour de plus amples informations, veuillez consulter [Désactiver Concurrent Store and Dispatch (Répartition et stockage simultanés) pour les files d'attente à consommateurs lents](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers).

**Par défaut** : `true`

#### cleanupOnStop
<a name="cleanupOnStop"></a>

**Pris en charge dans**  
Apache ActiveMQ 15.16.x et versions ultérieures

Si elle est désactivée, le récupérateur de mémoire et le nettoyage n'ont pas lieu lorsque l'agent est arrêté, ce qui accélère le processus d'arrêt. La vitesse accrue est utile dans les cas avec des bases de données volumineuses ou des bases de données de planificateur.

**Par défaut** : `true`

#### journalDiskSyncIntervalle
<a name="journalDiskSyncInterval"></a>

Intervalle (ms) indiquant quand effectuer une synchronisation de disque si `journalDiskSyncStrategy=periodic`. Pour de plus amples informations, veuillez consulter la [documentation Apache ActiveMQ KahadB](https://activemq.apache.org/kahadb).

**Par défaut** : `1000`

#### journalDiskSyncStratégie
<a name="journalDiskSyncStrategy"></a>

**Pris en charge dans**  
Apache ActiveMQ 15.14.x et versions ultérieures

Configure la politique de synchronisation du disque. Pour de plus amples informations, veuillez consulter la [documentation Apache ActiveMQ KahadB](https://activemq.apache.org/kahadb).

**Par défaut** : `always`

**Note**  
La [documentation ActiveMQ](https://activemq.apache.org/kahadb) indique que la perte de données est limitée à la durée de `journalDiskSyncInterval`, qui a une valeur par défaut de 1 s. La perte de données peut être plus longue que l'intervalle, mais il est difficile d'être précis. Soyez prudent. 

#### preallocationStrategy
<a name="preallocationStrategy"></a>

Configure la façon dont l'agent va essayer de préallouer les fichiers journaux lorsqu'un nouveau fichier journal est nécessaire. Pour de plus amples informations, veuillez consulter la [documentation Apache ActiveMQ KahadB](https://activemq.apache.org/kahadb).

**Par défaut** : `sparse_file`

### Exemple de configuration
<a name="kahaDB-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <persistenceAdapter>
                                <kahaDB preallocationStrategy="zeros" concurrentStoreAndDispatchQueues="false" journalDiskSyncInterval="10000" journalDiskSyncStrategy="periodic"/>
                            </persistenceAdapter>
                            </broker>
```

## systemUsage
<a name="systemUsage"></a>

`systemUsage` est un enfant de la collection d'élément enfant `systemUsage`. Il contrôle la quantité maximale d'espace que l'agent utilisera avant de ralentir les producteurs. Pour de plus amples informations, veuillez consulter [Producer Flow Control](http://activemq.apache.org/producer-flow-control.html) dans la documentation Apache ActiveMQ. 

### Élément enfant
<a name="systemUsage-child"></a>

#### memoryUsage
<a name="memoryUsage"></a>

 `memoryUsage` est un enfant de l'élément enfant `systemUsage`. Il gère l'utilisation de la mémoire. Utilisez `memoryUsage` pour conserver une trace de la quantité d'utilisation d'un élément afin que vous puissiez contrôler efficacement l'utilisation de l'ensemble de travail. Pour de plus amples informations, veuillez consulter [le schéma](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) dans la documentation ActiveMQ Apache.

##### Élément enfant
<a name="memoryUsage-child"></a>

 `memoryUsage` est un enfant de l'élément enfant `memoryUsage`. 

##### Attribut
<a name="memeoryUsage-attribute"></a>

##### percentOfJvmTas
<a name="percentOfJvmHeap"></a>

Entier compris entre 0 (inclus) et 70 (inclus).

*Par défaut* : `70` 

### Attributes
<a name="systemUsage-attributes"></a>

#### sendFailIfNoSpace
<a name="sendFailIfNoSpace"></a>

Définit si une méthode `send()` doit échouer s'il n'y a pas d'espace libre. La valeur par défaut est false, ce qui bloque la méthode `send()` jusqu'à ce qu'il y ait de l'espace disponible. Pour de plus amples informations, veuillez consulter le [schéma](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) dans la documentation Apache Active MQ.

**Par défaut** : `false`

#### sendFailIfNoSpaceAfterTimeout
<a name="sendFailIfNoSpaceAfterTimeout"></a>

**Par défaut** : `null`

#### Exemple de configuration
<a name="systemUsage-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <systemUsage>
                                <systemUsage sendFailIfNoSpace="true" sendFailIfNoSpaceAfterTimeout="2000">
                                    <memoryUsage>
                                        <memoryUsage  percentOfJvmHeap="60" />
                                    </memoryUsage>>
                                </systemUsage>
                                </systemUsage>
                            </broker>
                            </persistenceAdapter>
```