POST /vdc/{id}/disk

Operation:

POST /vdc/{id}/disk

Description:

Create a disk.

Since:

5.1

Input parameters

Consume media type(s):

application/vnd.vmware.vcloud.diskCreateParams+xml
application/vnd.vmware.vcloud.diskCreateParams+json

Input type:

DiskCreateParamsType

Output parameters

DiskType

Produce media type(s):

application/vnd.vmware.vcloud.disk+xml
application/vnd.vmware.vcloud.disk+json

Output type:

DiskType

Examples

Request

HTTP 1.1
POST /api/vdc/afaafb99-228c-4838-ad07-5bf3aa649d42/disk

Headers:
Content-Length: 574
Content-Type: application/vnd.vmware.vcloud.diskCreateParams+xml; charset=ISO-8859-1
x-vcloud-authorization: eVBkZn2wahPAU+IvbURo7ekslpuoHERMB2DZEFlJuHs=

Body:

<?xml version="1.0" encoding="UTF-8"?><vcloud:DiskCreateParams
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5">
    <vcloud:Disk
        id="1"
        name="diskName"
        operationKey="diskOperationKey"
        size="100000">
        <vcloud:Description>Description for this disk</vcloud:Description>
        <vcloud:Files>
            <vcloud:File
                bytesTransferred="1000"
                name="readme"
                operationKey="operationKey"
                size="1000">
                <vcloud:Description>File description</vcloud:Description>
            </vcloud:File>
        </vcloud:Files>
    </vcloud:Disk>
</vcloud:DiskCreateParams>

Response

HTTP/1.1 201 Created

Headers:
Content-Length: 2981
Content-Type: application/vnd.vmware.vcloud.disk+xml;version=5.5
Location: https://vcloud.example.com/api/disk/e8b2b752-21ca-4cb9-80f6-a55ef1a81eec
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?><Disk
    xmlns="http://www.vmware.com/vcloud/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    href="https://vcloud.example.com/api/disk/e8b2b752-21ca-4cb9-80f6-a55ef1a81eec"
    id="urn:vcloud:disk:e8b2b752-21ca-4cb9-80f6-a55ef1a81eec"
    name="diskName"
    size="100000"
    status="0"
    type="application/vnd.vmware.vcloud.disk+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/vdc/afaafb99-228c-4838-ad07-5bf3aa649d42"
        rel="up"
        type="application/vnd.vmware.vcloud.vdc+xml"/>
    <Link
        href="https://vcloud.example.com/api/disk/e8b2b752-21ca-4cb9-80f6-a55ef1a81eec"
        rel="remove"/>
    <Link
        href="https://vcloud.example.com/api/disk/e8b2b752-21ca-4cb9-80f6-a55ef1a81eec"
        rel="edit"
        type="application/vnd.vmware.vcloud.disk+xml"/>
    <Link
        href="https://vcloud.example.com/api/disk/e8b2b752-21ca-4cb9-80f6-a55ef1a81eec/owner"
        rel="down"
        type="application/vnd.vmware.vcloud.owner+xml"/>
    <Link
        href="https://vcloud.example.com/api/disk/e8b2b752-21ca-4cb9-80f6-a55ef1a81eec/attachedVms"
        rel="down"
        type="application/vnd.vmware.vcloud.vms+xml"/>
    <Link
        href="https://vcloud.example.com/api/disk/e8b2b752-21ca-4cb9-80f6-a55ef1a81eec/metadata"
        rel="down"
        type="application/vnd.vmware.vcloud.metadata+xml"/>
    <Description>Description for this disk</Description>
    <Tasks>
        <Task
            cancelRequested="false"
            expiryTime="2013-05-15T13:25:38.688+03:00"
            href="https://vcloud.example.com/api/task/e7ed89e7-0406-43b8-b098-ee0ec3cdce04"
            id="urn:vcloud:task:e7ed89e7-0406-43b8-b098-ee0ec3cdce04"
            name="task"
            operation="Creating Disk diskName(e8b2b752-21ca-4cb9-80f6-a55ef1a81eec)"
            operationName="vdcCreateDisk"
            serviceNamespace="com.vmware.vcloud"
            startTime="2013-02-14T13:25:38.688+02:00"
            status="running"
            type="application/vnd.vmware.vcloud.task+xml">
            <Link
                href="https://vcloud.example.com/api/task/e7ed89e7-0406-43b8-b098-ee0ec3cdce04/action/cancel"
                rel="task:cancel"/>
            <Owner
                href="https://vcloud.example.com/api/disk/e8b2b752-21ca-4cb9-80f6-a55ef1a81eec"
                name="diskName"
                type="application/vnd.vmware.vcloud.disk+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/7b832bc5-3d65-45a2-8d35-da28388ab80a"
                name="Default"
                type="application/vnd.vmware.vcloud.org+xml"/>
            <Details/>
        </Task>
    </Tasks>
    <StorageProfile
        href="https://vcloud.example.com/api/vdcStorageProfile/b520e879-71de-4d47-b2e1-e092aab97f61"
        name="*"
        type="application/vnd.vmware.vcloud.vdcStorageProfile+xml"/>
    <Owner
        type="application/vnd.vmware.vcloud.owner+xml">
        <User
            href="https://vcloud.example.com/api/admin/user/51e86769-9e2d-4edc-af4e-5d3606494cbf"
            name="system"
            type="application/vnd.vmware.admin.user+xml"/>
    </Owner>
</Disk>