An administrator can update an existing virtual datacenter to change its name or description.

Verify that you are logged in to the vCloud API endpoint as an Account Administrator.

Retrieve the VDC whose name or description you want to change. If you don't know the URL of the VDC, you can use a query like this one to retrieve a list of references all VDCs in your organization.

GET https://vcloud.example.com/api/query?type=adminOrgVdc&format=references
1

Examine the Vdc to find its rel="edit" link.

2

Create a Vdc element that contains the new name and description.

This Vdc element need only specify the new name and Description. See Example: Change the Name and Description of an Existing VDC.

3

Make a PUT request to the rel="edit" link to change the name or description of the VDC .

Supply the Vdc element as the request body.

This example changes the name and description of the VDC created in Example: Create a VDC From a Template.

Request:

PUT https://vcloud.example.com/api/vdc/130
Content-Type: application/vnd.vmware.vcloud.vdc+xml
...
<?xml version="1.0" encoding="UTF-8"?>
<Vdc
   xmlns="http://www.vmware.com/vcloud/v1.5"
   name="NewVdcName"
   type="application/vnd.vmware.vcloud.vdc+xml">
   <Description>New VDC description</Description>
</Vdc>

The response is a Task.

202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
<Task
   name="task"
   status="running"
   operation="Updating Virtual Datacenter templateVdc (130)" ...
   ...
</Task>