Granting Permissions to an Agency on a Domain¶
Function¶
This API is used to grant permissions to an agency on a domain.
Note
This operation will invalidate the delegated party's existing token. After the operation is complete, the delegated party must obtain a new token.
URI¶
URI format
PUT /v3.0/OS-AGENCY/domains/{domain_id}/agencies/{agency_id}/roles/{role_id}
URI parameters
Parameter
Mandatory
Type
Description
domain_id
Yes
String
ID of the current domain.
agency_id
Yes
String
ID of an agency.
role_id
Yes
String
ID of a role.
Note
The role name corresponding to role_id in a request body is controlled by a blacklist. The role name cannot be secu_admin or te_agency.
Request Parameters¶
Parameters in the request header
Parameter
Mandatory
Type
Description
Content-Type
Yes
String
Fill application/json;charset=utf8 in this field.
X-Auth-Token
Yes
String
Authenticated token with the Security Administrator permission.
Example request
curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X PUT https://sample.domain.com/v3.0/OS-AGENCY/domains/b32d99a7778d4fd9aa5bc616c3dc4e5f/agencies/37f90258b820472bbc8a0f4f0bfd720d/roles/0f3a2d418ed747fa8be46e92757be9ff
Response Parameters¶
No response: indicates that the response is successful.
Example response (request failed)
{ "error" : { "message" : "Could not find role: 0f3a2d418ed747fa8be46e92757be9ddff", "code" : 404, "title" : "Not Found" } }
Status Codes¶
Status Code | Description |
|---|---|
204 | The request is successful. |
401 | Authentication failed. |
403 | Access denied. |
404 | The requested resource cannot be found. |
500 | Internal server error. |