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

Prerequisites
■

This operation requires the rights included in the predefined Organization Administrator role or an equivalent set of rights.

■

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
Procedure
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.

Example: Change the Name and Description of an Existing VDC

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>