Oracle WebLogic ServerのRESTfulサーバー構成管理インタフェース

このJDBCデータ・ソース・パラメータの表示

get

/management/weblogic/{version}/serverConfig/JDBCSystemResources/{name}/JDBCResource/JDBCDataSourceParams

このJDBCデータ・ソース・パラメータを表示します。

リクエスト

パス・パラメータ

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'を指定しないでください。

セキュリティ

Admin: basic

型: Basic

説明: A user in the Admin security role.
デプロイヤ: 基本

型: Basic

説明: A user in the Deployer security role.
モニター: 基本

型: Basic

説明: A user in the Monitor security role.
オペレータ: 基本

型: Basic

説明: A user in the Operator security role.

先頭に戻る

レスポンス

サポートされるメディア・タイプ

application/json

200レスポンス

このJDBCデータ・ソース・パラメータを返します。

ルート・スキーマ: JDBCデータ・ソース・パラメータ

型: object

ソースの表示

algorithmType(optional): string
デフォルト値: Failover

使用可能な値: [ "Load-Balancing", "Failover" ]
マルチ・データ・ソースの接続リクエスト処理を決定するアルゴリズム。
次のいずれかのタイプのアルゴリズムを指定できます。
- フェイルオーバー
  接続リクエストはリストの最初のデータ・ソースに送信されます。リクエストが失敗した場合、リクエストはリストの次のデータ・ソースに送信されます。以降も同様です。有効な接続が取得されるか、あるいはリストの終わりに達するまで、この処理は繰り返されます。リストの終わりに達した場合には、例外がスローされます。
- ロード・バランシング
  接続リクエストは、マルチ・データ・ソースによってメンバー・データ・ソースに均等に分散されます。このアルゴリズムを指定すると、マルチ・データ・ソースはフェイルオーバー処理も提供します。つまり、リクエストが失敗すると、そのリクエストは、有効な接続が取得されるか、あるいはリストの終わりに達するまで、マルチ・データ・ソースによってリストの次のデータ・ソースに送信されます。リストの終わりに達した場合には、例外がスローされます。
connectionPoolFailoverCallbackHandler(optional): string

デフォルト値: oracle.doceng.json.BetterJsonNull@321a62a7

マルチ・データ・ソースがマルチ・データ・ソース内の別のデータ・ソースに接続リクエストをフェイルオーバーまたはフェイルバックする準備ができているときに、送られたコールバックを処理するアプリケーション・クラスの名前。
この名前は、weblogic.jdbc.extensions.ConnectionPoolFailoverCallbackインタフェースを実装するアプリケーション・クラスの絶対名である必要があります。
dataSourceList(optional): string

デフォルト値: oracle.doceng.json.BetterJsonNull@68f1463a

マルチ・データ・ソースが接続リクエストを送信するデータ・ソースのリスト。リスト内のデータ・ソースの順番でフェイルオーバーの順序が決まります。
failoverRequestIfBusy(optional): boolean

デフォルト値: false

「フェイルオーバー」アルゴリズムのマルチ・データ・ソースに対して、現在のデータ・ソースのすべての接続が使用されている場合に、マルチ・データ・ソースが接続リクエストを次のデータ・ソースにフェイルオーバーできるようにします。
globalTransactionsProtocol(optional): string
デフォルト値: OnePhaseCommit

使用可能な値: [ "TwoPhaseCommit", "LoggingLastResource", "EmulateTwoPhaseCommit", "OnePhaseCommit", "None" ]
データ・ソースのトランザクション・プロトコル(グローバル・トランザクション処理動作)を決定します。オプションは次のとおりです:
- TwoPhaseCommit: 標準XA トランザクション処理。XAドライバが必要です。
- LoggingLastResource: 1つの非XAリソースに対するパフォーマンス強化。
- EmulateTwoPhaseCommit: 1つの非XAリソースがグローバル・トランザクションに参加することを有効化します。ただし、データにリスクが発生することがあります。
- OnePhaseCommit: 非XAドライバを使用した、1フェーズXAトランザクション処理。これがデフォルトの設定です。
- None: ローカル・トランザクションのみサポートします。
JNDINames(optional): array 項目

タイトル: Items

このデータ・ソースのJNDIパス。デフォルトでは、JNDI名はデータ・ソースの名前です。
JNDIパスを参照するアプリケーションは、このデータ・ソースに対応するjavax.sql.DataSourceインスタンスを取得します。
keepConnAfterGlobalTx(optional): boolean

デフォルト値: false

WebLogic Serverがグローバル・トランザクションをコミットするときに、接続を解放するかわりに必要に応じて別の物理接続を取得することで、論理的接続に関連付けられている物理的なデータベース接続を保持できるようにします。
このオプションをtrueに設定すると、データベースでの追加の接続の構成が必要となる場合があります。
この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。
proxySwitchingCallback(optional): string

デフォルト値: oracle.doceng.json.BetterJsonNull@5f8e8ae6

Proxyデータ・ソースに対する切替えコールバック・クラスの名前。
このクラスはweblogic.jdbc.extensions.DataSourceSwitchingCallbackインタフェースを実装する必要があります。
proxySwitchingProperties(optional): string

デフォルト値: oracle.doceng.json.BetterJsonNull@78fd4233

Proxyデータ・ソースに対する切替えコールバック・メソッドに渡される切替えプロパティを指定します。
scope(optional): string
デフォルト値: Global

使用可能な値: [ "Global", "Application" ]
データ・ソースの範囲を指定します。
次のスコープのいずれかを指定できます。
- グローバル
  指定されたJNDINameでデータ・ソースがクラスタワイドのJNDIツリーにバインドされることが指定され、クラスタ全体の任意のJDBCクライアントでデータ・ソースを使用できます。
  これがデフォルトの設定です。
