このロード・バランシング・パラメータの表示
/management/weblogic/{version}/edit/JMSSystemResources/{name}/JMSResource/connectionFactories/{name}/loadBalancingParams
このロード・バランシング・パラメータを表示します。
リクエスト
- name: string
コレクション内のインスタンスのnameプロパティ。
- 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は指定できません。
レスポンス
- application/json
200レスポンス
このロード・バランシング・パラメータを返します。
object- loadBalancingEnabled(optional): boolean
デフォルト値:
true接続ファクトリを介して作成された非匿名プロデューサが、分散宛先内で呼出し単位でロード・バランシングされるようにするかどうかを指定します。
有効化すると、関連付けられているメッセージ・プロデューサは
send()またはpublish()が発行されるたびにロード・バランシングされます。無効化すると、関連付けられているメッセージ・プロデューサは最初の
send()またはpublish()でロード・バランシングされます。
- producerLoadBalancingPolicy(optional): string
デフォルト値:
Per-Member指定可能な値:[ "Per-Member", "Per-JVM" ]プロデューサのロード・バランシング・ポリシーは、分散宛先(DD)のメンバー間で、JMSメッセージ・プロデューサがメッセージのロード・バランシングを行える範囲を制限します。有効な値は、次のとおりです。
メンバー単位- デフォルト値。実行中のすべてのメンバーが候補です。Per-JVM- JVMごとに1つのメンバーのみが候補です。
注意:
この設定は、順序単位および作業単位のメッセージには影響しません。
すべてのWebLogic Server JVMで実行されているDDのメンバーが1つの場合は、
JVM単位とメンバー単位の動作が同じになります。特定DDの
JVM単位の候補メンバーは、WebLogic Server JVM当たり最大で1つです。JVM単位のロード・バランシングの候補は、(a)クラスタのターゲットとして指定されたJMSサーバーやSAFエージェントでホストされているDDメンバーのうち、優先サーバーで実行されているメンバー(フェイル・オーバーや移行が行われなかったものなど)か、(b)DDメンバーがクラスタのターゲットとして指定されたJMSサーバーやSAFエージェントでホストされていない同一のJVM上で、辞書順がより後ろのメンバー名です。(a)のメンバーは、(b)のメンバーより優先されます。2つのメンバーが(a)に当てはまる場合は、辞書順がより後ろのメンバーが選択されます。DDが
複製された分散トピックである場合や、「ロード・バランシングの有効化」が「false」に設定されている場合、MessageProducerは1つのメンバーに固定されるため、初回の作成時かエラーの発生後にのみロード・バランシングが行われます。MessageProducerがすでに特定JVMの特定のDDメンバーに固定されていて、そのDDがクラスタのターゲットとして指定されているJMSサーバーやSAFエージェントでホストされておらず、DDの新しいメンバーが同じJVMで開始されている場合は、そのメンバーがその時点においてもJVM単位のロード・バランシングの候補であるかどうかに関係なく、MessageProducerのその後のメッセージは、元のメンバーに固定されたままになります。カスタマイズされた接続ファクトリの
プロデューサのロード・バランシング・ポリシーは、クラスタ内のすべてのWebLogic Serverに、システム・プロパティweblogic.jms.ProducerLoadBalancingPolicyまたはweblogic.jms.ProducerLoadBalancingPolicy.MODULENAMEを指定することでオーバーライドできます(2つ目のプロパティが1つ目のプロパティより優先されます)。接続ファクトリがこれらのシステム・プロパティのいずれかでオーバーライドされた場合は、最初のMessageProducerが接続ファクトリを使用したときに、ホストWebLogic Serverで、その接続ファクトリの名前とシステム・プロパティ、そのシステム・プロパティの値が記載された情報メッセージBEA-040538が記録されます。ストア・アンド・フォワード・エージェント(SAFエージェント)を介して必ず1回のポリシーで転送されたメッセージのロード・バランシングを制御する類似の設定については、SAFインポート済宛先Beanの必ず1回のロード・バランシング・ポリシー属性を参照してください。
この属性は動的で、いつでも変更できます。ただし、値を変更しても既存の接続には影響しません。この接続ファクトリで作成された新しい接続にのみ影響します。
- serverAffinityEnabled(optional): boolean
デフォルト値:
trueサーバー・インスタンスで、分散宛先の複数のメンバー宛先にまたがってコンシューマまたはプロデューサのロード・バランシングを実行するときに、同じサーバー・インスタンス内で動作する他の物理宛先にまたがるロード・バランシングを最初に試行するかどうかを指定します。