更新时间:2022-08-16 GMT+08:00

查询用户所属用户组

功能介绍

该接口用于查询指定用户所属的用户组信息。

URI

  • URI格式

    GET /v3/users/{user_id}/groups

  • 参数说明

    参数

    是否必选

    类型

    说明

    user_id

    String

    用户ID。

请求

  • Request Header参数说明

    参数

    是否必选

    类型

    说明

    Content-Type

    String

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

    X-Auth-Token

    String

    已认证的拥有Security Administrator权限的token,或已认证的用户自身的token。

  • 请求样例
    curl -i -k -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -H "X-Auth-Token:$token" -X GET https://sample.domain.com/v3/users/43cbe5e77aaf4665bbb962062dc1fc9d/groups

响应

  • Response Body参数说明

    参数

    是否必选

    类型

    说明

    groups

    JSONArray

    用户组列表。

    links

    JSONObject

    用户组的资源链接。

  • group格式说明

    参数

    是否必选

    类型

    说明

    description

    String

    用户组描述。

    id

    String

    用户组ID。

    domain_id

    String

    用户组所在domain的ID。

    name

    String

    用户组名称。

    links

    JSONObject

    用户组的资源链接。

    create_time

    Long

    用户组创建时间。

  • 响应样例
    {
        "links": {
            "self": "https://sample.domain.com/v3/users/f7cb4876e5174c0885433e280e831c43/groups",
            "previous": null,
            "next": null
        },
        "groups": [{
            "description": "User group that has the permission for all system operations",
            "links": {
                "self": "https://sample.domain.com/v3/groups/e21c7a1e415c4604927948dc24750716"
            },
            "id": "e21c7a1e415c4604927948dc24750716",
            "create_time": 1472888495993,
            "domain_id": "88b16b6440684467b8825d7d96e154d8",
            "name": "admin"
        }]
    }

状态码

状态码

说明

200

请求成功。

400

请求错误。

401

认证失败。

403

鉴权失败。

404

找不到资源。

405

不允许的方法。

413

请求体过大。

500

内部服务错误。

503

服务不可用。