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

功能介绍

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

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

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	内部系统异常。