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

DescribeSnapshotAttribute

Description

Describes an attribute of the specified snapshot. You can specify only one attribute at a time.

Request Parameters

SnapshotId

The ID of the Amazon EBS snapshot.

Type: String

Default: None

Required: Yes

Attribute

The snapshot attribute.

Type: String

Default: None

Valid values: createVolumePermission | productCodes

Required: Yes

Response Elements

The following elements are returned in a DescribeSnapshotAttributeResponse element.

requestId

The ID of the request.

Type: xsd:string

snapshotId

The ID of the Amazon EBS snapshot.

Type: xsd:string

createVolumePermission

A list of permissions for creating volumes from the snapshot. Each permission is wrapped in an item element.

Type: CreateVolumePermissionItemType

productCodes

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

Type: ProductCodesSetItemType

Examples

Example Request

This example describes permissions for the snap-1a2b3c4d snapshot.

https://ec2.amazonaws.com/?Action=DescribeSnapshotAttribute
&SnapshotId=snap-1a2b3c4d
&Attribute=createVolumePermission
&AUTHPARAMS

Example Response

<DescribeSnapshotAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
   <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
   <snapshotId>snap-1a2b3c4d</snapshotId>
   <createVolumePermission>
      <item>
         <group>all</group>
      </item>
   </createVolumePermission>
</DescribeSnapshotAttributeResponse>

Example Request

This example describes product codes associated with the snap-1a2b3c4d snapshot.

https://ec2.amazonaws.com/?Action=DescribeSnapshotAttribute
&SnapshotId=snap-1a2b3c4d
&Attribute=productCodes
&AUTHPARAMS

Example Response

<DescribeSnapshotAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
   <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
   <snapshotId>snap-1a2b3c4d</snapshotId>
   <productCodes>
      <item>
        <productCode>a1b2c3d4e5f6g7h8i9j10k11</productCode>
        <type>marketplace</type>
      </item>
    </productCodes>
</DescribeSnapshotAttributeResponse>