文档首页/ 统一身份认证服务 IAM/ API参考/ API/ 企业项目管理/ 查询用户组关联的企业项目
更新时间:2024-11-18 GMT+08:00

查询用户组关联的企业项目

功能介绍

该接口可用于查询用户组所关联的企业项目。

该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见:地区和终端节点

调试

您可以在API Explorer中调试该接口。

URI

GET /v3.0/OS-PERMISSION/groups/{group_id}/enterprise-projects

表1 路径参数

参数

是否必选

参数类型

描述

group_id

String

待查询用户组ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

已认证的拥有iam:permissions:listEnterpriseProjectsForGroup细粒度权限或Security Administrator权限的token。同时要求group_id所属账号的domain_id与Token中的domain_id一致。

响应参数

状态码为 200 时:

表3 响应Body参数

参数

参数类型

描述

enterprise-projects

Array of objects

企业项目信息。

表4 enterprise-projects

参数

参数类型

描述

projectId

String

项目ID。

请求示例

查询用户组关联的企业项目。

GET  https://iam.myhuaweicloud.com/v3.0/OS-PERMISSION/groups/{group_id}/enterprise-projects

响应示例

状态码: 200

请求成功。

{ 
  "enterprise-projects" : [ { 
    "projectId" : "dd87a1a8-8602-45a8-8145-393af4c95..." 
  } ] 
}

状态码

状态码

描述

200

请求成功。

400

请求参数出错。

401

认证失败。

403

没有操作权限。

404

未找到相应的资源。

415

Content type校验错误。

500

内部系统异常。

错误码

请参见错误码