翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon MQ 子要素属性
<a name="child-element-details"></a>

以下は、子要素属性の詳しい説明です。詳細については、Apache ActiveMQ ドキュメントの [XML 設定](http://activemq.apache.org/xml-configuration.html)を参照してください。

**Topics**
+ [

## authorizationEntry
](#authorizationEntry)
+ [

## networkConnector
](#networkConnector)
+ [

## kahaDB
](#kahaDB)
+ [

## systemUsage
](#systemUsage)

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

`authorizationEntry` は `authorizationEntries` 子コレクション要素の子です。

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

#### 管理\$1読み取り\$1書き込み
<a name="admin-read-write"></a>

ユーザーのグループに付与されているアクセス許可。詳細については、「[認可マップを常に設定する](using-amazon-mq-securely.md#always-configure-authorization-map)」を参照してください。

`activemq-webconsole` グループが含まれない認可マップを指定する場合、Amazon MQ ブローカーにメッセージを送信する権限、またはブローカーからメッセージを受信する権限がグループにないことから、ActiveMQ ウェブコンソールは使用できません。

**デフォルト**: `null`

### サンプル設定
<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>
```

**注記**  
 Amazon MQ 上の ActiveMQ の `activemq-webconsole` グループには、すべてのキューとトピックに対する管理者アクセス許可があります。このグループのすべてのユーザーは管理者アクセス権を持ちます。

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

`networkConnector` は `networkConnectors` 子コレクション要素の子です。

**Topics**
+ [

### 属性
](#networkConnector-attributes)
+ [

### 構成例
](#networkConnector-example)

### 属性
<a name="networkConnector-attributes"></a>

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

ブローカーのネットワークのネットワーク接続が、同じ送信先にサブスクライブしている複数のコンシューマーを 1 つのコンシューマーとして扱うかどうかを指定します。たとえば、`conduitSubscriptions` が `true` に設定されていて、2 つのコンシューマーがブローカー B に接続して送信先から消費する場合、ブローカー B は、ブローカー A へのネットワーク接続を介してサブスクリプションを単一の論理サブスクリプションに結合するので、メッセージの単一コピーのみがブローカー A からブローカー B に転送されます。

**注記**  
`conduitSubscriptions` を `true` に設定すると、冗長なネットワークトラフィックを減らすことができます。ただし、この属性を使用すると、コンシューマー間でのメッセージのロードバランシングに影響が出る可能性があり、特定のシナリオ (JMS メッセージセレクタや耐久性のあるトピックなど) では正しくない動作を引き起こす可能性があります。

**デフォルト**: `true`

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

ブローカーのネットワーク内の接続を使用し、*また*メッセージを生成するかどうかを指定します。ブ たとえば、ブローカー A が非二重モードでブローカー B への接続を作成した場合、メッセージはブローカー A からブローカー B にのみ転送できます。ただし、ブローカー A がブローカー B への二重接続を作成した場合、ブローカー B は `<networkConnector>` を設定しなくてもメッセージをブローカー A に転送できます。

**デフォルト**: `false`

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

ブローカーのネットワークのブリッジの名前。

**デフォルト**: `bridge`

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

ブローカーのネットワークの 2 つのブローカーのうちの 1 つ (または複数のブローカー) のワイヤレベルプロトコルエンドポイント。

**デフォルト**: `null`

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

ブローカーのネットワークのブローカーに共通のユーザー名。

**デフォルト**: `null`

### 構成例
<a name="networkConnector-example"></a>

**注記**  
`networkConnector` を使用してブローカーのネットワークを定義するときは、ブローカーに共通のユーザーのパスワードを含めないでください。

#### 2 つのブローカーとブローカーのネットワーク
<a name="example-network-of-brokers-two-brokers"></a>

この設定では、2 つのブローカーがブローカーのネットワークで接続されています。ネットワークコネクターの名前は `connector_1_to_2`、ブローカーに共通のユーザー名は `myCommonUser`、接続は `duplex`、そして OpenWire エンドポイント URI は `static:` というプレフィックスは、ブローカー間の 1 対 1 の接続を示します。

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

詳細については、「[ステップ 2: ブローカー用のネットワークコネクターを設定する](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors)」を参照してください。

#### 複数のブローカーのあるブローカーのネットワーク
<a name="example-network-of-brokers-multiple-brokers"></a>

この設定では、複数のブローカーがブローカーのネットワークで接続されています。ネットワークコネクターの名前は `connector_1_to_2`、ブローカーに共通のユーザー名は `myCommonUser`、接続は `duplex` です。OpenWire エンドポイント URI のカンマ区切りのリストの前には `masterslave:` というプレフィックスが付き、ブローカー間のフェイルオーバー接続を示します。ブローカーからブローカーへのフェイルオーバーはランダム化されず、再接続の試行は無期限に続きます。

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

**注記**  
ブローカーのネットワークの `masterslave:` プレフィックスを使用することをお勧めします。プレフィックスはより明示的な `static:failover:()?randomize=false&maxReconnectAttempts=0` 構文と完全に一致します。

**注記**  
この XML 設定ではスペースを使用できません。

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

`kahaDB` は `persistenceAdapter` 子コレクション要素の子です。

### 属性
<a name="kahaDB-attributes"></a>

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

キューの同時保存とディスパッチを使用するかどうかを指定します。詳細については、「[低速コンシューマーのキューに対して同時保存とディスパッチを無効にする](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers)」を参照してください。

**デフォルト**: `true`

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

**以下でサポート**  
Apache ActiveMQ 15.16.x 以上

無効にされていると、ブローカーが停止されたときにガベージコレクションおよびクリーンアップが実行されず、シャットダウンプロセスの速度が上がります。高速化は、大規模なデータベースやスケジューラデータベースの場合に有用です。

**デフォルト**: `true`

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

`journalDiskSyncStrategy=periodic` の場合にディスク同期を実行する間隔 (ミリ秒)。詳細については、[Apache ActiveMQ kahaDB のドキュメント](https://activemq.apache.org/kahadb)を参照してください。

**デフォルト**: `1000`

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

**以下でサポート**  
Apache ActiveMQ 15.14.x 以上

ディスク同期ポリシーを設定します。詳細については、[Apache ActiveMQ kahaDB のドキュメント](https://activemq.apache.org/kahadb)を参照してください。

**デフォルト**: `always`

**注記**  
[ActiveMQ のドキュメント](https://activemq.apache.org/kahadb)では、データ損失は `journalDiskSyncInterval` の長さに制限されており、デフォルトは 1 秒です。厳密には言えませんが、データ損失はこの間隔よりも長くなる可能性があります。注意してください。

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

新しいジャーナルファイルが必要になったときにブローカーがジャーナルファイルの事前割り当てを試みる方法を設定します。詳細については、[Apache ActiveMQ kahaDB のドキュメント](https://activemq.apache.org/kahadb)を参照してください。

**デフォルト**: `sparse_file`

### サンプル設定
<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` は `systemUsage` 子コレクション要素の子です。プロデューサーの速度を遅くするまでにブローカーが使用する領域の最大量を制御します。詳細については、Apache ActiveMQ のドキュメントの [Producer Flow Control](http://activemq.apache.org/producer-flow-control.html) を参照してください。

### 子要素
<a name="systemUsage-child"></a>

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

 `memoryUsage` は `systemUsage` 子要素の子です。メモリ使用量を管理します。本番稼働での作業セットの使用を制御できるように、`memoryUsage` を使用してメモリ使用量を追跡します。詳細については、Apache ActiveMQ のドキュメントの [schema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) を参照してください。

##### 子要素
<a name="memoryUsage-child"></a>

 `memoryUsage` は `memoryUsage` 子要素の子です。

##### 属性
<a name="memeoryUsage-attribute"></a>

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

0 ～ 70 の整数。

*デフォルト*: `70` 

### 属性
<a name="systemUsage-attributes"></a>

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

空き領域がない場合に `send()` メソッドが失敗するかどうかを設定します。デフォルト値は false で、領域が空くまで `send()` メソッドをブロックします。詳細については、Apache Active MQ のドキュメントの [schema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) を参照してください。

**デフォルト**: `false`

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

**デフォルト**: `null`

#### サンプル設定
<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>
```