文档首页/ 云备份 CBR/ API参考/ API/ 项目/ 查询租户的项目信息 - ListProjects
更新时间:2025-11-03 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

是否是域级

parent_id

String

父项目 ID

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

错误码

请参见错误码

相关文档