[{"label":"Latest (6.4.0)","version":"latest"}]
vrealize-network-insight-api

Add VIdm User Group

Description

Add a new VMware Identity Manager user-group to vRealize Network Insight. Only admin users can perform this action. VMware Identity Manager must be configured prior to this action.

Request

Request

URL

URL


post
https://vrni.example.com/api/ni/settings/user-groups/vidm
Copy

Request Body

Request Body

VidmUserGroupRequest of type(s) application/json Required

User-group details

{
    "domain": "vidmlabs.com",
    "group_name": "testgroup",
    "role": "ADMIN"
}
string
domain Optional

Provide domain name to which user-group belongs to.


string
group_name Optional

Specify group name (domain should not be part of group name).


role Optional

Role assigned the user/group.

Possible values are: MEMBERADMINAUDITOR

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

201 Created

Returns UserGroupResponse of type(s) application/json
{
    "domain": "vidmlabs.com",
    "group_name": "testgroup",
    "group_type": "VIDM",
    "id": "testgroup@vidmlabs.com",
    "role": "ADMIN"
}
string
domain Optional

Domain name to which user-group belongs to.


string
group_name Optional

Group-name of the user-group.


group_type Optional

The type of user-group.

Possible values are: LDAPLOCALVIDM


string
id Optional

Unique identifier assigned to user-group.


role Optional

Role assigned the user/group.

Possible values are: MEMBERADMINAUDITOR

Errors

Errors

ApiError
400

Bad Request


ApiError
401

Unauthorized


ApiError
403

Forbidden


ApiError
409

Already Exists


500

Internal Error

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"domain":"vidmlabs.com","group_name":"testgroup","role":"ADMIN"}' https://vrni.example.com/api/ni/settings/user-groups/vidm


[{"label":"Latest (6.4.0)","version":"latest"}]
vrealize-network-insight-api
Settings Operations
Feedback

Was this page helpful?