リクエストの送信
Oracle Unified Directory管理REST APIを使用してリクエストを送信する際は、次のガイドラインを使用してください。
URL構造
リクエストのURL構造は次のとおりです:
https://<subdomain>.<domain>.com:<port>/<resource-path>
説明:
-
<subdomain.domain>.com:<port>
: Oracle Unified Directoryが動作しているホストおよびポート。 -
<resource-path>
: リソースを定義する相対パス。
サポートされているメソッド
次の表にまとめているように、標準HTTPメソッド・リクエストを使用して、リソースに対して基本的なCRUD操作(作成、読取り、更新、削除)を実行できます。
注意:
複数の操作を単一のHTTPリクエストにまとめてパフォーマンスを向上させることができます。HTTPメソッド | 説明 |
GET |
1つ以上の完全または部分リソースに関する情報を取得します。 |
POST |
エンドポイントに応じて、新規リソースを作成するか、検索リクエストを作成します。 |
PATCH |
クライアントが指定した変更のセット(partial updates)でリソースを変更します。 |
DELETE |
リソースを削除します。 |
メディア・タイプ
次のメディア・タイプは、Oracle Unified Directory管理REST APIによってサポートされています:
-
application/json
サポートされているヘッダー
Oracle Unified Directory管理REST APIでは、HTTPリクエストまたはレスポンスのヘッダー・セクションで渡される可能性のある次のヘッダーをサポートしています。
ヘッダー | 説明 | 例 |
Content-Type |
リクエストの本文のメディア・タイプ。POSTおよびPUTリクエストの場合、必須です。 | Content-Type: application/json |
ResponseTime |
リクエストの処理に要した時間(ミリ秒)。 | ResponseTime: 1000 |
Authorization |
HTTP認証の認証資格証明 |