ロール階層の取得
get
/iam/governance/selfservice/api/v1/roles/{roleid}/hierarchy
特定のロールIDの階層リストを返します。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
- roleid: string
階層詳細を取得するためのロールのロールID。ロールから継承される詳細およびロールによって継承される詳細が返されます。フィルタ・パラメータを使用して、ロールのサブセットを返すことができます。継承元の属性および継承先の属性は返されません。
問合せパラメータ
- hierarchyMode(optional): string
hierarchyMode問合せパラメータはオプションです。サポートされている値は、"direct"および"both"です。デフォルトは、"direct"です
- hierarchyType(optional): string
hierarchyType問合せパラメータはオプションです。問合せパラメータにより、フィルタして親ロールまたは子ロールを取得できます。サポートされている値は、"inheritsFrom"(親ロールを取得)および"inheritedBy"(子ロールを取得)です。デフォルト値は、"inheritsFrom"です
- q(optional): string
レコードを取得する検索フィルタ。たとえば、継承元または継承先に基づいて検索します。検索フィルタを指定しない場合、ロールの取得元と取得先の両方が返されます。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
成功
ヘッダー
- ResponseTime: string
リクエストの処理にかかった時間(ミリ秒)を取得します。
401レスポンス
未認可
404レスポンス
リクエスト・エンティティが見つからない
500レスポンス
内部サーバー・エラー
例
この例では、ロールの階層を取得する機能を示します。この例では、hierarchyTypeおよびinheritsFromによってリクエストをフィルタします。ここに示す情報は、擬似システムを使用した場合のものであり、プロトタイプとして提供しています。
cURLの例
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/roles/7/hierarchy?hierarchyType=inheritsfrom&hierarchyMode=direct
GETレスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{ "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/roles/43/hierarchy" } ], "count": 1, "inheritedFrom": [ { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/roles/42" } ], "id": "42", "fields": [ { "name": "Role Name", "value": "parentRole" }, { "name": "ugp_update", "value": 1553028059000 }, { "name": "ugp_createby", "value": 84 }, { "name": "Role Key", "value": "42" }, { "name": "Request Id", "value": "1014" }, { "name": "ugp_create", "value": 1553028059000 }, { "name": "Role Display Name", "value": { "base": "parentRole" } }, { "name": "ugp_updateby", "value": 84 }, { "name": "Role Unique Name", "value": "parentRole" }, { "name": "Role Category Key", "value": 1 }, { "name": "Role Owner Key", "value": 84 }, { "name": "Role Namespace", "value": "Default" } ] } ] }