Help Center> Identity and Access Management> API Reference> API> Agency Management> Checking Whether an Agency Has Specified Permissions for a Region-specific Project

Updated on 2023-07-05 GMT+08:00

View PDF

Checking Whether an Agency Has Specified Permissions for a Region-specific Project

Function

This API is provided for the administrator to check whether an agency has specified permissions for a region-specific project.

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

URI

HEAD /v3.0/OS-AGENCY/projects/{project_id}/agencies/{agency_id}/roles/{role_id}

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
agency_id	Yes	String	Agency ID. For details about how to obtain the agency ID, see Obtaining Account, IAM User, Group, Project, Region, and Agency Information.
project_id	Yes	String	Project ID of the delegating party. For details about how to obtain the project ID, see Obtaining Account, IAM User, Group, Project, Region, and Agency Information.
role_id	Yes	String	Project-level service permission ID. For details about how to obtain a permission ID, see Listing Permissions.

Request Parameters

**Table 2** Parameters in the request header
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Fill application/json;charset=utf8 in this field.
X-Auth-Token	Yes	String	Authenticated token with Security Administrator permissions.

Response Parameters

None

Example Request

Request for checking whether an agency has specified permissions for a region-specific project

HEAD https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/projects/{project_id}/agencies/{agency_id}/roles/{role_id}

Example Response

None

Status Codes

Status Code	Description
204	The request is successful. (The agency has the specified permissions for the region-specific project.)
401	Authentication failed.
403	Access denied.
404	The requested resource cannot be found.
500	Internal server error.