管理ロールの取得
get
/iam/governance/selfservice/api/v1/adminroles
Oracle Identity Managerで構成されたすべての管理ロールを返します。ユーザーの管理ロールは、フィルタ問合せパラメータを使用すると取得できます。例: /adminrole?q=userid={userId}。アルファベットAで始まる管理ロールをユーザーがフェッチしようとするシナリオでは、フィルタ問合せパラメータを使用できます。例: /adminrole?q=name sw 'A'
リクエスト
サポートされているメディア・タイプ
- application/json
問合せパラメータ
- fields(optional): string
結果に返される属性。カンマ区切り属性を受け入れます。サポートされている属性のサンプル値は、"ROLE_ID、ROLE_NAME、ROLE_DISPLAY_NAME、DESCRIPTIONおよびCUSTOM"です
- q(optional): string
レコードを取得する検索フィルタ。SCIMフィルタを受け入れます。属性値に空白は使用できません。属性値に空白を渡す場合、"::"に置き換えます。フィルタでサポートされている属性は、roleNameおよびroleKeyです。フィルタのサンプル値は、"ROLE_DISPLAY_NAME eq ITGRoleまたはROLE_ID eq 8"です。フィルタで使用できる属性名は、ROLE_ID、ROLE_NAME、ROLE_DISPLAY_NAME、DESCRIPTIONおよびCUSTOMです
レスポンス
サポートされているメディア・タイプ
- 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/adminrole?fields=roleId,roleName,roleDisplayName,roleDescription
GETレスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{ "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminrole" } ], "count": 4, "roles": [ { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminrole/1" } ], "id": "1", "name": "OrclOIMSystemAdministrator", "description": "OIM System Administrator Role with All Privileges", "displayName": "System Administrator" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminrole/2" } ], "id": "2", "name": "OrclOIMSystemConfigurator", "description": "Role with privileges to configure OIM application", "displayName": "System Configuration Administrator" }, { "links": [ { "rel": "self", "href"pseudo.com/iam/governance/selfservice/api/v1/adminrole/3" } ], "id": "3", "name": "OrclOIMCatalogAdmin", "description": "Role can administer all the catalog items", "displayName": "Catalog System Administrator" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminrole/4" } ], "id": "4", "name": "OrclOIMRoleAdministrator", "description": "Role can manage all assigned enterprise roles", "displayName": "Role Administrator" } ] }