Interface BackupStorageClient
- All Superinterfaces:
AutoCloseable
,AwsClient
,SdkAutoCloseable
,SdkClient
builder()
method.
The frontend service for Cryo Storage.-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Value for looking up the service's metadata from theServiceMetadataProvider
.static final String
-
Method Summary
Modifier and TypeMethodDescriptionstatic BackupStorageClientBuilder
builder()
Create a builder that can be used to configure and create aBackupStorageClient
.static BackupStorageClient
create()
Create aBackupStorageClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
.default DeleteObjectResponse
deleteObject
(Consumer<DeleteObjectRequest.Builder> deleteObjectRequest) Delete Object from the incremental base Backup.default DeleteObjectResponse
deleteObject
(DeleteObjectRequest deleteObjectRequest) Delete Object from the incremental base Backup.default ResponseInputStream
<GetChunkResponse> getChunk
(Consumer<GetChunkRequest.Builder> getChunkRequest) Gets the specified object's chunk.default GetChunkResponse
getChunk
(Consumer<GetChunkRequest.Builder> getChunkRequest, Path destinationPath) Gets the specified object's chunk.default <ReturnT> ReturnT
getChunk
(Consumer<GetChunkRequest.Builder> getChunkRequest, ResponseTransformer<GetChunkResponse, ReturnT> responseTransformer) Gets the specified object's chunk.default ResponseInputStream
<GetChunkResponse> getChunk
(GetChunkRequest getChunkRequest) Gets the specified object's chunk.default GetChunkResponse
getChunk
(GetChunkRequest getChunkRequest, Path destinationPath) Gets the specified object's chunk.default <ReturnT> ReturnT
getChunk
(GetChunkRequest getChunkRequest, ResponseTransformer<GetChunkResponse, ReturnT> responseTransformer) Gets the specified object's chunk.default ResponseBytes
<GetChunkResponse> getChunkAsBytes
(Consumer<GetChunkRequest.Builder> getChunkRequest) Gets the specified object's chunk.default ResponseBytes
<GetChunkResponse> getChunkAsBytes
(GetChunkRequest getChunkRequest) Gets the specified object's chunk.getObjectMetadata
(Consumer<GetObjectMetadataRequest.Builder> getObjectMetadataRequest) Get metadata associated with an Object.default GetObjectMetadataResponse
getObjectMetadata
(Consumer<GetObjectMetadataRequest.Builder> getObjectMetadataRequest, Path destinationPath) Get metadata associated with an Object.default <ReturnT> ReturnT
getObjectMetadata
(Consumer<GetObjectMetadataRequest.Builder> getObjectMetadataRequest, ResponseTransformer<GetObjectMetadataResponse, ReturnT> responseTransformer) Get metadata associated with an Object.getObjectMetadata
(GetObjectMetadataRequest getObjectMetadataRequest) Get metadata associated with an Object.default GetObjectMetadataResponse
getObjectMetadata
(GetObjectMetadataRequest getObjectMetadataRequest, Path destinationPath) Get metadata associated with an Object.default <ReturnT> ReturnT
getObjectMetadata
(GetObjectMetadataRequest getObjectMetadataRequest, ResponseTransformer<GetObjectMetadataResponse, ReturnT> responseTransformer) Get metadata associated with an Object.default ResponseBytes
<GetObjectMetadataResponse> getObjectMetadataAsBytes
(Consumer<GetObjectMetadataRequest.Builder> getObjectMetadataRequest) Get metadata associated with an Object.default ResponseBytes
<GetObjectMetadataResponse> getObjectMetadataAsBytes
(GetObjectMetadataRequest getObjectMetadataRequest) Get metadata associated with an Object.default ListChunksResponse
listChunks
(Consumer<ListChunksRequest.Builder> listChunksRequest) List chunks in a given Objectdefault ListChunksResponse
listChunks
(ListChunksRequest listChunksRequest) List chunks in a given Objectdefault ListChunksIterable
listChunksPaginator
(Consumer<ListChunksRequest.Builder> listChunksRequest) This is a variant oflistChunks(software.amazon.awssdk.services.backupstorage.model.ListChunksRequest)
operation.default ListChunksIterable
listChunksPaginator
(ListChunksRequest listChunksRequest) This is a variant oflistChunks(software.amazon.awssdk.services.backupstorage.model.ListChunksRequest)
operation.default ListObjectsResponse
listObjects
(Consumer<ListObjectsRequest.Builder> listObjectsRequest) List all Objects in a given Backup.default ListObjectsResponse
listObjects
(ListObjectsRequest listObjectsRequest) List all Objects in a given Backup.default ListObjectsIterable
listObjectsPaginator
(Consumer<ListObjectsRequest.Builder> listObjectsRequest) This is a variant oflistObjects(software.amazon.awssdk.services.backupstorage.model.ListObjectsRequest)
operation.default ListObjectsIterable
listObjectsPaginator
(ListObjectsRequest listObjectsRequest) This is a variant oflistObjects(software.amazon.awssdk.services.backupstorage.model.ListObjectsRequest)
operation.default NotifyObjectCompleteResponse
notifyObjectComplete
(Consumer<NotifyObjectCompleteRequest.Builder> notifyObjectCompleteRequest, Path sourcePath) Complete uploaddefault NotifyObjectCompleteResponse
notifyObjectComplete
(Consumer<NotifyObjectCompleteRequest.Builder> notifyObjectCompleteRequest, RequestBody requestBody) Complete uploaddefault NotifyObjectCompleteResponse
notifyObjectComplete
(NotifyObjectCompleteRequest notifyObjectCompleteRequest, Path sourcePath) Complete uploaddefault NotifyObjectCompleteResponse
notifyObjectComplete
(NotifyObjectCompleteRequest notifyObjectCompleteRequest, RequestBody requestBody) Complete uploaddefault PutChunkResponse
putChunk
(Consumer<PutChunkRequest.Builder> putChunkRequest, Path sourcePath) Upload chunk.default PutChunkResponse
putChunk
(Consumer<PutChunkRequest.Builder> putChunkRequest, RequestBody requestBody) Upload chunk.default PutChunkResponse
putChunk
(PutChunkRequest putChunkRequest, Path sourcePath) Upload chunk.default PutChunkResponse
putChunk
(PutChunkRequest putChunkRequest, RequestBody requestBody) Upload chunk.default PutObjectResponse
putObject
(Consumer<PutObjectRequest.Builder> putObjectRequest, Path sourcePath) Upload object that can store object metadata String and data blob in single API call using inline chunk field.default PutObjectResponse
putObject
(Consumer<PutObjectRequest.Builder> putObjectRequest, RequestBody requestBody) Upload object that can store object metadata String and data blob in single API call using inline chunk field.default PutObjectResponse
putObject
(PutObjectRequest putObjectRequest, Path sourcePath) Upload object that can store object metadata String and data blob in single API call using inline chunk field.default PutObjectResponse
putObject
(PutObjectRequest putObjectRequest, RequestBody requestBody) Upload object that can store object metadata String and data blob in single API call using inline chunk field.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstatic ServiceMetadata
default StartObjectResponse
startObject
(Consumer<StartObjectRequest.Builder> startObjectRequest) Start upload containing one or many chunks.default StartObjectResponse
startObject
(StartObjectRequest startObjectRequest) Start upload containing one or many chunks.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider
.- See Also:
-
-
Method Details
-
deleteObject
default DeleteObjectResponse deleteObject(DeleteObjectRequest deleteObjectRequest) throws ServiceUnavailableException, ServiceInternalException, RetryableException, IllegalArgumentException, ResourceNotFoundException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Delete Object from the incremental base Backup.- Parameters:
deleteObjectRequest
-- Returns:
- Result of the DeleteObject operation returned by the service.
- See Also:
-
deleteObject
default DeleteObjectResponse deleteObject(Consumer<DeleteObjectRequest.Builder> deleteObjectRequest) throws ServiceUnavailableException, ServiceInternalException, RetryableException, IllegalArgumentException, ResourceNotFoundException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Delete Object from the incremental base Backup.
This is a convenience which creates an instance of the
DeleteObjectRequest.Builder
avoiding the need to create one manually viaDeleteObjectRequest.builder()
- Parameters:
deleteObjectRequest
- AConsumer
that will call methods onDeleteObjectRequest.Builder
to create a request.- Returns:
- Result of the DeleteObject operation returned by the service.
- See Also:
-
getChunk
default <ReturnT> ReturnT getChunk(GetChunkRequest getChunkRequest, ResponseTransformer<GetChunkResponse, ReturnT> responseTransformer) throws IllegalArgumentException, RetryableException, ResourceNotFoundException, ServiceInternalException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageExceptionGets the specified object's chunk.- Parameters:
getChunkRequest
-responseTransformer
- Functional interface for processing the streamed response content. The unmarshalled GetChunkResponse 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. SeeResponseTransformer
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 'Chunk data'.- Returns:
- The transformed result of the ResponseTransformer.
- See Also:
-
getChunk
default <ReturnT> ReturnT getChunk(Consumer<GetChunkRequest.Builder> getChunkRequest, ResponseTransformer<GetChunkResponse, ReturnT> responseTransformer) throws IllegalArgumentException, RetryableException, ResourceNotFoundException, ServiceInternalException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageExceptionGets the specified object's chunk.
This is a convenience which creates an instance of the
GetChunkRequest.Builder
avoiding the need to create one manually viaGetChunkRequest.builder()
- Parameters:
getChunkRequest
- AConsumer
that will call methods onGetChunkRequest.Builder
to create a request.responseTransformer
- Functional interface for processing the streamed response content. The unmarshalled GetChunkResponse 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. SeeResponseTransformer
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 'Chunk data'.- Returns:
- The transformed result of the ResponseTransformer.
- See Also:
-
getChunk
default GetChunkResponse getChunk(GetChunkRequest getChunkRequest, Path destinationPath) throws IllegalArgumentException, RetryableException, ResourceNotFoundException, ServiceInternalException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Gets the specified object's chunk.- Parameters:
getChunkRequest
-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 'Chunk data'.- Returns:
- The transformed result of the ResponseTransformer.
- See Also:
-
getChunk
default GetChunkResponse getChunk(Consumer<GetChunkRequest.Builder> getChunkRequest, Path destinationPath) throws IllegalArgumentException, RetryableException, ResourceNotFoundException, ServiceInternalException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Gets the specified object's chunk.
This is a convenience which creates an instance of the
GetChunkRequest.Builder
avoiding the need to create one manually viaGetChunkRequest.builder()
- Parameters:
getChunkRequest
- AConsumer
that will call methods onGetChunkRequest.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 'Chunk data'.- Returns:
- The transformed result of the ResponseTransformer.
- See Also:
-
getChunk
default ResponseInputStream<GetChunkResponse> getChunk(GetChunkRequest getChunkRequest) throws IllegalArgumentException, RetryableException, ResourceNotFoundException, ServiceInternalException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Gets the specified object's chunk.- Parameters:
getChunkRequest
-- Returns:
- A
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 viaResponseInputStream.response()
. The service documentation for the response content is as follows 'Chunk data'. - See Also:
-
getChunk
default ResponseInputStream<GetChunkResponse> getChunk(Consumer<GetChunkRequest.Builder> getChunkRequest) throws IllegalArgumentException, RetryableException, ResourceNotFoundException, ServiceInternalException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Gets the specified object's chunk.
This is a convenience which creates an instance of the
GetChunkRequest.Builder
avoiding the need to create one manually viaGetChunkRequest.builder()
- Parameters:
getChunkRequest
- AConsumer
that will call methods onGetChunkRequest.Builder
to create a request.- Returns:
- A
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 viaResponseInputStream.response()
. The service documentation for the response content is as follows 'Chunk data'. - See Also:
-
getChunkAsBytes
default ResponseBytes<GetChunkResponse> getChunkAsBytes(GetChunkRequest getChunkRequest) throws IllegalArgumentException, RetryableException, ResourceNotFoundException, ServiceInternalException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Gets the specified object's chunk.- Parameters:
getChunkRequest
-- Returns:
- A
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 viaResponseBytes.response()
. The service documentation for the response content is as follows 'Chunk data'. - See Also:
-
getChunkAsBytes
default ResponseBytes<GetChunkResponse> getChunkAsBytes(Consumer<GetChunkRequest.Builder> getChunkRequest) throws IllegalArgumentException, RetryableException, ResourceNotFoundException, ServiceInternalException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Gets the specified object's chunk.
This is a convenience which creates an instance of the
GetChunkRequest.Builder
avoiding the need to create one manually viaGetChunkRequest.builder()
- Parameters:
getChunkRequest
- AConsumer
that will call methods onGetChunkRequest.Builder
to create a request.- Returns:
- A
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 viaResponseBytes.response()
. The service documentation for the response content is as follows 'Chunk data'. - See Also:
-
getObjectMetadata
default <ReturnT> ReturnT getObjectMetadata(GetObjectMetadataRequest getObjectMetadataRequest, ResponseTransformer<GetObjectMetadataResponse, ReturnT> responseTransformer) throws ServiceUnavailableException, ServiceInternalException, ResourceNotFoundException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageExceptionGet metadata associated with an Object.- Parameters:
getObjectMetadataRequest
-responseTransformer
- Functional interface for processing the streamed response content. The unmarshalled GetObjectMetadataResponse 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. SeeResponseTransformer
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 'Metadata blob.'.- Returns:
- The transformed result of the ResponseTransformer.
- See Also:
-
getObjectMetadata
default <ReturnT> ReturnT getObjectMetadata(Consumer<GetObjectMetadataRequest.Builder> getObjectMetadataRequest, ResponseTransformer<GetObjectMetadataResponse, ReturnT> responseTransformer) throws ServiceUnavailableException, ServiceInternalException, ResourceNotFoundException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageExceptionGet metadata associated with an Object.
This is a convenience which creates an instance of the
GetObjectMetadataRequest.Builder
avoiding the need to create one manually viaGetObjectMetadataRequest.builder()
- Parameters:
getObjectMetadataRequest
- AConsumer
that will call methods onGetObjectMetadataRequest.Builder
to create a request.responseTransformer
- Functional interface for processing the streamed response content. The unmarshalled GetObjectMetadataResponse 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. SeeResponseTransformer
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 'Metadata blob.'.- Returns:
- The transformed result of the ResponseTransformer.
- See Also:
-
getObjectMetadata
default GetObjectMetadataResponse getObjectMetadata(GetObjectMetadataRequest getObjectMetadataRequest, Path destinationPath) throws ServiceUnavailableException, ServiceInternalException, ResourceNotFoundException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Get metadata associated with an Object.- Parameters:
getObjectMetadataRequest
-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 'Metadata blob.'.- Returns:
- The transformed result of the ResponseTransformer.
- See Also:
-
getObjectMetadata
default GetObjectMetadataResponse getObjectMetadata(Consumer<GetObjectMetadataRequest.Builder> getObjectMetadataRequest, Path destinationPath) throws ServiceUnavailableException, ServiceInternalException, ResourceNotFoundException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Get metadata associated with an Object.
This is a convenience which creates an instance of the
GetObjectMetadataRequest.Builder
avoiding the need to create one manually viaGetObjectMetadataRequest.builder()
- Parameters:
getObjectMetadataRequest
- AConsumer
that will call methods onGetObjectMetadataRequest.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 'Metadata blob.'.- Returns:
- The transformed result of the ResponseTransformer.
- See Also:
-
getObjectMetadata
default ResponseInputStream<GetObjectMetadataResponse> getObjectMetadata(GetObjectMetadataRequest getObjectMetadataRequest) throws ServiceUnavailableException, ServiceInternalException, ResourceNotFoundException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Get metadata associated with an Object.- Parameters:
getObjectMetadataRequest
-- Returns:
- A
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 viaResponseInputStream.response()
. The service documentation for the response content is as follows 'Metadata blob.'. - See Also:
-
getObjectMetadata
default ResponseInputStream<GetObjectMetadataResponse> getObjectMetadata(Consumer<GetObjectMetadataRequest.Builder> getObjectMetadataRequest) throws ServiceUnavailableException, ServiceInternalException, ResourceNotFoundException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Get metadata associated with an Object.
This is a convenience which creates an instance of the
GetObjectMetadataRequest.Builder
avoiding the need to create one manually viaGetObjectMetadataRequest.builder()
- Parameters:
getObjectMetadataRequest
- AConsumer
that will call methods onGetObjectMetadataRequest.Builder
to create a request.- Returns:
- A
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 viaResponseInputStream.response()
. The service documentation for the response content is as follows 'Metadata blob.'. - See Also:
-
getObjectMetadataAsBytes
default ResponseBytes<GetObjectMetadataResponse> getObjectMetadataAsBytes(GetObjectMetadataRequest getObjectMetadataRequest) throws ServiceUnavailableException, ServiceInternalException, ResourceNotFoundException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Get metadata associated with an Object.- Parameters:
getObjectMetadataRequest
-- Returns:
- A
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 viaResponseBytes.response()
. The service documentation for the response content is as follows 'Metadata blob.'. - See Also:
-
getObjectMetadataAsBytes
default ResponseBytes<GetObjectMetadataResponse> getObjectMetadataAsBytes(Consumer<GetObjectMetadataRequest.Builder> getObjectMetadataRequest) throws ServiceUnavailableException, ServiceInternalException, ResourceNotFoundException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Get metadata associated with an Object.
This is a convenience which creates an instance of the
GetObjectMetadataRequest.Builder
avoiding the need to create one manually viaGetObjectMetadataRequest.builder()
- Parameters:
getObjectMetadataRequest
- AConsumer
that will call methods onGetObjectMetadataRequest.Builder
to create a request.- Returns:
- A
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 viaResponseBytes.response()
. The service documentation for the response content is as follows 'Metadata blob.'. - See Also:
-
listChunks
default ListChunksResponse listChunks(ListChunksRequest listChunksRequest) throws ServiceUnavailableException, ResourceNotFoundException, ServiceInternalException, RetryableException, IllegalArgumentException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException List chunks in a given Object- Parameters:
listChunksRequest
-- Returns:
- Result of the ListChunks operation returned by the service.
- See Also:
-
listChunks
default ListChunksResponse listChunks(Consumer<ListChunksRequest.Builder> listChunksRequest) throws ServiceUnavailableException, ResourceNotFoundException, ServiceInternalException, RetryableException, IllegalArgumentException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException List chunks in a given Object
This is a convenience which creates an instance of the
ListChunksRequest.Builder
avoiding the need to create one manually viaListChunksRequest.builder()
- Parameters:
listChunksRequest
- AConsumer
that will call methods onListChunksRequest.Builder
to create a request.- Returns:
- Result of the ListChunks operation returned by the service.
- See Also:
-
listChunksPaginator
default ListChunksIterable listChunksPaginator(ListChunksRequest listChunksRequest) throws ServiceUnavailableException, ResourceNotFoundException, ServiceInternalException, RetryableException, IllegalArgumentException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException This is a variant of
listChunks(software.amazon.awssdk.services.backupstorage.model.ListChunksRequest)
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 Streamsoftware.amazon.awssdk.services.backupstorage.paginators.ListChunksIterable responses = client.listChunksPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.backupstorage.paginators.ListChunksIterable responses = client.listChunksPaginator(request); for (software.amazon.awssdk.services.backupstorage.model.ListChunksResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.backupstorage.paginators.ListChunksIterable responses = client.listChunksPaginator(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
listChunks(software.amazon.awssdk.services.backupstorage.model.ListChunksRequest)
operation.- Parameters:
listChunksRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listChunksPaginator
default ListChunksIterable listChunksPaginator(Consumer<ListChunksRequest.Builder> listChunksRequest) throws ServiceUnavailableException, ResourceNotFoundException, ServiceInternalException, RetryableException, IllegalArgumentException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException This is a variant of
listChunks(software.amazon.awssdk.services.backupstorage.model.ListChunksRequest)
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 Streamsoftware.amazon.awssdk.services.backupstorage.paginators.ListChunksIterable responses = client.listChunksPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.backupstorage.paginators.ListChunksIterable responses = client.listChunksPaginator(request); for (software.amazon.awssdk.services.backupstorage.model.ListChunksResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.backupstorage.paginators.ListChunksIterable responses = client.listChunksPaginator(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
listChunks(software.amazon.awssdk.services.backupstorage.model.ListChunksRequest)
operation.
This is a convenience which creates an instance of the
ListChunksRequest.Builder
avoiding the need to create one manually viaListChunksRequest.builder()
- Parameters:
listChunksRequest
- AConsumer
that will call methods onListChunksRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listObjects
default ListObjectsResponse listObjects(ListObjectsRequest listObjectsRequest) throws ServiceUnavailableException, ServiceInternalException, RetryableException, IllegalArgumentException, ThrottlingException, ResourceNotFoundException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException List all Objects in a given Backup.- Parameters:
listObjectsRequest
-- Returns:
- Result of the ListObjects operation returned by the service.
- See Also:
-
listObjects
default ListObjectsResponse listObjects(Consumer<ListObjectsRequest.Builder> listObjectsRequest) throws ServiceUnavailableException, ServiceInternalException, RetryableException, IllegalArgumentException, ThrottlingException, ResourceNotFoundException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException List all Objects in a given Backup.
This is a convenience which creates an instance of the
ListObjectsRequest.Builder
avoiding the need to create one manually viaListObjectsRequest.builder()
- Parameters:
listObjectsRequest
- AConsumer
that will call methods onListObjectsRequest.Builder
to create a request.- Returns:
- Result of the ListObjects operation returned by the service.
- See Also:
-
listObjectsPaginator
default ListObjectsIterable listObjectsPaginator(ListObjectsRequest listObjectsRequest) throws ServiceUnavailableException, ServiceInternalException, RetryableException, IllegalArgumentException, ThrottlingException, ResourceNotFoundException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException This is a variant of
listObjects(software.amazon.awssdk.services.backupstorage.model.ListObjectsRequest)
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 Streamsoftware.amazon.awssdk.services.backupstorage.paginators.ListObjectsIterable responses = client.listObjectsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.backupstorage.paginators.ListObjectsIterable responses = client.listObjectsPaginator(request); for (software.amazon.awssdk.services.backupstorage.model.ListObjectsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.backupstorage.paginators.ListObjectsIterable responses = client.listObjectsPaginator(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
listObjects(software.amazon.awssdk.services.backupstorage.model.ListObjectsRequest)
operation.- Parameters:
listObjectsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listObjectsPaginator
default ListObjectsIterable listObjectsPaginator(Consumer<ListObjectsRequest.Builder> listObjectsRequest) throws ServiceUnavailableException, ServiceInternalException, RetryableException, IllegalArgumentException, ThrottlingException, ResourceNotFoundException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException This is a variant of
listObjects(software.amazon.awssdk.services.backupstorage.model.ListObjectsRequest)
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 Streamsoftware.amazon.awssdk.services.backupstorage.paginators.ListObjectsIterable responses = client.listObjectsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.backupstorage.paginators.ListObjectsIterable responses = client.listObjectsPaginator(request); for (software.amazon.awssdk.services.backupstorage.model.ListObjectsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.backupstorage.paginators.ListObjectsIterable responses = client.listObjectsPaginator(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
listObjects(software.amazon.awssdk.services.backupstorage.model.ListObjectsRequest)
operation.
This is a convenience which creates an instance of the
ListObjectsRequest.Builder
avoiding the need to create one manually viaListObjectsRequest.builder()
- Parameters:
listObjectsRequest
- AConsumer
that will call methods onListObjectsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
notifyObjectComplete
default NotifyObjectCompleteResponse notifyObjectComplete(NotifyObjectCompleteRequest notifyObjectCompleteRequest, RequestBody requestBody) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Complete upload- Parameters:
notifyObjectCompleteRequest
-requestBody
- The content to send to the service. ARequestBody
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"))
RequestBody
for additional details and which sources of data are supported. The service documentation for the request content is as follows 'Optional metadata associated with an Object. Maximum length is 4MB.'- Returns:
- Result of the NotifyObjectComplete operation returned by the service.
- See Also:
-
notifyObjectComplete
default NotifyObjectCompleteResponse notifyObjectComplete(Consumer<NotifyObjectCompleteRequest.Builder> notifyObjectCompleteRequest, RequestBody requestBody) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Complete upload
This is a convenience which creates an instance of the
NotifyObjectCompleteRequest.Builder
avoiding the need to create one manually viaNotifyObjectCompleteRequest.builder()
- Parameters:
notifyObjectCompleteRequest
- AConsumer
that will call methods onNotifyObjectCompleteRequest.Builder
to create a request.requestBody
- The content to send to the service. ARequestBody
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"))
RequestBody
for additional details and which sources of data are supported. The service documentation for the request content is as follows 'Optional metadata associated with an Object. Maximum length is 4MB.'- Returns:
- Result of the NotifyObjectComplete operation returned by the service.
- See Also:
-
notifyObjectComplete
default NotifyObjectCompleteResponse notifyObjectComplete(NotifyObjectCompleteRequest notifyObjectCompleteRequest, Path sourcePath) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Complete upload- Parameters:
notifyObjectCompleteRequest
-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 'Optional metadata associated with an Object. Maximum length is 4MB.'- Returns:
- Result of the NotifyObjectComplete operation returned by the service.
- See Also:
-
notifyObjectComplete
default NotifyObjectCompleteResponse notifyObjectComplete(Consumer<NotifyObjectCompleteRequest.Builder> notifyObjectCompleteRequest, Path sourcePath) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Complete upload
This is a convenience which creates an instance of the
NotifyObjectCompleteRequest.Builder
avoiding the need to create one manually viaNotifyObjectCompleteRequest.builder()
- Parameters:
notifyObjectCompleteRequest
- AConsumer
that will call methods onNotifyObjectCompleteRequest.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 'Optional metadata associated with an Object. Maximum length is 4MB.'- Returns:
- Result of the NotifyObjectComplete operation returned by the service.
- See Also:
-
putChunk
default PutChunkResponse putChunk(PutChunkRequest putChunkRequest, RequestBody requestBody) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Upload chunk.- Parameters:
putChunkRequest
-requestBody
- The content to send to the service. ARequestBody
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"))
RequestBody
for additional details and which sources of data are supported. The service documentation for the request content is as follows 'Data to be uploaded'- Returns:
- Result of the PutChunk operation returned by the service.
- See Also:
-
putChunk
default PutChunkResponse putChunk(Consumer<PutChunkRequest.Builder> putChunkRequest, RequestBody requestBody) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Upload chunk.
This is a convenience which creates an instance of the
PutChunkRequest.Builder
avoiding the need to create one manually viaPutChunkRequest.builder()
- Parameters:
putChunkRequest
- AConsumer
that will call methods onPutChunkRequest.Builder
to create a request.requestBody
- The content to send to the service. ARequestBody
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"))
RequestBody
for additional details and which sources of data are supported. The service documentation for the request content is as follows 'Data to be uploaded'- Returns:
- Result of the PutChunk operation returned by the service.
- See Also:
-
putChunk
default PutChunkResponse putChunk(PutChunkRequest putChunkRequest, Path sourcePath) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Upload chunk.- Parameters:
putChunkRequest
-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 'Data to be uploaded'- Returns:
- Result of the PutChunk operation returned by the service.
- See Also:
-
putChunk
default PutChunkResponse putChunk(Consumer<PutChunkRequest.Builder> putChunkRequest, Path sourcePath) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Upload chunk.
This is a convenience which creates an instance of the
PutChunkRequest.Builder
avoiding the need to create one manually viaPutChunkRequest.builder()
- Parameters:
putChunkRequest
- AConsumer
that will call methods onPutChunkRequest.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 'Data to be uploaded'- Returns:
- Result of the PutChunk operation returned by the service.
- See Also:
-
putObject
default PutObjectResponse putObject(PutObjectRequest putObjectRequest, RequestBody requestBody) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Upload object that can store object metadata String and data blob in single API call using inline chunk field.- Parameters:
putObjectRequest
-requestBody
- The content to send to the service. ARequestBody
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"))
RequestBody
for additional details and which sources of data are supported. The service documentation for the request content is as follows 'Inline chunk data to be uploaded.'- Returns:
- Result of the PutObject operation returned by the service.
- See Also:
-
putObject
default PutObjectResponse putObject(Consumer<PutObjectRequest.Builder> putObjectRequest, RequestBody requestBody) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Upload object that can store object metadata String and data blob in single API call using inline chunk field.
This is a convenience which creates an instance of the
PutObjectRequest.Builder
avoiding the need to create one manually viaPutObjectRequest.builder()
- Parameters:
putObjectRequest
- AConsumer
that will call methods onPutObjectRequest.Builder
to create a request.requestBody
- The content to send to the service. ARequestBody
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"))
RequestBody
for additional details and which sources of data are supported. The service documentation for the request content is as follows 'Inline chunk data to be uploaded.'- Returns:
- Result of the PutObject operation returned by the service.
- See Also:
-
putObject
default PutObjectResponse putObject(PutObjectRequest putObjectRequest, Path sourcePath) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Upload object that can store object metadata String and data blob in single API call using inline chunk field.- Parameters:
putObjectRequest
-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 'Inline chunk data to be uploaded.'- Returns:
- Result of the PutObject operation returned by the service.
- See Also:
-
putObject
default PutObjectResponse putObject(Consumer<PutObjectRequest.Builder> putObjectRequest, Path sourcePath) throws ServiceUnavailableException, ServiceInternalException, NotReadableInputStreamException, RetryableException, IllegalArgumentException, ThrottlingException, KmsInvalidKeyUsageException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Upload object that can store object metadata String and data blob in single API call using inline chunk field.
This is a convenience which creates an instance of the
PutObjectRequest.Builder
avoiding the need to create one manually viaPutObjectRequest.builder()
- Parameters:
putObjectRequest
- AConsumer
that will call methods onPutObjectRequest.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 'Inline chunk data to be uploaded.'- Returns:
- Result of the PutObject operation returned by the service.
- See Also:
-
startObject
default StartObjectResponse startObject(StartObjectRequest startObjectRequest) throws ServiceUnavailableException, ServiceInternalException, RetryableException, IllegalArgumentException, ResourceNotFoundException, DataAlreadyExistsException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Start upload containing one or many chunks.- Parameters:
startObjectRequest
-- Returns:
- Result of the StartObject operation returned by the service.
- See Also:
-
startObject
default StartObjectResponse startObject(Consumer<StartObjectRequest.Builder> startObjectRequest) throws ServiceUnavailableException, ServiceInternalException, RetryableException, IllegalArgumentException, ResourceNotFoundException, DataAlreadyExistsException, ThrottlingException, AccessDeniedException, AwsServiceException, SdkClientException, BackupStorageException Start upload containing one or many chunks.
This is a convenience which creates an instance of the
StartObjectRequest.Builder
avoiding the need to create one manually viaStartObjectRequest.builder()
- Parameters:
startObjectRequest
- AConsumer
that will call methods onStartObjectRequest.Builder
to create a request.- Returns:
- Result of the StartObject operation returned by the service.
- See Also:
-
create
Create aBackupStorageClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
. -
builder
Create a builder that can be used to configure and create aBackupStorageClient
. -
serviceMetadata
-
serviceClientConfiguration
Description copied from interface:SdkClient
The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfiguration
in interfaceAwsClient
- Specified by:
serviceClientConfiguration
in interfaceSdkClient
- Returns:
- SdkServiceClientConfiguration
-