このSAFインポート済宛先の表示
/management/weblogic/{version}/edit/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}
このSAFインポート済宛先を表示します。
リクエスト
- 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レスポンス
このSAFインポート済宛先を返します。
このメソッドは次のリンクを返すことができます。
- rel=SAFErrorHandling
このリソースの、SAFエラー処理リソースに対するSAFErrorHandling参照。
- rel=SAFQueueCreateForm uri=/management/weblogic/{version}/edit/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}/SAFQueueCreateForm
このリソースのSAFQueuesコレクション・リソースの作成フォーム・リソース。
- rel=SAFQueues uri=/management/weblogic/{version}/edit/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}/SAFQueues
このリソースのSAFQueuesコレクション・リソース。
- rel=SAFRemoteContext
このリソースの、SAFリモート・コンテキスト・リソースに対するSAFRemoteContext参照。
- rel=SAFTopicCreateForm uri=/management/weblogic/{version}/edit/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}/SAFTopicCreateForm
このリソースのSAFTopicsコレクション・リソースの作成フォーム・リソース。
- rel=SAFTopics uri=/management/weblogic/{version}/edit/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}/SAFTopics
このリソースのSAFTopicsコレクション・リソース。
- rel=messageLoggingParams uri=/management/weblogic/{version}/edit/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}/messageLoggingParams
このリソースのmessageLoggingParamsシングルトン・リソース。
object
- defaultTargetingEnabled(optional): boolean
デフォルト値:
false
このJMSリソースが、デフォルトの親モジュールのターゲット指定を行うのか、サブデプロイメントのターゲット指定メカニズムを使用するのかを指定します。
Trueに設定すると、このリソースは暗黙的に、親モジュールのターゲット指定を継承します。Falseに設定すると、このリソースはサブデプロイメントのターゲット(指定されている場合)に基づいてターゲット指定されます。
- exactlyOnceLoadBalancingPolicy(optional): string
デフォルト値:
Per-Member
指定可能な値:[ "Per-Member", "Per-JVM" ]
SAFサービスにより、
「必ず1回」
のサービス品質(QOS)でメッセージが分散宛先に転送される際にロード・バランシングの動作を制御します。有効な値は、次のとおりです。
メンバー単位
- デフォルト値。ターゲット分散宛先(DD)のアクティブなすべてのメンバーがロード・バランシングの候補になります。WebLogic Server JVMで同じDDのメンバーが複数実行されている場合、これらすべてのメンバーが転送されたというメッセージを受信します。JVM単位
- 各WebLogic Server JVMにおいて、ターゲット分散宛先(DD)のアクティブなメンバーの1つのみが、ロード・バランシングの候補になります。クラスタのターゲットとして指定されているJMSサーバーのインスタンスに関連付けられたメンバーがDDに存在する場合、ロード・バランシング・アルゴリズムには、特定のJVMに対する自然なアフィニティまたはプリファレンスがあるため、優先メンバーが優先されます。それ以外の場合、このアルゴリズムでは、同じJVMに存在するすべての候補メンバーの中で、名前が辞書順で最後になるメンバーが優先されます。
ノート:
各JVMでホストしているDDのメンバーが1つのみの場合、2つのオプションの動作は同じになります。
すべてのJMSモジュールまたは特定のJMSモジュールに定義されているSAFインポート済宛先Beanの
必ず1回のロード・バランシング・ポリシー
は、クラスタ内のすべてのWebLogic Serverに、システム・プロパティweblogic.jms.saf.ExactlyOnceLoadBalancingPolicy
またはweblogic.jms.saf.ExactlyOnceLoadBalancingPolicy.MODULENAME
を指定することでオーバーライドできます(2つ目のプロパティが1つ目のプロパティより優先されます)。SAFインポート済宛先がこれらのシステム・プロパティのいずれかでオーバーライドされた場合は、最初のSAFメッセージが転送されたときに、ホストWebLogic Serverで、そのSAFインポート済宛先の名前とシステム・プロパティ、そのシステム・プロパティの値が記載された情報メッセージBEA-281034が記録されます。この設定は、
「1回以上」
または「最大1回」
のQOSが使用されるSAF構成には適用されません。スタンドアロンの宛先へのメッセージの転送にも、順序単位のメッセージの転送にも適用されません。この設定は、サーバー側のストア・アンド・フォワードでも、クライアント側のストア・アンド・フォワードでも適用されます。
ローカルに分散されたインポート済宛先におけるメッセージのロード・バランシングを制御する類似の設定については、接続ファクトリ・ロード・バランシング・パラメータBeanのプロデューサのロード・バランシング・ポリシー属性を参照してください。
- id(optional): integer(int64)
読取り専用:
true
このBeanインスタンスの一意の識別子を返します。
- JNDIPrefix(optional): string
リモート宛先のローカルJNDI名の先頭に付ける文字列を指定します。
この接頭辞に対する変更は、受信メッセージにのみ影響します。格納されているメッセージには影響しません。
- name(optional): string
読取り専用:
true
このエンティティの名前。XMLでは属性として示されます。
JMSモジュール内の要素の多くは名前付きのエンティティです。XMLファイル内で、ある型に含まれる名前付きエンティティは、すべて一意でなければなりません。これは、JMSモジュール内で特定のエンティティを区別するための識別子です。
この属性は、モジュールの内部で参照される可能性があるため、モジュールの外から(たとえば、デプロイメント・プランで)変更することはできません。
制約
- 有効なnull
- notes(optional): string
この名前付きJMSディスクリプタBeanの説明に含めることのできるオプションの情報。
JMSモジュールはこのノートをJMSディスクリプタ・ファイルにXML PCDATAとして保存します。すべての左山カッコ(<)はXMLエンティティ
<に変換されます。キャリッジ・リターンとライン・フィードは維持されます。)>
- ノート:
管理コンソールからノートを作成または編集した場合、キャリッジ・リターンとライン・フィードは維持されません。
- SAFErrorHandling(optional): array SAF Error Handling Reference
タイトル:
SAF Error Handling Reference
SAFエラー処理参照を含みます。インポート済み宛先に使用されるエラー処理構成を指定します。
このパラメータに対する変更は、受信するメッセージにのみ影響します。格納されているメッセージには影響しません。
制約
- 再起動が必要です
- SAFRemoteContext(optional): array SAF Remote Context Reference
タイトル:
SAF Remote Context Reference
SAFリモート・コンテキスト参照を含みます。インポート済み宛先に使用されるリモート・コンテキストを指定します。
リモート・コンテキスト名に対する変更は、格納されているメッセージと受信するメッセージの双方に影響します。
- subDeploymentName(optional): string
このエンティティをターゲットにする場合に使用するサブデプロイメントの名前を取得します。
この名前を持つサブデプロイメントを使用してエンティティをターゲットにします。サブデプロイメントのターゲットは、このエンティティのターゲットになります。
- timeToLiveDefault(optional): integer(int64)
最小値:
-1
デフォルト値:3600000
インポートされるJMSメッセージのデフォルトの生存時間の値をミリ秒単位で指定します。JMSメッセージに対して設定された存続時間はこの値をオーバーライドします。ただし、
SAFデフォルト存続時間の有効化
フィールドがオンになっている場合は除きます。その場合は、インポートされる宛先に対するJMSメッセージの存続時間がオーバーライドされます。この値に対する変更は、受信するメッセージにのみ影響します。格納されているメッセージには影響しません。
- unitOfOrderRouting(optional): string
デフォルト値:
Hash
指定可能な値:[ "Hash", "PathService" ]
メッセージの順序単位機能を使用する場合、SAFエージェントの検索に使用するルーティングのタイプを指定します。
ハッシュ
の場合、メッセージ・プロデューサはメッセージの順序単位のハッシュ・コードを使用してSAFエージェントを検索します。パス・サービス
の場合、メッセージ・プロデューサはパス・サービスを使用してSAFエージェントを検索します。
- useSAFTimeToLiveDefault(optional): boolean
デフォルト値:
false
インポートされるJMSメッセージに対して設定された存続時間を「
SAFデフォルト存続時間
」フィールドで指定した値でオーバーライドするかどうかを制御します。このパラメータに対する変更は、受信するメッセージにのみ影響します。格納されているメッセージには影響しません。
array
SAF Error Handling Reference
インポート済み宛先に使用されるエラー処理構成を指定します。
このパラメータに対する変更は、受信するメッセージにのみ影響します。格納されているメッセージには影響しません。
制約
- 再起動が必要です
array
SAF Remote Context Reference
インポート済み宛先に使用されるリモート・コンテキストを指定します。
リモート・コンテキスト名に対する変更は、格納されているメッセージと受信するメッセージの双方に影響します。