リクエストの取得
get
/iam/governance/selfservice/api/v1/requests
Oracle Identity Managerで発生したすべてのリクエストを返します。ログイン・ユーザーのコンテキストでのリクエストが返されます。たとえば、エンド・ユーザーの場合、エンド・ユーザーに対して発生したリクエストまたはエンド・ユーザーによって発生したリクエストが表示されます。ただし、マネージャの場合、マネージャによって発生したかマネージャに対して発生したリクエスト、または直接の報告者によって発生したか直接の報告者に対して発生したリクエスト(あるいはその両方)が返されます。リクエストはフィルタ問合せパラメータでフィルタして、結果セットを絞り込むことができます。たとえば、下書き状態のすべてのリクエストを取得するには、フィルタ・パラメータのrequestStatusを、/requests?q=requestStatus=draftのように使用できます。view=trackRequestsの前述のデフォルトの動作に加えて、問合せパラメータとしてview=pendingApprovalsを指定できます。これにより、属性をtitle、id、creator、taskId、state、assignee、createdとして指定して、ユーザーのタスクを提供します。view=pendingApprovalsモードでは、保留中リクエストをフィルタ・パラメータ"q=state eq assigned"でフィルタできます。ここで、状態は、Any、Assigned、Completed、Suspended、Withdrawn、Expired、Errored、Alerted、Information Requiredの場合があります。
リクエスト
サポートされているメディア・タイプ
- application/json
問合せパラメータ
- fields(optional): string
結果に返される属性。RequestId属性は戻りリストで必須です。カンマ区切り属性を受け入れます。
- q(optional): string
リクエストを取得する検索フィルタ。SCIMフィルタを受け入れます。フィルタ属性は、リクエスタ詳細または受益者詳細にできます。属性値に空白は使用できません。属性値に空白を渡す場合、"::"に置き換えます。フィルタのサンプル値は、"requester eq johnまたはbeneficiary eq avink"です。view=pendingApprovalsモードでは、フィルタ・パラメータ"q=state eq assigned"を使用して、保留中リクエストをフィルタできます
- uuid: string
ターゲット・ユーザーID
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
成功
ヘッダー
- ResponseTime: string
リクエストの処理にかかった時間(ミリ秒)を取得します。
401レスポンス
未認可
404レスポンス
リソースが見つからない
500レスポンス
内部サーバー・エラー
デフォルト・レスポンス
予期しないエラー
例
この例では、すべてのリクエストのリクエスト情報を取得します。ここで表示された情報は疑似システムに対するものであり、プロトタイプとして使用します。
cURLの例
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/requests
GETレスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{ "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests" } ], "requests": [ { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/1002" } ], "id": "1002", "reqStatus": "Request Completed", "requester": "1", "reqCreatedOn": "Mon Feb 22 13:12:03 IST 2016", "reqExpireOn": "Mon Feb 22 13:12:07 IST 2016", "reqType": "Modify User Profile" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/1003" } ], "id": "1003", "reqStatus": "Request Completed", "requester": "1", "reqCreatedOn": "Mon Feb 22 13:12:27 IST 2016", "reqExpireOn": "Mon Feb 22 13:12:28 IST 2016", "reqType": "Modify User Profile" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/1004" } ], "id": "1004", "reqStatus": "Request Completed", "requester": "1", "reqCreatedOn": "Mon Feb 22 14:30:10 IST 2016", "reqExpireOn": "Mon Feb 22 14:30:11 IST 2016", "reqType": "Modify User Profile" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/2001" } ], "id": "2001", "reqStatus": "Request Completed", "requester": "1", "reqCreatedOn": "Mon Feb 29 19:06:26 IST 2016", "reqExpireOn": "Mon Feb 29 19:09:31 IST 2016", "reqType": "Create Role" }, { }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/2002" } ], "id": "2002", "reqStatus": "Request Awaiting Approval", "requester": "1", "reqCreatedOn": "Mon Feb 29 19:08:27 IST 2016", "reqType": "Create Role" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/2003" } ], "id": "2003", "reqStatus": "Request Completed", "requester": "1", "reqCreatedOn": "Mon Feb 29 19:27:30 IST 2016", "reqExpireOn": "Mon Feb 29 19:27:57 IST 2016", "reqType": "Modify Role" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/2039" } ], "id": "2039", "reqStatus": "Request Completed", "requester": "1", "reqCreatedOn": "Mon Mar 07 13:23:55 IST 2016", "reqExpireOn": "Mon Mar 21 18:25:22 IST 2016", "reqType": "Heterogeneous Request" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/2040" } ], "id": "2040", "reqStatus": "Request Completed", "requester": "1", "reqCreatedOn": "Mon Mar 07 13:24:20 IST 2016", "reqExpireOn": "Mon Mar 07 13:32:04 IST 2016", "reqType": "Provision ApplicationInstance" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/2041" } ], "id": "2041", "reqStatus": "Request Completed", "requester": "1", "reqCreatedOn": "Mon Mar 07 13:24:20 IST 2016", "reqExpireOn": "Mon Mar 21 18:25:21 IST 2016", "reqType": "Provision Entitlement" } ] }