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.

# Atributos de elemento secundarios de Amazon MQ
<a name="child-element-details"></a>

A continuación se ofrece una explicación detallada de los atributos de elemento secundarios. Para obtener más información, consulte el tema sobre la [configuración de XML](http://activemq.apache.org/xml-configuration.html) en la documentación de Apache ActiveMQ.

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

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

`authorizationEntry` es un elemento secundario del elemento de colección secundario `authorizationEntries`.

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

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

Los permisos concedidos a un grupo de usuarios. Para obtener más información, consulte [Configurar siempre una asignación de autorizaciones](using-amazon-mq-securely.md#always-configure-authorization-map).

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.

**Valor predeterminado**: `null`

### Configuración de ejemplo
<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>
```

**nota**  
 El grupo `activemq-webconsole` de ActiveMQ en Amazon MQ tiene permisos de administrador en todas las colas y temas. Todos los usuarios de este grupo tendrán acceso de administrador. 

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

`networkConnector` es un elemento secundario del elemento de colección secundario `networkConnectors`.

**Topics**
+ [Atributos](#networkConnector-attributes)
+ [Ejemplo de configuraciones](#networkConnector-example)

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

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

Especifica si una conexión de red en una red de agentes trata varios consumidores suscritos al mismo destino como un consumidor. Por ejemplo, si `conduitSubscriptions` se ha establecido en `true` y se conectan dos consumidores al agente B y consumen desde un destino, el agente B combina las suscripciones en una sola suscripción lógica a través de la conexión de red al agente A, de modo que solo se reenvía una única copia de un mensaje del agente A al agente B. 

**nota**  
Establecer `conduitSubscriptions` en `true` puede reducir el tráfico de red redundante. Sin embargo, el uso de este atributo puede tener implicaciones para el balanceo de carga de mensajes en los consumidores y podría causar un comportamiento incorrecto en ciertas situaciones (por ejemplo, con selectores de mensajes de JMS o con temas duraderos).

**Valor predeterminado**: `true`

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

Especifica si la conexión en la red de agentes se utiliza para producir *y* consumir mensajes. Por ejemplo, si un agente A crea una conexión al agente B en modo no dúplex, los mensajes pueden reenviarse solo desde el agente A al agente B. Sin embargo, si un agente A crea una conexión dúplex al agente B, entonces el agente B puede reenviar mensajes al agente A sin tener que configurar un `<networkConnector>`.

**Valor predeterminado**: `false`

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

El nombre del puente en la red de agentes.

**Valor predeterminado**: `bridge`

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

El punto de enlace de protocolo de nivel de conexión para uno de los dos agentes (o para varios agentes) en una red de agentes.

**Valor predeterminado**: `null`

#### nombre de usuario
<a name="username"></a>

El nombre de usuario común a los agentes en una red de agentes.

**Valor predeterminado**: `null`

### Ejemplo de configuraciones
<a name="networkConnector-example"></a>

**nota**  
Cuando se utiliza un `networkConnector` para definir una red de agentes, no incluya la contraseña para el usuario común a los agentes.

#### Una red de agentes con dos agentes
<a name="example-network-of-brokers-two-brokers"></a>

En esta configuración, dos agentes están conectados en una red de agentes. El nombre del conector de red es`connector_1_to_2`, el nombre de usuario común a los corredores es`myCommonUser`, la conexión es `duplex` y el URI del OpenWire punto final lleva el prefijo`static:`, lo que indica una one-to-one conexión entre los corredores.

```
<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>
```

Para obtener más información, consulte [Paso 2: Configurar conectores de red para su agente](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors).

#### Una red de agentes con varios agentes
<a name="example-network-of-brokers-multiple-brokers"></a>

En esta configuración, varios agentes están conectados en una red de agentes. El nombre del conector de red es`connector_1_to_2`, el nombre de usuario común a los intermediarios`myCommonUser`, la conexión es y la lista de OpenWire terminales separados por comas lleva el prefijo `duplex``masterslave:`, lo que indica que URIs hay una conexión de conmutación por error entre los corredores. La conmutación por error de agente a agente no es aleatoria y los intentos de reconexión continúan indefinidamente.

```
<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>
```

**nota**  
Le recomendamos que utilice el prefijo `masterslave:` para las redes de agentes. El prefijo es idéntico a la sintaxis `static:failover:()?randomize=false&maxReconnectAttempts=0` más explícita.

**nota**  
Esta configuración de XML no permite espacios.

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

`kahaDB` es un elemento secundario del elemento de colección secundario `persistenceAdapter`.

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

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

Especifica si se debe usar almacenamiento y envío simultáneo para colas. Para obtener más información, consulte [Desactivar el almacenamiento y el envío simultáneos en colas con consumidores lentos](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers).

**Valor predeterminado**: `true`

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

**Compatible con**  
Apache ActiveMQ 15.16.x y versiones posteriores

Si se desactiva, la recolección de basura y la limpieza no se llevan a cabo cuando se suspende al agente, lo que acelera el proceso de apagado. El aumento de la velocidad es útil en casos de bases de datos grandes o de programadores.

**Valor predeterminado**: `true`

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

Intervalo (ms) para cuándo realizar una sincronización de disco si `journalDiskSyncStrategy=periodic`. Para obtener más información, consulte la [documentación de Apache ActiveMQ kahaDB](https://activemq.apache.org/kahadb).

**Valor predeterminado**: `1000`

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

**Compatible con**  
Apache ActiveMQ 15.14.x y versiones posteriores

Configura la política de sincronización de disco. Para obtener más información, consulte la [documentación de Apache ActiveMQ kahaDB](https://activemq.apache.org/kahadb).

**Valor predeterminado**: `always`

**nota**  
La [documentación de ActiveMQ](https://activemq.apache.org/kahadb) indica que la pérdida de datos está limitada a la duración de `journalDiskSyncInterval`, que tiene un valor predeterminado de 1 segundo. La pérdida de datos puede ser más larga que el intervalo, pero es difícil ser preciso. Sea precavido. 

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

Configura la forma en que el agente intentará preasignar los archivos de diario cuando se necesite un nuevo archivo de diario. Para obtener más información, consulte la [documentación de Apache ActiveMQ kahaDB](https://activemq.apache.org/kahadb).

**Valor predeterminado**: `sparse_file`

### Configuración de ejemplo
<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` es un elemento secundario del elemento de colección secundario `systemUsage`. Controla la cantidad máxima de espacio que usará el agente antes de ralentizar a los productores. Para obtener más información, consulte [Producer Flow Control (Control del flujo del productor)](http://activemq.apache.org/producer-flow-control.html) en la documentación de Apache ActiveMQ. 

### Elemento secundario
<a name="systemUsage-child"></a>

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

 `memoryUsage` es un elemento secundario del elemento secundario `systemUsage`. Gestiona el uso de la memoria. Use `memoryUsage` para realizar un seguimiento de cuánto se está utilizando un elemento para que pueda controlar el uso del conjunto de trabajo de manera productiva. Para obtener más información, consulte [el esquema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) de la documentación de Apache ActiveMQ.

##### Elemento secundario
<a name="memoryUsage-child"></a>

 `memoryUsage` es un elemento secundario del elemento secundario `memoryUsage`. 

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

##### percentOfJvmMontón
<a name="percentOfJvmHeap"></a>

Número entero entre 0 (inclusive) y 70 (inclusive).

*Valor predeterminado*: `70` 

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

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

Establece si un método `send()` debe fallar si no hay espacio libre. El valor predeterminado es false, lo que bloquea el método `send()` hasta que el espacio esté disponible. Para obtener más información, consulte el [esquema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) de la documentación de Apache Active MQ.

**Valor predeterminado**: `false`

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

**Valor predeterminado**: `null`

#### Configuración de ejemplo
<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>
```