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

Granting Permissions to Agencies Associated with Specified Enterprise Projects

Function

This API is used to grant permissions to 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

PUT /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 iam:permissions:grantRoleToAgencyOnEnterpriseProject or 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 granting permissions to agencies associated with a specified enterprise project

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

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

200

The request is successful.

400

Parameter error.

401

Authentication failed.

403

Unauthorized operation.

500

Internal server error.