POST /admin/extension/providervdcs

Operation:

POST /admin/extension/providervdcs

Description:

Create a provider vDC.

Since:

0.9

Deprecated:

Since version 5.1 createProviderVdcParams should be used.

Input parameters

Consume media type(s):

application/vnd.vmware.admin.vmwprovidervdc+xml

Input type:

VMWProviderVdcType

Output parameters

VMWProviderVdcType

This operation is asynchronous. The response includes a Task that you can monitor to track the progress of the request.

Produce media type(s):

application/vnd.vmware.admin.vmwprovidervdc+xml

Output type:

VMWProviderVdcType

Examples

Request

HTTP 1.1
POST /api/admin/extension/providervdcs

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

Body:

<?xml version="1.0" encoding="UTF-8"?><vmext:VMWProviderVdc
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
    name="pvdc-example"
    type="application/vnd.vmware.admin.vmwprovidervdc+xml">
    <vcloud:Description>Example pvdc description</vcloud:Description>
    <vcloud:IsEnabled>true</vcloud:IsEnabled>
    <vmext:DataStoreRefs>
        <vmext:VimObjectRef>
            <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>datastore-69</vmext:MoRef>
            <vmext:VimObjectType>DATASTORE</vmext:VimObjectType>
        </vmext:VimObjectRef>
        <vmext:VimObjectRef>
            <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>datastore-42</vmext:MoRef>
            <vmext:VimObjectType>DATASTORE</vmext:VimObjectType>
        </vmext:VimObjectRef>
    </vmext:DataStoreRefs>
    <vmext:ResourcePoolRefs>
        <vmext:VimObjectRef>
            <vmext:VimServerRef
                href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
                type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
            <vmext:MoRef>resgroup-49</vmext:MoRef>
            <vmext:VimObjectType>RESOURCE_POOL</vmext:VimObjectType>
        </vmext:VimObjectRef>
    </vmext:ResourcePoolRefs>
    <vmext:VimServer
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
        type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
    <vmext:VimServer
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
        type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
</vmext:VMWProviderVdc>

Response

HTTP/1.1 201 Created

Headers:
Content-Length: 4516
Content-Type: application/vnd.vmware.admin.vmwprovidervdc+xml;version=5.1
Location: https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?><vmext:VMWProviderVdc
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
    id="urn:vcloud:providervdc:bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
    name="pvdc-example"
    status="0"
    type="application/vnd.vmware.admin.vmwprovidervdc+xml"
    xsi:schemaLocation="http://www.vmware.com/vcloud/extension/v1.5 http://https://vcloud.example.com/api/v1.5/schema/vmwextensions.xsd http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/providerVdcReferences"
        rel="up"
        type="application/vnd.vmware.admin.vmwProviderVdcReferences+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/storageProfiles"
        rel="edit"
        type="application/vnd.vmware.admin.updateProviderVdcStorageProfiles+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
        rel="alternate"
        type="application/vnd.vmware.admin.providervdc+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/action/updateResourcePools"
        rel="update:resourcePools"
        type="application/vnd.vmware.admin.resourcePoolSetUpdateParams+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/resourcePools"
        rel="down"
        type="application/vnd.vmware.admin.vmwProviderVdcResourcePoolSet+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/availableStorageProfiles"
        rel="down"
        type="application/vnd.vmware.admin.vmwStorageProfiles+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/vdcReferences"
        rel="down"
        type="application/vnd.vmware.admin.vdcReferences+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/metadata"
        rel="down"
        type="application/vnd.vmware.vcloud.metadata+xml"/>
    <vcloud:Description>Example pvdc description</vcloud:Description>
    <vcloud:Tasks>
        <vcloud:Task
            cancelRequested="false"
            expiryTime="2013-05-13T16:57:37.672+03:00"
            href="https://vcloud.example.com/api/task/b99a5c42-401c-453e-ad79-3cd334488b0b"
            id="urn:vcloud:task:b99a5c42-401c-453e-ad79-3cd334488b0b"
            name="task"
            operation="Creating Provider Virtual Datacenter pvdc-example(bde68d2b-d0c3-4dff-999d-1a3bfa6ba887)"
            operationName="rclCreateProviderVdc"
            serviceNamespace="com.vmware.vcloud"
            startTime="2013-02-12T16:57:37.672+02:00"
            status="running"
            type="application/vnd.vmware.vcloud.task+xml">
            <vcloud:Link
                href="https://vcloud.example.com/api/task/b99a5c42-401c-453e-ad79-3cd334488b0b/action/cancel"
                rel="task:cancel"/>
            <vcloud:Owner
                href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
                name="pvdc-example"
                type="application/vnd.vmware.admin.vmwprovidervdc+xml"/>
            <vcloud:User
                href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
                name="vcloud"
                type="application/vnd.vmware.admin.user+xml"/>
            <vcloud:Organization
                href="https://vcloud.example.com/api/org/a93c9db9-7471-3192-8d09-a8f7eeda85f9"
                name="System"
                type="application/vnd.vmware.vcloud.org+xml"/>
            <vcloud:Details/>
        </vcloud:Task>
    </vcloud:Tasks>
    <vcloud:ComputeCapacity>
        <vcloud:Cpu>
            <vcloud:Units>MHz</vcloud:Units>
            <vcloud:Total>0</vcloud:Total>
        </vcloud:Cpu>
        <vcloud:Memory>
            <vcloud:Units>MB</vcloud:Units>
            <vcloud:Total>0</vcloud:Total>
        </vcloud:Memory>
    </vcloud:ComputeCapacity>
    <vcloud:AvailableNetworks/>
    <vcloud:StorageProfiles/>
    <vcloud:IsEnabled>true</vcloud:IsEnabled>
    <vcloud:NetworkPoolReferences/>
    <vmext:DataStoreRefs/>
    <vmext:ResourcePoolRefs/>
    <vmext:VimServer
        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:HostReferences/>
    <vmext:HighestSupportedHardwareVersion>vmx-07</vmext:HighestSupportedHardwareVersion>
</vmext:VMWProviderVdc>