Identity and Access Management API, REST: Role.List
Retrieves the list of Role resources.
HTTP request
GET https://iam.api.cloud.yandex.net/iam/v1/roles
Query parameters
|
Field |
Description |
|
pageSize |
string (int64) The maximum number of results per page to return. If the number of available |
|
pageToken |
string Page token. To get the next page of results, set |
|
filter |
string A filter expression that filters resources listed in the response. |
Response
HTTP Code: 200 - OK
{
"roles": [
{
"id": "string",
"description": "string"
}
],
"nextPageToken": "string"
}
|
Field |
Description |
|
roles[] |
List of Role resources. |
|
nextPageToken |
string This token allows you to get the next page of results for list requests. If the number of results |
Role
A Role resource. For more information, see Roles.
|
Field |
Description |
|
id |
string ID of the role. |
|
description |
string Description of the role. 0-256 characters long. |