このSAFインポート済宛先の表示
/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}
このSAFインポート済宛先を表示します。
リクエスト
- name: string
コレクション内のインスタンスのnameプロパティ。
- version: string
WebLogic RESTインタフェースのバージョン。
- excludeFields (オプション): string
excludeFields問合せパラメータを使用して、レスポンスで返されるフィールドを制限します。フィールド名のカンマ区切りリストです。指定すると、リストに名前がないフィールドのみが返されます。指定しないと、すべてのフィールドが戻されます(fields問合せパラメータが指定されていない場合)。ノート: excludeFieldsを指定する場合、fieldsは指定できません。
- excludeLinks (オプション): string
excludeLinks問合せパラメータを使用して、レスポンスで返されるリンクを制限します。リンク関係名のカンマ区切りリストです。指定すると、リストに関係名前がないリンクのみが返されます。指定しないと、すべてのリンクが戻されます(links問合せパラメータが指定されていない場合)。ノート: excludeLinksを指定する場合、linksは指定できません。
- fields (オプション): string
fields問合せパラメータを使用して、レスポンスで返されるフィールドを制限します。フィールド名のカンマ区切りリストです。指定すると、名前が一致するフィールドのみが返されます。指定しないと、すべてのフィールドが戻されます(excludeFields問合せパラメータが指定されていない場合)。ノート: fieldsを指定する場合、excludeFieldsは指定できません。
- links (オプション): string
links問合せパラメータを使用して、レスポンスで返されるリンクを制限します。リンク関係名のカンマ区切りリストです。指定すると、関係名が一致するリンクのみが返されます。指定しないと、すべてのリンクが戻されます(excludeLinks問合せパラメータが指定されていない場合)。ノート: linksを指定する場合、excludeLinksは指定できません。
- Admin: basic
タイプ:
Basic
説明:A user in the Admin security role.
- Deployer: basic
タイプ:
Basic
説明:A user in the Deployer security role.
- Monitor: basic
タイプ:
Basic
説明:A user in the Monitor security role.
- Operator: basic
タイプ:
Basic
説明:A user in the Operator security role.
レスポンス
- application/json
200レスポンス
このSAFインポート済宛先を返します。
このメソッドは次のリンクを返すことができます。
- rel=SAFErrorHandling
SAFエラー処理リソースに対するこのリソースのSAFErrorHandling参照。
- rel=SAFQueues uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}/SAFQueues
このリソースのSAFQueuesコレクション・リソース。
- rel=SAFRemoteContext
SAFリモート・コンテキスト・リソースに対するこのリソースのSAFRemoteContext参照。
- rel=SAFTopics uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}/SAFTopics
このリソースのSAFTopicsコレクション・リソース。
- rel=messageLoggingParams uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/SAFImportedDestinations/{name}/messageLoggingParams
このリソースのmessageLoggingParamsシングルトン・リソース。
object
- defaultTargetingEnabled (オプション): boolean
デフォルト値:
false
このJMSリソースが、デフォルトの親モジュールのターゲット指定を行うのか、サブデプロイメントのターゲット指定メカニズムを使用するのかを指定します。
Trueに設定すると、このリソースは暗黙的に、親モジュールのターゲット指定を継承します。Falseに設定すると、このリソースはサブデプロイメントのターゲット(指定されている場合)に基づいてターゲット指定されます。
- exactlyOnceLoadBalancingPolicy (オプション): 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 (オプション): integer(int64)
読取り専用:
true
このBeanインスタンスの一意の識別子を返します。
- JNDIPrefix (オプション): string
リモート宛先のローカルJNDI名の先頭に付ける文字列を指定します。
この接頭辞に対する変更は、受信メッセージにのみ影響します。格納されているメッセージには影響しません。
- name (オプション): string
読取り専用:
true
このエンティティの名前。XMLでは属性として示されます。
JMSモジュール内の要素の多くは名前付きのエンティティです。XMLファイル内で、ある型に含まれる名前付きエンティティは、すべて一意でなければなりません。これは、JMSモジュール内で特定のエンティティを区別するための識別子です。
この属性は、モジュールの内部で参照される可能性があるため、モジュールの外から(たとえば、デプロイメント・プランで)変更することはできません。
制約
- 有効なnull
- notes (オプション): string
この名前付きJMSディスクリプタBeanの説明に含めることのできるオプションの情報。
JMSモジュールはこのノートをJMSディスクリプタ・ファイルにXML PCDATAとして保存します。左向きの山カッコ(<)はすべてxmlエンティティ
<に変換されます。キャリッジ・リターン/ライン・フィードは維持されます。)>
- ノート:
管理コンソールからノートを作成または編集した場合、キャリッジ・リターンとライン・フィードは維持されません。
- SAFErrorHandling (オプション): array SAF Error Handling Reference
タイトル:
SAF Error Handling Reference
SAFエラー処理参照が含まれます。インポート済の宛先に使用されるエラー処理構成を指定します。
このパラメータに対する変更は、受信するメッセージにのみ影響します。格納されているメッセージには影響しません。
制約
- 再起動が必要
- SAFRemoteContext (オプション): array SAF Remote Context Reference
タイトル:
SAF Remote Context Reference
SAFリモート・コンテキスト参照が含まれます。インポート済の宛先に使用されるリモート・コンテキストを指定します。
リモート・コンテキスト名に対する変更は、格納されているメッセージと受信するメッセージの双方に影響します。
- subDeploymentName (オプション): string
このエンティティをターゲットにする場合に使用するサブデプロイメントの名前を取得します。
この名前を持つサブデプロイメントを使用してエンティティをターゲットにします。サブデプロイメントのターゲットは、このエンティティのターゲットになります。
- timeToLiveDefault (オプション): integer(int64)
最小値:
-1
デフォルト値:3600000
インポートされるJMSメッセージのデフォルトの生存時間の値をミリ秒単位で指定します。JMSメッセージに対して設定された存続時間はこの値をオーバーライドします。ただし、
SAFデフォルト存続時間の有効化
フィールドがオンになっている場合は除きます。その場合は、インポートされる宛先に対するJMSメッセージの存続時間がオーバーライドされます。この値に対する変更は、受信するメッセージにのみ影響します。格納されているメッセージには影響しません。
- unitOfOrderRouting (オプション): string
デフォルト値:
Hash
指定可能な値:[ "Hash", "PathService" ]
メッセージの順序単位機能を使用する場合、SAFエージェントの検索に使用するルーティングのタイプを指定します。
ハッシュ
の場合、メッセージ・プロデューサはメッセージの順序単位のハッシュ・コードを使用してSAFエージェントを検索します。パス・サービス
の場合、メッセージ・プロデューサはパス・サービスを使用してSAFエージェントを検索します。
- useSAFTimeToLiveDefault (オプション): boolean
デフォルト値:
false
インポートされるJMSメッセージに対して設定された存続時間を「
SAFデフォルト存続時間
」フィールドで指定した値でオーバーライドするかどうかを制御します。このパラメータに対する変更は、受信するメッセージにのみ影響します。格納されているメッセージには影響しません。
array
SAF Error Handling Reference
インポート済の宛先に使用されるエラー処理構成を指定します。
このパラメータに対する変更は、受信するメッセージにのみ影響します。格納されているメッセージには影響しません。
制約
- 再起動が必要
array
SAF Remote Context Reference
インポート済の宛先に使用されるリモート・コンテキストを指定します。
リモート・コンテキスト名に対する変更は、格納されているメッセージと受信するメッセージの双方に影響します。