VMware Cloud Director API - PUT-Disk
PUT /disk/{id}
- Operation:
- PUT /disk/{id}
- Description:
- Update the name, description, iops, size and storage class of a disk. Beginning in 37.0, we have deprecated the 'iops' field of {@link DiskType} and introduced a new type representing IOPS metrics: {@link IopsResourceType}. NOTE that while the original 'iops' field still exists (which represents IOPS reservation), if both the old field and reservation in {@link IopsResourceType} are set, VCD will favor the IOPS reservation value within the new {@link IopsResourceType}.
- Since:
- 5.1
- Input parameters
-
- Consume media type(s):
-
application/vnd.vmware.vcloud.disk+xml
application/vnd.vmware.vcloud.disk+json
- Input type:
- DiskType
- Output parameters
-
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
-
- Request
-
HTTP 1.1
PUT /api/disk/e8b2b752-21ca-4cb9-80f6-a55ef1a81eec
Headers:
Content-Length: 216
Content-Type: application/vnd.vmware.vcloud.disk+xml; charset=ISO-8859-1
x-vcloud-authorization: eVBkZn2wahPAU+IvbURo7ekslpuoHERMB2DZEFlJuHs=
Body:
<?xml version="1.0" encoding="UTF-8"?><vcloud:Disk
xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
name="diskNewName"
size="10000000">
<vcloud:Description>newDiskDescription</vcloud:Description>
</vcloud:Disk>
- Response
-
HTTP/1.1 202 Accepted
Headers:
Content-Length: 1319
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.5
Location: https://vcloud.example.com/api/task/e6635202-aaff-41b8-a02b-a5aea8e00805
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-15T13:26:09.274+03:00"
href="https://vcloud.example.com/api/task/e6635202-aaff-41b8-a02b-a5aea8e00805"
id="urn:vcloud:task:e6635202-aaff-41b8-a02b-a5aea8e00805"
name="task"
operation="Updating Disk diskName(e8b2b752-21ca-4cb9-80f6-a55ef1a81eec)"
operationName="vdcUpdateDisk"
serviceNamespace="com.vmware.vcloud"
startTime="2013-02-14T13:26:09.274+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/e6635202-aaff-41b8-a02b-a5aea8e00805/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>