Help Center/ Identity and Access Management/ API Reference/ API/ Enterprise Project Management/ Querying the Enterprise Projects Directly Associated with an IAM User
Updated on 2024-07-30 GMT+08:00

Querying the Enterprise Projects Directly Associated with an IAM User

Function

This API is used to query the enterprise projects directly associated with an IAM user.

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

GET /v3.0/OS-PERMISSION/users/{user_id}/enterprise-projects

Table 1 URI parameters

Parameter

Mandatory

Type

Description

user_id

Yes

String

IAM user ID.

Request Parameters

Table 2 Parameters in the request header

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

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

Response Parameters

Status code: 200

Table 3 Parameters in the response body

Parameter

Type

Description

enterprise-projects

Array of objects

Enterprise project information.

Table 4 enterprise-projects

Parameter

Type

Description

projectId

String

Project ID.

Example Request

Request for querying enterprise projects directly associated with an IAM user

GET https://iam.myhuaweicloud.com/v3.0/OS-PERMISSION/users/{user_id}/enterprise-projects

Example Response

Status code: 200

The request is successful.

{ 
  "enterprise-projects" : [ { 
    "projectId" : "dd87a1a8-8602-45a8-8145-393af4c95..." 
  }, { 
    "projectId" : "dd87a1a8-8602-45a8-8145-393af4c95..." 
  } ] 
}

Status Codes

Status Code

Description

200

The request is successful.

400

Parameter error.

401

Authentication failed.

403

Access denied.

404

The requested resource cannot be found.

415

Incorrect Content-Type.

500

A system error occurred.

Error Codes

For details, see Error Codes.