Removing Permissions of Agencies Associated with Specified Enterprise Projects
Function
This API is used to remove permissions of agencies associated with specified enterprise projects.
The API can be called using both the global endpoint and region-specific endpoints.
URI
DELETE /v3.0/OS-PERMISSION/subjects/agency/scopes/enterprise-project/role-assignments
Request Parameters
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
X-Auth-Token |
Yes |
String |
Authenticated token with the iam:permissions:revokeRoleFromAgencyOnEnterpriseProject fine-grained permissions or the Security Administrator permissions. |
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
Yes |
Array of objects |
Association between agencies and enterprise projects. A maximum of 250 association records are supported. |
Response Parameters
None
Example Request
Request for removing permissions of agencies associated with a specified enterprise project
DELETE /v3.0/OS-PERMISSION/subjects/agency/scopes/enterprise-project/role-assignments
{
"role_assignments": [
{
"agency_id": "as0d9f8asdfasdfa09sd8f9aaa",
"enterprise_project_id": "3asdfs0d9f8asdfasdfa09sd8f9aaa",
"role_id": "5s0d9f8dafsdfasdfa09sd8f9aaa"
}
]
}
Example Response
Status code: 204
The request is successful.
Status code: 400
Parameter error.
{
"error" : {
"message" : "Illegal request",
"code" : 400,
"title" : "Bad Request"
}
}
Status code: 401
Authentication failed.
{
"error" : {
"message" : "Authentication failed",
"code" : 401,
"title" : "Unauthorized"
}
}
Status code: 403
Operation denied.
{
"error" : {
"message" : "Forbidden operation",
"code" : 403,
"title" : "Forbidden"
}
}
Status Codes
|
Status Code |
Description |
|---|---|
|
204 |
The request is successful. |
|
400 |
Parameter error. |
|
401 |
Authentication failed. |
|
403 |
Unauthorized operation. |
|
500 |
Internal server error. |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.
