Help Center/ Identity and Access Management/ API Reference/ API/ Enterprise Project Management/ Removing Permissions of Agencies Associated with Specified Enterprise Projects
Updated on 2024-07-30 GMT+08:00
View PDF
Share

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. For IAM endpoints, see Regions and Endpoints.

Debugging

You can debug this API in API Explorer.

URI

DELETE /v3.0/OS-PERMISSION/subjects/agency/scopes/enterprise-project/role-assignments

Request Parameters

Table 1 Parameters in the request header

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Authenticated token with the iam:permissions:revokeRoleFromAgencyOnEnterpriseProject fine-grained permissions or the Security Administrator permissions.
Table 2 Parameters in the request body

Parameter

Mandatory

Type

Description

role_assignments

Yes

Array of objects

Association between agencies and enterprise projects. A maximum of 250 association records are supported.
Table 3 role_assignments

Parameter

Mandatory

Type

Description

agency_id

Yes

String

Agency ID.

enterprise_project_id

Yes

String

Enterprise project ID.

role_id

Yes

String

Policy ID.

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.