Amazon Elastic Compute Cloud
API Reference (API Version 2013-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

ModifyVolumeAttribute

Description

Modifies a volume attribute.

By default, all I/O operations for the volume are suspended when the data on the volume is determined to be potentially inconsistent, to prevent undetectable, latent data corruption. The I/O access to the volume can be resumed by first calling EnableVolumeIO action to enable I/O access and then checking the data consistency on your volume.

You can change the default behavior to resume I/O operations without calling EnableVolumeIO action by setting the AutoEnableIO attribute of the volume to true. We recommend that you change this attribute only for volumes that are stateless, or disposable, or for boot volumes.

Request Parameters

VolumeId

The ID of the volume.

Type: String

Default: None

Required: Yes

AutoEnableIO.Value

This attribute exists to auto-enable the I/O operations to the volume.

Type: Boolean

Default: false

Required: Yes

Response Elements

The following elements are returned in a ModifyVolumeAttributeResponse element.

requestId

The ID of the request.

Type: xsd:string

return

Returns true if the request succeeds. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example modifies the attribute of the volume vol-12345678

https://ec2.amazonaws.com/?Action=ModifyVolumeAttribute
&VolumeId=vol-12345678
&AutoEnableIO.Value=true
&AUTHPARAMS

Example Response

<ModifyVolumeAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
   <requestId>5jkdf074-37ed-4004-8671-a78ee82bf1cbEXAMPLE</requestId> 
   <return>true</return>
</ModifyVolumeAttributeResponse>