Help Center> Identity and Access Management> API Reference> API> Enterprise Project Management> Granting Permissions to a User Group Associated with an Enterprise Project
Updated on 2023-07-05 GMT+08:00

Granting Permissions to a User Group Associated with an Enterprise Project

Function

This API is used to grant permissions to a user group associated with the enterprise project of a specified ID.

The API can be called using both the global endpoint and region-specific endpoints. For IAM endpoints, see Regions and Endpoints.

URI

PUT /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

Role ID.

NOTE:

Ensure that the role you specify can be used for authorization by enterprise project. For details, see Supported Cloud Services.

Request Parameters

Table 2 Parameters in the request header

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

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

Response Parameters

None

Example Request

Request for granting permissions to a user group associated with an enterprise project

PUT https://iam.myhuaweicloud.com/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.

415

Incorrect Content-Type.

500

A system error occurred.

Error Codes

For details, see Error Codes.