com.amazonaws.services.ebs

Interface AmazonEBSAsync

All Superinterfaces:

AmazonEBS

All Known Implementing Classes:

AbstractAmazonEBSAsync, AmazonEBSAsyncClient

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public interface AmazonEBSAsync
extends AmazonEBS

Interface for accessing Amazon EBS asynchronously. Each asynchronous method will return a Java Future object representing the asynchronous operation; overloads which accept an AsyncHandler can be used to receive notification when an asynchronous operation completes.

Note: Do not directly implement this interface, new methods are added to it regularly. Extend from AbstractAmazonEBSAsync instead.

You can use the Amazon Elastic Block Store (EBS) direct APIs to directly read the data on your EBS snapshots, and identify the difference between two snapshots. You can view the details of blocks in an EBS snapshot, compare the block difference between two snapshots, and directly access the data in a snapshot. If you're an independent software vendor (ISV) who offers backup services for EBS, the EBS direct APIs make it easier and more cost-effective to track incremental changes on your EBS volumes via EBS snapshots. This can be done without having to create new volumes from EBS snapshots.

This API reference provides detailed information about the actions, data types, parameters, and errors of the EBS direct APIs. For more information about the elements that make up the EBS direct APIs, and examples of how to use them effectively, see Accessing the Contents of an EBS Snapshot in the Amazon Elastic Compute Cloud User Guide. For more information about the supported AWS Regions, endpoints, and service quotas for the EBS direct APIs, see Amazon Elastic Block Store Endpoints and Quotas in the AWS General Reference.

Field Summary

Fields inherited from interface com.amazonaws.services.ebs.AmazonEBS

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
Future<CompleteSnapshotResult>	completeSnapshotAsync(CompleteSnapshotRequest completeSnapshotRequest) Seals and completes the snapshot after all of the required blocks of data have been written to it.
Future<CompleteSnapshotResult>	completeSnapshotAsync(CompleteSnapshotRequest completeSnapshotRequest, AsyncHandler<CompleteSnapshotRequest,CompleteSnapshotResult> asyncHandler) Seals and completes the snapshot after all of the required blocks of data have been written to it.
Future<GetSnapshotBlockResult>	getSnapshotBlockAsync(GetSnapshotBlockRequest getSnapshotBlockRequest) Returns the data in a block in an Amazon Elastic Block Store snapshot.
Future<GetSnapshotBlockResult>	getSnapshotBlockAsync(GetSnapshotBlockRequest getSnapshotBlockRequest, AsyncHandler<GetSnapshotBlockRequest,GetSnapshotBlockResult> asyncHandler) Returns the data in a block in an Amazon Elastic Block Store snapshot.
Future<ListChangedBlocksResult>	listChangedBlocksAsync(ListChangedBlocksRequest listChangedBlocksRequest) Returns the block indexes and block tokens for blocks that are different between two Amazon Elastic Block Store snapshots of the same volume/snapshot lineage.
Future<ListChangedBlocksResult>	listChangedBlocksAsync(ListChangedBlocksRequest listChangedBlocksRequest, AsyncHandler<ListChangedBlocksRequest,ListChangedBlocksResult> asyncHandler) Returns the block indexes and block tokens for blocks that are different between two Amazon Elastic Block Store snapshots of the same volume/snapshot lineage.
Future<ListSnapshotBlocksResult>	listSnapshotBlocksAsync(ListSnapshotBlocksRequest listSnapshotBlocksRequest) Returns the block indexes and block tokens for blocks in an Amazon Elastic Block Store snapshot.
Future<ListSnapshotBlocksResult>	listSnapshotBlocksAsync(ListSnapshotBlocksRequest listSnapshotBlocksRequest, AsyncHandler<ListSnapshotBlocksRequest,ListSnapshotBlocksResult> asyncHandler) Returns the block indexes and block tokens for blocks in an Amazon Elastic Block Store snapshot.
Future<PutSnapshotBlockResult>	putSnapshotBlockAsync(PutSnapshotBlockRequest putSnapshotBlockRequest) Writes a block of data to a block in the snapshot.
Future<PutSnapshotBlockResult>	putSnapshotBlockAsync(PutSnapshotBlockRequest putSnapshotBlockRequest, AsyncHandler<PutSnapshotBlockRequest,PutSnapshotBlockResult> asyncHandler) Writes a block of data to a block in the snapshot.
Future<StartSnapshotResult>	startSnapshotAsync(StartSnapshotRequest startSnapshotRequest) Creates a new Amazon EBS snapshot.
Future<StartSnapshotResult>	startSnapshotAsync(StartSnapshotRequest startSnapshotRequest, AsyncHandler<StartSnapshotRequest,StartSnapshotResult> asyncHandler) Creates a new Amazon EBS snapshot.

Methods inherited from interface com.amazonaws.services.ebs.AmazonEBS

completeSnapshot, getCachedResponseMetadata, getSnapshotBlock, listChangedBlocks, listSnapshotBlocks, putSnapshotBlock, shutdown, startSnapshot

Method Detail

completeSnapshotAsync

Future<CompleteSnapshotResult> completeSnapshotAsync(CompleteSnapshotRequest completeSnapshotRequest)

Seals and completes the snapshot after all of the required blocks of data have been written to it. Completing the snapshot changes the status to completed. You cannot write new blocks to a snapshot after it has been completed.

Parameters:

completeSnapshotRequest -

Returns:

A Java Future containing the result of the CompleteSnapshot operation returned by the service.

See Also:

AWS API Documentation

completeSnapshotAsync

