この共通分散トピックの表示
/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/uniformDistributedTopics/{name}
この共通分散トピックを表示します。
リクエスト
- name: string
コレクション内のインスタンスの名前プロパティ。
- version: string
WebLogic RESTインタフェースのバージョン。
- excludeFields(optional): string
'excludeFields'問合せパラメータは、レスポンスで返されるフィールドを制限するために使用します。これはフィールド名のカンマ区切りリストです。存在する場合は、名前がリストにないフィールドのみが返されます。存在しない場合は、すべてのフィールドが返されます('fields'問合せパラメータが指定されていない場合)。ノート: 'excludeFields'が指定されている場合、'fields'は指定できません。
- excludeLinks(optional): string
'excludeLinks'問合せパラメータは、レスポンスで返されるリンクを制限するために使用します。これはリンク関係名のカンマ区切りリストです。存在する場合は、関係名がリストにないフィールドのみが返されます。存在しない場合は、すべてのリンクが返されます('links'問合せパラメータが指定されていない場合)。ノート: 'excludeLinks'が指定されている場合、'links'は指定できません。
- fields(optional): string
'fields'問合せパラメータは、レスポンスで返されるフィールドを制限するために使用します。これはフィールド名のカンマ区切りリストです。存在する場合は、名前が一致するフィールドのみが返されます。存在しない場合は、すべてのフィールドが返されます('excludeFields'問合せパラメータが指定されていない場合)。ノート: 'fields'が指定されている場合、'excludeFields'は指定できません。
- links(optional): string
'links'問合せパラメータは、レスポンスで返されるリンクを制限するために使用します。これはリンク関係名のカンマ区切りリストです。存在する場合は、関係名が一致するリンクのみが返されます。存在しない場合は、すべてのリンクが返されます('excludeLinks'問合せパラメータが指定されていない場合)。ノート: 'links'が指定されている場合、'excludeLinks'は指定できません。
- Admin: basic
型:
basic
説明:Adminセキュリティ・ロールのユーザー。
- Deployer: basic
型:
basic
説明:デプロイヤ・セキュリティ・ロールのユーザー。
- Monitor: basic
型:
basic
説明:モニター・セキュリティ・ロールのユーザー。
- Operator: basic
型:
basic
説明:オペレータ・セキュリティ・ロールのユーザー。
レスポンス
- application/json
200レスポンス
この共通分散トピックを返します。
このメソッドは次のリンクを返すことができます。
- rel=deliveryFailureParams uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/uniformDistributedTopics/{name}/deliveryFailureParams
このリソースのdeliveryFailureParamsシングルトン・リソース。
- rel=deliveryParamsOverrides uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/uniformDistributedTopics/{name}/deliveryParamsOverrides
このリソースのdeliveryParamsOverridesシングルトン・リソース。
- rel=messageLoggingParams uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/uniformDistributedTopics/{name}/messageLoggingParams
このリソースのmessageLoggingParamsシングルトン・リソース。
- rel=multicast uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/uniformDistributedTopics/{name}/multicast
このリソースのmulticastシングルトン・リソース。
- rel=quota
割当てリソースへのこのリソースの割当て参照。
- rel=template
テンプレート・リソースへのこのリソースのテンプレート参照。
- rel=thresholds uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/uniformDistributedTopics/{name}/thresholds
このリソースのthresholdsシングルトン・リソース。
- rel=topicSubscriptionParams uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/uniformDistributedTopics/{name}/topicSubscriptionParams
このリソースのtopicSubscriptionParamsシングルトン・リソース。
object
- attachSender(optional): string
デフォルト値:
supports
指定可能な値:[ "supports"、"never"、"always" ]
この宛先に届くメッセージに送信側ユーザーの資格証明が添付されている必要があるかどうかを指定します。この機能を使用する前に、WebLogic JMSプログラマーズ・ガイドのJMSXUserIDに関するドキュメントを参照してください。
Supports 必要な場合は、JMSXUserIDプロパティが送信側ユーザーのセキュリティ・プリンシパルに設定されます。送信側は、AttachJMSXUserIDセキュリティ・プロパティを有効にした接続ファクトリを使用して、メッセージにIDを添付するようにリクエストできます。
Never 接続ファクトリでAttachJMSXUserIDプロパティがどのように構成されていても、JMSXUserIDプロパティに送信側ユーザーのセキュリティ・プリンシパルが設定されることはありません。
Always 接続ファクトリでAttachJMSXUserIDプロパティがどのように構成されていても、JMSXUserIDプロパティには常に送信側ユーザーのセキュリティ・プリンシパルが設定されます。
この属性は動的に構成できます。この属性を動的に変更した場合は、更新後に受信したメッセージにのみ影響します。
- consumptionPausedAtStartup(optional): boolean
デフォルト値:
false
起動時に宛先で消費を休止するかどうかを指定します。
default JMSテンプレートが指定されている場合、この値はテンプレートの「起動時に消費を休止」の値を継承します。宛先にJMSテンプレートが構成されていない場合、デフォルト値はfalseと同じになります。
false 消費の休止は、この宛先に対して明示的に無効になります。
true 消費の休止は、この宛先に対して明示的に有効になります。
- defaultTargetingEnabled(optional): boolean
デフォルト値:
false
このJMSリソースが、デフォルトの親モジュールのターゲット指定を行うのか、サブデプロイメントのターゲット指定メカニズムを使用するのかを指定します。
Trueに設定すると、このリソースは暗黙的に、親モジュールのターゲット指定を継承します。Falseに設定すると、このリソースはサブデプロイメントのターゲット(指定されている場合)に基づいてターゲット指定されます。
- defaultUnitOfOrder(optional): boolean
デフォルト値:
false
ドメイン、JMSサーバー、宛先名に基づいて、システムで生成される順序単位名をWebLogic Serverが作成するかどうかを指定します。この宛先に届き、まだ順序単位に属していないメッセージは、このデフォルト名を割り当てられます。
このフィールドは、高度な使用にお薦めします。一般的には、アプリケーションの呼出しまたは接続ファクトリ構成を使用してメッセージの順序単位を設定することをお薦めします。分散宛先での強制的な順序付けで宛先のデフォルトの順序単位に依存する場合、アプリケーションでは順序単位のルーティングが適用されないことを認識している必要があります。かわりに、アプリケーションでは、処理の失敗やサービスの移行が発生した場合でも、順番に処理する必要がある特定のメッセージ・セットが指定された同一のメンバー宛先にすべて送信されるように、特別に注意する必要があります。
- destinationKeys(optional): array 項目
タイトル:
Items
JMS宛先に届くメッセージのソートに使用できる宛先キーのリスト。
キーは最上位から最下位の順に順序付けられます。複数のキーが指定されている場合、JMSMessageIDに基づいたキーはリストの最後のキーになります。
ノート: JMSMessageIDがキーに定義されていない場合は、暗黙的にそれが最後のキーと仮定され、ソート順序は「昇順」(FIFO)に設定されます。
- forwardingPolicy(optional): string
デフォルト値:
Replicated
指定可能な値:[ "Partitioned"、"Replicated" ]
送信されたメッセージをすべてのメンバーに転送するかどうかを指定する共通分散トピックのメッセージ転送ポリシー。
有効な値は、次のとおりです。
Replicated - デフォルト。すべての物理トピック・メンバーは各送信済メッセージを受信します。メッセージが物理トピック・メンバーのいずれかに着信する場合、該当する共通分散トピックの他のメンバーにこのメッセージのコピーが転送されます。いずれかの特定のメンバー上のサブスクリプションは、共通分散トピックの論理名または特定の共通分散トピック・メンバーに送信されたメッセージのコピーを取得します。
Partitioned - メッセージを受信する物理メンバーはメッセージを認識する共通分散トピックのメンバーのみになります。メッセージがパーティション化された共通分散トピックの論理名にパブリッシュされるとき、特定の1つの物理トピック・メンバー上にのみ着信します。メッセージが物理トピック・メンバー上に着信すると、メッセージは共通分散宛先の残りのメンバーには転送されず、他の物理トピック・メンバー上のサブスクライバは当該メッセージのコピーを取得しません。パーティション化機能はWebLogic 10.3.4 (11gR1PS3)で追加されました。
「ロード・バランシングの有効化」
属性の値に関係なく、レプリケート分散トピックの論理JNDI名を使用するパブリッシャが1つのメンバー上に作成され、各send呼出しでメッセージが同じメンバーにパブリッシュされます。この動作は、共通分散トピックを使用する以前のリリースのWebLogic Serverと下位互換性があります。これと同じ条件で、パーティション化分散トピックが同じメンバーにパブリッシュされるのは、「ロード・バランシングの有効化」
属性がfalseに設定されている場合のみです。「ロード・バランシングの有効化」
属性がtrueに設定されている場合、パーティション化分散トピックへのパブリッシャは、共通分散トピックの全メンバーでロード・バランスされるメッセージをパブリッシュします。通常、新規アプリケーションでは、新規のパーティション化転送ポリシーを、次のように構成された共通分散トピックの論理サブスクリプション・トポロジと組み合せて使用します: (1)各物理メンバー上で直接作成された同名の物理サブスクリプション、(2)制限なしのクライアントIDポリシー、(3)
「共有可能」
のサブスクリプション共有ポリシー。WL 10.3.4のメッセージドリブンBean (MDB)には、このようなトポロジを自動で設定する「トピック・メッセージ分散モード」オプションがあります。ノート: この属性はスタンドアロン/シングルトンのトピックでは無視されます。分散トピックにしか適用されません。
- id(optional): integer(int64)
読取り専用:
true
このBeanインスタンスの一意の識別子を返します。
- incompleteWorkExpirationTime(optional): integer(int32)
デフォルト値:
-1
未完了のUOW内の未配信メッセージが期限切れになるまでの最長時間(ミリ秒)を指定します。このオプションが設定されたメッセージは、配信不能メッセージ用に定義されている有効期限ポリシーに従います。
ノート: UOWメッセージのエラー宛先を、「単一のメッセージ配信」値の作業単位処理ポリシーで構成することはできません。
この属性は、作業単位処理ポリシーが「単一のメッセージ配信」値に設定されている場合にのみ有効です。値 -1は、UOWメッセージが期限切れにならないことを意味します。
- insertionPausedAtStartup(optional): boolean
デフォルト値:
false
起動時に宛先で新しいメッセージの挿入を休止するかどうかを指定します。
default JMSテンプレートが指定されている場合、この値はテンプレートの「起動時に挿入を休止」の値を継承します。宛先にJMSテンプレートが構成されていない場合、デフォルト値はfalseと同じになります。
false 挿入の休止は、この宛先に対して明示的に無効になります。
true 挿入の休止は、この宛先に対して明示的に有効になります。
- JMSCreateDestinationIdentifier(optional): string
デフォルト値:
oracle.doceng.json.BetterJsonNull@29b421b
宛先の参照名または分散宛先のメンバーの参照名。JNDIを利用せずに
javax.jms.Session createQueue
またはcreateTopic
を使用して宛先を検索する方法を提供します。この属性の使用方法は、JMSのプログラミングの宛先のルックアップ方法を参照してください。この名前は、この宛先のターゲットとなるJMSサーバーのスコープ内で一意である必要があります。ただし、JMSモジュール全体のスコープで一意である必要はありません。たとえば、異なるJMSサーバーに割り当てられているかぎり、2つのキューは同じ宛先名を持つことができます。
ノート:この名前はJMSサーバーのスコープ内で一意である必要があるので、他のJMSモジュールに、この名前と競合する宛先名が含まれているかどうか確認してください。JMSサーバーをターゲットとする宛先名を解決するのは、デプロイヤの役目です。
- JNDIName(optional): string
デフォルト値:
oracle.doceng.json.BetterJsonNull@706fa0ad
JNDIネームスペース内で宛先の検索に使用されるグローバルJNDI名。
クラスタ環境では、この名前はクラスタ全体に伝播されます。JNDI名をローカル・サーバーにのみバインドし、クラスタの他のサーバーに伝播しないようにするには、「
ローカルJNDI名
」パラメータを使用します。この属性を指定しない場合、宛先名はグローバルJNDIネームスペース内に通知されません。
- loadBalancingPolicy(optional): string
デフォルト値:
Round-Robin
指定可能な値:[ "Round-Robin"、"Random" ]
この宛先のメンバーにメッセージが配信される方法を指定します。
次の配信方法から選択します。
Round-Robin 構成ファイルで定義されている順序に従って各トピック・メンバーに順番にメッセージを処理させて負荷を分散し、セット内の物理的なトピック・メンバーの順序を維持します。各WebLogic Serverインスタンスは、同じ順序を維持しますが、順序内の異なるポイントに存在する場合があります。セット内のトピック・メンバーに重みが割り当てられている場合、そのメンバーは順序内に何度も存在することになります。
Random トピック・メンバーに割り当てられた重みを基に、セット内の各メンバーに対する分散の程度を計算します。疑似的なランダム・アクセスによって、トピック・メンバー間でメッセージの負荷を分散します。短期的には、負荷は重みには直接比例しません。長期的には、極限に近い分散が行われます。純粋にランダムな分散にするには、すべての重みを同じ値(通常は1)に設定します。
ノート: この属性はスタンドアロン/シングルトンのキューおよびトピックでは無視されます。分散宛先にしか適用されません。
- localJNDIName(optional): string
デフォルト値:
oracle.doceng.json.BetterJsonNull@622222f
宛先リソースが割り当てられているサーバーのJNDIネームスペース内で、宛先のルックアップに使用されるローカルJNDI名。クラスタ環境では、この名前はローカル・サーバー・インスタンスにのみバインドされ、クラスタの他のサーバーには伝播されません。
宛先はローカルJNDI名と(グローバル) JNDI名の両方を持つことができます。
- maximumMessageSize(optional): integer(int32)
最小値:
0
最大値:2147483647
デフォルト値:2147483647
この宛先でプロデューサから受信するメッセージの最大サイズ。
メッセージのサイズには、メッセージの本文、ユーザー定義のプロパティ、ユーザー定義のJMSヘッダー・フィールド(
JMSCorrelationID
およびJMSType
)が含まれます。宛先のメッセージの最大サイズの設定を超えるメッセージをプロジューサが送信すると、ResourceAllocationException
が発生します。最大メッセージ・サイズは、メッセージの最初の生成に対してのみ適用されます。エラー宛先に転送されるメッセージや、分散宛先のメンバーに転送されるメッセージは、サイズをチェックされません。たとえば、宛先の最大メッセージ・サイズが128KB、対応するエラー宛先の最大メッセージ・サイズが64KBで構成されている場合、96KBのメッセージは(64KBを超えても)エラー宛先にリダイレクトできますが、プロデューサが96KBのメッセージをエラー宛先に直接送信することはできません。
この属性は動的に構成できますが、新しく配信されるメッセージにのみ適用され、すでに保存されているメッセージには影響しません。
- messagingPerformancePreference(optional): integer(int32)
最小値:
0
最大値:100
デフォルト値:25
宛先が、コンシューマに配信する消費可能なメッセージ(存在する場合)の完全なバッチを作成するまでに待機できる期間の長さを制御します。最小値の場合、バッチ処理は無効化されます。デフォルト値の場合、完全でないバッチは待機せずに、ただちに現在消費可能なメッセージによる配信が行われます。デフォルト値より大きい値にチューニングすることで、完全でないバッチがコンシューマに配信される前に、さらなるメッセージに対する最長待機時間を制御できます。
完全なバッチの最大メッセージ数は、JMS接続ファクトリの「最大メッセージ数」の設定によって制御されます。
- name(optional): string
読取り専用:
true
このエンティティの名前。XMLでは属性として示されます。
JMSモジュール内の要素の多くは名前付きのエンティティです。XMLファイル内で、ある型に含まれる名前付きエンティティは、すべて一意でなければなりません。これは、JMSモジュール内で特定のエンティティを区別するための識別子です。
この属性は、モジュールの内部で参照される可能性があるため、モジュールの外から(たとえば、デプロイメント・プランで)変更することはできません。
制約
- 有効なNULL
- notes(optional): string
この名前付きJMSディスクリプタBeanの説明に含めることのできるオプションの情報。
JMSモジュールはこのノートをJMSディスクリプタ・ファイルにXML PCDATAとして保存します。すべての左山カッコ(<)はxmlエンティティに変換されます<) are converted to the xml entity
<。改行/行送りは保持されます</)>。)>
- ノート:
管理コンソールからノートを作成または編集した場合、キャリッジ・リターンとライン・フィードは維持されません。
- productionPausedAtStartup(optional): boolean
デフォルト値:
false
起動時に宛先で新しいメッセージの生成を休止するかどうかを指定します。
default JMSテンプレートが指定されている場合、この値はテンプレートの「起動時に生成を休止」の値を継承します。宛先にJMSテンプレートが構成されていない場合、デフォルト値はfalseと同じになります。
false 生成の休止はこの宛先に対して明示的に無効になります。
true 生成の休止は、この宛先に対して明示的に有効になります。
- quota(optional): array 割当て参照
タイトル:
Quota Reference
割当て参照が含まれます。Quotaは、宛先で使用できるシステム・リソースの割当てを制御します。たとえば、宛先で格納できるバイト数をQuotaを使用して構成できます。
- SAFExportPolicy(optional): string
デフォルト値:
All
指定可能な値:[ "All"、"None" ]
ユーザーがストア・アンド・フォワードを使用する宛先にメッセージを送信できるかどうかを指定します。
All すべてのユーザーが、ストア・アンド・フォワードを使用してこの宛先にメッセージを送信できます。
None リモート・ユーザーは、ストア・アンド・フォワードを使用して宛先にメッセージを送信できません。
この属性は動的に構成できます。この属性を動的に変更した場合は、更新後に送信されたメッセージにのみ影響します。
- subDeploymentName(optional): string
このエンティティをターゲットにする場合に使用するサブデプロイメントの名前を取得します。
この名前を持つサブデプロイメントを使用してエンティティをターゲットにします。サブデプロイメントのターゲットは、このエンティティのターゲットになります。
- template(optional): array テンプレート参照
タイトル:
Template Reference
テンプレート参照が含まれます。宛先の派生元のJMSテンプレート。テンプレートを使用すると、似た構成値を持つ複数の宛先を効率的に定義できます。
JMSテンプレートを指定した場合、デフォルト値に設定されている宛先のパラメータは、実行時にJMSテンプレートからその値を継承します。ただし、JMSテンプレートが定義されていない場合、宛先の構成値は宛先で指定する必要があります。
JMSテンプレートの構成は動的に変更できますが、宛先の構成値は静的です。
制約
- 再起動が必要
- unitOfOrderRouting(optional): string
デフォルト値:
Hash
順序単位の一部であるメッセージの宛先として分散宛先メンバーが選択される方法を指定します。「ハッシュ」は、メッセージ・プロデューサが順序単位の
hashCode
からメンバー宛先を計算することを指定します。「パス・サービス」の場合、構成した「パス・サービス」によって、メンバー宛先が決定されます。「順序単位のルーティング」は、WLProducerでプログラム的に設定されたり、接続ファクトリまたは宛先で管理上の理由から設定される場合があります。
「順序単位のルーティング」は動的に構成できません。
ノート: この属性はスタンドアロン/シングルトンのキューおよびトピックでは無視されます。分散宛先にしか適用されません。
- unitOfWorkHandlingPolicy(optional): string
デフォルト値:
PassThrough
指定可能な値:[ "PassThrough"、"SingleMessageDelivery" ]
この宛先で、作業単位(UOW)機能を有効化するかどうかを指定します。UOWは1つの単位として処理されるメッセージのセットです。
PassThrough デフォルトでは、この宛先はメッセージをUOWの一部として処理しません。
SingleMessageDelivery UOWコンシューマがこの宛先でメッセージを受信する場合にのみ、この値を選択します。選択した場合、UOWメッセージはリストになり、そのリストを格納した
ObjectMessage
として消費されます。
array
Items
JMS宛先に届くメッセージのソートに使用できる宛先キーのリスト。
キーは最上位から最下位の順に順序付けられます。複数のキーが指定されている場合、JMSMessageIDに基づいたキーはリストの最後のキーになります。
ノート: JMSMessageIDがキーに定義されていない場合は、暗黙的にそれが最後のキーと仮定され、ソート順序は「昇順」(FIFO)に設定されます。
array
Quota Reference
Quotaは、宛先で使用できるシステム・リソースの割当てを制御します。たとえば、宛先で格納できるバイト数をQuotaを使用して構成できます。
array
Template Reference
宛先の派生元のJMSテンプレート。テンプレートを使用すると、似た構成値を持つ複数の宛先を効率的に定義できます。
JMSテンプレートを指定した場合、デフォルト値に設定されている宛先のパラメータは、実行時にJMSテンプレートからその値を継承します。ただし、JMSテンプレートが定義されていない場合、宛先の構成値は宛先で指定する必要があります。
JMSテンプレートの構成は動的に変更できますが、宛先の構成値は静的です。
制約
- 再起動が必要