Files

weihongmin1 46d24ba358 IAM API 0401 Version

Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com>
Co-authored-by: weihongmin1 <weihongmin1@huawei.com>
Co-committed-by: weihongmin1 <weihongmin1@huawei.com>

2026-01-14 14:13:49 +00:00

15 KiB

Raw Blame History

Removing Permissions of Agencies Associated with Specified Enterprise Projects

Function

This API is used to remove permissions of agencies associated with specified enterprise projects.

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.

Parent topic: Enterprise Project Management

15 KiB Raw Blame History