Future<CompleteSnapshotResult> completeSnapshotAsync(CompleteSnapshotRequest completeSnapshotRequest,
                                                     AsyncHandler<CompleteSnapshotRequest,CompleteSnapshotResult> asyncHandler)

Seals and completes the snapshot after all of the required blocks of data have been written to it. Completing the snapshot changes the status to completed. You cannot write new blocks to a snapshot after it has been completed.

Parameters:

completeSnapshotRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the CompleteSnapshot operation returned by the service.

See Also:

AWS API Documentation

getSnapshotBlockAsync

Future<GetSnapshotBlockResult> getSnapshotBlockAsync(GetSnapshotBlockRequest getSnapshotBlockRequest)

Returns the data in a block in an Amazon Elastic Block Store snapshot.

Parameters:

getSnapshotBlockRequest -

Returns:

A Java Future containing the result of the GetSnapshotBlock operation returned by the service.

See Also:

AWS API Documentation

getSnapshotBlockAsync

Future<GetSnapshotBlockResult> getSnapshotBlockAsync(GetSnapshotBlockRequest getSnapshotBlockRequest,
                                                     AsyncHandler<GetSnapshotBlockRequest,GetSnapshotBlockResult> asyncHandler)

Returns the data in a block in an Amazon Elastic Block Store snapshot.

Parameters:

getSnapshotBlockRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the GetSnapshotBlock operation returned by the service.

See Also:

AWS API Documentation

listChangedBlocksAsync

Future<ListChangedBlocksResult> listChangedBlocksAsync(ListChangedBlocksRequest listChangedBlocksRequest)

Returns the block indexes and block tokens for blocks that are different between two Amazon Elastic Block Store snapshots of the same volume/snapshot lineage.

Parameters:

listChangedBlocksRequest -

Returns:

A Java Future containing the result of the ListChangedBlocks operation returned by the service.

See Also:

AWS API Documentation

listChangedBlocksAsync

Future<ListChangedBlocksResult> listChangedBlocksAsync(ListChangedBlocksRequest listChangedBlocksRequest,
                                                       AsyncHandler<ListChangedBlocksRequest,ListChangedBlocksResult> asyncHandler)

Returns the block indexes and block tokens for blocks that are different between two Amazon Elastic Block Store snapshots of the same volume/snapshot lineage.

Parameters:

listChangedBlocksRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the ListChangedBlocks operation returned by the service.

See Also:

AWS API Documentation

listSnapshotBlocksAsync

Future<ListSnapshotBlocksResult> listSnapshotBlocksAsync(ListSnapshotBlocksRequest listSnapshotBlocksRequest)

Returns the block indexes and block tokens for blocks in an Amazon Elastic Block Store snapshot.

Parameters:

listSnapshotBlocksRequest -

Returns:

A Java Future containing the result of the ListSnapshotBlocks operation returned by the service.

See Also:

AWS API Documentation

listSnapshotBlocksAsync

Future<ListSnapshotBlocksResult> listSnapshotBlocksAsync(ListSnapshotBlocksRequest listSnapshotBlocksRequest,
                                                         AsyncHandler<ListSnapshotBlocksRequest,ListSnapshotBlocksResult> asyncHandler)

Returns the block indexes and block tokens for blocks in an Amazon Elastic Block Store snapshot.

Parameters:

listSnapshotBlocksRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the ListSnapshotBlocks operation returned by the service.

See Also:

AWS API Documentation

putSnapshotBlockAsync

Future<PutSnapshotBlockResult> putSnapshotBlockAsync(PutSnapshotBlockRequest putSnapshotBlockRequest)

Writes a block of data to a block in the snapshot. If the specified block contains data, the existing data is overwritten. The target snapshot must be in the pending state.

Data written to a snapshot must be aligned with 512-byte sectors.

Parameters:

putSnapshotBlockRequest -

Returns:

A Java Future containing the result of the PutSnapshotBlock operation returned by the service.

See Also:

AWS API Documentation

putSnapshotBlockAsync

Future<PutSnapshotBlockResult> putSnapshotBlockAsync(PutSnapshotBlockRequest putSnapshotBlockRequest,
                                                     AsyncHandler<PutSnapshotBlockRequest,PutSnapshotBlockResult> asyncHandler)

Writes a block of data to a block in the snapshot. If the specified block contains data, the existing data is overwritten. The target snapshot must be in the pending state.

Data written to a snapshot must be aligned with 512-byte sectors.

Parameters:

putSnapshotBlockRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the PutSnapshotBlock operation returned by the service.

See Also:

AWS API Documentation

startSnapshotAsync

Future<StartSnapshotResult> startSnapshotAsync(StartSnapshotRequest startSnapshotRequest)

Creates a new Amazon EBS snapshot. The new snapshot enters the pending state after the request completes.

After creating the snapshot, use PutSnapshotBlock to write blocks of data to the snapshot.

Parameters:

startSnapshotRequest -

Returns:

A Java Future containing the result of the StartSnapshot operation returned by the service.

See Also:

AWS API Documentation

startSnapshotAsync

Future<StartSnapshotResult> startSnapshotAsync(StartSnapshotRequest startSnapshotRequest,
                                               AsyncHandler<StartSnapshotRequest,StartSnapshotResult> asyncHandler)

Creates a new Amazon EBS snapshot. The new snapshot enters the pending state after the request completes.

After creating the snapshot, use PutSnapshotBlock to write blocks of data to the snapshot.

Parameters:

startSnapshotRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the StartSnapshot operation returned by the service.

See Also:

AWS API Documentation