管理ロールの取得
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/adminroles? fields=id,name,description,displayName
GETレスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{ "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles?fields=id %2Cname%2Cdescription%2CdisplayName&offset=1&limit=10" }, { "rel": "first", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles?fields=id %2Cname%2Cdescription%2CdisplayName&offset=1&limit=10" }, { "rel": "next", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles?fields=id %2Cname%2Cdescription%2CdisplayName&offset=11&limit=10" } ], "count": 10, "hasMore": true, "totalResult": -1, "adminroles": [ { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles/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/adminroles/2" } ], "id": "2", "name": "OrclOIMSystemConfigurator", "description": "Role with privileges to configure OIM application", "displayName": "System Configuration Administrator" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles/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/adminroles/4" } ], "id": "4", "name": "OrclOIMRoleAdministrator", "description": "Role can manage all assigned enterprise roles", "displayName": "Role Administrator" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles/5" } ], "id": "5", "name": "OrclOIMRoleAuthorizer", "description": "Role can authorize assigned enterprise roles", "displayName": "Role Authorizer" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles/6" } ], "id": "6", "name": "OrclOIMRoleViewer", "description": "Role can view assigned enterprise roles.", "displayName": "Role Viewer" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles/7" } ], "id": "7", "name": "OrclOIMEntitlementAdministrator", "description": "Entitlement administrator", "displayName": "Entitlement Administrator" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles/8" } ], "id": "8", "name": "OrclOIMEntitlementAuthorizer", "description": "Entitlement authorizer", "displayName": "Entitlement Authorizer" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles/9" } ], "id": "9", "name": "OrclOIMEntitlementViewer", "description": "Role can view assigned entitlements.", "displayName": "Entitlement Viewer" }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/adminroles/10" } ], "id": "10", "name": "OrclOIMApplicationInstanceAdministratorRole", "description": "Role can manage assigned application instances.", "displayName": "Application Instance Administrator" } ] }