割り当てられたロールのリストをクエリします。例えば、グループ ID を指定してグループの管理者をクエリできます。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST /v2/role/list_assignment HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| body |
object |
任意 |
リクエストパラメーター。 |
|
| manage_resource_type |
string |
必須 |
管理対象リソースのタイプ。値を RT_Group に設定すると、グループの管理者がクエリされます。 |
RT_Group |
| manage_resource_id |
string |
必須 |
管理対象リソースの ID (例: グループ ID)。 |
105***b82 |
| marker |
string |
任意 |
次のリクエストで新しい結果ページを取得するために使用されるページネーショントークン。最初のリクエストでは、このパラメーターを指定する必要はありません。以前のクエリから取得されたトークンを marker の値として指定する必要があります。デフォルトでは、このパラメーターは空です。 |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
| limit |
integer |
任意 |
返される結果の最大数。有効な値: 1 から 100。 返される結果の数は、指定された数以下である必要があります。 |
50 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| assignment_list |
array<object> |
割り当てられたロール。 |
|
|
object |
|||
| domain_id |
string |
ドメイン ID。 |
hz1 |
| identity | Identity |
ロールが割り当てられている ID。ユーザーまたはグループです。 |
|
| role_id |
string |
ID に割り当てられたロールの ID。 |
SystemGroupAdmin |
| manage_resource_type |
string |
管理対象リソースのタイプ。例えば、RT_Group の値はグループを示します。 |
RT_Group |
| manage_resource_id |
string |
管理対象リソースの ID (例: グループ ID)。 |
105***b82 |
| creator |
string |
ロールを割り当てたユーザーの ID。 |
216***c83 |
| created_at |
integer |
ロールが割り当てられた時間。この値は、1970 年 1 月 1 日 00:00:00 UTC から経過したミリ秒数を表す UNIX タイムスタンプです。 |
1622682267564 |
| next_marker |
string |
ページネーショントークン。次のリクエストで新しい結果ページを取得するために使用できます。next_marker が空の場合、次のページは存在しません。 |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
例
成功レスポンス
JSONJSON
{
"assignment_list": [
{
"domain_id": "hz1",
"identity": {
"identity_type": "IT_User",
"identity_id": "16435bdf934248b788b7b3771ee9a3dw"
},
"role_id": "SystemGroupAdmin",
"manage_resource_type": "RT_Group",
"manage_resource_id": "105***b82",
"creator": "216***c83",
"created_at": 1622682267564
}
],
"next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。