Updated: July 10, 2015
The Update Disk operation updates the label of an existing disk in the image repository that is associated with the specified subscription.
The Update Disk request may be specified as follows. Replace <subscription-id> with the subscription ID and <disk-name> with the name of the disk being updated.
The following table describes the request headers.
Required. Specifies the version of the operation to use for this request. This header should be set to 2012-03-01 or higher.
<Disk xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <Name>name-of-disk</Name> <Label>description-of-disk</Label> <ResizedSizeInGB>resized-size-in-GB</ResizedSizeInGB> </Disk>
The following table describes the elements of the request body.
Required. Specifies the name of the disk to update. This element is only used to identify the disk for which the label should be updated and cannot be changed.
Optional. Specifies the label of the disk that is to be updated.
Optional. Resizes the underlying blob to the indicated size in GB.
To use the ResizedSizeInGB property, the version header should be at least 2014-10-01.
The response includes an HTTP status code and a set of response headers.
If ResizedSizeInGB is not used, then the API completes synchronously and returns HTTP 200 (OK) if successful. If ResizedSizeInGB is specified, the API returns HTTP 202 (Accepted) and executes asynchronously. Then one must poll on the status of the API using Get Operation Status.
The response for this operation includes the following headers. The response may also include additional standard HTTP headers.
A value that uniquely identifies a request made against the management service.
The updated Disk as XML.
Disks can only be resized to a larger size, they cannot be shrunk. The size in GB cannot include decimals.
To resize a disk, it must not be attached to a running VM. You can stop the machine without detaching the disk.
An error may occur if the disk cannot be resized. Retry the update operation with the same or larger value to recover the disk.