Each name=value pair in an object's metadata is represented as a MetadataEntry element, which includes links that a system administrator or 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 a system 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 Organization (26)"
   ... >