Amazon Elastic Compute Cloud
API Reference (API Version 2011-12-15)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

DescribeSnapshotAttribute

Description

Returns information about an attribute of a snapshot. You can get information about only one attribute per call. Currently the only attribute you can get describes who has permission to create a volume from the snapshot.

Request Parameters

NameDescriptionRequired

SnapshotId

The ID of the Amazon EBS snapshot.

Type: String

Default: None

Yes

Attribute

The attribute to get.

Type: String

Default: None

Valid Value: createVolumePermission

Yes

Response Elements

The elements in the following table are wrapped in a DescribeSnapshotAttributeResponse structure.

NameDescription

requestId

The ID of the request.

Type: xsd:string

snapshotId

The ID of the Amazon EBS snapshot.

Type: xsd:string

createVolumePermission

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

Type: CreateVolumePermissionItemType

Examples

Example Request

This example describes permissions for the snap-78a54011 snapshot.

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

Example Response

<DescribeSnapshotAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2011-12-15/">
   <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
   <snapshotId>snap-78a54011</snapshotId>
   <createVolumePermission>
      <item>
         <group>all</group>
      </item>
   </createVolumePermission>
</DescribeSnapshotAttributeResponse>