VMware Cloud Director API - POST-UpdatePvdcResourcePools

VMware Cloud Director API - POST-UpdatePvdcResourcePools

POST /admin/extension/providervdc/{id}/action/updateResourcePools

Operation:
POST /admin/extension/providervdc/{id}/action/updateResourcePools
Description:
Add or remove provider vDC resource pools.
Since:
1.5
Input parameters
Consume media type(s):
application/vnd.vmware.admin.resourcePoolSetUpdateParams+xml
application/vnd.vmware.admin.resourcePoolSetUpdateParams+json
Input type:
UpdateResourcePoolSetParamsType
Output parameters
{@link TaskType}

This operation is asynchronous and returns a task that you can monitor to track the progress of the request.

Produce media type(s):
application/vnd.vmware.vcloud.task+xml
application/vnd.vmware.vcloud.task+json
Output type:
TaskType
Examples
Adding resource pool to a provider vDC.

Request
HTTP 1.1
POST /api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/action/updateResourcePools

Headers:
Content-Length: 522
Content-Type: application/vnd.vmware.admin.resourcePoolSetUpdateParams+xml; charset=ISO-8859-1
x-vcloud-authorization: X600Twh81GezzqBm3B3GXTe8r9U8+U5kIrA3X4H2ctE=

Body:
<?xml version="1.0" encoding="UTF-8"?><vmext:UpdateResourcePoolSetParams
    xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5">
    <vmext:AddItem>
        <vmext:VimServerRef
            href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
            name="VC-2"
            type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
        <vmext:MoRef>resgroup-27</vmext:MoRef>
        <vmext:VimObjectType>RESOURCE_POOL</vmext:VimObjectType>
    </vmext:AddItem>
</vmext:UpdateResourcePoolSetParams>
Response
HTTP/1.1 202 Accepted

Headers:
Content-Length: 1368
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.1
Location: https://vcloud.example.com/api/task/e9a25464-a1f7-4e44-a41f-3f9839b8efe3
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-13T16:58:10.742+03:00"
    href="https://vcloud.example.com/api/task/e9a25464-a1f7-4e44-a41f-3f9839b8efe3"
    id="urn:vcloud:task:e9a25464-a1f7-4e44-a41f-3f9839b8efe3"
    name="task"
    operation="Updating Provider Virtual Datacenter (bde68d2b-d0c3-4dff-999d-1a3bfa6ba887)"
    operationName="rclUpdateResourcePoolSet"
    serviceNamespace="com.vmware.vcloud"
    startTime="2013-02-12T16:58:10.742+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/e9a25464-a1f7-4e44-a41f-3f9839b8efe3/action/cancel"
        rel="task:cancel"/>
    <Owner
        href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
        name=""
        type="application/vnd.vmware.admin.vmwprovidervdc+xml"/>
    <User
        href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
        name="vcloud"
        type="application/vnd.vmware.admin.user+xml"/>
    <Organization
        href="https://vcloud.example.com/api/org/a93c9db9-7471-3192-8d09-a8f7eeda85f9"
        name="System"
        type="application/vnd.vmware.vcloud.org+xml"/>
    <Details/>
</Task>
Removing resource pool from a provider vDC.

Request
HTTP 1.1
POST /api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/action/updateResourcePools

Headers:
Content-Length: 364
Content-Type: application/vnd.vmware.admin.resourcePoolSetUpdateParams+xml; charset=ISO-8859-1
x-vcloud-authorization: X600Twh81GezzqBm3B3GXTe8r9U8+U5kIrA3X4H2ctE=

Body:
<?xml version="1.0" encoding="UTF-8"?><vmext:UpdateResourcePoolSetParams
    xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5">
    <vmext:DeleteItem
        href="https://vcloud.example.com/api/admin/extension/resourcePool/e84ed5d3-1de7-4a10-b7c0-7efcdab40ec0"
        type="application/vnd.vmware.admin.vmwProviderVdcResourcePool+xml"/>
</vmext:UpdateResourcePoolSetParams>
Response
HTTP/1.1 202 Accepted

Headers:
Content-Length: 1368
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.1
Location: https://vcloud.example.com/api/task/ddb7d307-f015-4cc5-a25d-b63894dc7bc6
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-13T16:58:20.935+03:00"
    href="https://vcloud.example.com/api/task/ddb7d307-f015-4cc5-a25d-b63894dc7bc6"
    id="urn:vcloud:task:ddb7d307-f015-4cc5-a25d-b63894dc7bc6"
    name="task"
    operation="Updating Provider Virtual Datacenter (bde68d2b-d0c3-4dff-999d-1a3bfa6ba887)"
    operationName="rclUpdateResourcePoolSet"
    serviceNamespace="com.vmware.vcloud"
    startTime="2013-02-12T16:58:20.935+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/ddb7d307-f015-4cc5-a25d-b63894dc7bc6/action/cancel"
        rel="task:cancel"/>
    <Owner
        href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
        name=""
        type="application/vnd.vmware.admin.vmwprovidervdc+xml"/>
    <User
        href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
        name="vcloud"
        type="application/vnd.vmware.admin.user+xml"/>
    <Organization
        href="https://vcloud.example.com/api/org/a93c9db9-7471-3192-8d09-a8f7eeda85f9"
        name="System"
        type="application/vnd.vmware.vcloud.org+xml"/>
    <Details/>
</Task>