| Method | URI | Description |
|---|---|---|
| GET | /v2.0/OS-KSADM/roles/ | Lists roles. |
Normal response codes: 200, 203
Error response codes: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
This table shows the header parameters for the list roles request:
| Name | Type | Description |
|---|---|---|
| String (Required) | A valid authentication token for an administrative user. |
This operation does not require a request body.
Example 4.15. List Roles: XML response
<?xml version="1.0" encoding="UTF-8"?> <roles xmlns="http://docs.openstack.org/identity/api/v2.0"> <role id="123" name="Admin" description="All Access" /> <role id="234" name="Guest" description="Guest Access" /> </roles>
Example 4.16. List Roles: JSON response
{
"roles":[
{
"id":"123",
"name":"compute:admin",
"description":"Nova Administrator"
}
],
"roles_links":[
]
}