この配信失敗パラメータの表示
/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/topics/{name}/deliveryFailureParams
この配信失敗パラメータを表示します。
リクエスト
- 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レスポンス
この配信失敗パラメータを返します。
このメソッドは次のリンクを返すことができます。
- rel=action title=findSubDeploymentName uri=/management/weblogic/{version}/domainConfig/partitions/{name}/resourceGroups/{name}/JMSSystemResources/{name}/JMSResource/topics/{name}/deliveryFailureParams/findSubDeploymentName
このリソースのfindSubDeploymentNameアクション・リソース。
- rel=errorDestination
宛先リソースに対するこのリソースのerrorDestination参照。
- rel=templateBean
テンプレート・リソースに対するこのリソースのtemplateBean参照。
object
- errorDestination (オプション): array Destination Reference
タイトル:
Destination Reference
宛先参照が含まれます。期限切れになった、または再配信の制限に達したメッセージのターゲット・エラー宛先の名前。エラー宛先が構成されていない場合、メッセージはそのまま破棄されます。メッセージが期限切れになっている、または再配信の制限に達していて「有効期限ポリシー」が「リダイレクト」に設定されている場合、メッセージは指定された「エラー宛先」に移動します。
スタンドアロンの宛先の場合、エラー宛先は、そのエラー宛先が定義されている宛先と同じJMSサーバーにターゲット指定される別のスタンドアロンの宛先である必要があります。共通分散宛先(UDD)の場合、エラー宛先は、現在のUDDと同じサブデプロイメント(つまりターゲット)を共有する別のUDDである必要があります。
この属性は動的に構成できますが、新しく配信されるメッセージにのみ適用され、すでに保存されているメッセージには影響しません。
- expirationLoggingPolicy (オプション): string
デフォルト値:
oracle.doceng.json.BetterJsonNull@44d8e130
「有効期限ポリシー」が「ログ」に設定されている場合に、メッセージに関するどのような情報を記録するかを定義するポリシー。有効なロギング・ポリシーの値は次のとおりです。
%header% - すべてのJMSヘッダー・フィールドがログに記録されます。
%properties% - すべてのユーザー定義プロパティがログに記録されます。
JMSDeliveryTime - このWebLogic JMS固有の拡張ヘッダー・フィールドがログに記録されます。
JMSRedeliveryLimit - このWebLogic JMS固有の拡張ヘッダー・フィールドがログに記録されます。
foo - すべての有効なJMSヘッダー・フィールドまたはユーザー定義プロパティがログに記録されます。
複数の値を指定する場合は、値をカンマ区切りのリストとして入力します。
%header%
と%properties%
の値では、大文字と小文字は区別されません。たとえば、すべてのJMSヘッダー・フィールドとユーザー・プロパティを指定する場合は、"%header%,%properties%"
という値にします。ただし、個々のJMSヘッダー・フィールドおよびユーザー定義プロパティの列挙値では、大文字と小文字が区別されます。個別のJMSヘッダー・フィールドのみを列挙するには、"%header, name, address, city, state, zip"
と指定します。ノート:
JMSMessageID
フィールドは常にログに書き込まれ、無効にはできません。したがって、「有効期限ロギング・ポリシー」が未定義(つまりnull)であるか、または空の文字列として定義されている場合は、ログ・ファイルへの出力にはメッセージのJMSMessageID
のみが含まれます。 - expirationPolicy (オプション): string
デフォルト値:
Discard
指定可能な値:[ "Discard", "Log", "Redirect" ]
宛先で期限切れメッセージに遭遇したときに使用するメッセージの有効期限ポリシー。有効な有効期限ポリシーは次のとおりです。
「なし」-「破棄」ポリシーと同じ。期限切れのメッセージは単に宛先から削除されます。
「破棄」- メッセージング・システムから期限切れのメッセージを削除します。削除はログに記録されず、メッセージは別の場所にリダイレクトされません。指定の宛先に値を定義しない場合(つまり、「なし」)、期限切れのメッセージは破棄されます。
「ログ」- 期限切れのメッセージをシステムから削除し、メッセージがシステムから削除されたことを示すエントリをサーバー・ログ・ファイルに書き込みます。ログに書き込まれる実際の情報は、「有効期限ロギング・ポリシー」で定義します。
「リダイレクト」- 期限切れのメッセージを現在の位置から、宛先に定義されているエラー宛先へ移動します。メッセージの本体とすべてのプロパティは保持されます。また、次の例外を除きメッセージのヘッダー・フィールドもすべて保持されます。
メッセージの宛先はエラー宛先になります。
エラー宛先に関連するプロパティのオーバーライドは、すべてリダイレクト対象のメッセージに適用されます。
「存続時間のオーバーライド」の値がエラー宛先に設定されていない場合、メッセージは新しい有効期限の値0を受け取ります(つまり、再び期限切れになりません)。
宛先に有効なエラー宛先が定義されていない場合、「リダイレクト」ポリシーは使用できません。また、「リダイレクト」ポリシーを使用している宛先に対して、エラー宛先を削除することはできません。
ノート: 最大メッセージ割当ては、新しいメッセージが送信される場合にのみ強制されます。「リダイレクト」ポリシーによりメッセージが移動される場合、これは無視されます。
- redeliveryLimit (オプション): integer(int32)
最小値:
-1
最大値:2147483647
デフォルト値:-1
メッセージがエラー宛先に移動する前に再配信を試行できる回数。この設定は、メッセージの送信側で設定された再配信の上限をオーバーライドします。再配信の上限が構成されているものの、エラー宛先が構成されていない場合、永続および非永続メッセージは、再配信の上限に達すると、単純にドロップ(削除)されます。
デフォルト値(-1)は、メッセージ送信側の再配信の上限設定を宛先でオーバーライドしないことを指定します。
ノート: WebLogic Serverでは、メッセージの配信試行回数(1回目の試行を1とし、その後2、3、...と続く)を指定するJMSXDeliveryCountメッセージ・プロパティがサポートされています。配信回数の保持に最善を尽くすため、配信回数はサーバーの再起動後も1にリセットされません。
この属性は動的に構成可能ですが、変更内容は、これから受信するメッセージにのみ影響し、すでに送信されているメッセージは、元の再配信の上限を引き続き使用します。
- templateBean (オプション): array Template Reference
タイトル:
Template Reference
読取り専用:true
テンプレート参照が含まれます。これは、この宛先のテンプレートBeanの検索に使用します
array
Destination Reference
期限切れになった、または再配信の制限に達したメッセージのターゲット・エラー宛先の名前。エラー宛先が構成されていない場合、メッセージはそのまま破棄されます。メッセージが期限切れになっている、または再配信の制限に達していて「有効期限ポリシー」が「リダイレクト」に設定されている場合、メッセージは指定された「エラー宛先」に移動します。
スタンドアロンの宛先の場合、エラー宛先は、そのエラー宛先が定義されている宛先と同じJMSサーバーにターゲット指定される別のスタンドアロンの宛先である必要があります。共通分散宛先(UDD)の場合、エラー宛先は、現在のUDDと同じサブデプロイメント(つまりターゲット)を共有する別のUDDである必要があります。
この属性は動的に構成できますが、新しく配信されるメッセージにのみ適用され、すでに保存されているメッセージには影響しません。
array
Template Reference
true
これは、この宛先のテンプレートBeanの検索に使用します