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

DescribeVolumeAttribute

Description

Describes an attribute of a volume. You can specify only one attribute at a time.

Currently, volumes have two attributes, autoEnableIO and productCodes.

Request Parameters

VolumeId

The ID of the volume.

Type: String

Default: None

Required: Yes

Attribute

The instance attribute.

Type: String

Default: None

Valid values: autoEnableIO | productCodes

Required: Yes

Response Elements

The following elements are returned in a DescribeVolumeAttributeResponse element.

requestId

The ID of the request.

Type: xsd:string

volumeId

The ID of the volume.

Type: xsd:string

autoEnableIO

The state of autoEnableIO attribute.

Type: NullableAttributeBooleanValueType

productCodes

A list of product codes. Each product code is wrapped in an item element that contains a product code and a type.

Type: ProductCodesSetItemType

Example

Example Request

This example describes the autoEnableIO attribute of the volume vol-12345678.

https://ec2.amazonaws.com/?Action=DescribeVolumeAttribute
&Attribute=autoEnableIO
&VolumeId=vol-12345678
&AUTHPARAMS

Example Response

<DescribeVolumeAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
  <requestId>5jkdf074-37ed-4004-8671-a78ee82bf1cbEXAMPLE</requestId> 
  <volumeId>vol-12345678</volumeId>
  <autoEnableIO>
    <value>false</value>
  </autoEnableIO>
</DescribeVolumeAttributeResponse>

Example Request

This example describes the productCodes attribute of the volume vol-12345678.

https://ec2.amazonaws.com/?Action=DescribeVolumeAttribute
&Attribute=productCodes
&VolumeId=vol-12345678
&AUTHPARAMS

Example Response

<DescribeVolumeAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
  <requestId>5jkdf074-37ed-4004-8671-a78ee82bf1cbEXAMPLE</requestId> 
  <volumeId>vol-12345678</volumeId>
  <productCodes>
      <item>
          <productCode>a1b2c3d4e5f6g7h8i9j10k11</productCode>
          <type>marketplace</type>
        </item>
  </productCodes>
</DescribeVolumeAttributeResponse>