文档首页/ 统一身份认证服务 IAM/ API参考/ API/ 企业项目管理/ 查询企业项目关联的用户组
更新时间：2025-09-24 GMT+08:00
查看PDF
分享

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

功能介绍

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

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

调试

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

enterprise_project_id

是

String

待查询的企业项目的ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

响应参数

状态码为 200 时：

表3 响应Body参数

参数

参数类型

描述

groups

Array of objects

用户组信息。
表4 groups

参数

参数类型

描述

createTime

Integer

用户组创建时间。

description

String

用户组描述。

domainId

String

账号ID。

id

String

用户组ID。

name

String

用户组名称。

请求示例

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

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

响应示例

状态码： 200

请求成功。

{ 
  "groups" : [ { 
    "createTime" : 1552093271000, 
    "description" : null, 
    "domainId" : "dc7f62ae236c47b8836014c16d64d...", 
    "id" : "e6bde2403bda43e2813a1a6848963...", 
    "name" : "auth" 
  } ] 
}

状态码

状态码

描述

200

请求成功。

400

请求参数出错。

401

认证失败。

403

没有操作权限。

404

找不到指定资源。

415

Content type校验错误。

500

内部系统异常。

错误码

请参见错误码。

父主题： 企业项目管理