Create Group

Create Group

Create a new group.

Request
URI
POST
https://{api_host}/cloudapi/1.0.0/groups
COPY
Request Body
UserGroup of type(s) application/json
Optional

Show optional properties

{
    "name": "string",
    "description": "string",
    "orgEntityRef": {},
    "roleEntityRef": {},
    "providerType": "string"
}
{
    "name": "string",
    "id": "string",
    "description": "string",
    "orgEntityRef": {
        "name": "string",
        "id": "string"
    },
    "sourceEntityRef": {
        "name": "string",
        "id": "string"
    },
    "roleEntityRef": {
        "name": "string",
        "id": "string"
    },
    "nameInSource": "string",
    "providerType": "string"
}
Authentication
This operation uses the following authentication methods.
Responses
201

Created

Returns UserGroup of type(s) application/json;version=39.1 
"UserGroup Object"
string
name
Required

name

string
id
Optional

id

string
description
Required

description

object
orgEntityRef
Required

Entity reference used to describe VCD entities

object
sourceEntityRef
Optional

Entity reference used to describe VCD entities

object
roleEntityRef
Required

Entity reference used to describe VCD entities

string
nameInSource
Optional

nameInSource

string
providerType
Required

The provider type of the group. Valid values are:

  • LDAP
  • SAML
  • OAUTH

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"description:"string","name:"string","orgEntityRef:"object","providerType:"string","roleEntityRef:"object"}' https://{api_host}/cloudapi/1.0.0/groups
Availability
Added in 36.0
On This Page
Group Operations
GET
Query Groups
POST
Create Group
GET
Get Group
PUT
Update Group
DELETE
Delete Group
GET
Query Group Users