Each name=value pair in an object's metadata is represented as a MetadataEntry element, which includes links that an administrator or the object owner can use to retrieve or update the metadata value, or delete the MetadataEntry.

Verify that you are logged in to the vCloud API as an administrator or the object owner.

Retrieve the object's Metadata element. See Retrieve or Update a Metadata Element


Examine the retrieved Metadata element to find the MetadataEntry you want.

Each MetadataEntry contains a link of the following form, which you can use when updating the Value of the entry:

   href="https://vcloud.example.com/api/admin/object/id/metadata/DOMAIN/key-name" />

For example:


Retrieve or update the value.

Make a request to the URL in the value of the href attribute of the MetadataEntry that contains the Key.

To retrieve the value, make a GET request to URL in the value of the href attribute of the MetadataEntry. The response is a MetadataValue element.

To update the value, make a PUT request to the URL in the edit link described in Step 1, and supply a MetadataValue element as the request body. See .Example: Update a Metadata Value


The href value of a MetadataEntry in the SYSTEM domain includes the SYSTEM qualifier. The href value of a MetadataEntry in the GENERAL domain does not include a qualifier.

This request updates the value of the metadata Key named LOS from the original value of bronze (shown in Example: Update a Metadata Element) to a new value of silver. Note that because this MetadataValue is contained by a MetadataEntry where the Domain is SYSTEM and visibility is PRIVATE, only a system administrator can update it.


PUT https://vcloud.example.com/api/admin/org/26/metadata/SYSTEM/LOS
Content-Type: application/vnd.vmware.vcloud.metadata.value+xml
<?xml version="1.0" encoding="UTF-8"?>

The response is a task.


   operation="Updating metadata for vApp (7)"
   ... >