文档首页/ 云备份 CBR/ API参考/ API/ 项目/ 查询租户的项目信息 - ListProjects
更新时间:2026-07-21 GMT+08:00
分享

查询租户的项目信息 - ListProjects

功能介绍

查询租户的企业项目信息

接口约束

本接口仅用于开通了企业项目场景中,Console需要获取复制目标区域的project_id时使用,其它场景下调用无返回值。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v3/region-projects

请求参数

响应参数

状态码:200

表1 响应Body参数

参数

参数类型

描述

projects

Array of ProjectsListInfo objects

参数解释:

项目信息

取值范围:

取值范围不涉及,最大返回条数不涉及

links

SelfLinksInfo object

参数解释:

链接地址

取值范围:

不涉及

表2 ProjectsListInfo

参数

参数类型

描述

domain_id

String

参数解释:

账号的域ID

取值范围:

不涉及

is_domain

Boolean

参数解释:

是否是域级

取值范围:

-True:是域级

-False:不是域级

parent_id

String

参数解释:

父项目ID,为UUID

取值范围:

取值范围不涉及

name

String

参数解释:

账号名称

取值范围:

不涉及

description

String

参数解释:

租户描述信息

取值范围:

不涉及

id

String

参数解释:

项目ID

取值范围:

不涉及

enabled

Boolean

参数解释:

项目是否启用

取值范围:

不涉及

links

SelfLinksInfo object

参数解释:

项目链接地址

取值范围:

不涉及

表3 SelfLinksInfo

参数

参数类型

描述

self

String

参数解释:

项目连接地址

取值范围:

不涉及

请求示例

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

响应示例

状态码:200

OK

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

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档