software.amazon.awssdk.services.qldb.QldbClient Maven / Gradle / Ivy
Show all versions of qldb Show documentation
/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package software.amazon.awssdk.services.qldb;
import java.util.function.Consumer;
import software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.annotations.SdkPublicApi;
import software.amazon.awssdk.annotations.ThreadSafe;
import software.amazon.awssdk.awscore.AwsClient;
import software.amazon.awssdk.awscore.exception.AwsServiceException;
import software.amazon.awssdk.core.exception.SdkClientException;
import software.amazon.awssdk.regions.ServiceMetadata;
import software.amazon.awssdk.services.qldb.model.CancelJournalKinesisStreamRequest;
import software.amazon.awssdk.services.qldb.model.CancelJournalKinesisStreamResponse;
import software.amazon.awssdk.services.qldb.model.CreateLedgerRequest;
import software.amazon.awssdk.services.qldb.model.CreateLedgerResponse;
import software.amazon.awssdk.services.qldb.model.DeleteLedgerRequest;
import software.amazon.awssdk.services.qldb.model.DeleteLedgerResponse;
import software.amazon.awssdk.services.qldb.model.DescribeJournalKinesisStreamRequest;
import software.amazon.awssdk.services.qldb.model.DescribeJournalKinesisStreamResponse;
import software.amazon.awssdk.services.qldb.model.DescribeJournalS3ExportRequest;
import software.amazon.awssdk.services.qldb.model.DescribeJournalS3ExportResponse;
import software.amazon.awssdk.services.qldb.model.DescribeLedgerRequest;
import software.amazon.awssdk.services.qldb.model.DescribeLedgerResponse;
import software.amazon.awssdk.services.qldb.model.ExportJournalToS3Request;
import software.amazon.awssdk.services.qldb.model.ExportJournalToS3Response;
import software.amazon.awssdk.services.qldb.model.GetBlockRequest;
import software.amazon.awssdk.services.qldb.model.GetBlockResponse;
import software.amazon.awssdk.services.qldb.model.GetDigestRequest;
import software.amazon.awssdk.services.qldb.model.GetDigestResponse;
import software.amazon.awssdk.services.qldb.model.GetRevisionRequest;
import software.amazon.awssdk.services.qldb.model.GetRevisionResponse;
import software.amazon.awssdk.services.qldb.model.InvalidParameterException;
import software.amazon.awssdk.services.qldb.model.LimitExceededException;
import software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerRequest;
import software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerResponse;
import software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerRequest;
import software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerResponse;
import software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsRequest;
import software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsResponse;
import software.amazon.awssdk.services.qldb.model.ListLedgersRequest;
import software.amazon.awssdk.services.qldb.model.ListLedgersResponse;
import software.amazon.awssdk.services.qldb.model.ListTagsForResourceRequest;
import software.amazon.awssdk.services.qldb.model.ListTagsForResourceResponse;
import software.amazon.awssdk.services.qldb.model.QldbException;
import software.amazon.awssdk.services.qldb.model.ResourceAlreadyExistsException;
import software.amazon.awssdk.services.qldb.model.ResourceInUseException;
import software.amazon.awssdk.services.qldb.model.ResourceNotFoundException;
import software.amazon.awssdk.services.qldb.model.ResourcePreconditionNotMetException;
import software.amazon.awssdk.services.qldb.model.StreamJournalToKinesisRequest;
import software.amazon.awssdk.services.qldb.model.StreamJournalToKinesisResponse;
import software.amazon.awssdk.services.qldb.model.TagResourceRequest;
import software.amazon.awssdk.services.qldb.model.TagResourceResponse;
import software.amazon.awssdk.services.qldb.model.UntagResourceRequest;
import software.amazon.awssdk.services.qldb.model.UntagResourceResponse;
import software.amazon.awssdk.services.qldb.model.UpdateLedgerPermissionsModeRequest;
import software.amazon.awssdk.services.qldb.model.UpdateLedgerPermissionsModeResponse;
import software.amazon.awssdk.services.qldb.model.UpdateLedgerRequest;
import software.amazon.awssdk.services.qldb.model.UpdateLedgerResponse;
import software.amazon.awssdk.services.qldb.paginators.ListJournalKinesisStreamsForLedgerIterable;
import software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsForLedgerIterable;
import software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsIterable;
import software.amazon.awssdk.services.qldb.paginators.ListLedgersIterable;
/**
* Service client for accessing QLDB. This can be created using the static {@link #builder()} method.
*
*
* The resource management API for Amazon QLDB
*
*/
@Generated("software.amazon.awssdk:codegen")
@SdkPublicApi
@ThreadSafe
public interface QldbClient extends AwsClient {
String SERVICE_NAME = "qldb";
/**
* Value for looking up the service's metadata from the
* {@link software.amazon.awssdk.regions.ServiceMetadataProvider}.
*/
String SERVICE_METADATA_ID = "qldb";
/**
*
* Ends a given Amazon QLDB journal stream. Before a stream can be canceled, its current status must be
* ACTIVE.
*
*
* You can't restart a stream after you cancel it. Canceled QLDB stream resources are subject to a 7-day retention
* period, so they are automatically deleted after this limit expires.
*
*
* @param cancelJournalKinesisStreamRequest
* @return Result of the CancelJournalKinesisStream operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.CancelJournalKinesisStream
* @see AWS API Documentation
*/
default CancelJournalKinesisStreamResponse cancelJournalKinesisStream(
CancelJournalKinesisStreamRequest cancelJournalKinesisStreamRequest) throws InvalidParameterException,
ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Ends a given Amazon QLDB journal stream. Before a stream can be canceled, its current status must be
* ACTIVE.
*
*
* You can't restart a stream after you cancel it. Canceled QLDB stream resources are subject to a 7-day retention
* period, so they are automatically deleted after this limit expires.
*
*
*
* This is a convenience which creates an instance of the {@link CancelJournalKinesisStreamRequest.Builder} avoiding
* the need to create one manually via {@link CancelJournalKinesisStreamRequest#builder()}
*
*
* @param cancelJournalKinesisStreamRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.CancelJournalKinesisStreamRequest.Builder} to create a
* request.
* @return Result of the CancelJournalKinesisStream operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.CancelJournalKinesisStream
* @see AWS API Documentation
*/
default CancelJournalKinesisStreamResponse cancelJournalKinesisStream(
Consumer cancelJournalKinesisStreamRequest)
throws InvalidParameterException, ResourceNotFoundException, ResourcePreconditionNotMetException,
AwsServiceException, SdkClientException, QldbException {
return cancelJournalKinesisStream(CancelJournalKinesisStreamRequest.builder()
.applyMutation(cancelJournalKinesisStreamRequest).build());
}
/**
*
* Creates a new ledger in your Amazon Web Services account in the current Region.
*
*
* @param createLedgerRequest
* @return Result of the CreateLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceAlreadyExistsException
* The specified resource already exists.
* @throws LimitExceededException
* You have reached the limit on the maximum number of resources allowed.
* @throws ResourceInUseException
* The specified resource can't be modified at this time.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.CreateLedger
* @see AWS API
* Documentation
*/
default CreateLedgerResponse createLedger(CreateLedgerRequest createLedgerRequest) throws InvalidParameterException,
ResourceAlreadyExistsException, LimitExceededException, ResourceInUseException, AwsServiceException,
SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Creates a new ledger in your Amazon Web Services account in the current Region.
*
*
*
* This is a convenience which creates an instance of the {@link CreateLedgerRequest.Builder} avoiding the need to
* create one manually via {@link CreateLedgerRequest#builder()}
*
*
* @param createLedgerRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.CreateLedgerRequest.Builder} to create a request.
* @return Result of the CreateLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceAlreadyExistsException
* The specified resource already exists.
* @throws LimitExceededException
* You have reached the limit on the maximum number of resources allowed.
* @throws ResourceInUseException
* The specified resource can't be modified at this time.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.CreateLedger
* @see AWS API
* Documentation
*/
default CreateLedgerResponse createLedger(Consumer createLedgerRequest)
throws InvalidParameterException, ResourceAlreadyExistsException, LimitExceededException, ResourceInUseException,
AwsServiceException, SdkClientException, QldbException {
return createLedger(CreateLedgerRequest.builder().applyMutation(createLedgerRequest).build());
}
/**
*
* Deletes a ledger and all of its contents. This action is irreversible.
*
*
* If deletion protection is enabled, you must first disable it before you can delete the ledger. You can disable it
* by calling the UpdateLedger operation to set this parameter to false.
*
*
* @param deleteLedgerRequest
* @return Result of the DeleteLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourceInUseException
* The specified resource can't be modified at this time.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.DeleteLedger
* @see AWS API
* Documentation
*/
default DeleteLedgerResponse deleteLedger(DeleteLedgerRequest deleteLedgerRequest) throws InvalidParameterException,
ResourceNotFoundException, ResourceInUseException, ResourcePreconditionNotMetException, AwsServiceException,
SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Deletes a ledger and all of its contents. This action is irreversible.
*
*
* If deletion protection is enabled, you must first disable it before you can delete the ledger. You can disable it
* by calling the UpdateLedger operation to set this parameter to false.
*
*
*
* This is a convenience which creates an instance of the {@link DeleteLedgerRequest.Builder} avoiding the need to
* create one manually via {@link DeleteLedgerRequest#builder()}
*
*
* @param deleteLedgerRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.DeleteLedgerRequest.Builder} to create a request.
* @return Result of the DeleteLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourceInUseException
* The specified resource can't be modified at this time.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.DeleteLedger
* @see AWS API
* Documentation
*/
default DeleteLedgerResponse deleteLedger(Consumer deleteLedgerRequest)
throws InvalidParameterException, ResourceNotFoundException, ResourceInUseException,
ResourcePreconditionNotMetException, AwsServiceException, SdkClientException, QldbException {
return deleteLedger(DeleteLedgerRequest.builder().applyMutation(deleteLedgerRequest).build());
}
/**
*
* Returns detailed information about a given Amazon QLDB journal stream. The output includes the Amazon Resource
* Name (ARN), stream name, current status, creation time, and the parameters of the original stream creation
* request.
*
*
* This action does not return any expired journal streams. For more information, see Expiration for terminal streams in the Amazon QLDB Developer Guide.
*
*
* @param describeJournalKinesisStreamRequest
* @return Result of the DescribeJournalKinesisStream operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.DescribeJournalKinesisStream
* @see AWS API Documentation
*/
default DescribeJournalKinesisStreamResponse describeJournalKinesisStream(
DescribeJournalKinesisStreamRequest describeJournalKinesisStreamRequest) throws InvalidParameterException,
ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns detailed information about a given Amazon QLDB journal stream. The output includes the Amazon Resource
* Name (ARN), stream name, current status, creation time, and the parameters of the original stream creation
* request.
*
*
* This action does not return any expired journal streams. For more information, see Expiration for terminal streams in the Amazon QLDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeJournalKinesisStreamRequest.Builder}
* avoiding the need to create one manually via {@link DescribeJournalKinesisStreamRequest#builder()}
*
*
* @param describeJournalKinesisStreamRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.DescribeJournalKinesisStreamRequest.Builder} to create a
* request.
* @return Result of the DescribeJournalKinesisStream operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.DescribeJournalKinesisStream
* @see AWS API Documentation
*/
default DescribeJournalKinesisStreamResponse describeJournalKinesisStream(
Consumer describeJournalKinesisStreamRequest)
throws InvalidParameterException, ResourceNotFoundException, ResourcePreconditionNotMetException,
AwsServiceException, SdkClientException, QldbException {
return describeJournalKinesisStream(DescribeJournalKinesisStreamRequest.builder()
.applyMutation(describeJournalKinesisStreamRequest).build());
}
/**
*
* Returns information about a journal export job, including the ledger name, export ID, creation time, current
* status, and the parameters of the original export creation request.
*
*
* This action does not return any expired export jobs. For more information, see Export job expiration in the Amazon QLDB Developer Guide.
*
*
* If the export job with the given ExportId doesn't exist, then throws
* ResourceNotFoundException.
*
*
* If the ledger with the given Name doesn't exist, then throws ResourceNotFoundException.
*
*
* @param describeJournalS3ExportRequest
* @return Result of the DescribeJournalS3Export operation returned by the service.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.DescribeJournalS3Export
* @see AWS
* API Documentation
*/
default DescribeJournalS3ExportResponse describeJournalS3Export(DescribeJournalS3ExportRequest describeJournalS3ExportRequest)
throws ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns information about a journal export job, including the ledger name, export ID, creation time, current
* status, and the parameters of the original export creation request.
*
*
* This action does not return any expired export jobs. For more information, see Export job expiration in the Amazon QLDB Developer Guide.
*
*
* If the export job with the given ExportId doesn't exist, then throws
* ResourceNotFoundException.
*
*
* If the ledger with the given Name doesn't exist, then throws ResourceNotFoundException.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeJournalS3ExportRequest.Builder} avoiding
* the need to create one manually via {@link DescribeJournalS3ExportRequest#builder()}
*
*
* @param describeJournalS3ExportRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.DescribeJournalS3ExportRequest.Builder} to create a
* request.
* @return Result of the DescribeJournalS3Export operation returned by the service.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.DescribeJournalS3Export
* @see AWS
* API Documentation
*/
default DescribeJournalS3ExportResponse describeJournalS3Export(
Consumer describeJournalS3ExportRequest) throws ResourceNotFoundException,
AwsServiceException, SdkClientException, QldbException {
return describeJournalS3Export(DescribeJournalS3ExportRequest.builder().applyMutation(describeJournalS3ExportRequest)
.build());
}
/**
*
* Returns information about a ledger, including its state, permissions mode, encryption at rest settings, and when
* it was created.
*
*
* @param describeLedgerRequest
* @return Result of the DescribeLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.DescribeLedger
* @see AWS API
* Documentation
*/
default DescribeLedgerResponse describeLedger(DescribeLedgerRequest describeLedgerRequest) throws InvalidParameterException,
ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns information about a ledger, including its state, permissions mode, encryption at rest settings, and when
* it was created.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeLedgerRequest.Builder} avoiding the need to
* create one manually via {@link DescribeLedgerRequest#builder()}
*
*
* @param describeLedgerRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.DescribeLedgerRequest.Builder} to create a request.
* @return Result of the DescribeLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.DescribeLedger
* @see AWS API
* Documentation
*/
default DescribeLedgerResponse describeLedger(Consumer describeLedgerRequest)
throws InvalidParameterException, ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
return describeLedger(DescribeLedgerRequest.builder().applyMutation(describeLedgerRequest).build());
}
/**
*
* Exports journal contents within a date and time range from a ledger into a specified Amazon Simple Storage
* Service (Amazon S3) bucket. A journal export job can write the data objects in either the text or binary
* representation of Amazon Ion format, or in JSON Lines text format.
*
*
* If the ledger with the given Name doesn't exist, then throws ResourceNotFoundException.
*
*
* If the ledger with the given Name is in CREATING status, then throws
* ResourcePreconditionNotMetException.
*
*
* You can initiate up to two concurrent journal export requests for each ledger. Beyond this limit, journal export
* requests throw LimitExceededException.
*
*
* @param exportJournalToS3Request
* @return Result of the ExportJournalToS3 operation returned by the service.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ExportJournalToS3
* @see AWS API
* Documentation
*/
default ExportJournalToS3Response exportJournalToS3(ExportJournalToS3Request exportJournalToS3Request)
throws ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Exports journal contents within a date and time range from a ledger into a specified Amazon Simple Storage
* Service (Amazon S3) bucket. A journal export job can write the data objects in either the text or binary
* representation of Amazon Ion format, or in JSON Lines text format.
*
*
* If the ledger with the given Name doesn't exist, then throws ResourceNotFoundException.
*
*
* If the ledger with the given Name is in CREATING status, then throws
* ResourcePreconditionNotMetException.
*
*
* You can initiate up to two concurrent journal export requests for each ledger. Beyond this limit, journal export
* requests throw LimitExceededException.
*
*
*
* This is a convenience which creates an instance of the {@link ExportJournalToS3Request.Builder} avoiding the need
* to create one manually via {@link ExportJournalToS3Request#builder()}
*
*
* @param exportJournalToS3Request
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ExportJournalToS3Request.Builder} to create a request.
* @return Result of the ExportJournalToS3 operation returned by the service.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ExportJournalToS3
* @see AWS API
* Documentation
*/
default ExportJournalToS3Response exportJournalToS3(Consumer exportJournalToS3Request)
throws ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
return exportJournalToS3(ExportJournalToS3Request.builder().applyMutation(exportJournalToS3Request).build());
}
/**
*
* Returns a block object at a specified address in a journal. Also returns a proof of the specified block for
* verification if DigestTipAddress is provided.
*
*
* For information about the data contents in a block, see Journal contents in the
* Amazon QLDB Developer Guide.
*
*
* If the specified ledger doesn't exist or is in DELETING status, then throws
* ResourceNotFoundException.
*
*
* If the specified ledger is in CREATING status, then throws
* ResourcePreconditionNotMetException.
*
*
* If no block exists with the specified address, then throws InvalidParameterException.
*
*
* @param getBlockRequest
* @return Result of the GetBlock operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.GetBlock
* @see AWS API
* Documentation
*/
default GetBlockResponse getBlock(GetBlockRequest getBlockRequest) throws InvalidParameterException,
ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns a block object at a specified address in a journal. Also returns a proof of the specified block for
* verification if DigestTipAddress is provided.
*
*
* For information about the data contents in a block, see Journal contents in the
* Amazon QLDB Developer Guide.
*
*
* If the specified ledger doesn't exist or is in DELETING status, then throws
* ResourceNotFoundException.
*
*
* If the specified ledger is in CREATING status, then throws
* ResourcePreconditionNotMetException.
*
*
* If no block exists with the specified address, then throws InvalidParameterException.
*
*
*
* This is a convenience which creates an instance of the {@link GetBlockRequest.Builder} avoiding the need to
* create one manually via {@link GetBlockRequest#builder()}
*
*
* @param getBlockRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.GetBlockRequest.Builder} to create a request.
* @return Result of the GetBlock operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.GetBlock
* @see AWS API
* Documentation
*/
default GetBlockResponse getBlock(Consumer getBlockRequest) throws InvalidParameterException,
ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
return getBlock(GetBlockRequest.builder().applyMutation(getBlockRequest).build());
}
/**
*
* Returns the digest of a ledger at the latest committed block in the journal. The response includes a 256-bit hash
* value and a block address.
*
*
* @param getDigestRequest
* @return Result of the GetDigest operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.GetDigest
* @see AWS API
* Documentation
*/
default GetDigestResponse getDigest(GetDigestRequest getDigestRequest) throws InvalidParameterException,
ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns the digest of a ledger at the latest committed block in the journal. The response includes a 256-bit hash
* value and a block address.
*
*
*
* This is a convenience which creates an instance of the {@link GetDigestRequest.Builder} avoiding the need to
* create one manually via {@link GetDigestRequest#builder()}
*
*
* @param getDigestRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.GetDigestRequest.Builder} to create a request.
* @return Result of the GetDigest operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.GetDigest
* @see AWS API
* Documentation
*/
default GetDigestResponse getDigest(Consumer getDigestRequest) throws InvalidParameterException,
ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
return getDigest(GetDigestRequest.builder().applyMutation(getDigestRequest).build());
}
/**
*
* Returns a revision data object for a specified document ID and block address. Also returns a proof of the
* specified revision for verification if DigestTipAddress is provided.
*
*
* @param getRevisionRequest
* @return Result of the GetRevision operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.GetRevision
* @see AWS API
* Documentation
*/
default GetRevisionResponse getRevision(GetRevisionRequest getRevisionRequest) throws InvalidParameterException,
ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns a revision data object for a specified document ID and block address. Also returns a proof of the
* specified revision for verification if DigestTipAddress is provided.
*
*
*
* This is a convenience which creates an instance of the {@link GetRevisionRequest.Builder} avoiding the need to
* create one manually via {@link GetRevisionRequest#builder()}
*
*
* @param getRevisionRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.GetRevisionRequest.Builder} to create a request.
* @return Result of the GetRevision operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.GetRevision
* @see AWS API
* Documentation
*/
default GetRevisionResponse getRevision(Consumer getRevisionRequest)
throws InvalidParameterException, ResourceNotFoundException, ResourcePreconditionNotMetException,
AwsServiceException, SdkClientException, QldbException {
return getRevision(GetRevisionRequest.builder().applyMutation(getRevisionRequest).build());
}
/**
*
* Returns all Amazon QLDB journal streams for a given ledger.
*
*
* This action does not return any expired journal streams. For more information, see Expiration for terminal streams in the Amazon QLDB Developer Guide.
*
*
* This action returns a maximum of MaxResults items. It is paginated so that you can retrieve all the
* items by calling ListJournalKinesisStreamsForLedger multiple times.
*
*
* @param listJournalKinesisStreamsForLedgerRequest
* @return Result of the ListJournalKinesisStreamsForLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalKinesisStreamsForLedger
* @see AWS API Documentation
*/
default ListJournalKinesisStreamsForLedgerResponse listJournalKinesisStreamsForLedger(
ListJournalKinesisStreamsForLedgerRequest listJournalKinesisStreamsForLedgerRequest)
throws InvalidParameterException, ResourceNotFoundException, ResourcePreconditionNotMetException,
AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns all Amazon QLDB journal streams for a given ledger.
*
*
* This action does not return any expired journal streams. For more information, see Expiration for terminal streams in the Amazon QLDB Developer Guide.
*
*
* This action returns a maximum of MaxResults items. It is paginated so that you can retrieve all the
* items by calling ListJournalKinesisStreamsForLedger multiple times.
*
*
*
* This is a convenience which creates an instance of the {@link ListJournalKinesisStreamsForLedgerRequest.Builder}
* avoiding the need to create one manually via {@link ListJournalKinesisStreamsForLedgerRequest#builder()}
*
*
* @param listJournalKinesisStreamsForLedgerRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerRequest.Builder} to
* create a request.
* @return Result of the ListJournalKinesisStreamsForLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalKinesisStreamsForLedger
* @see AWS API Documentation
*/
default ListJournalKinesisStreamsForLedgerResponse listJournalKinesisStreamsForLedger(
Consumer listJournalKinesisStreamsForLedgerRequest)
throws InvalidParameterException, ResourceNotFoundException, ResourcePreconditionNotMetException,
AwsServiceException, SdkClientException, QldbException {
return listJournalKinesisStreamsForLedger(ListJournalKinesisStreamsForLedgerRequest.builder()
.applyMutation(listJournalKinesisStreamsForLedgerRequest).build());
}
/**
*
* This is a variant of
* {@link #listJournalKinesisStreamsForLedger(software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerRequest)}
* 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
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalKinesisStreamsForLedgerIterable responses = client.listJournalKinesisStreamsForLedgerPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.qldb.paginators.ListJournalKinesisStreamsForLedgerIterable responses = client
* .listJournalKinesisStreamsForLedgerPaginator(request);
* for (software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalKinesisStreamsForLedgerIterable responses = client.listJournalKinesisStreamsForLedgerPaginator(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
* {@link #listJournalKinesisStreamsForLedger(software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerRequest)}
* operation.
*
*
* @param listJournalKinesisStreamsForLedgerRequest
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalKinesisStreamsForLedger
* @see AWS API Documentation
*/
default ListJournalKinesisStreamsForLedgerIterable listJournalKinesisStreamsForLedgerPaginator(
ListJournalKinesisStreamsForLedgerRequest listJournalKinesisStreamsForLedgerRequest)
throws InvalidParameterException, ResourceNotFoundException, ResourcePreconditionNotMetException,
AwsServiceException, SdkClientException, QldbException {
return new ListJournalKinesisStreamsForLedgerIterable(this, listJournalKinesisStreamsForLedgerRequest);
}
/**
*
* This is a variant of
* {@link #listJournalKinesisStreamsForLedger(software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerRequest)}
* 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
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalKinesisStreamsForLedgerIterable responses = client.listJournalKinesisStreamsForLedgerPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.qldb.paginators.ListJournalKinesisStreamsForLedgerIterable responses = client
* .listJournalKinesisStreamsForLedgerPaginator(request);
* for (software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalKinesisStreamsForLedgerIterable responses = client.listJournalKinesisStreamsForLedgerPaginator(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
* {@link #listJournalKinesisStreamsForLedger(software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerRequest)}
* operation.
*
*
*
* This is a convenience which creates an instance of the {@link ListJournalKinesisStreamsForLedgerRequest.Builder}
* avoiding the need to create one manually via {@link ListJournalKinesisStreamsForLedgerRequest#builder()}
*
*
* @param listJournalKinesisStreamsForLedgerRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ListJournalKinesisStreamsForLedgerRequest.Builder} to
* create a request.
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalKinesisStreamsForLedger
* @see AWS API Documentation
*/
default ListJournalKinesisStreamsForLedgerIterable listJournalKinesisStreamsForLedgerPaginator(
Consumer listJournalKinesisStreamsForLedgerRequest)
throws InvalidParameterException, ResourceNotFoundException, ResourcePreconditionNotMetException,
AwsServiceException, SdkClientException, QldbException {
return listJournalKinesisStreamsForLedgerPaginator(ListJournalKinesisStreamsForLedgerRequest.builder()
.applyMutation(listJournalKinesisStreamsForLedgerRequest).build());
}
/**
*
* Returns all journal export jobs for all ledgers that are associated with the current Amazon Web Services account
* and Region.
*
*
* This action returns a maximum of MaxResults items, and is paginated so that you can retrieve all the
* items by calling ListJournalS3Exports multiple times.
*
*
* This action does not return any expired export jobs. For more information, see Export job expiration in the Amazon QLDB Developer Guide.
*
*
* @param listJournalS3ExportsRequest
* @return Result of the ListJournalS3Exports operation returned by the service.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalS3Exports
* @see AWS API
* Documentation
*/
default ListJournalS3ExportsResponse listJournalS3Exports(ListJournalS3ExportsRequest listJournalS3ExportsRequest)
throws AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns all journal export jobs for all ledgers that are associated with the current Amazon Web Services account
* and Region.
*
*
* This action returns a maximum of MaxResults items, and is paginated so that you can retrieve all the
* items by calling ListJournalS3Exports multiple times.
*
*
* This action does not return any expired export jobs. For more information, see Export job expiration in the Amazon QLDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link ListJournalS3ExportsRequest.Builder} avoiding the
* need to create one manually via {@link ListJournalS3ExportsRequest#builder()}
*
*
* @param listJournalS3ExportsRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsRequest.Builder} to create a
* request.
* @return Result of the ListJournalS3Exports operation returned by the service.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalS3Exports
* @see AWS API
* Documentation
*/
default ListJournalS3ExportsResponse listJournalS3Exports(
Consumer listJournalS3ExportsRequest) throws AwsServiceException,
SdkClientException, QldbException {
return listJournalS3Exports(ListJournalS3ExportsRequest.builder().applyMutation(listJournalS3ExportsRequest).build());
}
/**
*
* This is a variant of
* {@link #listJournalS3Exports(software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsRequest)} 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
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsIterable responses = client.listJournalS3ExportsPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsIterable responses = client
* .listJournalS3ExportsPaginator(request);
* for (software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsIterable responses = client.listJournalS3ExportsPaginator(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
* {@link #listJournalS3Exports(software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsRequest)}
* operation.
*
*
* @param listJournalS3ExportsRequest
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalS3Exports
* @see AWS API
* Documentation
*/
default ListJournalS3ExportsIterable listJournalS3ExportsPaginator(ListJournalS3ExportsRequest listJournalS3ExportsRequest)
throws AwsServiceException, SdkClientException, QldbException {
return new ListJournalS3ExportsIterable(this, listJournalS3ExportsRequest);
}
/**
*
* This is a variant of
* {@link #listJournalS3Exports(software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsRequest)} 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
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsIterable responses = client.listJournalS3ExportsPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsIterable responses = client
* .listJournalS3ExportsPaginator(request);
* for (software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsIterable responses = client.listJournalS3ExportsPaginator(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
* {@link #listJournalS3Exports(software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsRequest)}
* operation.
*
*
*
* This is a convenience which creates an instance of the {@link ListJournalS3ExportsRequest.Builder} avoiding the
* need to create one manually via {@link ListJournalS3ExportsRequest#builder()}
*
*
* @param listJournalS3ExportsRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsRequest.Builder} to create a
* request.
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalS3Exports
* @see AWS API
* Documentation
*/
default ListJournalS3ExportsIterable listJournalS3ExportsPaginator(
Consumer listJournalS3ExportsRequest) throws AwsServiceException,
SdkClientException, QldbException {
return listJournalS3ExportsPaginator(ListJournalS3ExportsRequest.builder().applyMutation(listJournalS3ExportsRequest)
.build());
}
/**
*
* Returns all journal export jobs for a specified ledger.
*
*
* This action returns a maximum of MaxResults items, and is paginated so that you can retrieve all the
* items by calling ListJournalS3ExportsForLedger multiple times.
*
*
* This action does not return any expired export jobs. For more information, see Export job expiration in the Amazon QLDB Developer Guide.
*
*
* @param listJournalS3ExportsForLedgerRequest
* @return Result of the ListJournalS3ExportsForLedger operation returned by the service.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalS3ExportsForLedger
* @see AWS API Documentation
*/
default ListJournalS3ExportsForLedgerResponse listJournalS3ExportsForLedger(
ListJournalS3ExportsForLedgerRequest listJournalS3ExportsForLedgerRequest) throws AwsServiceException,
SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns all journal export jobs for a specified ledger.
*
*
* This action returns a maximum of MaxResults items, and is paginated so that you can retrieve all the
* items by calling ListJournalS3ExportsForLedger multiple times.
*
*
* This action does not return any expired export jobs. For more information, see Export job expiration in the Amazon QLDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link ListJournalS3ExportsForLedgerRequest.Builder}
* avoiding the need to create one manually via {@link ListJournalS3ExportsForLedgerRequest#builder()}
*
*
* @param listJournalS3ExportsForLedgerRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerRequest.Builder} to create
* a request.
* @return Result of the ListJournalS3ExportsForLedger operation returned by the service.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalS3ExportsForLedger
* @see AWS API Documentation
*/
default ListJournalS3ExportsForLedgerResponse listJournalS3ExportsForLedger(
Consumer listJournalS3ExportsForLedgerRequest)
throws AwsServiceException, SdkClientException, QldbException {
return listJournalS3ExportsForLedger(ListJournalS3ExportsForLedgerRequest.builder()
.applyMutation(listJournalS3ExportsForLedgerRequest).build());
}
/**
*
* This is a variant of
* {@link #listJournalS3ExportsForLedger(software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerRequest)}
* 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
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsForLedgerIterable responses = client.listJournalS3ExportsForLedgerPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsForLedgerIterable responses = client
* .listJournalS3ExportsForLedgerPaginator(request);
* for (software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsForLedgerIterable responses = client.listJournalS3ExportsForLedgerPaginator(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
* {@link #listJournalS3ExportsForLedger(software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerRequest)}
* operation.
*
*
* @param listJournalS3ExportsForLedgerRequest
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalS3ExportsForLedger
* @see AWS API Documentation
*/
default ListJournalS3ExportsForLedgerIterable listJournalS3ExportsForLedgerPaginator(
ListJournalS3ExportsForLedgerRequest listJournalS3ExportsForLedgerRequest) throws AwsServiceException,
SdkClientException, QldbException {
return new ListJournalS3ExportsForLedgerIterable(this, listJournalS3ExportsForLedgerRequest);
}
/**
*
* This is a variant of
* {@link #listJournalS3ExportsForLedger(software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerRequest)}
* 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
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsForLedgerIterable responses = client.listJournalS3ExportsForLedgerPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsForLedgerIterable responses = client
* .listJournalS3ExportsForLedgerPaginator(request);
* for (software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListJournalS3ExportsForLedgerIterable responses = client.listJournalS3ExportsForLedgerPaginator(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
* {@link #listJournalS3ExportsForLedger(software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerRequest)}
* operation.
*
*
*
* This is a convenience which creates an instance of the {@link ListJournalS3ExportsForLedgerRequest.Builder}
* avoiding the need to create one manually via {@link ListJournalS3ExportsForLedgerRequest#builder()}
*
*
* @param listJournalS3ExportsForLedgerRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ListJournalS3ExportsForLedgerRequest.Builder} to create
* a request.
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListJournalS3ExportsForLedger
* @see AWS API Documentation
*/
default ListJournalS3ExportsForLedgerIterable listJournalS3ExportsForLedgerPaginator(
Consumer listJournalS3ExportsForLedgerRequest)
throws AwsServiceException, SdkClientException, QldbException {
return listJournalS3ExportsForLedgerPaginator(ListJournalS3ExportsForLedgerRequest.builder()
.applyMutation(listJournalS3ExportsForLedgerRequest).build());
}
/**
*
* Returns all ledgers that are associated with the current Amazon Web Services account and Region.
*
*
* This action returns a maximum of MaxResults items and is paginated so that you can retrieve all the
* items by calling ListLedgers multiple times.
*
*
* @param listLedgersRequest
* @return Result of the ListLedgers operation returned by the service.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListLedgers
* @see AWS API
* Documentation
*/
default ListLedgersResponse listLedgers(ListLedgersRequest listLedgersRequest) throws AwsServiceException,
SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns all ledgers that are associated with the current Amazon Web Services account and Region.
*
*
* This action returns a maximum of MaxResults items and is paginated so that you can retrieve all the
* items by calling ListLedgers multiple times.
*
*
*
* This is a convenience which creates an instance of the {@link ListLedgersRequest.Builder} avoiding the need to
* create one manually via {@link ListLedgersRequest#builder()}
*
*
* @param listLedgersRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ListLedgersRequest.Builder} to create a request.
* @return Result of the ListLedgers operation returned by the service.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListLedgers
* @see AWS API
* Documentation
*/
default ListLedgersResponse listLedgers(Consumer listLedgersRequest) throws AwsServiceException,
SdkClientException, QldbException {
return listLedgers(ListLedgersRequest.builder().applyMutation(listLedgersRequest).build());
}
/**
*
* This is a variant of {@link #listLedgers(software.amazon.awssdk.services.qldb.model.ListLedgersRequest)}
* 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
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListLedgersIterable responses = client.listLedgersPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.qldb.paginators.ListLedgersIterable responses = client.listLedgersPaginator(request);
* for (software.amazon.awssdk.services.qldb.model.ListLedgersResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListLedgersIterable responses = client.listLedgersPaginator(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
* {@link #listLedgers(software.amazon.awssdk.services.qldb.model.ListLedgersRequest)} operation.
*
*
* @param listLedgersRequest
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListLedgers
* @see AWS API
* Documentation
*/
default ListLedgersIterable listLedgersPaginator(ListLedgersRequest listLedgersRequest) throws AwsServiceException,
SdkClientException, QldbException {
return new ListLedgersIterable(this, listLedgersRequest);
}
/**
*
* This is a variant of {@link #listLedgers(software.amazon.awssdk.services.qldb.model.ListLedgersRequest)}
* 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
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListLedgersIterable responses = client.listLedgersPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.qldb.paginators.ListLedgersIterable responses = client.listLedgersPaginator(request);
* for (software.amazon.awssdk.services.qldb.model.ListLedgersResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.qldb.paginators.ListLedgersIterable responses = client.listLedgersPaginator(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
* {@link #listLedgers(software.amazon.awssdk.services.qldb.model.ListLedgersRequest)} operation.
*
*
*
* This is a convenience which creates an instance of the {@link ListLedgersRequest.Builder} avoiding the need to
* create one manually via {@link ListLedgersRequest#builder()}
*
*
* @param listLedgersRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ListLedgersRequest.Builder} to create a request.
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListLedgers
* @see AWS API
* Documentation
*/
default ListLedgersIterable listLedgersPaginator(Consumer listLedgersRequest)
throws AwsServiceException, SdkClientException, QldbException {
return listLedgersPaginator(ListLedgersRequest.builder().applyMutation(listLedgersRequest).build());
}
/**
*
* Returns all tags for a specified Amazon QLDB resource.
*
*
* @param listTagsForResourceRequest
* @return Result of the ListTagsForResource operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListTagsForResource
* @see AWS API
* Documentation
*/
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
throws InvalidParameterException, ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Returns all tags for a specified Amazon QLDB resource.
*
*
*
* This is a convenience which creates an instance of the {@link ListTagsForResourceRequest.Builder} avoiding the
* need to create one manually via {@link ListTagsForResourceRequest#builder()}
*
*
* @param listTagsForResourceRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.ListTagsForResourceRequest.Builder} to create a request.
* @return Result of the ListTagsForResource operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.ListTagsForResource
* @see AWS API
* Documentation
*/
default ListTagsForResourceResponse listTagsForResource(
Consumer listTagsForResourceRequest) throws InvalidParameterException,
ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
return listTagsForResource(ListTagsForResourceRequest.builder().applyMutation(listTagsForResourceRequest).build());
}
/**
*
* Creates a journal stream for a given Amazon QLDB ledger. The stream captures every document revision that is
* committed to the ledger's journal and delivers the data to a specified Amazon Kinesis Data Streams resource.
*
*
* @param streamJournalToKinesisRequest
* @return Result of the StreamJournalToKinesis operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.StreamJournalToKinesis
* @see AWS
* API Documentation
*/
default StreamJournalToKinesisResponse streamJournalToKinesis(StreamJournalToKinesisRequest streamJournalToKinesisRequest)
throws InvalidParameterException, ResourceNotFoundException, ResourcePreconditionNotMetException,
AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Creates a journal stream for a given Amazon QLDB ledger. The stream captures every document revision that is
* committed to the ledger's journal and delivers the data to a specified Amazon Kinesis Data Streams resource.
*
*
*
* This is a convenience which creates an instance of the {@link StreamJournalToKinesisRequest.Builder} avoiding the
* need to create one manually via {@link StreamJournalToKinesisRequest#builder()}
*
*
* @param streamJournalToKinesisRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.StreamJournalToKinesisRequest.Builder} to create a
* request.
* @return Result of the StreamJournalToKinesis operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws ResourcePreconditionNotMetException
* The operation failed because a condition wasn't satisfied in advance.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.StreamJournalToKinesis
* @see AWS
* API Documentation
*/
default StreamJournalToKinesisResponse streamJournalToKinesis(
Consumer streamJournalToKinesisRequest) throws InvalidParameterException,
ResourceNotFoundException, ResourcePreconditionNotMetException, AwsServiceException, SdkClientException,
QldbException {
return streamJournalToKinesis(StreamJournalToKinesisRequest.builder().applyMutation(streamJournalToKinesisRequest)
.build());
}
/**
*
* Adds one or more tags to a specified Amazon QLDB resource.
*
*
* A resource can have up to 50 tags. If you try to create more than 50 tags for a resource, your request fails and
* returns an error.
*
*
* @param tagResourceRequest
* @return Result of the TagResource operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.TagResource
* @see AWS API
* Documentation
*/
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws InvalidParameterException,
ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Adds one or more tags to a specified Amazon QLDB resource.
*
*
* A resource can have up to 50 tags. If you try to create more than 50 tags for a resource, your request fails and
* returns an error.
*
*
*
* This is a convenience which creates an instance of the {@link TagResourceRequest.Builder} avoiding the need to
* create one manually via {@link TagResourceRequest#builder()}
*
*
* @param tagResourceRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.TagResourceRequest.Builder} to create a request.
* @return Result of the TagResource operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.TagResource
* @see AWS API
* Documentation
*/
default TagResourceResponse tagResource(Consumer tagResourceRequest)
throws InvalidParameterException, ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
return tagResource(TagResourceRequest.builder().applyMutation(tagResourceRequest).build());
}
/**
*
* Removes one or more tags from a specified Amazon QLDB resource. You can specify up to 50 tag keys to remove.
*
*
* @param untagResourceRequest
* @return Result of the UntagResource operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.UntagResource
* @see AWS API
* Documentation
*/
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws InvalidParameterException,
ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Removes one or more tags from a specified Amazon QLDB resource. You can specify up to 50 tag keys to remove.
*
*
*
* This is a convenience which creates an instance of the {@link UntagResourceRequest.Builder} avoiding the need to
* create one manually via {@link UntagResourceRequest#builder()}
*
*
* @param untagResourceRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.UntagResourceRequest.Builder} to create a request.
* @return Result of the UntagResource operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.UntagResource
* @see AWS API
* Documentation
*/
default UntagResourceResponse untagResource(Consumer untagResourceRequest)
throws InvalidParameterException, ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
return untagResource(UntagResourceRequest.builder().applyMutation(untagResourceRequest).build());
}
/**
*
* Updates properties on a ledger.
*
*
* @param updateLedgerRequest
* @return Result of the UpdateLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.UpdateLedger
* @see AWS API
* Documentation
*/
default UpdateLedgerResponse updateLedger(UpdateLedgerRequest updateLedgerRequest) throws InvalidParameterException,
ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Updates properties on a ledger.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateLedgerRequest.Builder} avoiding the need to
* create one manually via {@link UpdateLedgerRequest#builder()}
*
*
* @param updateLedgerRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.UpdateLedgerRequest.Builder} to create a request.
* @return Result of the UpdateLedger operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.UpdateLedger
* @see AWS API
* Documentation
*/
default UpdateLedgerResponse updateLedger(Consumer updateLedgerRequest)
throws InvalidParameterException, ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
return updateLedger(UpdateLedgerRequest.builder().applyMutation(updateLedgerRequest).build());
}
/**
*
* Updates the permissions mode of a ledger.
*
*
*
* Before you switch to the STANDARD permissions mode, you must first create all required IAM policies
* and table tags to avoid disruption to your users. To learn more, see Migrating to the standard permissions mode in the Amazon QLDB Developer Guide.
*
*
*
* @param updateLedgerPermissionsModeRequest
* @return Result of the UpdateLedgerPermissionsMode operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.UpdateLedgerPermissionsMode
* @see AWS API Documentation
*/
default UpdateLedgerPermissionsModeResponse updateLedgerPermissionsMode(
UpdateLedgerPermissionsModeRequest updateLedgerPermissionsModeRequest) throws InvalidParameterException,
ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
throw new UnsupportedOperationException();
}
/**
*
* Updates the permissions mode of a ledger.
*
*
*
* Before you switch to the STANDARD permissions mode, you must first create all required IAM policies
* and table tags to avoid disruption to your users. To learn more, see Migrating to the standard permissions mode in the Amazon QLDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateLedgerPermissionsModeRequest.Builder}
* avoiding the need to create one manually via {@link UpdateLedgerPermissionsModeRequest#builder()}
*
*
* @param updateLedgerPermissionsModeRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.qldb.model.UpdateLedgerPermissionsModeRequest.Builder} to create a
* request.
* @return Result of the UpdateLedgerPermissionsMode operation returned by the service.
* @throws InvalidParameterException
* One or more parameters in the request aren't valid.
* @throws ResourceNotFoundException
* The specified resource doesn't exist.
* @throws SdkException
* Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
* catch all scenarios.
* @throws SdkClientException
* If any client side error occurs such as an IO related failure, failure to get credentials, etc.
* @throws QldbException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample QldbClient.UpdateLedgerPermissionsMode
* @see AWS API Documentation
*/
default UpdateLedgerPermissionsModeResponse updateLedgerPermissionsMode(
Consumer updateLedgerPermissionsModeRequest)
throws InvalidParameterException, ResourceNotFoundException, AwsServiceException, SdkClientException, QldbException {
return updateLedgerPermissionsMode(UpdateLedgerPermissionsModeRequest.builder()
.applyMutation(updateLedgerPermissionsModeRequest).build());
}
/**
* Create a {@link QldbClient} with the region loaded from the
* {@link software.amazon.awssdk.regions.providers.DefaultAwsRegionProviderChain} and credentials loaded from the
* {@link software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider}.
*/
static QldbClient create() {
return builder().build();
}
/**
* Create a builder that can be used to configure and create a {@link QldbClient}.
*/
static QldbClientBuilder builder() {
return new DefaultQldbClientBuilder();
}
static ServiceMetadata serviceMetadata() {
return ServiceMetadata.of(SERVICE_METADATA_ID);
}
@Override
default QldbServiceClientConfiguration serviceClientConfiguration() {
throw new UnsupportedOperationException();
}
}