- アプリケーション
  指定されたJNDINameでデータ・ソースがアプリケーションのローカル・ネームスペースにバインドされることが指定され、アプリケーション内のJDBCクライアントでのみデータ・ソースを使用できます。これはパッケージ化されたデータソースに対してのみ使用でき、JDBCシステム・リソースについては無視されます。

{
    "type":"object",
    "properties":{
        "JNDINames":{
            "title":"Items",
            "type":"array",
            "items":{
                "type":"string",
                "description":""
            },
            "description":"<p>The JNDI path for this Data Source. By default, the JNDI name is the name of the data source.</p><p>Applications that look up the JNDI path get a <code>javax.sql.DataSource</code> instance that corresponds to this data source. </p>"
        },
        "algorithmType":{
            "default":"Failover",
            "enum":[
                "Load-Balancing",
                "Failover"
            ],
            "type":"string",
            "description":"<p>The algorithm determines the connection request processing for the multi data source.</p><p>You can specify one of the following algorithm types:</p><ul><li><p><b>Failover</b></p><p>Connection requests are sent to the first data source in the list; if the request fails, the request is sent to the next data source in the list, and so forth. The process is repeated until a valid connection is obtained, or until the end of the list is reached, in which case an exception is thrown.</p></li><li><p><b>Load balancing</b></p><p>The multi data source distributes connection requests evenly to its member data sources. With this algorithm, the multi data source also provides failover processing. That is, if a request fails, the multi data source sends the request to the next data source in the list until a valid connection is obtained, or until the end of the list is reached, in which case an exception is thrown.</p></li></ul>"
        },
        "connectionPoolFailoverCallbackHandler":{
            "default":null,
            "type":"string",
            "description":"<p>The name of the application class to handle the callback sent when a multi data source is ready to failover or fail back connection requests to another data source within the multi data source.</p><p>The name must be the absolute name of an application class that implements the <code>weblogic.jdbc.extensions.ConnectionPoolFailoverCallback</code> interface.</p>"
        },
        "dataSourceList":{
            "default":null,
            "type":"string",
            "description":"<p>The list of data sources to which the multi data source will route connection requests. The order of data sources in the list determines the failover order.</p>"
        },
        "failoverRequestIfBusy":{
            "default":false,
            "type":"boolean",
            "description":"<p>For multi data sources with the <code>failover</code> algorithm, enables the multi data source to failover connection requests to the next data source if all connections in the current data source are in use.</p>"
        },
        "globalTransactionsProtocol":{
            "default":"OnePhaseCommit",
            "enum":[
                "TwoPhaseCommit",
                "LoggingLastResource",
                "EmulateTwoPhaseCommit",
                "OnePhaseCommit",
                "None"
            ],
            "type":"string",
            "description":"<p>Determines the transaction protocol (global transaction processing behavior) for the data source. Options include:</p><ul><li><p>TwoPhaseCommit - Standard XA transaction processing. Requires an XA driver.</p></li><li><p>LoggingLastResource - A performance enhancement for one non-XA resource.</p></li><li><p>EmulateTwoPhaseCommit - Enables one non-XA resource to participate in a global transaction, but has some risk to data.</p></li><li><p>OnePhaseCommit - One-phase XA transaction processing using a non-XA driver. This is the default setting.</p></li><li><p>None - Support for local transactions only.</p></li></ul>"
        },
        "keepConnAfterGlobalTx":{
            "default":false,
            "type":"boolean",
            "description":"<p>Enables WebLogic Server to keep the physical database connection associated with the logical connection when committing a global transaction instead releasing it and getting another physical connection when needed.</p><p>Setting this option to true may require additional connections to be configured on the database.</p><p>Use this setting to work around specific problems with JDBC XA drivers.</p>"
        },
        "proxySwitchingCallback":{
            "default":null,
            "type":"string",
            "description":"<p>The name of the switching callback class for a Proxy data source.</p><p>This class implements the <code>weblogic.jdbc.extensions.DataSourceSwitchingCallback</code> interface.</p>"
        },
        "proxySwitchingProperties":{
            "default":null,
            "type":"string",
            "description":"<p>Specifies the switching properties passed to the switching callback method for a Proxy data source.</p>"
        },
        "scope":{
            "default":"Global",
            "enum":[
                "Global",
                "Application"
            ],
            "type":"string",
            "description":"<p>Specifies the scoping of the data source.</p><p>You can specify one of the following scopes:</p><ul><li><p><b>Global</b></p><p>Specifies that the data source is bound in the cluster-wide JNDI tree with the JNDIName specified so that the data source is available for use to any JDBC client across the cluster.</p><p>This is the default setting.</p></li><li><p><b>Application</b></p><p>Specifies that the data source is bound in the application's local namespace with the JNDIName specified so that the data source is available for use only by JDBC clients within the application.  This can only be used for packaged datasources and is ignored for JDBC System resources.</p></li></ul>"
        }
    },
    "description":""
}

ネストされたスキーマ: 項目

型: array

タイトル: Items

このデータ・ソースのJNDIパス。デフォルトでは、JNDI名はデータ・ソースの名前です。

JNDIパスを参照するアプリケーションは、このデータ・ソースに対応するjavax.sql.DataSourceインスタンスを取得します。

ソースの表示

配列: string

{
    "title":"Items",
    "type":"array",
    "items":{
        "type":"string",
        "description":""
    },
    "description":"<p>The JNDI path for this Data Source. By default, the JNDI name is the name of the data source.</p><p>Applications that look up the JNDI path get a <code>javax.sql.DataSource</code> instance that corresponds to this data source. </p>"
}

先頭に戻る