Get User Groups

Get User Groups

Retrieve the list of existing user-groups. Only admin users can retrieve this information. This action is currently restricted to user-groups mapped through VMware Identity Manager.

Request
URI
GET
https://vrni.example.com/api/ni/settings/user-groups
COPY
Query Parameters
number
size
Optional

page size of results

string
cursor
Optional

cursor from previous response

string
type
Required

type of user-group


Authentication
This operation uses the following authentication methods.
Responses
200

Success

Returns PagedUserGroupListResponse of type(s) application/json
{
    "results": [
        {
            "id": "[email protected]",
            "group_type": "VIDM",
            "group_name": "testgroup",
            "domain": "vidmlabs.com",
            "role": "ADMIN"
        }
    ],
    "cursor": "string",
    "total_count": 0
}
results
Optional

results

string
cursor
Optional

cursor

integer
total_count
Optional

total_count


400

Bad Request

Returns ApiError of type(s) application/json
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of ErrorDetail
details
Optional

details


401

Unauthorized

Returns ApiError of type(s) application/json
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of ErrorDetail
details
Optional

details


403

Forbidden

Returns ApiError of type(s) application/json
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of ErrorDetail
details
Optional

details


404

Not Found

Returns ApiError of type(s) application/json
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of ErrorDetail
details
Optional

details


500

Internal Error

Operation doesn't return any data structure