[{"label":"Latest (v37.0)","version":"latest"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

Create Group

Description

Create a new group.

Request

Request

URL

URL


post
https://{api_host}/cloudapi/1.0.0/groups
Copy

Request Body

Request Body

UserGroup of type(s) application/json Required
{
	"description": "string",
	"name": "string",
	"orgEntityRef": {},
	"providerType": "string",
	"roleEntityRef": {}
}
string
description Required

string
name Required

orgEntityRef Required

Entity reference used to describe VCD entities


string
providerType Required

The provider type of the group. Valid values are:

  • LDAP
  • SAML
  • OAUTH


roleEntityRef Required

Entity reference used to describe VCD entities


string
id Optional

string
nameInSource Optional

sourceEntityRef Optional

This field is under accelerated deprecation and will be removed next release.

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

201 Created

Returns UserGroup of type(s) application/json;version=36.3
{
	"description": "string",
	"id": "string",
	"name": "string",
	"nameInSource": "string",
	"orgEntityRef": {
		"id": "string",
		"name": "string"
	},
	"providerType": "string",
	"roleEntityRef": {
		"id": "string",
		"name": "string"
	},
	"sourceEntityRef": {
		"id": "string",
		"name": "string"
	}
}
string
description Required

string
name Required

orgEntityRef Required

Entity reference used to describe VCD entities


string
providerType Required

The provider type of the group. Valid values are:

  • LDAP
  • SAML
  • OAUTH


roleEntityRef Required

Entity reference used to describe VCD entities


string
id Optional

string
nameInSource Optional

sourceEntityRef Optional

This field is under accelerated deprecation and will be removed next release.

No error details were provided in the OpenAPI specification.

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"description":"string","id":"string","name":"string","nameInSource":"string","orgEntityRef":{"id":"string","name":"string"},"providerType":"string","roleEntityRef":{"id":"string","name":"string"},"sourceEntityRef":{"id":"string","name":"string"}}' https://{api_host}/cloudapi/1.0.0/groups
Vendor Extensions

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:
x-vcloud-event: com/vmware/vcloud/event/group/import


[{"label":"Latest (v37.0)","version":"latest"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
Feedback

Was this page helpful?