Create User Group Using POST

If the authSourceId is specified(in the request), then the user group will be imported from the corresponding auth source (LDAP/AD/SSO/VIDM).Note that the id of the user group has to be null. For LDAP/AD groups the distinguishedName should be provided in the name field. The value of displayName is used only while importing LDAP/AD groups, and if it is not provided then the value of name will be assigned to it. For SSO/VIDM groups the value of name is assigned to displayName. NOTE: Before importing please make sure that the group exists in the specified authSource by using the following API - /api/auth/sources/{id}/usergroups/search . Otherwise, if you try to import a non-existing group, a new one will be created with the specified authSourceId.

Request

URI

POST

https://{api_host}/api/auth/usergroups

COPY

Request Body

The group object to be created.

user-group of type(s) application/json

Required

Show optional properties

{
    "name": "string"
}

{
    "authSourceId": "string",
    "description": "string",
    "displayName": "string",
    "id": "string",
    "links": [
        {
            "description": "string",
            "href": "string",
            "name": "string",
            "rel": "string"
        }
    ],
    "name": "string",
    "role-permissions": [
        {
            "allowAllObjects": false,
            "links": [
                {
                    "description": "string",
                    "href": "string",
                    "name": "string",
                    "rel": "string"
                }
            ],
            "roleName": "string",
            "scopeId": "string",
            "traversal-spec-instances": [
                {
                    "adapterKind": "string",
                    "includedAdapterKinds": [
                        "string"
                    ],
                    "name": "string",
                    "resourceKind": "string",
                    "resourceSelection": [
                        {
                            "resourceId": [
                                "string"
                            ],
                            "type": "string"
                        }
                    ],
                    "selectAllResources": false
                }
            ]
        }
    ],
    "roleNames": [
        "string"
    ],
    "userIds": [
        "string"
    ]
}

string As uuid As uuid

authSourceId

Optional

The identifier of the auth source. If it is null, a local user group will be created.

string

description

Optional

A description about this group.

string

displayName

Optional

The displayName of this group.

string As uuid As uuid

Optional

The identifier of this group.(unique)

Note: Required when updating or deleting the user group.

array of link

links

Optional

links

string

name

Required

The name of this group.

array of role-permission

role-permissions

Optional

The list of role permissions assigned to this group. May be null. Replaces and takes precedence over roleNames.

array of string

roleNames

Optional

(Deprecated) List of role names assigned to the user group. May be null.

array of string

userIds

Optional

The list of users who are members of this group.

Authentication

This operation uses the following authentication methods.

CSPToken

Responses

201

The user group is created successfully

Returns user-group of type(s) application/json

{
    "authSourceId": "string",
    "description": "string",
    "displayName": "string",
    "id": "string",
    "links": [
        {
            "description": "string",
            "href": "string",
            "name": "string",
            "rel": "string"
        }
    ],
    "name": "string",
    "role-permissions": [
        {
            "allowAllObjects": false,
            "links": [
                {
                    "description": "string",
                    "href": "string",
                    "name": "string",
                    "rel": "string"
                }
            ],
            "roleName": "string",
            "scopeId": "string",
            "traversal-spec-instances": [
                {
                    "adapterKind": "string",
                    "includedAdapterKinds": [
                        "string"
                    ],
                    "name": "string",
                    "resourceKind": "string",
                    "resourceSelection": [
                        {
                            "resourceId": [
                                "string"
                            ],
                            "type": "string"
                        }
                    ],
                    "selectAllResources": false
                }
            ]
        }
    ],
    "roleNames": [
        "string"
    ],
    "userIds": [
        "string"
    ]
}

string As uuid As uuid

authSourceId

Optional

The identifier of the auth source. If it is null, a local user group will be created.

string

description

Optional

A description about this group.

string

displayName

Optional

The displayName of this group.