Eksporter (0) Skriv ut
Vis alt
EN
Dette innholdet er ikke tilgjengelig på ditt språk, men her er den engelske versjonen.

Update Disk

Updated: December 1, 2014

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.

 

Method Request URI

PUT

https://management.core.windows.net/<subscription-id>/services/disks/<disk-name>

You must make sure that the request that is made to the management service is secure. For additional details, see Authenticating Service Management Requests.

The following table describes the request headers.

 

Request Header Description

x-ms-version

Required. Specifies the version of the operation to use for this request. This header should be set to 2012-03-01 or higher. For more information about versioning headers, see Service Management Versioning.

    
<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.

 

Element name Description

Name

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.

Label

Optional. Specifies the label of the disk that is to be updated.

ResizedSizeInGB

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. For information about status codes, see Service Management Status and Error Codes.

The response for this operation includes the following headers. The response may also include additional standard HTTP headers. All standard headers conform to the HTTP/1.1 protocol specification.

 

Response Header Description

x-ms-request-id

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, the Disk must not be attached to a running VM. This means that either the Disk should not be attached to a VM or the VM must be in Stopped (Deallocated) state.

Due to various reasons, the disk resize may fail and sometimes the blob may be in an inconsistent state. In this case, when one attempts to start the VM with such a disk or create a new VM with it, you may get an error that the disk is in a bad state. In such a case retry Update Disk to resize the Disk to the same or larger value to recover the Disk.

Vis:
© 2014 Microsoft