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. Verify that you are logged in to the vCloud Air Compute Service 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

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