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

ModifySnapshotAttribute

Description

Adds or remove permission settings for the specified snapshot.

Note

Snapshots with AWS Marketplace product codes cannot be made public.

Request Parameters

SnapshotId

The ID of the snapshot.

Type: String

Default: None

Required: Yes

CreateVolumePermission.Add.n.UserId

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

Type: String

Default: None

Required: 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

Required: Yes

CreateVolumePermission.Remove.n.UserId

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

Type: String

Default: None

Required: No

CreateVolumePermission.Remove.n.Group

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

Type: String

Default: None

Required: No

Response Elements

The following elements are returned in a ModifySnapshotAttributeResponse 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 makes the snap-1a2b3c4d snapshot public, and gives the account with ID 111122223333 permission to create volumes from the snapshot.

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

This example makes the snap-1a2b3c4d 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-1a2b3c4d
&CreateVolumePermission.Remove.1.UserId=111122223333
&CreateVolumePermission.Add.1.Group=all
&AUTHPARAMS

Example Response

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