VMware Cloud Director API - POST-UpdateCatalogMetadata

POST /admin/catalog/{id}/metadata

Operation:

POST /admin/catalog/{id}/metadata

Description:

Merge the metadata provided in the request with existing metadata.

Since:

1.5

Input parameters

Consume media type(s):: application/vnd.vmware.vcloud.metadata+xml
application/vnd.vmware.vcloud.metadata+json
Input type:: MetadataType

Output parameters

Produce media type(s):: application/vnd.vmware.vcloud.task+xml
application/vnd.vmware.vcloud.task+json
Output type:: TaskType

Examples

Request: HTTP 1.1
POST /api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/metadata

Headers:
Content-Length: 479
Content-Type: application/vnd.vmware.vcloud.metadata+xml; charset=ISO-8859-1
x-vcloud-authorization: FQMWZgFq5mhMRSpt2ecxnsAXTxRpxdbZ/z2u6uwEH+w=

Body:

<?xml version="1.0" encoding="UTF-8"?><vcloud:Metadata
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <vcloud:MetadataEntry>
        <vcloud:Domain
            visibility="PRIVATE">SYSTEM</vcloud:Domain>
        <vcloud:Key>key</vcloud:Key>
        <vcloud:TypedValue
            xsi:type="vcloud:MetadataNumberValue">
            <vcloud:Value>1000</vcloud:Value>
        </vcloud:TypedValue>
    </vcloud:MetadataEntry>
</vcloud:Metadata>
Response: HTTP/1.1 202 Accepted

Headers:
Content-Length: 1331
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.5
Location: https://vcloud.example.com/api/task/264469b0-7e56-43eb-af06-67568bcd0c11
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?><Task
    xmlns="http://www.vmware.com/vcloud/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    cancelRequested="false"
    expiryTime="2013-05-14T18:35:05.562+03:00"
    href="https://vcloud.example.com/api/task/264469b0-7e56-43eb-af06-67568bcd0c11"
    id="urn:vcloud:task:264469b0-7e56-43eb-af06-67568bcd0c11"
    name="task"
    operation="Updating metadata for Library (2a8c1427-7ba9-4a5a-ba08-040b630d9859)"
    operationName="metadataUpdate"
    serviceNamespace="com.vmware.vcloud"
    startTime="2013-02-13T18:35:05.562+02:00"
    status="running"
    type="application/vnd.vmware.vcloud.task+xml"
    xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
    <Link
        href="https://vcloud.example.com/api/task/264469b0-7e56-43eb-af06-67568bcd0c11/action/cancel"
        rel="task:cancel"/>
    <Owner
        href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859"
        name=""
        type="application/vnd.vmware.admin.catalog+xml"/>
    <User
        href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
        name="system"
        type="application/vnd.vmware.admin.user+xml"/>
    <Organization
        href="https://vcloud.example.com/api/org/7cc8d565-1203-49bd-b50c-24e0acbaeb5a"
        name="OrgName"
        type="application/vnd.vmware.vcloud.org+xml"/>
    <Details/>
</Task>