Help Center/Identity and Access Management/API Reference/API/Enterprise Project Management/Removing Permissions of a User Group Associated with an Enterprise Project
Updated on 2025-12-27 GMT+08:00
View PDF

Removing Permissions of a User Group Associated with an Enterprise Project

Function

This API is used to remove the permissions of a user group associated with an enterprise project.

The API can be called using both the global endpoint and region-specific endpoints.

Authorization Information

Each account is authorized to call all APIs, but its IAM users must obtain the required permissions. For details, see Permissions and Supported Actions.

URI

DELETE /v3.0/OS-PERMISSION/enterprise-projects/{enterprise_project_id}/groups/{group_id}/roles/{role_id}

Table 1 URI parameters

Parameter

Mandatory

Type

Description

enterprise_project_id

Yes

String

Enterprise project ID.

group_id

Yes

String

User group ID.

role_id

Yes

String

Permission ID.

Request Parameters

Table 2 Parameters in the request header

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Authenticated token with iam:permissions:revokeRoleFromGroupOnEnterpriseProject or Security Administrator permissions. The domain_id of the account which the group_id belongs to must be the same as the domain_id in the token.

Response Parameters

None

Example Request

Request for removing permissions of a user group associated with an enterprise project

DELETE https://iam.myhuaweicloud.eu/v3.0/OS-PERMISSION/enterprise-projects/{enterprise_project_id}/groups/{group_id}/roles/{role_id}

Example Response

None

Status Codes

Status Code

Description

204

The request is successful.

400

The request message is invalid.

401

Token authentication failed.

403

Access denied.

404

The resource does not exist.

415

Incorrect Content-Type.

500

A system error occurred.

Error Codes

For details, see Error Codes.