HTTP接続ハンドラの追加、検索、比較または削除
POST
/rest/v1/admin
HTTP接続ハンドラの追加、検索、比較または削除
リクエスト
サポートされているメディア・タイプ
- application/json
作成する必要があるHTTP接続ハンドラ
ルート・スキーマ: HTTP接続ハンドラのPOSTRequest
型:
ソースを表示
object
- assertion: string
LDAP比較操作用のアサーション文字列。ノート: POSTを使用したLDAP比較操作の実行時(つまり、msgTypeがurn:ietf:params:rest:schemas:oracle:oud:1.0:CompareRequestである場合)にのみ使用します。
- attributes: object HTTP接続ハンドラのプロパティ
- base: string
LDAP検索操作に使用する検索ベースDN。ノート: POSTを使用したLDAP検索操作の実行時(つまり、msgTypeがurn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequestである場合)にのみ使用します。このような操作の場合も必須です
- controls: array controls
LDAP操作のためにサーバーに送信するLDAP制御。
- dn: string
作成、削除または比較するエントリのLDAP DN。ノート: LDAPの追加、削除または比較操作の実行時(つまり、msgTypeがurn:ietf:params:rest:schemas:oracle:oud:1.0:AddRequest、urn:ietf:params:rest:schemas:oracle:oud:1.0:DeleteRequestまたはurn:ietf:params:rest:schemas:oracle:oud:1.0:CompareRequestである場合)にのみ使用します。このような操作の場合に必須です。
- filter: string
LDAP検索操作用の検索フィルタ。LDAP検索フィルタの構文に従う必要があります。ノート: POSTリクエストを使用したLDAP検索操作の実行時(つまり、msgTypeがurn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequestである場合)にのみ使用します。
- msgType(required): string
指定可能な値:
[ "urn:ietf:params:rest:schemas:oracle:oud:1.0:AddRequest", "urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequest", "urn:ietf:params:rest:schemas:oracle:oud:1.0:DeleteRequest", "urn:ietf:params:rest:schemas:oracle:oud:1.0:CompareRequest" ]
RESTメッセージ・タイプ - requiredAttributes: array requiredAttributes
エントリに対してフェッチする属性のリスト。ノート: POSTを使用したLDAP検索操作の実行時(つまり、msgTypeがurn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequestである場合)にのみ使用します。
- scope: string
指定可能な値:
[ "base", "sub", "one" ]
LDAP検索操作の範囲。ノート: POSTを使用したLDAP検索操作の実行時(つまり、msgTypeがurn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequestである場合)にのみ使用します。
ネストされたスキーマ: HTTP接続ハンドラのプロパティ
型:
ソースを表示
object
- cn: string
エントリのCN (共通名)
- ds-cfg-accept-backlog: integer(int32)
デフォルト値:
128
受入れバックログのキューに入れることができる保留中の接続試行の最大数を指定します。この数を超えるとサーバーが新しい接続試行を拒否し始めます。 - ds-cfg-allow-tcp-reuse-address: boolean
デフォルト値:
true
HTTP接続ハンドラがソケット記述子を再利用するかどうかを示します。 - ds-cfg-allowed-client: array ds-cfg-allowed-client
この接続ハンドラへの接続の確立を許可されているクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
- ds-cfg-denied-client: array ds-cfg-denied-client
この接続ハンドラへの接続の確立を許可されていないクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
- ds-cfg-dos-filter-max-requests-per-sec: integer(int32)
デフォルト値:
25
1つの接続の最大リクエスト数/秒を指定します。 - ds-cfg-dos-filter-throttled-requests: integer(int32)
デフォルト値:
5
一度に考慮可能なレート制限を超えるリクエスト数。 - ds-cfg-enabled(required): boolean
接続ハンドラが使用可能かどうかを示します。
- ds-cfg-header-cache-size: string
デフォルト値:
6 kilobytes
ヘッダー・フィールド・キャッシュ・サイズを設定します。 - ds-cfg-http-server-max-thread-pool-size: integer(int32)
デフォルト値:
24
埋込みHTTPサーバーによってキューに入れられた操作を処理するために使用されるスレッドの最大数を指定します。 - ds-cfg-http-server-max-work-queue-capacity: integer(int32)
デフォルト値:
6000
常にワーク・キューに入れることができる、キュー操作の最大数を指定します。 - ds-cfg-http-server-min-thread-pool-size: integer(int32)
デフォルト値:
8
埋込みHTTPサーバーによってキューに入れられた操作を処理するために使用されるスレッドの最小数を指定します。 - ds-cfg-idle-time-limit: string
デフォルト値:
60000ms
スレッドがアイドル状態でいられる最大アイドル時間を設定します。 - ds-cfg-java-class(required): string
デフォルト値:
org.opends.server.protocols.http.HTTPConnectionHandler
HTTP接続ハンドラの実装を提供するJavaクラスの完全修飾名を指定します。 - ds-cfg-jetty-statistics-enabled: boolean
デフォルト値:
false
HTTP接続ハンドラがJMXを介してjetty統計情報を使用可能にするかどうかを示します。 - ds-cfg-keep-stats: boolean
デフォルト値:
true
HTTP接続ハンドラが統計情報を保持するかどうかを示します。 - ds-cfg-key-manager-provider: string
このHTTP接続ハンドラで使用する必要があるキー・マネージャの名前を指定します。
- ds-cfg-listen-address: array ds-cfg-listen-address
HTTP接続ハンドラがHTTPクライアントからの接続をリスニングするアドレスまたはアドレスのセットを指定します。
- ds-cfg-listen-port(required): integer(int32)
HTTP接続ハンドラがクライアントからの接続をリスニングするポート番号を指定します。
- ds-cfg-max-idle-time-limit: string
デフォルト値:
2 minutes
接続の最大アイドル時間を設定します。これは大まかにSocket.setSoTimeout(int)コールに変換されます。 - ds-cfg-num-http-acceptor-threads: integer(int32)
アクセプタは新しいTCP/IP接続を受け入れます
- ds-cfg-num-http-selector-threads: integer(int32)
セレクタにより、IOを進行させることができる確立された接続が通知およびスケジュールされます。
- ds-cfg-output-buffer-size: string
デフォルト値:
32 kilobytes
レスポンスを送信するためのコンテンツ・バッファのサイズを設定します。 - ds-cfg-request-header-size: string
デフォルト値:
8 kilobytes
リクエスト・ヘッダーの最大サイズを設定します。 - ds-cfg-response-header-size: string
デフォルト値:
32 kilobytes
レスポンス・ヘッダーの最大サイズを設定します。 - ds-cfg-ssl-cert-nickname: string
HTTP接続ハンドラがSSL通信の実行時に使用する必要がある証明書のニックネーム(エイリアスとも呼ばれます)を指定します。
- ds-cfg-ssl-cipher-suite: array ds-cfg-ssl-cipher-suite
SSLまたはStartTLS通信で使用できるSSL暗号スイートの名前を指定します。
- ds-cfg-ssl-client-auth-policy: string
デフォルト値:
optional
指定可能な値:[ "disabled", "optional", "required" ]
クライアントSSL証明書に関してHTTP接続ハンドラが使用するポリシーを指定します。 - ds-cfg-ssl-protocol: array ds-cfg-ssl-protocol
SSLまたはStartTLS通信で使用できるSSLプロトコルの名前を指定します。
- ds-cfg-trust-manager-provider: string
このHTTP接続ハンドラで使用する必要がある信頼マネージャの名前を指定します。
- ds-cfg-use-ssl: boolean
デフォルト値:
false
HTTP接続ハンドラがSSLを使用する必要があるかどうかを示します。 - objectclass(required): array objectclass
このエントリが属するオブジェクト・クラス。
ネストされたスキーマ: requiredAttributes
型:
array
エントリに対してフェッチする属性のリスト。ノート: POSTを使用したLDAP検索操作の実行時(つまり、msgTypeがurn:ietf:params:rest:schemas:oracle:oud:1.0:SearchRequestである場合)にのみ使用します。
ソースを表示
ネストされたスキーマ: ds-cfg-allowed-client
型:
array
この接続ハンドラへの接続の確立を許可されているクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
ソースを表示
ネストされたスキーマ: ds-cfg-denied-client
型:
array
この接続ハンドラへの接続の確立を許可されていないクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
ソースを表示
ネストされたスキーマ: ds-cfg-listen-address
型:
array
HTTP接続ハンドラがHTTPクライアントからの接続をリスニングするアドレスまたはアドレスのセットを指定します。
デフォルト値:
ソースを表示
[ "0.0.0.0" ]
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
OK
ルート・スキーマ: HTTP接続ハンドラのSuccessResponse
型:
ソースを表示
object
- compareResult: boolean
LDAP比較操作の結果を示します。
- msgType(required): string
指定可能な値:
[ "urn:ietf:params:rest:schemas:oracle:oud:1.0:SearchResponse", "urn:ietf:params:rest:schemas:oracle:oud:1.0:DeleteResponse", "urn:ietf:params:rest:schemas:oracle:oud:1.0:CompareResponse" ]
RESTメッセージ・タイプ - searchResultEntries(required): array searchResultEntries
LDAP操作後に返される検索結果エントリの数。
- totalResults(required): integer(int32)
作成され、返されるエントリの数を指定します。
ネストされたスキーマ: HTTP接続ハンドラのSearchResultEntry
型:
ソースを表示
object
- attributes(required): object HTTP接続ハンドラのプロパティ
- dn(required): string
作成するエントリのLDAP DN。
ネストされたスキーマ: HTTP接続ハンドラのプロパティ
型:
ソースを表示
object
- cn: string
エントリのCN (共通名)
- ds-cfg-accept-backlog: integer(int32)
デフォルト値:
128
受入れバックログのキューに入れることができる保留中の接続試行の最大数を指定します。この数を超えるとサーバーが新しい接続試行を拒否し始めます。 - ds-cfg-allow-tcp-reuse-address: boolean
デフォルト値:
true
HTTP接続ハンドラがソケット記述子を再利用するかどうかを示します。 - ds-cfg-allowed-client: array ds-cfg-allowed-client
この接続ハンドラへの接続の確立を許可されているクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
- ds-cfg-denied-client: array ds-cfg-denied-client
この接続ハンドラへの接続の確立を許可されていないクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
- ds-cfg-dos-filter-max-requests-per-sec: integer(int32)
デフォルト値:
25
1つの接続の最大リクエスト数/秒を指定します。 - ds-cfg-dos-filter-throttled-requests: integer(int32)
デフォルト値:
5
一度に考慮可能なレート制限を超えるリクエスト数。 - ds-cfg-enabled(required): boolean
接続ハンドラが使用可能かどうかを示します。
- ds-cfg-header-cache-size: string
デフォルト値:
6 kilobytes
ヘッダー・フィールド・キャッシュ・サイズを設定します。 - ds-cfg-http-server-max-thread-pool-size: integer(int32)
デフォルト値:
24
埋込みHTTPサーバーによってキューに入れられた操作を処理するために使用されるスレッドの最大数を指定します。 - ds-cfg-http-server-max-work-queue-capacity: integer(int32)
デフォルト値:
6000
常にワーク・キューに入れることができる、キュー操作の最大数を指定します。 - ds-cfg-http-server-min-thread-pool-size: integer(int32)
デフォルト値:
8
埋込みHTTPサーバーによってキューに入れられた操作を処理するために使用されるスレッドの最小数を指定します。 - ds-cfg-idle-time-limit: string
デフォルト値:
60000ms
スレッドがアイドル状態でいられる最大アイドル時間を設定します。 - ds-cfg-java-class(required): string
デフォルト値:
org.opends.server.protocols.http.HTTPConnectionHandler
HTTP接続ハンドラの実装を提供するJavaクラスの完全修飾名を指定します。 - ds-cfg-jetty-statistics-enabled: boolean
デフォルト値:
false
HTTP接続ハンドラがJMXを介してjetty統計情報を使用可能にするかどうかを示します。 - ds-cfg-keep-stats: boolean
デフォルト値:
true
HTTP接続ハンドラが統計情報を保持するかどうかを示します。 - ds-cfg-key-manager-provider: string
このHTTP接続ハンドラで使用する必要があるキー・マネージャの名前を指定します。
- ds-cfg-listen-address: array ds-cfg-listen-address
HTTP接続ハンドラがHTTPクライアントからの接続をリスニングするアドレスまたはアドレスのセットを指定します。
- ds-cfg-listen-port(required): integer(int32)
HTTP接続ハンドラがクライアントからの接続をリスニングするポート番号を指定します。
- ds-cfg-max-idle-time-limit: string
デフォルト値:
2 minutes
接続の最大アイドル時間を設定します。これは大まかにSocket.setSoTimeout(int)コールに変換されます。 - ds-cfg-num-http-acceptor-threads: integer(int32)
アクセプタは新しいTCP/IP接続を受け入れます
- ds-cfg-num-http-selector-threads: integer(int32)
セレクタにより、IOを進行させることができる確立された接続が通知およびスケジュールされます。
- ds-cfg-output-buffer-size: string
デフォルト値:
32 kilobytes
レスポンスを送信するためのコンテンツ・バッファのサイズを設定します。 - ds-cfg-request-header-size: string
デフォルト値:
8 kilobytes
リクエスト・ヘッダーの最大サイズを設定します。 - ds-cfg-response-header-size: string
デフォルト値:
32 kilobytes
レスポンス・ヘッダーの最大サイズを設定します。 - ds-cfg-ssl-cert-nickname: string
HTTP接続ハンドラがSSL通信の実行時に使用する必要がある証明書のニックネーム(エイリアスとも呼ばれます)を指定します。
- ds-cfg-ssl-cipher-suite: array ds-cfg-ssl-cipher-suite
SSLまたはStartTLS通信で使用できるSSL暗号スイートの名前を指定します。
- ds-cfg-ssl-client-auth-policy: string
デフォルト値:
optional
指定可能な値:[ "disabled", "optional", "required" ]
クライアントSSL証明書に関してHTTP接続ハンドラが使用するポリシーを指定します。 - ds-cfg-ssl-protocol: array ds-cfg-ssl-protocol
SSLまたはStartTLS通信で使用できるSSLプロトコルの名前を指定します。
- ds-cfg-trust-manager-provider: string
このHTTP接続ハンドラで使用する必要がある信頼マネージャの名前を指定します。
- ds-cfg-use-ssl: boolean
デフォルト値:
false
HTTP接続ハンドラがSSLを使用する必要があるかどうかを示します。 - objectclass(required): array objectclass
このエントリが属するオブジェクト・クラス。
ネストされたスキーマ: ds-cfg-allowed-client
型:
array
この接続ハンドラへの接続の確立を許可されているクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
ソースを表示
ネストされたスキーマ: ds-cfg-denied-client
型:
array
この接続ハンドラへの接続の確立を許可されていないクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
ソースを表示
ネストされたスキーマ: ds-cfg-listen-address
型:
array
HTTP接続ハンドラがHTTPクライアントからの接続をリスニングするアドレスまたはアドレスのセットを指定します。
デフォルト値:
ソースを表示
[ "0.0.0.0" ]
201レスポンス
作成済
ルート・スキーマ: HTTP接続ハンドラのADDResponse
型:
ソースを表示
object
- msgType(required): string
デフォルト値:
urn:ietf:params:rest:schemas:oracle:oud:1.0:AddResponse
RESTメッセージ・タイプ - searchResultEntries(required): array searchResultEntries
- totalResults(required): integer(int32)
作成され、返されるエントリの数を指定します。
ネストされたスキーマ: HTTP接続ハンドラのSearchResultEntry
型:
ソースを表示
object
- attributes(required): object HTTP接続ハンドラのプロパティ
- dn(required): string
作成するエントリのLDAP DN。
ネストされたスキーマ: HTTP接続ハンドラのプロパティ
型:
ソースを表示
object
- cn: string
エントリのCN (共通名)
- ds-cfg-accept-backlog: integer(int32)
デフォルト値:
128
受入れバックログのキューに入れることができる保留中の接続試行の最大数を指定します。この数を超えるとサーバーが新しい接続試行を拒否し始めます。 - ds-cfg-allow-tcp-reuse-address: boolean
デフォルト値:
true
HTTP接続ハンドラがソケット記述子を再利用するかどうかを示します。 - ds-cfg-allowed-client: array ds-cfg-allowed-client
この接続ハンドラへの接続の確立を許可されているクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
- ds-cfg-denied-client: array ds-cfg-denied-client
この接続ハンドラへの接続の確立を許可されていないクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
- ds-cfg-dos-filter-max-requests-per-sec: integer(int32)
デフォルト値:
25
1つの接続の最大リクエスト数/秒を指定します。 - ds-cfg-dos-filter-throttled-requests: integer(int32)
デフォルト値:
5
一度に考慮可能なレート制限を超えるリクエスト数。 - ds-cfg-enabled(required): boolean
接続ハンドラが使用可能かどうかを示します。
- ds-cfg-header-cache-size: string
デフォルト値:
6 kilobytes
ヘッダー・フィールド・キャッシュ・サイズを設定します。 - ds-cfg-http-server-max-thread-pool-size: integer(int32)
デフォルト値:
24
埋込みHTTPサーバーによってキューに入れられた操作を処理するために使用されるスレッドの最大数を指定します。 - ds-cfg-http-server-max-work-queue-capacity: integer(int32)
デフォルト値:
6000
常にワーク・キューに入れることができる、キュー操作の最大数を指定します。 - ds-cfg-http-server-min-thread-pool-size: integer(int32)
デフォルト値:
8
埋込みHTTPサーバーによってキューに入れられた操作を処理するために使用されるスレッドの最小数を指定します。 - ds-cfg-idle-time-limit: string
デフォルト値:
60000ms
スレッドがアイドル状態でいられる最大アイドル時間を設定します。 - ds-cfg-java-class(required): string
デフォルト値:
org.opends.server.protocols.http.HTTPConnectionHandler
HTTP接続ハンドラの実装を提供するJavaクラスの完全修飾名を指定します。 - ds-cfg-jetty-statistics-enabled: boolean
デフォルト値:
false
HTTP接続ハンドラがJMXを介してjetty統計情報を使用可能にするかどうかを示します。 - ds-cfg-keep-stats: boolean
デフォルト値:
true
HTTP接続ハンドラが統計情報を保持するかどうかを示します。 - ds-cfg-key-manager-provider: string
このHTTP接続ハンドラで使用する必要があるキー・マネージャの名前を指定します。
- ds-cfg-listen-address: array ds-cfg-listen-address
HTTP接続ハンドラがHTTPクライアントからの接続をリスニングするアドレスまたはアドレスのセットを指定します。
- ds-cfg-listen-port(required): integer(int32)
HTTP接続ハンドラがクライアントからの接続をリスニングするポート番号を指定します。
- ds-cfg-max-idle-time-limit: string
デフォルト値:
2 minutes
接続の最大アイドル時間を設定します。これは大まかにSocket.setSoTimeout(int)コールに変換されます。 - ds-cfg-num-http-acceptor-threads: integer(int32)
アクセプタは新しいTCP/IP接続を受け入れます
- ds-cfg-num-http-selector-threads: integer(int32)
セレクタにより、IOを進行させることができる確立された接続が通知およびスケジュールされます。
- ds-cfg-output-buffer-size: string
デフォルト値:
32 kilobytes
レスポンスを送信するためのコンテンツ・バッファのサイズを設定します。 - ds-cfg-request-header-size: string
デフォルト値:
8 kilobytes
リクエスト・ヘッダーの最大サイズを設定します。 - ds-cfg-response-header-size: string
デフォルト値:
32 kilobytes
レスポンス・ヘッダーの最大サイズを設定します。 - ds-cfg-ssl-cert-nickname: string
HTTP接続ハンドラがSSL通信の実行時に使用する必要がある証明書のニックネーム(エイリアスとも呼ばれます)を指定します。
- ds-cfg-ssl-cipher-suite: array ds-cfg-ssl-cipher-suite
SSLまたはStartTLS通信で使用できるSSL暗号スイートの名前を指定します。
- ds-cfg-ssl-client-auth-policy: string
デフォルト値:
optional
指定可能な値:[ "disabled", "optional", "required" ]
クライアントSSL証明書に関してHTTP接続ハンドラが使用するポリシーを指定します。 - ds-cfg-ssl-protocol: array ds-cfg-ssl-protocol
SSLまたはStartTLS通信で使用できるSSLプロトコルの名前を指定します。
- ds-cfg-trust-manager-provider: string
このHTTP接続ハンドラで使用する必要がある信頼マネージャの名前を指定します。
- ds-cfg-use-ssl: boolean
デフォルト値:
false
HTTP接続ハンドラがSSLを使用する必要があるかどうかを示します。 - objectclass(required): array objectclass
このエントリが属するオブジェクト・クラス。
ネストされたスキーマ: ds-cfg-allowed-client
型:
array
この接続ハンドラへの接続の確立を許可されているクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
ソースを表示
ネストされたスキーマ: ds-cfg-denied-client
型:
array
この接続ハンドラへの接続の確立を許可されていないクライアントを判断するためのホスト名またはアドレス・マスクのセットを指定します。
ソースを表示
ネストされたスキーマ: ds-cfg-listen-address
型:
array
HTTP接続ハンドラがHTTPクライアントからの接続をリスニングするアドレスまたはアドレスのセットを指定します。
デフォルト値:
ソースを表示
[ "0.0.0.0" ]
204レスポンス
コンテンツがありません
406レスポンス
受入れできません
ルート・スキーマ: ErrorResponse
型:
ソースを表示
object
- ldapErrorCode: integer(int32)
操作に対して返されるLDAPエラー・コードを指定します。
- message(required): string
操作に対して返されるエラー・メッセージ。
- msgType(required): string
デフォルト値:
urn:ietf:params:rest:schemas:oracle:oud:1.0:ErrorResponse
RESTメッセージ・タイプ