リクエストの送信

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認証の認証資格証明