[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"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 VDC Group

Description

Creates a vDC Group. A universal router will also be created if universalNetworkingEnabled is set to true.

Request

Request

URL

URL


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

Request Body

Request Body

VdcGroup of type(s) application/json Required
{
	"name": "string",
	"orgId": "string",
	"participatingOrgVdcs": [
		{
			"vdcRef": {}
		}
	]
}
string
name Required

The name of this group. The name must be unique.


participatingOrgVdcs Required

The list of organization vDCs that are participating in this group.


string
orgId Required

The organization that this group belongs to.


string
description Optional

The description of this group.


boolean
localEgress Optional

Determines whether local egress is enabled for a universal router belonging to a universal vDC group. This value is used on create if universalNetworkingEnabled is set to true. This cannot be updated. This value is always false for local vDC groups.


string
id Optional

The unique ID for the vDC Group (read-only).


string
networkPoolId Optional

ID of network pool to use if creating a local vDC group router. Must be set if creating a local group. Ignored if creating a universal group.


string
networkPoolUniversalId Optional

The network provider’s universal id that is backing the universal network pool. This field is read-only and is derived from the list of participating vDCs if a universal vDC group is created. For universal vDC groups, each participating vDC should have a universal network pool that is backed by this same id.


string
networkProviderType Optional

The values currently supported are NSX_V and NSX_T. Defines the networking provider backing the vDC Group. This is used on create. If not specified, NSX_V value will be used. NSX_V is used for existing vDC Groups and vDC Groups where Cross-VC NSX is used for the underlying technology. NSX_T is used when the networking provider type for the Organization vDCs in the group is NSX-T. NSX_T only supports groups of type LOCAL (single site).


string
errorMessage Optional

If the group has an error status, a more detailed error message is set here.


boolean
dfwEnabled Optional

Whether Distributed Firewall is enabled for this vDC Group. Only applicable for NSX_T vDC Groups.


status Optional

The status that the group can be in.


string
type Optional

Defines the group as LOCAL or UNIVERSAL. This cannot be changed. Local vDC Groups can have networks stretched across multiple vDCs in a single Cloud Director instance. Local vDC Groups share the same broadcast domain/transport zone and network provider scope. Universal vDC groups can have networks stretched across multiple vDCs in a single or multiple Cloud Director instance(s). Universal vDC groups are backed by a broadcast domain/transport zone that strectches across a single or multiple Cloud Director instance(s). Local vDC groups are supported for both NSX-V and NSX-T Network Provider Types. Universal vDC Groups are supported for only NSX_V Network Provider Type.

Possible values are: LOCALUNIVERSAL


boolean
universalNetworkingEnabled Optional

True means that a vDC group router has been created. If set to true for vdc group creation, a universal router will also be created.

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

202 Accepted

The request have been accepted and the task to monitor the request is in the Location header.

Errors

Errors

Error
400

Invalid configuration.

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"description":"string","dfwEnabled":false,"errorMessage":"string","id":"string","localEgress":false,"name":"string","networkPoolId":"string","networkPoolUniversalId":"string","networkProviderType":"string","orgId":"string","participatingOrgVdcs":[{"faultDomainTag":"string","networkProviderScope":"string","orgRef":{"id":"string","name":"string"},"remoteOrg":false,"siteRef":{"id":"string","name":"string"},"status":"enum","vdcRef":{"id":"string","name":"string"}}],"status":"enum","type":"LOCAL","universalNetworkingEnabled":false}' https://{api_host}/cloudapi/1.0.0/vdcGroups


[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"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?