Updated on 2022-08-16 GMT+08:00

Listing User Groups

Function

This API is used to query user group information.

URI

  • URI format

    GET /v3/groups{?domain_id,name}

  • Query parameters

    Parameter

    Mandatory

    Type

    Description

    domain_id

    No

    String

    ID of the domain where a user group is located.

    name

    No

    String

    Name of a user group. The length is less than or equal to 64 characters.

Request Parameters

  • Parameters in the request header

    Parameter

    Mandatory

    Type

    Description

    Content-Type

    Yes

    String

    Fill application/json;charset=utf8 in this field.

    X-Auth-Token

    Yes

    String

    Authenticated token with the Security Administrator permission.

  • Example request
    curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X GET https://sample.domain.com/v3/groups?domain_id=ac7197fd67a24dc5850972854729a762&name=group123

Response Parameters

  • Parameters in the response body

    Parameter

    Mandatory

    Type

    Description

    links

    Yes

    JSON object

    User group resource link.

    groups

    Yes

    JSONArray

    List of a user group.

  • Group parameter description

    Parameter

    Mandatory

    Type

    Description

    description

    Yes

    String

    Description for a user group.

    domain_id

    Yes

    String

    ID of the domain to which a user group belongs.

    id

    Yes

    String

    ID of a user group.

    links

    Yes

    JSON object

    User group resource link.

    name

    Yes

    String

    Name of a user group.

    create_time

    Yes

    Long

    Time when a user group is created.

  • Example response
    {
        "links": {
            "self": "https://sample.domain.com/v3/groups?domain_id=ac7197fd67a24dc5850972854729a762&name=group123",
            "previous": null,
            "next": null
        },
        "groups": [{
            "description": "",
            "links": {
                "self": "https://sample.domain.com/v3/groups/ff74abaeabe34c278a4b7693c7f0dff7"
            },
            "id": "ff74abaeabe34c278a4b7693c7f0dff7",
            "create_time": 1482566254983,
            "domain_id": "ac7197fd67a24dc5850972854729a762",
            "name": "group123"
        }]
    }

Status Codes

Status Code

Description

200

The request is successful.

400

The server failed to process the request.

401

Authentication failed.

403

Access denied.