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

ModifySnapshotAttribute

Description

Adds or remove permission settings for the specified snapshot.

Request Parameters

NameDescriptionRequired

SnapshotId

The ID of the snapshot.

Type: String

Default: None

Yes

CreateVolumePermission.Add.n.UserId

Adds the specified AWS account ID to the volume's list of create volume permissions.

Type: String

Default: None

Yes

CreateVolumePermission.Add.n.Group

Adds the specified group to the volume's list of create volume permissions. The only valid value is all.

Type: String

Default: None

Yes

CreateVolumePermission.Remove.n.UserId

Removes the specified AWS account ID from the volume's list of create volume pernissions.

Type: String

Default: None

No

CreateVolumePermission.Remove.n.Group

Removes the specified group from the volume's list of create volume permissions.

Type: String

Default: None

No

Response Elements

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

NameDescription

requestId

The ID of the request.

Type: xsd:string

return

Returns true if successful. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example makes the snap-78a54011 snapshot public, and gives the account with ID 111122223333 permission to create volumes from the snapshot.

https://ec2.amazonaws.com/?Action=ModifySnapshotAttribute
&snapshotId=snap-78a54011
&CreateVolumePermission.Add.1.UserId=111122223333
&CreateVolumePermission.Add.1.Group=all
&AUTHPARAMS

This example makes the snap-78a54011 snapshot public, and removes the account with ID 111122223333 from the list of users with permission to create volumes from the snapshot.

https://ec2.amazonaws.com/?Action=ModifySnapshotAttribute
&snapshotId=snap-78a54011
&CreateVolumePermission.Remove.1.UserId=111122223333
&CreateVolumePermission.Add.1.Group=all
&AUTHPARAMS

Example Response

<ModifySnapshotAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2011-12-15/">
   <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
   <return>true</return>
</ModifySnapshotAttributeResponse>