文档首页> 统一身份认证服务 IAM> API参考> 历史API> 查询企业项目关联的用户组
更新时间:2022-09-21 GMT+08:00

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

功能介绍

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

根据产品迭代计划,该接口将逐步下线,推荐您使用查询企业项目关联的用户组

URI

  • URI格式

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

  • URI参数说明

    属性

    是否必选

    类型

    说明

    enterprise_project_id

    String

    待查询的企业项目的ID。

请求

  • Request Header参数说明

    参数

    是否必选

    类型

    说明

    X-Auth-Token

    String

    已认证的拥有Security Administrator权限的token。

    Content-Type

    String

    该字段内容填为“application/json;charset=utf8”

  • 请求样例
    curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X GET https://iam.myhuaweicloud.com/v3.0/OS-PAP/enterprise-projects/535fb147-6148-4c71-a679-b79a2cb0ee5d/groups

响应

  • Reponse Body参数说明

    参数

    是否必选

    类型

    说明

    groups

    Array

    企业项目关联的用户组详情。

  • groups格式说明

    参数

    是否必选

    类型

    说明

    group_id

    String

    关联用户组的ID。

    group_name

    String

    关联用户组的名称。

    group_desc

    String

    关联用户组的描述。

    user_num

    Int

    关联用户组中的用户数。

    policy_num

    Int

    关联用户组的策略数。

    created_at

    Int

    关联用户组创建的时间(Unix时间:毫秒)。

  • 响应样例:查询的企业项目关联了用户组。
    {
        "groups": [
            {
                "group_id": "758b99fa1fa24ec4a297d44e092bd...",
                "group_name": "Test",
                "group_desc": "Test",
                "user_num": 4,
                "policy_num": 1,
                "created_at": 1549088526...
            }
        ]
    }
  • 查询的企业项目没有关联任何用户组,返回的响应体中“groups”的内容为空。
    {
      "groups": []
    }

状态码

状态码

说明

200

请求成功。

400

参数无效。

401

认证失败。

403

鉴权失败。

404

找不到资源。