Querying Tenant's Project Information

Function

This API is used to query the enterprise project information of a tenant.

Constraints

This API is used only when the enterprise project management service is enabled. The project ID of the replication destination region must be obtained for CBR Console. In other scenarios, no value is returned when this API is called.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

URI

GET /v3/region-projects

Request Parameters

None

Response Parameters

Status code: 200

**Table 1** Response body parameters
Parameter	Type	Description
projects	Array of ProjectsListInfo objects	Project information
links	SelfLinksInfo object	Link address

**Table 2** ProjectsListInfo
Parameter	Type	Description
domain_id	String	Domain ID
is_domain	Boolean	The value is false.
parent_id	String	ID of the specific project or account ID of a specific system project
name	String	Backup name
description	String	Description
id	String	Project ID
enabled	Boolean	Enabling status of the project
links	SelfLinksInfo object	Link address

**Table 3** SelfLinksInfo
Parameter	Type	Description
self	String	Link address

Example Requests

GET  https://{endpoint}/v3/region-projects

Example Responses

Status code: 200

{
  "projects" : [ {
    "description" : "",
    "domain_id" : "5ba348512fd541c3a57c9bb2196108f8",
    "enabled" : true,
    "id" : "45a3afcc926f47d08b9375694b062193",
    "is_domain" : false,
    "links" : {
      "self" : "https://iam.huaweicloud.com:31943/v3/projects/45a3afcc926f47d08b9375694b062193"
    },
    "name" : "cn-hk1_yyx2",
    "parent_id" : ""
  }, {
    "description" : "",
    "domain_id" : "5ba348512fd541c3a57c9bb2196108f8",
    "enabled" : true,
    "id" : "438fe051ccb04aeabc0c8112a276a0dc",
    "is_domain" : false,
    "links" : {
      "self" : "https://iam.huaweicloud.com:31943/v3/projects/438fe051ccb04aeabc0c8112a276a0dc"
    },
    "name" : "cn-xianhz-1",
    "parent_id" : ""
  } ],
  "links" : {
    "self" : "https://iam.huaweicloud.com:31943/v3/auth/projects"
  }
}