@Generated(value="software.amazon.awssdk:codegen") @ThreadSafe public interface EbsClient extends SdkClient
builder() method.
You can use the Amazon Elastic Block Store (Amazon EBS) direct APIs to create Amazon EBS snapshots, write data directly to your snapshots, read data on your snapshots, and identify the differences or changes between two snapshots. If you’re an independent software vendor (ISV) who offers backup services for Amazon EBS, the EBS direct APIs make it more efficient and cost-effective to track incremental changes on your Amazon EBS volumes through snapshots. This can be done without having to create new volumes from snapshots, and then use Amazon Elastic Compute Cloud (Amazon EC2) instances to compare the differences.
You can create incremental snapshots directly from data on-premises into volumes and the cloud to use for quick disaster recovery. With the ability to write and read snapshots, you can write your on-premises data to an snapshot during a disaster. Then after recovery, you can restore it back to Amazon Web Services or on-premises from the snapshot. You no longer need to build and maintain complex mechanisms to copy data to and from Amazon EBS.
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 Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide. For more information about the supported Amazon Web Services Regions, endpoints, and service quotas for the EBS direct APIs, see Amazon Elastic Block Store Endpoints and Quotas in the Amazon Web Services General Reference.
| Modifier and Type | Field and Description |
|---|---|
static String |
SERVICE_METADATA_ID
Value for looking up the service's metadata from the
ServiceMetadataProvider. |
static String |
SERVICE_NAME |
| Modifier and Type | Method and Description |
|---|---|
static EbsClientBuilder |
builder()
Create a builder that can be used to configure and create a
EbsClient. |
default CompleteSnapshotResponse |
completeSnapshot(CompleteSnapshotRequest completeSnapshotRequest)
Seals and completes the snapshot after all of the required blocks of data have been written to it.
|
default CompleteSnapshotResponse |
completeSnapshot(Consumer<CompleteSnapshotRequest.Builder> completeSnapshotRequest)
Seals and completes the snapshot after all of the required blocks of data have been written to it.
|
static EbsClient |
create()
Create a
EbsClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider. |
default ResponseInputStream<GetSnapshotBlockResponse> |
getSnapshotBlock(Consumer<GetSnapshotBlockRequest.Builder> getSnapshotBlockRequest)
Returns the data in a block in an Amazon Elastic Block Store snapshot.
|
default GetSnapshotBlockResponse |
getSnapshotBlock(Consumer<GetSnapshotBlockRequest.Builder> getSnapshotBlockRequest,
Path destinationPath)
Returns the data in a block in an Amazon Elastic Block Store snapshot.
|
default <ReturnT> ReturnT |
getSnapshotBlock(Consumer<GetSnapshotBlockRequest.Builder> getSnapshotBlockRequest,
ResponseTransformer<GetSnapshotBlockResponse,ReturnT> responseTransformer)
Returns the data in a block in an Amazon Elastic Block Store snapshot.
|
default ResponseInputStream<GetSnapshotBlockResponse> |
getSnapshotBlock(GetSnapshotBlockRequest getSnapshotBlockRequest)
Returns the data in a block in an Amazon Elastic Block Store snapshot.
|
default GetSnapshotBlockResponse |
getSnapshotBlock(GetSnapshotBlockRequest getSnapshotBlockRequest,
Path destinationPath)
Returns the data in a block in an Amazon Elastic Block Store snapshot.
|
default <ReturnT> ReturnT |
getSnapshotBlock(GetSnapshotBlockRequest getSnapshotBlockRequest,
ResponseTransformer<GetSnapshotBlockResponse,ReturnT> responseTransformer)
Returns the data in a block in an Amazon Elastic Block Store snapshot.
|
default ResponseBytes<GetSnapshotBlockResponse> |
getSnapshotBlockAsBytes(Consumer<GetSnapshotBlockRequest.Builder> getSnapshotBlockRequest)
Returns the data in a block in an Amazon Elastic Block Store snapshot.
|
default ResponseBytes<GetSnapshotBlockResponse> |
getSnapshotBlockAsBytes(GetSnapshotBlockRequest getSnapshotBlockRequest)
Returns the data in a block in an Amazon Elastic Block Store snapshot.
|
default ListChangedBlocksResponse |
listChangedBlocks(Consumer<ListChangedBlocksRequest.Builder> listChangedBlocksRequest)
Returns information about the blocks that are different between two Amazon Elastic Block Store snapshots of the
same volume/snapshot lineage.
|
default ListChangedBlocksResponse |
listChangedBlocks(ListChangedBlocksRequest listChangedBlocksRequest)
Returns information about the blocks that are different between two Amazon Elastic Block Store snapshots of the
same volume/snapshot lineage.
|
default ListChangedBlocksIterable |
listChangedBlocksPaginator(Consumer<ListChangedBlocksRequest.Builder> listChangedBlocksRequest)
Returns information about the blocks that are different between two Amazon Elastic Block Store snapshots of the
same volume/snapshot lineage.
|
default ListChangedBlocksIterable |
listChangedBlocksPaginator(ListChangedBlocksRequest listChangedBlocksRequest)
Returns information about the blocks that are different between two Amazon Elastic Block Store snapshots of the
same volume/snapshot lineage.
|
default ListSnapshotBlocksResponse |
listSnapshotBlocks(Consumer<ListSnapshotBlocksRequest.Builder> listSnapshotBlocksRequest)
Returns information about the blocks in an Amazon Elastic Block Store snapshot.
|
default ListSnapshotBlocksResponse |
listSnapshotBlocks(ListSnapshotBlocksRequest listSnapshotBlocksRequest)
Returns information about the blocks in an Amazon Elastic Block Store snapshot.
|
default ListSnapshotBlocksIterable |
listSnapshotBlocksPaginator(Consumer<ListSnapshotBlocksRequest.Builder> listSnapshotBlocksRequest)
Returns information about the blocks in an Amazon Elastic Block Store snapshot.
|
default ListSnapshotBlocksIterable |
listSnapshotBlocksPaginator(ListSnapshotBlocksRequest listSnapshotBlocksRequest)
Returns information about the blocks in an Amazon Elastic Block Store snapshot.
|
default PutSnapshotBlockResponse |
putSnapshotBlock(Consumer<PutSnapshotBlockRequest.Builder> putSnapshotBlockRequest,
Path sourcePath)
Writes a block of data to a snapshot.
|
default PutSnapshotBlockResponse |
putSnapshotBlock(Consumer<PutSnapshotBlockRequest.Builder> putSnapshotBlockRequest,
RequestBody requestBody)
Writes a block of data to a snapshot.
|
default PutSnapshotBlockResponse |
putSnapshotBlock(PutSnapshotBlockRequest putSnapshotBlockRequest,
Path sourcePath)
Writes a block of data to a snapshot.
|
default PutSnapshotBlockResponse |
putSnapshotBlock(PutSnapshotBlockRequest putSnapshotBlockRequest,
RequestBody requestBody)
Writes a block of data to a snapshot.
|
static ServiceMetadata |
serviceMetadata() |
default StartSnapshotResponse |
startSnapshot(Consumer<StartSnapshotRequest.Builder> startSnapshotRequest)
Creates a new Amazon EBS snapshot.
|
default StartSnapshotResponse |
startSnapshot(StartSnapshotRequest startSnapshotRequest)
Creates a new Amazon EBS snapshot.
|
serviceNameclosestatic final String SERVICE_NAME
static final String SERVICE_METADATA_ID
ServiceMetadataProvider.static EbsClient create()
EbsClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider.static EbsClientBuilder builder()
EbsClient.default CompleteSnapshotResponse completeSnapshot(CompleteSnapshotRequest completeSnapshotRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
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.
completeSnapshotRequest - AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault CompleteSnapshotResponse completeSnapshot(Consumer<CompleteSnapshotRequest.Builder> completeSnapshotRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
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.
This is a convenience which creates an instance of the CompleteSnapshotRequest.Builder avoiding the need
to create one manually via CompleteSnapshotRequest.builder()
completeSnapshotRequest - A Consumer that will call methods on CompleteSnapshotRequest.Builder to create a request.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault <ReturnT> ReturnT getSnapshotBlock(GetSnapshotBlockRequest getSnapshotBlockRequest, ResponseTransformer<GetSnapshotBlockResponse,ReturnT> responseTransformer) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns the data in a block in an Amazon Elastic Block Store snapshot.
getSnapshotBlockRequest - responseTransformer - Functional interface for processing the streamed response content. The unmarshalled
GetSnapshotBlockResponse and an InputStream to the response content are provided as parameters to the
callback. The callback may return a transformed type which will be the return value of this method. See
ResponseTransformer for details on implementing this interface
and for links to pre-canned implementations for common scenarios like downloading to a file. The service
documentation for the response content is as follows '
The data content of the block.
'.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault <ReturnT> ReturnT getSnapshotBlock(Consumer<GetSnapshotBlockRequest.Builder> getSnapshotBlockRequest, ResponseTransformer<GetSnapshotBlockResponse,ReturnT> responseTransformer) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns the data in a block in an Amazon Elastic Block Store snapshot.
This is a convenience which creates an instance of the GetSnapshotBlockRequest.Builder avoiding the need
to create one manually via GetSnapshotBlockRequest.builder()
getSnapshotBlockRequest - A Consumer that will call methods on GetSnapshotBlockRequest.Builder to create a request.responseTransformer - Functional interface for processing the streamed response content. The unmarshalled
GetSnapshotBlockResponse and an InputStream to the response content are provided as parameters to the
callback. The callback may return a transformed type which will be the return value of this method. See
ResponseTransformer for details on implementing this interface
and for links to pre-canned implementations for common scenarios like downloading to a file. The service
documentation for the response content is as follows '
The data content of the block.
'.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetSnapshotBlockResponse getSnapshotBlock(GetSnapshotBlockRequest getSnapshotBlockRequest, Path destinationPath) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns the data in a block in an Amazon Elastic Block Store snapshot.
getSnapshotBlockRequest - destinationPath - Path to file that response contents will be written to. The file must not exist or this method
will throw an exception. If the file is not writable by the current user then an exception will be thrown.
The service documentation for the response content is as follows '
The data content of the block.
'.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiongetSnapshotBlock(GetSnapshotBlockRequest, ResponseTransformer),
AWS API
Documentationdefault GetSnapshotBlockResponse getSnapshotBlock(Consumer<GetSnapshotBlockRequest.Builder> getSnapshotBlockRequest, Path destinationPath) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns the data in a block in an Amazon Elastic Block Store snapshot.
This is a convenience which creates an instance of the GetSnapshotBlockRequest.Builder avoiding the need
to create one manually via GetSnapshotBlockRequest.builder()
getSnapshotBlockRequest - A Consumer that will call methods on GetSnapshotBlockRequest.Builder to create a request.destinationPath - Path to file that response contents will be written to. The file must not exist or this method
will throw an exception. If the file is not writable by the current user then an exception will be thrown.
The service documentation for the response content is as follows '
The data content of the block.
'.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiongetSnapshotBlock(GetSnapshotBlockRequest, ResponseTransformer),
AWS API
Documentationdefault ResponseInputStream<GetSnapshotBlockResponse> getSnapshotBlock(GetSnapshotBlockRequest getSnapshotBlockRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns the data in a block in an Amazon Elastic Block Store snapshot.
getSnapshotBlockRequest - ResponseInputStream containing data streamed from service. Note that this is an unmanaged
reference to the underlying HTTP connection so great care must be taken to ensure all data if fully read
from the input stream and that it is properly closed. Failure to do so may result in sub-optimal behavior
and exhausting connections in the connection pool. The unmarshalled response object can be obtained via
ResponseInputStream.response(). The service documentation for the response content is as follows
'
The data content of the block.
'.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException#getObject(getSnapshotBlock, ResponseTransformer),
AWS API
Documentationdefault ResponseInputStream<GetSnapshotBlockResponse> getSnapshotBlock(Consumer<GetSnapshotBlockRequest.Builder> getSnapshotBlockRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns the data in a block in an Amazon Elastic Block Store snapshot.
This is a convenience which creates an instance of the GetSnapshotBlockRequest.Builder avoiding the need
to create one manually via GetSnapshotBlockRequest.builder()
getSnapshotBlockRequest - A Consumer that will call methods on GetSnapshotBlockRequest.Builder to create a request.ResponseInputStream containing data streamed from service. Note that this is an unmanaged
reference to the underlying HTTP connection so great care must be taken to ensure all data if fully read
from the input stream and that it is properly closed. Failure to do so may result in sub-optimal behavior
and exhausting connections in the connection pool. The unmarshalled response object can be obtained via
ResponseInputStream.response(). The service documentation for the response content is as follows
'
The data content of the block.
'.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException#getObject(getSnapshotBlock, ResponseTransformer),
AWS API
Documentationdefault ResponseBytes<GetSnapshotBlockResponse> getSnapshotBlockAsBytes(GetSnapshotBlockRequest getSnapshotBlockRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns the data in a block in an Amazon Elastic Block Store snapshot.
getSnapshotBlockRequest - ResponseBytes that loads the data streamed from the service into memory and exposes it in
convenient in-memory representations like a byte buffer or string. The unmarshalled response object can
be obtained via ResponseBytes.response(). The service documentation for the response content is
as follows '
The data content of the block.
'.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException#getObject(getSnapshotBlock, ResponseTransformer),
AWS API
Documentationdefault ResponseBytes<GetSnapshotBlockResponse> getSnapshotBlockAsBytes(Consumer<GetSnapshotBlockRequest.Builder> getSnapshotBlockRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns the data in a block in an Amazon Elastic Block Store snapshot.
This is a convenience which creates an instance of the GetSnapshotBlockRequest.Builder avoiding the need
to create one manually via GetSnapshotBlockRequest.builder()
getSnapshotBlockRequest - A Consumer that will call methods on GetSnapshotBlockRequest.Builder to create a request.ResponseBytes that loads the data streamed from the service into memory and exposes it in
convenient in-memory representations like a byte buffer or string. The unmarshalled response object can
be obtained via ResponseBytes.response(). The service documentation for the response content is
as follows '
The data content of the block.
'.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException#getObject(getSnapshotBlock, ResponseTransformer),
AWS API
Documentationdefault ListChangedBlocksResponse listChangedBlocks(ListChangedBlocksRequest listChangedBlocksRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns information about the blocks that are different between two Amazon Elastic Block Store snapshots of the same volume/snapshot lineage.
listChangedBlocksRequest - AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListChangedBlocksResponse listChangedBlocks(Consumer<ListChangedBlocksRequest.Builder> listChangedBlocksRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns information about the blocks that are different between two Amazon Elastic Block Store snapshots of the same volume/snapshot lineage.
This is a convenience which creates an instance of the ListChangedBlocksRequest.Builder avoiding the need
to create one manually via ListChangedBlocksRequest.builder()
listChangedBlocksRequest - A Consumer that will call methods on ListChangedBlocksRequest.Builder to create a request.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListChangedBlocksIterable listChangedBlocksPaginator(ListChangedBlocksRequest listChangedBlocksRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns information about the blocks that are different between two Amazon Elastic Block Store snapshots of the same volume/snapshot lineage.
This is a variant of
listChangedBlocks(software.amazon.awssdk.services.ebs.model.ListChangedBlocksRequest) operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.ebs.paginators.ListChangedBlocksIterable responses = client.listChangedBlocksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.ebs.paginators.ListChangedBlocksIterable responses = client
.listChangedBlocksPaginator(request);
for (software.amazon.awssdk.services.ebs.model.ListChangedBlocksResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.ebs.paginators.ListChangedBlocksIterable responses = client.listChangedBlocksPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listChangedBlocks(software.amazon.awssdk.services.ebs.model.ListChangedBlocksRequest) operation.
listChangedBlocksRequest - AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListChangedBlocksIterable listChangedBlocksPaginator(Consumer<ListChangedBlocksRequest.Builder> listChangedBlocksRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns information about the blocks that are different between two Amazon Elastic Block Store snapshots of the same volume/snapshot lineage.
This is a variant of
listChangedBlocks(software.amazon.awssdk.services.ebs.model.ListChangedBlocksRequest) operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.ebs.paginators.ListChangedBlocksIterable responses = client.listChangedBlocksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.ebs.paginators.ListChangedBlocksIterable responses = client
.listChangedBlocksPaginator(request);
for (software.amazon.awssdk.services.ebs.model.ListChangedBlocksResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.ebs.paginators.ListChangedBlocksIterable responses = client.listChangedBlocksPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listChangedBlocks(software.amazon.awssdk.services.ebs.model.ListChangedBlocksRequest) operation.
This is a convenience which creates an instance of the ListChangedBlocksRequest.Builder avoiding the need
to create one manually via ListChangedBlocksRequest.builder()
listChangedBlocksRequest - A Consumer that will call methods on ListChangedBlocksRequest.Builder to create a request.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSnapshotBlocksResponse listSnapshotBlocks(ListSnapshotBlocksRequest listSnapshotBlocksRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns information about the blocks in an Amazon Elastic Block Store snapshot.
listSnapshotBlocksRequest - AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSnapshotBlocksResponse listSnapshotBlocks(Consumer<ListSnapshotBlocksRequest.Builder> listSnapshotBlocksRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns information about the blocks in an Amazon Elastic Block Store snapshot.
This is a convenience which creates an instance of the ListSnapshotBlocksRequest.Builder avoiding the
need to create one manually via ListSnapshotBlocksRequest.builder()
listSnapshotBlocksRequest - A Consumer that will call methods on ListSnapshotBlocksRequest.Builder to create a
request.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSnapshotBlocksIterable listSnapshotBlocksPaginator(ListSnapshotBlocksRequest listSnapshotBlocksRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns information about the blocks in an Amazon Elastic Block Store snapshot.
This is a variant of
listSnapshotBlocks(software.amazon.awssdk.services.ebs.model.ListSnapshotBlocksRequest) operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.ebs.paginators.ListSnapshotBlocksIterable responses = client.listSnapshotBlocksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.ebs.paginators.ListSnapshotBlocksIterable responses = client
.listSnapshotBlocksPaginator(request);
for (software.amazon.awssdk.services.ebs.model.ListSnapshotBlocksResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.ebs.paginators.ListSnapshotBlocksIterable responses = client.listSnapshotBlocksPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSnapshotBlocks(software.amazon.awssdk.services.ebs.model.ListSnapshotBlocksRequest) operation.
listSnapshotBlocksRequest - AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSnapshotBlocksIterable listSnapshotBlocksPaginator(Consumer<ListSnapshotBlocksRequest.Builder> listSnapshotBlocksRequest) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Returns information about the blocks in an Amazon Elastic Block Store snapshot.
This is a variant of
listSnapshotBlocks(software.amazon.awssdk.services.ebs.model.ListSnapshotBlocksRequest) operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.ebs.paginators.ListSnapshotBlocksIterable responses = client.listSnapshotBlocksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.ebs.paginators.ListSnapshotBlocksIterable responses = client
.listSnapshotBlocksPaginator(request);
for (software.amazon.awssdk.services.ebs.model.ListSnapshotBlocksResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.ebs.paginators.ListSnapshotBlocksIterable responses = client.listSnapshotBlocksPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSnapshotBlocks(software.amazon.awssdk.services.ebs.model.ListSnapshotBlocksRequest) operation.
This is a convenience which creates an instance of the ListSnapshotBlocksRequest.Builder avoiding the
need to create one manually via ListSnapshotBlocksRequest.builder()
listSnapshotBlocksRequest - A Consumer that will call methods on ListSnapshotBlocksRequest.Builder to create a
request.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault PutSnapshotBlockResponse putSnapshotBlock(PutSnapshotBlockRequest putSnapshotBlockRequest, RequestBody requestBody) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Writes a block of data to a 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-KiB sectors.
putSnapshotBlockRequest - requestBody - The content to send to the service. A RequestBody can be created using one of several factory
methods for various sources of data. For example, to create a request body from a file you can do the
following.
RequestBody.fromFile(new File("myfile.txt"))
See documentation in RequestBody for additional details and which sources of data are supported.
The service documentation for the request content is as follows '
The data to write to the block.
The block data is not signed as part of the Signature Version 4 signing process. As a result, you must generate and provide a Base64-encoded SHA256 checksum for the block data using the x-amz-Checksum header. Also, you must specify the checksum algorithm using the x-amz-Checksum-Algorithm header. The checksum that you provide is part of the Signature Version 4 signing process. It is validated against a checksum generated by Amazon EBS to ensure the validity and authenticity of the data. If the checksums do not correspond, the request fails. For more information, see Using checksums with the EBS direct APIs in the Amazon Elastic Compute Cloud User Guide.
'AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault PutSnapshotBlockResponse putSnapshotBlock(Consumer<PutSnapshotBlockRequest.Builder> putSnapshotBlockRequest, RequestBody requestBody) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Writes a block of data to a 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-KiB sectors.
This is a convenience which creates an instance of the PutSnapshotBlockRequest.Builder avoiding the need
to create one manually via PutSnapshotBlockRequest.builder()
putSnapshotBlockRequest - A Consumer that will call methods on PutSnapshotBlockRequest.Builder to create a request.requestBody - The content to send to the service. A RequestBody can be created using one of several factory
methods for various sources of data. For example, to create a request body from a file you can do the
following.
RequestBody.fromFile(new File("myfile.txt"))
See documentation in RequestBody for additional details and which sources of data are supported.
The service documentation for the request content is as follows '
The data to write to the block.
The block data is not signed as part of the Signature Version 4 signing process. As a result, you must generate and provide a Base64-encoded SHA256 checksum for the block data using the x-amz-Checksum header. Also, you must specify the checksum algorithm using the x-amz-Checksum-Algorithm header. The checksum that you provide is part of the Signature Version 4 signing process. It is validated against a checksum generated by Amazon EBS to ensure the validity and authenticity of the data. If the checksums do not correspond, the request fails. For more information, see Using checksums with the EBS direct APIs in the Amazon Elastic Compute Cloud User Guide.
'AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault PutSnapshotBlockResponse putSnapshotBlock(PutSnapshotBlockRequest putSnapshotBlockRequest, Path sourcePath) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Writes a block of data to a 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-KiB sectors.
putSnapshotBlockRequest - sourcePath - Path to file containing data to send to the service. File will be read entirely and may be read
multiple times in the event of a retry. If the file does not exist or the current user does not have
access to read it then an exception will be thrown. The service documentation for the request content is
as follows '
The data to write to the block.
The block data is not signed as part of the Signature Version 4 signing process. As a result, you must generate and provide a Base64-encoded SHA256 checksum for the block data using the x-amz-Checksum header. Also, you must specify the checksum algorithm using the x-amz-Checksum-Algorithm header. The checksum that you provide is part of the Signature Version 4 signing process. It is validated against a checksum generated by Amazon EBS to ensure the validity and authenticity of the data. If the checksums do not correspond, the request fails. For more information, see Using checksums with the EBS direct APIs in the Amazon Elastic Compute Cloud User Guide.
'AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptionputSnapshotBlock(PutSnapshotBlockRequest, RequestBody),
AWS API
Documentationdefault PutSnapshotBlockResponse putSnapshotBlock(Consumer<PutSnapshotBlockRequest.Builder> putSnapshotBlockRequest, Path sourcePath) throws AccessDeniedException, ValidationException, ResourceNotFoundException, RequestThrottledException, ServiceQuotaExceededException, InternalServerException, AwsServiceException, SdkClientException, EbsException
Writes a block of data to a 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-KiB sectors.
This is a convenience which creates an instance of the PutSnapshotBlockRequest.Builder avoiding the need
to create one manually via PutSnapshotBlockRequest.builder()
putSnapshotBlockRequest - A Consumer that will call methods on PutSnapshotBlockRequest.Builder to create a request.sourcePath - Path to file containing data to send to the service. File will be read entirely and may be read
multiple times in the event of a retry. If the file does not exist or the current user does not have
access to read it then an exception will be thrown. The service documentation for the request content is
as follows '
The data to write to the block.
The block data is not signed as part of the Signature Version 4 signing process. As a result, you must generate and provide a Base64-encoded SHA256 checksum for the block data using the x-amz-Checksum header. Also, you must specify the checksum algorithm using the x-amz-Checksum-Algorithm header. The checksum that you provide is part of the Signature Version 4 signing process. It is validated against a checksum generated by Amazon EBS to ensure the validity and authenticity of the data. If the checksums do not correspond, the request fails. For more information, see Using checksums with the EBS direct APIs in the Amazon Elastic Compute Cloud User Guide.
'AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.ResourceNotFoundException - The specified resource does not exist.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptionputSnapshotBlock(PutSnapshotBlockRequest, RequestBody),
AWS API
Documentationdefault StartSnapshotResponse startSnapshot(StartSnapshotRequest startSnapshotRequest) throws AccessDeniedException, ValidationException, RequestThrottledException, ResourceNotFoundException, ServiceQuotaExceededException, InternalServerException, ConcurrentLimitExceededException, ConflictException, AwsServiceException, SdkClientException, EbsException
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.
startSnapshotRequest - AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ResourceNotFoundException - The specified resource does not exist.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.ConcurrentLimitExceededException - You have reached the limit for concurrent API requests. For more information, see Optimizing performance of the EBS direct APIs in the Amazon Elastic Compute Cloud User Guide.ConflictException - The request uses the same client token as a previous, but non-identical request.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault StartSnapshotResponse startSnapshot(Consumer<StartSnapshotRequest.Builder> startSnapshotRequest) throws AccessDeniedException, ValidationException, RequestThrottledException, ResourceNotFoundException, ServiceQuotaExceededException, InternalServerException, ConcurrentLimitExceededException, ConflictException, AwsServiceException, SdkClientException, EbsException
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.
This is a convenience which creates an instance of the StartSnapshotRequest.Builder avoiding the need to
create one manually via StartSnapshotRequest.builder()
startSnapshotRequest - A Consumer that will call methods on StartSnapshotRequest.Builder to create a request.AccessDeniedException - You do not have sufficient access to perform this action.ValidationException - The input fails to satisfy the constraints of the EBS direct APIs.RequestThrottledException - The number of API requests has exceed the maximum allowed API request throttling limit.ResourceNotFoundException - The specified resource does not exist.ServiceQuotaExceededException - Your current service quotas do not allow you to perform this action.InternalServerException - An internal error has occurred.ConcurrentLimitExceededException - You have reached the limit for concurrent API requests. For more information, see Optimizing performance of the EBS direct APIs in the Amazon Elastic Compute Cloud User Guide.ConflictException - The request uses the same client token as a previous, but non-identical request.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.EbsException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptionstatic ServiceMetadata serviceMetadata()
Copyright © 2022. All rights reserved.