As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atributos de elementos filho do Amazon MQ
<a name="child-element-details"></a>

A seguinte é uma explicação detalhada dos atributos de elementos filho. Para obter mais informações, consulte [Configuração de XML](http://activemq.apache.org/xml-configuration.html) na documentação do Apache ActiveMQ.

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

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

`authorizationEntry` é um filho do elemento do conjunto de filhos `authorizationEntries`.

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

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

As permissões concedidas a um grupo de usuários. Para obter mais informações, consulte [Sempre configurar um mapa de autorização](using-amazon-mq-securely.md#always-configure-authorization-map).

Se você especificar um mapa de autorização que não inclua o `activemq-webconsole`, você não poderá usar o Console da Web do ActiveMQ porque o grupo não estará autorizado a enviar mensagens ou receber mensagens do agente do Amazon MQ.

**Padrão**: `null`

### Exemplo de configuração
<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**  
 O grupo `activemq-webconsole` do ActiveMQ no Amazon MQ tem permissões de administrador em todas as filas e tópicos. Todos os usuários desse grupo terão acesso de administrador. 

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

`networkConnector` é um filho do elemento do conjunto de filhos `networkConnectors`.

**Topics**
+ [Atributos](#networkConnector-attributes)
+ [Exemplos de configuração](#networkConnector-example)

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

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

Especifica se uma conexão de rede em uma rede de agentes trata vários consumidores que se inscreveram para o mesmo destino como um consumidor. Por exemplo, se `conduitSubscriptions` estiver definido como `true` e dois consumidores se conectarem ao agente B e consumirem a partir de um destino, o agente B combina as assinaturas em uma única assinatura lógica pela conexão de rede para o agente A, para que apenas uma única cópia de um agente de mensagem seja encaminhado do agente A para o B. 

**nota**  
Configurar `conduitSubscriptions` como `true` pode reduzir o tráfego de rede redundante. No entanto, usar esse atributo pode ter implicações para o balanceamento de carga de mensagens entre os consumidores e pode causar comportamento incorreto em determinados cenários (por exemplo, com seletores de mensagens JMS ou com tópicos duráveis).

**Padrão**: `true`

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

Especifica se a conexão na rede de agentes é usada para produzir *e* consumir mensagens. Por exemplo, se o agente A cria uma conexão para o agente B no modo não duplex, as mensagens podem ser encaminhadas apenas do agente A para o agente B. No entanto, se o agente A cria uma conexão duplex para o agente B, então, o agente B pode encaminhar mensagens para o agente A sem a necessidade de configurar um `<networkConnector>`.

**Padrão**: `false`

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

O nome da ponte na rede de agentes.

**Padrão**: `bridge`

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

O endpoint do protocolo de nível de conexão para um dos dois agentes (ou para vários agentes) em uma rede de agentes.

**Padrão**: `null`

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

O nome de usuário comum aos agentes em uma rede de agentes.

**Padrão**: `null`

### Exemplos de configuração
<a name="networkConnector-example"></a>

**nota**  
Ao usar um `networkConnector` para definir uma rede de agentes, não inclua a senha de usuário comum para os agentes.

#### Uma rede de agentes com dois agentes
<a name="example-network-of-brokers-two-brokers"></a>

Nesta configuração, dois agentes são conectados em uma rede de agentes. O nome do conector de rede é`connector_1_to_2`, o nome de usuário comum aos corretores é`myCommonUser`, a conexão é `duplex` e o URI do OpenWire endpoint é prefixado por`static:`, indicando uma one-to-one conexão entre os corretores.

```
<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 obter mais informações, consulte [Etapa 2: Configurar os conectores de rede para o seu agente](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors).

#### Uma rede de agentes com vários agentes
<a name="example-network-of-brokers-multiple-brokers"></a>

Nesta configuração, vários agentes são conectados em uma rede de agentes. O nome do conector de rede é`connector_1_to_2`, o nome de usuário comum aos corretores é`myCommonUser`, a conexão é`duplex`, e a lista de OpenWire endpoints separados por vírgulas URIs é prefixada por`masterslave:`, indicando uma conexão de failover entre os corretores. O failover do agente para o agente não é aleatório e tentativas de reconexão continuam 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**  
Recomendamos usar o prefixo `masterslave:` para as redes de agentes. O prefixo é idêntico à sintaxe mais explícita `static:failover:()?randomize=false&maxReconnectAttempts=0`.

**nota**  
Essa configuração de XML não permite espaços.

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

`kahaDB` é um filho do elemento do conjunto de filhos `persistenceAdapter`.

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

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

Especifica se é necessário usar armazenamento e despacho simultâneos para filas. Para obter mais informações, consulte [Desativar o armazenamento e a expedição simultâneos para filas com consumidores lentos](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers).

**Padrão**: `true`

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

**Compatível com**  
Apache ActiveMQ 15.16.x e versão superior

Quando desativada, a coleta de resíduos e a limpeza não ocorrem quando o agente é interrompido, o que agiliza o processo de desligamento. O aumento da velocidade é útil em casos com grandes bancos de dados ou bancos de dados do programador.

**Padrão**: `true`

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

Intervalo (ms) para quando executar uma sincronização de disco se `journalDiskSyncStrategy=periodic`. Para obter mais informações, consulte a [documentação do Apache ActiveMQ kahaDB](https://activemq.apache.org/kahadb).

**Padrão**: `1000`

#### journalDiskSyncEstratégia
<a name="journalDiskSyncStrategy"></a>

**Compatível com**  
Apache ActiveMQ 15.14.x e versão superior

Configura a política de sincronização de disco. Para obter mais informações, consulte a [documentação do Apache ActiveMQ kahaDB](https://activemq.apache.org/kahadb).

**Padrão**: `always`

**nota**  
A [documentação do ActiveMQ](https://activemq.apache.org/kahadb) afirma que a perda de dados é limitada à duração de `journalDiskSyncInterval`, que tem um padrão de 1s. A perda de dados pode ser maior do que o intervalo, mas é difícil ser preciso. Tenha cuidado. 

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

Configura como o agente tentará pré-alocar os arquivos do diário quando um novo arquivo do diário for necessário. Para obter mais informações, consulte a [documentação do Apache ActiveMQ kahaDB](https://activemq.apache.org/kahadb).

**Padrão**: `sparse_file`

### Exemplo de configuração
<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` é um filho do elemento do conjunto de filhos `systemUsage`. Ele controla a quantidade máxima de espaço que o agente usará antes de desacelerar os produtores. Para obter mais informações, consulte [Controle do fluxo do produtor](http://activemq.apache.org/producer-flow-control.html) na documentação do Apache ActiveMQ. 

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

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

 `memoryUsage` é um filho do elemento filho `systemUsage`. Ele gerencia o uso de memória. Use `memoryUsage` para acompanhar quanto de um elemento está sendo usado, para que você possa controlar o uso do conjunto de trabalho de forma produtiva. Para obter mais informações, consulte [o esquema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) na documentação do Apache ActiveMQ.

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

 `memoryUsage` é um filho do elemento filho `memoryUsage`. 

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

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

Número inteiro entre 0 (inclusive) e 70 (inclusive).

*Padrão*: `70` 

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

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

Define se um método `send()` deverá falhar se não houver espaço livre. O valor padrão é false, o que bloqueia o método `send()` até haver espaço disponível. Para obter mais informações, consulte o [esquema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) na documentação do Apache Active MQ.

**Padrão**: `false`

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

**Padrão**: `null`

#### Exemplo de configuração
<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>
```