com.amazonaws.services.ec2.model

Class CreateSnapshotRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.ec2.model.CreateSnapshotRequest

All Implemented Interfaces:

DryRunSupportedRequest<CreateSnapshotRequest>, Serializable

public class CreateSnapshotRequest
extends AmazonWebServiceRequest
implements Serializable, DryRunSupportedRequest<CreateSnapshotRequest>

Container for the parameters to the CreateSnapshot operation.

Creates a snapshot of an Amazon EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of Amazon EBS volumes, and to save data before shutting down an instance.

When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your Amazon EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file writes to the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending .

To create a snapshot for Amazon EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide .

See Also:

AmazonEC2.createSnapshot(CreateSnapshotRequest), Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
CreateSnapshotRequest() Default constructor for a new CreateSnapshotRequest object.
CreateSnapshotRequest(String volumeId, String description) Constructs a new CreateSnapshotRequest object.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj)
String	getDescription() A description for the snapshot.
Request<CreateSnapshotRequest>	getDryRunRequest() This method is intended for internal use only.
String	getVolumeId() The ID of the Amazon EBS volume.
int	hashCode()
void	setDescription(String description) A description for the snapshot.
void	setVolumeId(String volumeId) The ID of the Amazon EBS volume.
String	toString() Returns a string representation of this object; useful for testing and debugging.
CreateSnapshotRequest	withDescription(String description) A description for the snapshot.
CreateSnapshotRequest	withVolumeId(String volumeId) The ID of the Amazon EBS volume.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

copyPrivateRequestParameters, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CreateSnapshotRequest

public CreateSnapshotRequest()

Default constructor for a new CreateSnapshotRequest object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.

CreateSnapshotRequest

public CreateSnapshotRequest(String volumeId,
                     String description)

Constructs a new CreateSnapshotRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:

volumeId - The ID of the Amazon EBS volume.

description - A description for the snapshot.

Method Detail

getVolumeId

public String getVolumeId()

The ID of the Amazon EBS volume.

Returns:

The ID of the Amazon EBS volume.

setVolumeId

public void setVolumeId(String volumeId)

The ID of the Amazon EBS volume.

Parameters:

volumeId - The ID of the Amazon EBS volume.

withVolumeId

public CreateSnapshotRequest withVolumeId(String volumeId)

The ID of the Amazon EBS volume.

Returns a reference to this object so that method calls can be chained together.

Parameters:

volumeId - The ID of the Amazon EBS volume.

Returns:

A reference to this updated object so that method calls can be chained together.

getDescription

public String getDescription()

A description for the snapshot.

Returns:

A description for the snapshot.

setDescription

public void setDescription(String description)

A description for the snapshot.

Parameters:

description - A description for the snapshot.

withDescription

public CreateSnapshotRequest withDescription(String description)

A description for the snapshot.

Returns a reference to this object so that method calls can be chained together.

Parameters:

description - A description for the snapshot.

Returns:

A reference to this updated object so that method calls can be chained together.

getDryRunRequest

public Request<CreateSnapshotRequest> getDryRunRequest()

This method is intended for internal use only. Returns the marshaled request configured with additional parameters to enable operation dry-run.

Specified by:

getDryRunRequest in interface DryRunSupportedRequest<CreateSnapshotRequest>

toString

public String toString()

Returns a string representation of this object; useful for testing and debugging.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object