Distributed Virtual Switch Create DV Portgroup Task
Creates a single DistributedVirtualPortgroup and adds it to the distributed virtual switch.
Required privileges: DVPortgroup.Create
The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId
, in this case DistributedVirtualSwitch/{moId}
.
The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.
"CreateDVPortgroupRequestType Object"
The DVPortgroupConfigSpec data object contains configuration data for a DistributedVirtualPortgroup.
Use the ReconfigureDVPortgroup_Task method to apply the configuration to the portgroup.
Returns a Task object. The Task.info.result property contains a managed object reference to the new portgroup. The portgroup property also contains the reference.
"MoRefTask Object"
DuplicateName: if a portgroup with the same name already exists
DvsFault: if operation fails on any host or if there are other update failures.
InvalidName: if name of the portgroup is invalid
"VimFault Object"
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/DistributedVirtualSwitch/{moId}/CreateDVPortgroup_Task