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	Definition Project information. Range Range: N/A; maximum number of records that can be returned: N/A
links	SelfLinksInfo object	Definition Link address. Range N/A

**Table 2** ProjectsListInfo
Parameter	Type	Description
domain_id	String	Definition Domain ID of the account. Range N/A
is_domain	Boolean	Definition Whether it is a domain-level project. Range True: domain-level False: not domain-level
parent_id	String	Definition Parent project ID, which is the UUID. Range N/A
name	String	Definition Account name. Range N/A
description	String	Definition Tenant description. Range N/A
id	String	Definition Project ID. Range N/A
enabled	Boolean	Definition Whether the project is enabled. Range N/A
links	SelfLinksInfo object	Definition Project link. Range N/A

**Table 3** SelfLinksInfo
Parameter	Type	Description
self	String	Definition Project link. Range N/A

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"
  }
}