Did this page help you?

   Yes   No   Tell us about it...

com.amazonaws.services.storagegateway.model
Class CreateSnapshotRequest

java.lang.Object
  extended by com.amazonaws.AmazonWebServiceRequest
      extended by com.amazonaws.services.storagegateway.model.CreateSnapshotRequest
All Implemented Interfaces:
Serializable

public class CreateSnapshotRequest
extends AmazonWebServiceRequest
implements Serializable

Container for the parameters to the CreateSnapshot operation.

This operation initiates a snapshot of a volume.

AWS Storage Gateway provides the ability to back up point-in-time snapshots of your data to Amazon Simple Storage (S3) for durable off-site recovery, as well as import the data to an Amazon Elastic Block Store (EBS) volume in Amazon Elastic Compute Cloud (EC2). You can take snapshots of your gateway volume on a scheduled or ad-hoc basis. This API enables you to take ad-hoc snapshot. For more information, see Working With Snapshots in the AWS Storage Gateway Console.

In the CreateSnapshot request you identify the volume by providing its Amazon Resource Name (ARN). You must also provide description for the snapshot. When AWS Storage Gateway takes the snapshot of specified volume, the snapshot and description appears in the AWS Storage Gateway Console. In response, AWS Storage Gateway returns you a snapshot ID. You can use this snapshot ID to check the snapshot progress or later use it when you want to create a volume from a snapshot.

NOTE:To list or delete a snapshot, you must use the Amazon EC2 API. For more information, go to DeleteSnapshot and DescribeSnapshots in the Amazon Elastic Compute Cloud API Reference.

See Also:
AWSStorageGateway.createSnapshot(CreateSnapshotRequest), Serialized Form

Constructor Summary
CreateSnapshotRequest()
           
 
Method Summary
 boolean equals(Object obj)
           
 String getSnapshotDescription()
          Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field
 String getVolumeARN()
          The Amazon Resource Name (ARN) of the volume.
 int hashCode()
           
 void setSnapshotDescription(String snapshotDescription)
          Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field
 void setVolumeARN(String volumeARN)
          The Amazon Resource Name (ARN) of the volume.
 String toString()
          Returns a string representation of this object; useful for testing and debugging.
 CreateSnapshotRequest withSnapshotDescription(String snapshotDescription)
          Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field
 CreateSnapshotRequest withVolumeARN(String volumeARN)
          The Amazon Resource Name (ARN) of the volume.
 
Methods inherited from class com.amazonaws.AmazonWebServiceRequest
copyPrivateRequestParameters, getRequestClientOptions, getRequestCredentials, setRequestCredentials
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

CreateSnapshotRequest

public CreateSnapshotRequest()
Method Detail

getVolumeARN

public String getVolumeARN()
The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.

Constraints:
Length: 50 - 500

Returns:
The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.

setVolumeARN

public void setVolumeARN(String volumeARN)
The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.

Constraints:
Length: 50 - 500

Parameters:
volumeARN - The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.

withVolumeARN

public CreateSnapshotRequest withVolumeARN(String volumeARN)
The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.

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

Constraints:
Length: 50 - 500

Parameters:
volumeARN - The Amazon Resource Name (ARN) of the volume. Use the ListVolumes operation to return a list of gateway volumes.
Returns:
A reference to this updated object so that method calls can be chained together.

getSnapshotDescription

public String getSnapshotDescription()
Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field

Constraints:
Length: 1 - 255

Returns:
Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field

setSnapshotDescription

public void setSnapshotDescription(String snapshotDescription)
Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field

Constraints:
Length: 1 - 255

Parameters:
snapshotDescription - Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field

withSnapshotDescription

public CreateSnapshotRequest withSnapshotDescription(String snapshotDescription)
Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field

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

Constraints:
Length: 1 - 255

Parameters:
snapshotDescription - Textual description of the snapshot that appears in the Amazon EC2 console, Elastic Block Store snapshots panel in the Description field, and in the AWS Storage Gateway snapshot Details pane, Description field
Returns:
A reference to this updated object so that method calls can be chained together.

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


Copyright © 2010 Amazon Web Services, Inc. All Rights Reserved.