software.amazon.awssdk.services.timestreamwrite.TimestreamWriteClient Maven / Gradle / Ivy
/*
* 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.timestreamwrite;
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.exception.AwsServiceException;
import software.amazon.awssdk.core.SdkClient;
import software.amazon.awssdk.core.exception.SdkClientException;
import software.amazon.awssdk.regions.ServiceMetadata;
import software.amazon.awssdk.services.timestreamwrite.model.AccessDeniedException;
import software.amazon.awssdk.services.timestreamwrite.model.ConflictException;
import software.amazon.awssdk.services.timestreamwrite.model.CreateDatabaseRequest;
import software.amazon.awssdk.services.timestreamwrite.model.CreateDatabaseResponse;
import software.amazon.awssdk.services.timestreamwrite.model.CreateTableRequest;
import software.amazon.awssdk.services.timestreamwrite.model.CreateTableResponse;
import software.amazon.awssdk.services.timestreamwrite.model.DeleteDatabaseRequest;
import software.amazon.awssdk.services.timestreamwrite.model.DeleteDatabaseResponse;
import software.amazon.awssdk.services.timestreamwrite.model.DeleteTableRequest;
import software.amazon.awssdk.services.timestreamwrite.model.DeleteTableResponse;
import software.amazon.awssdk.services.timestreamwrite.model.DescribeDatabaseRequest;
import software.amazon.awssdk.services.timestreamwrite.model.DescribeDatabaseResponse;
import software.amazon.awssdk.services.timestreamwrite.model.DescribeEndpointsRequest;
import software.amazon.awssdk.services.timestreamwrite.model.DescribeEndpointsResponse;
import software.amazon.awssdk.services.timestreamwrite.model.DescribeTableRequest;
import software.amazon.awssdk.services.timestreamwrite.model.DescribeTableResponse;
import software.amazon.awssdk.services.timestreamwrite.model.InternalServerException;
import software.amazon.awssdk.services.timestreamwrite.model.InvalidEndpointException;
import software.amazon.awssdk.services.timestreamwrite.model.ListDatabasesRequest;
import software.amazon.awssdk.services.timestreamwrite.model.ListDatabasesResponse;
import software.amazon.awssdk.services.timestreamwrite.model.ListTablesRequest;
import software.amazon.awssdk.services.timestreamwrite.model.ListTablesResponse;
import software.amazon.awssdk.services.timestreamwrite.model.ListTagsForResourceRequest;
import software.amazon.awssdk.services.timestreamwrite.model.ListTagsForResourceResponse;
import software.amazon.awssdk.services.timestreamwrite.model.RejectedRecordsException;
import software.amazon.awssdk.services.timestreamwrite.model.ResourceNotFoundException;
import software.amazon.awssdk.services.timestreamwrite.model.ServiceQuotaExceededException;
import software.amazon.awssdk.services.timestreamwrite.model.TagResourceRequest;
import software.amazon.awssdk.services.timestreamwrite.model.TagResourceResponse;
import software.amazon.awssdk.services.timestreamwrite.model.ThrottlingException;
import software.amazon.awssdk.services.timestreamwrite.model.TimestreamWriteException;
import software.amazon.awssdk.services.timestreamwrite.model.UntagResourceRequest;
import software.amazon.awssdk.services.timestreamwrite.model.UntagResourceResponse;
import software.amazon.awssdk.services.timestreamwrite.model.UpdateDatabaseRequest;
import software.amazon.awssdk.services.timestreamwrite.model.UpdateDatabaseResponse;
import software.amazon.awssdk.services.timestreamwrite.model.UpdateTableRequest;
import software.amazon.awssdk.services.timestreamwrite.model.UpdateTableResponse;
import software.amazon.awssdk.services.timestreamwrite.model.ValidationException;
import software.amazon.awssdk.services.timestreamwrite.model.WriteRecordsRequest;
import software.amazon.awssdk.services.timestreamwrite.model.WriteRecordsResponse;
import software.amazon.awssdk.services.timestreamwrite.paginators.ListDatabasesIterable;
import software.amazon.awssdk.services.timestreamwrite.paginators.ListTablesIterable;
/**
* Service client for accessing Timestream Write. This can be created using the static {@link #builder()} method.
*
*
* Amazon Timestream is a fast, scalable, fully managed time series database service that makes it easy to store and
* analyze trillions of time series data points per day. With Timestream, you can easily store and analyze IoT sensor
* data to derive insights from your IoT applications. You can analyze industrial telemetry to streamline equipment
* management and maintenance. You can also store and analyze log data and metrics to improve the performance and
* availability of your applications. Timestream is built from the ground up to effectively ingest, process, and store
* time series data. It organizes data to optimize query processing. It automatically scales based on the volume of data
* ingested and on the query volume to ensure you receive optimal performance while inserting and querying data. As your
* data grows over time, Timestream’s adaptive query processing engine spans across storage tiers to provide fast
* analysis while reducing costs.
*
*/
@Generated("software.amazon.awssdk:codegen")
@SdkPublicApi
@ThreadSafe
public interface TimestreamWriteClient extends SdkClient {
String SERVICE_NAME = "timestream";
/**
* Value for looking up the service's metadata from the
* {@link software.amazon.awssdk.regions.ServiceMetadataProvider}.
*/
String SERVICE_METADATA_ID = "ingest.timestream";
/**
* Create a {@link TimestreamWriteClient} 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 TimestreamWriteClient create() {
return builder().build();
}
/**
* Create a builder that can be used to configure and create a {@link TimestreamWriteClient}.
*/
static TimestreamWriteClientBuilder builder() {
return new DefaultTimestreamWriteClientBuilder();
}
/**
*
* Creates a new Timestream database. If the KMS key is not specified, the database will be encrypted with a
* Timestream managed KMS key located in your account. Refer to AWS managed KMS
* keys for more info. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
* @param createDatabaseRequest
* @return Result of the CreateDatabase operation returned by the service.
* @throws ConflictException
* Timestream was unable to process this request because it contains resource that already exists.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.CreateDatabase
* @see AWS API Documentation
*/
default CreateDatabaseResponse createDatabase(CreateDatabaseRequest createDatabaseRequest) throws ConflictException,
ValidationException, AccessDeniedException, ServiceQuotaExceededException, ThrottlingException,
InvalidEndpointException, InternalServerException, AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Creates a new Timestream database. If the KMS key is not specified, the database will be encrypted with a
* Timestream managed KMS key located in your account. Refer to AWS managed KMS
* keys for more info. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link CreateDatabaseRequest.Builder} avoiding the need to
* create one manually via {@link CreateDatabaseRequest#builder()}
*
*
* @param createDatabaseRequest
* A {@link Consumer} that will call methods on {@link CreateDatabaseRequest.Builder} to create a request.
* @return Result of the CreateDatabase operation returned by the service.
* @throws ConflictException
* Timestream was unable to process this request because it contains resource that already exists.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.CreateDatabase
* @see AWS API Documentation
*/
default CreateDatabaseResponse createDatabase(Consumer createDatabaseRequest)
throws ConflictException, ValidationException, AccessDeniedException, ServiceQuotaExceededException,
ThrottlingException, InvalidEndpointException, InternalServerException, AwsServiceException, SdkClientException,
TimestreamWriteException {
return createDatabase(CreateDatabaseRequest.builder().applyMutation(createDatabaseRequest).build());
}
/**
*
* The CreateTable operation adds a new table to an existing database in your account. In an AWS account, table
* names must be at least unique within each Region if they are in the same database. You may have identical table
* names in the same Region if the tables are in seperate databases. While creating the table, you must specify the
* table name, database name, and the retention properties. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
* @param createTableRequest
* @return Result of the CreateTable operation returned by the service.
* @throws ConflictException
* Timestream was unable to process this request because it contains resource that already exists.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.CreateTable
* @see AWS
* API Documentation
*/
default CreateTableResponse createTable(CreateTableRequest createTableRequest) throws ConflictException, ValidationException,
AccessDeniedException, ResourceNotFoundException, ServiceQuotaExceededException, ThrottlingException,
InternalServerException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* The CreateTable operation adds a new table to an existing database in your account. In an AWS account, table
* names must be at least unique within each Region if they are in the same database. You may have identical table
* names in the same Region if the tables are in seperate databases. While creating the table, you must specify the
* table name, database name, and the retention properties. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link CreateTableRequest.Builder} avoiding the need to
* create one manually via {@link CreateTableRequest#builder()}
*
*
* @param createTableRequest
* A {@link Consumer} that will call methods on {@link CreateTableRequest.Builder} to create a request.
* @return Result of the CreateTable operation returned by the service.
* @throws ConflictException
* Timestream was unable to process this request because it contains resource that already exists.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.CreateTable
* @see AWS
* API Documentation
*/
default CreateTableResponse createTable(Consumer createTableRequest) throws ConflictException,
ValidationException, AccessDeniedException, ResourceNotFoundException, ServiceQuotaExceededException,
ThrottlingException, InternalServerException, InvalidEndpointException, AwsServiceException, SdkClientException,
TimestreamWriteException {
return createTable(CreateTableRequest.builder().applyMutation(createTableRequest).build());
}
/**
*
* Deletes a given Timestream database. This is an irreversible operation. After a database is deleted, the time
* series data from its tables cannot be recovered.
*
*
* All tables in the database must be deleted first, or a ValidationException error will be thrown.
*
*
* Due to the nature of distributed retries, the operation can return either success or a ResourceNotFoundException.
* Clients should consider them equivalent.
*
*
* @param deleteDatabaseRequest
* @return Result of the DeleteDatabase operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DeleteDatabase
* @see AWS API Documentation
*/
default DeleteDatabaseResponse deleteDatabase(DeleteDatabaseRequest deleteDatabaseRequest) throws InternalServerException,
ThrottlingException, ResourceNotFoundException, ValidationException, AccessDeniedException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Deletes a given Timestream database. This is an irreversible operation. After a database is deleted, the time
* series data from its tables cannot be recovered.
*
*
* All tables in the database must be deleted first, or a ValidationException error will be thrown.
*
*
* Due to the nature of distributed retries, the operation can return either success or a ResourceNotFoundException.
* Clients should consider them equivalent.
*
*
*
* This is a convenience which creates an instance of the {@link DeleteDatabaseRequest.Builder} avoiding the need to
* create one manually via {@link DeleteDatabaseRequest#builder()}
*
*
* @param deleteDatabaseRequest
* A {@link Consumer} that will call methods on {@link DeleteDatabaseRequest.Builder} to create a request.
* @return Result of the DeleteDatabase operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DeleteDatabase
* @see AWS API Documentation
*/
default DeleteDatabaseResponse deleteDatabase(Consumer deleteDatabaseRequest)
throws InternalServerException, ThrottlingException, ResourceNotFoundException, ValidationException,
AccessDeniedException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return deleteDatabase(DeleteDatabaseRequest.builder().applyMutation(deleteDatabaseRequest).build());
}
/**
*
* Deletes a given Timestream table. This is an irreversible operation. After a Timestream database table is
* deleted, the time series data stored in the table cannot be recovered.
*
*
* Due to the nature of distributed retries, the operation can return either success or a ResourceNotFoundException.
* Clients should consider them equivalent.
*
*
* @param deleteTableRequest
* @return Result of the DeleteTable operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DeleteTable
* @see AWS
* API Documentation
*/
default DeleteTableResponse deleteTable(DeleteTableRequest deleteTableRequest) throws InternalServerException,
ThrottlingException, ValidationException, ResourceNotFoundException, AccessDeniedException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Deletes a given Timestream table. This is an irreversible operation. After a Timestream database table is
* deleted, the time series data stored in the table cannot be recovered.
*
*
* Due to the nature of distributed retries, the operation can return either success or a ResourceNotFoundException.
* Clients should consider them equivalent.
*
*
*
* This is a convenience which creates an instance of the {@link DeleteTableRequest.Builder} avoiding the need to
* create one manually via {@link DeleteTableRequest#builder()}
*
*
* @param deleteTableRequest
* A {@link Consumer} that will call methods on {@link DeleteTableRequest.Builder} to create a request.
* @return Result of the DeleteTable operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DeleteTable
* @see AWS
* API Documentation
*/
default DeleteTableResponse deleteTable(Consumer deleteTableRequest)
throws InternalServerException, ThrottlingException, ValidationException, ResourceNotFoundException,
AccessDeniedException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return deleteTable(DeleteTableRequest.builder().applyMutation(deleteTableRequest).build());
}
/**
*
* Returns information about the database, including the database name, time that the database was created, and the
* total number of tables found within the database. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
* @param describeDatabaseRequest
* @return Result of the DescribeDatabase operation returned by the service.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DescribeDatabase
* @see AWS API Documentation
*/
default DescribeDatabaseResponse describeDatabase(DescribeDatabaseRequest describeDatabaseRequest)
throws ResourceNotFoundException, ValidationException, AccessDeniedException, ThrottlingException,
InternalServerException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Returns information about the database, including the database name, time that the database was created, and the
* total number of tables found within the database. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeDatabaseRequest.Builder} avoiding the need
* to create one manually via {@link DescribeDatabaseRequest#builder()}
*
*
* @param describeDatabaseRequest
* A {@link Consumer} that will call methods on {@link DescribeDatabaseRequest.Builder} to create a request.
* @return Result of the DescribeDatabase operation returned by the service.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DescribeDatabase
* @see AWS API Documentation
*/
default DescribeDatabaseResponse describeDatabase(Consumer describeDatabaseRequest)
throws ResourceNotFoundException, ValidationException, AccessDeniedException, ThrottlingException,
InternalServerException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return describeDatabase(DescribeDatabaseRequest.builder().applyMutation(describeDatabaseRequest).build());
}
/**
*
* DescribeEndpoints returns a list of available endpoints to make Timestream API calls against. This API is
* available through both Write and Query.
*
*
* Because Timestream’s SDKs are designed to transparently work with the service’s architecture, including the
* management and mapping of the service endpoints, it is not recommended that you use this API unless:
*
*
* -
*
* Your application uses a programming language that does not yet have SDK support
*
*
* -
*
* You require better control over the client-side implementation
*
*
*
*
* For detailed information on how to use DescribeEndpoints, see The
* Endpoint Discovery Pattern and REST APIs.
*
*
* @param describeEndpointsRequest
* @return Result of the DescribeEndpoints operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ValidationException
* Invalid or malformed request.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DescribeEndpoints
* @see AWS API Documentation
*/
default DescribeEndpointsResponse describeEndpoints(DescribeEndpointsRequest describeEndpointsRequest)
throws InternalServerException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException,
TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* DescribeEndpoints returns a list of available endpoints to make Timestream API calls against. This API is
* available through both Write and Query.
*
*
* Because Timestream’s SDKs are designed to transparently work with the service’s architecture, including the
* management and mapping of the service endpoints, it is not recommended that you use this API unless:
*
*
* -
*
* Your application uses a programming language that does not yet have SDK support
*
*
* -
*
* You require better control over the client-side implementation
*
*
*
*
* For detailed information on how to use DescribeEndpoints, see The
* Endpoint Discovery Pattern and REST APIs.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeEndpointsRequest.Builder} avoiding the need
* to create one manually via {@link DescribeEndpointsRequest#builder()}
*
*
* @param describeEndpointsRequest
* A {@link Consumer} that will call methods on {@link DescribeEndpointsRequest.Builder} to create a request.
* @return Result of the DescribeEndpoints operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ValidationException
* Invalid or malformed request.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DescribeEndpoints
* @see AWS API Documentation
*/
default DescribeEndpointsResponse describeEndpoints(Consumer describeEndpointsRequest)
throws InternalServerException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException,
TimestreamWriteException {
return describeEndpoints(DescribeEndpointsRequest.builder().applyMutation(describeEndpointsRequest).build());
}
/**
*
* Returns information about the table, including the table name, database name, retention duration of the memory
* store and the magnetic store. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
* @param describeTableRequest
* @return Result of the DescribeTable operation returned by the service.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DescribeTable
* @see AWS API Documentation
*/
default DescribeTableResponse describeTable(DescribeTableRequest describeTableRequest) throws ResourceNotFoundException,
ValidationException, AccessDeniedException, ThrottlingException, InternalServerException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Returns information about the table, including the table name, database name, retention duration of the memory
* store and the magnetic store. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeTableRequest.Builder} avoiding the need to
* create one manually via {@link DescribeTableRequest#builder()}
*
*
* @param describeTableRequest
* A {@link Consumer} that will call methods on {@link DescribeTableRequest.Builder} to create a request.
* @return Result of the DescribeTable operation returned by the service.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.DescribeTable
* @see AWS API Documentation
*/
default DescribeTableResponse describeTable(Consumer describeTableRequest)
throws ResourceNotFoundException, ValidationException, AccessDeniedException, ThrottlingException,
InternalServerException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return describeTable(DescribeTableRequest.builder().applyMutation(describeTableRequest).build());
}
/**
*
* Returns a list of your Timestream databases. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
* @param listDatabasesRequest
* @return Result of the ListDatabases operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListDatabases
* @see AWS API Documentation
*/
default ListDatabasesResponse listDatabases(ListDatabasesRequest listDatabasesRequest) throws InternalServerException,
ThrottlingException, ValidationException, AccessDeniedException, InvalidEndpointException, AwsServiceException,
SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Returns a list of your Timestream databases. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link ListDatabasesRequest.Builder} avoiding the need to
* create one manually via {@link ListDatabasesRequest#builder()}
*
*
* @param listDatabasesRequest
* A {@link Consumer} that will call methods on {@link ListDatabasesRequest.Builder} to create a request.
* @return Result of the ListDatabases operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListDatabases
* @see AWS API Documentation
*/
default ListDatabasesResponse listDatabases(Consumer listDatabasesRequest)
throws InternalServerException, ThrottlingException, ValidationException, AccessDeniedException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return listDatabases(ListDatabasesRequest.builder().applyMutation(listDatabasesRequest).build());
}
/**
*
* Returns a list of your Timestream databases. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
*
* This is a variant of
* {@link #listDatabases(software.amazon.awssdk.services.timestreamwrite.model.ListDatabasesRequest)} 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.timestreamwrite.paginators.ListDatabasesIterable responses = client.listDatabasesPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamwrite.paginators.ListDatabasesIterable responses = client
* .listDatabasesPaginator(request);
* for (software.amazon.awssdk.services.timestreamwrite.model.ListDatabasesResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamwrite.paginators.ListDatabasesIterable responses = client.listDatabasesPaginator(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 #listDatabases(software.amazon.awssdk.services.timestreamwrite.model.ListDatabasesRequest)} operation.
*
*
* @param listDatabasesRequest
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListDatabases
* @see AWS API Documentation
*/
default ListDatabasesIterable listDatabasesPaginator(ListDatabasesRequest listDatabasesRequest)
throws InternalServerException, ThrottlingException, ValidationException, AccessDeniedException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Returns a list of your Timestream databases. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
*
* This is a variant of
* {@link #listDatabases(software.amazon.awssdk.services.timestreamwrite.model.ListDatabasesRequest)} 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.timestreamwrite.paginators.ListDatabasesIterable responses = client.listDatabasesPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamwrite.paginators.ListDatabasesIterable responses = client
* .listDatabasesPaginator(request);
* for (software.amazon.awssdk.services.timestreamwrite.model.ListDatabasesResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamwrite.paginators.ListDatabasesIterable responses = client.listDatabasesPaginator(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 #listDatabases(software.amazon.awssdk.services.timestreamwrite.model.ListDatabasesRequest)} operation.
*
*
* This is a convenience which creates an instance of the {@link ListDatabasesRequest.Builder} avoiding the need to
* create one manually via {@link ListDatabasesRequest#builder()}
*
*
* @param listDatabasesRequest
* A {@link Consumer} that will call methods on {@link ListDatabasesRequest.Builder} to create a request.
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListDatabases
* @see AWS API Documentation
*/
default ListDatabasesIterable listDatabasesPaginator(Consumer listDatabasesRequest)
throws InternalServerException, ThrottlingException, ValidationException, AccessDeniedException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return listDatabasesPaginator(ListDatabasesRequest.builder().applyMutation(listDatabasesRequest).build());
}
/**
*
* A list of tables, along with the name, status and retention properties of each table.
*
*
* @param listTablesRequest
* @return Result of the ListTables operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListTables
* @see AWS
* API Documentation
*/
default ListTablesResponse listTables(ListTablesRequest listTablesRequest) throws InternalServerException,
ThrottlingException, ValidationException, ResourceNotFoundException, AccessDeniedException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* A list of tables, along with the name, status and retention properties of each table.
*
*
*
* This is a convenience which creates an instance of the {@link ListTablesRequest.Builder} avoiding the need to
* create one manually via {@link ListTablesRequest#builder()}
*
*
* @param listTablesRequest
* A {@link Consumer} that will call methods on {@link ListTablesRequest.Builder} to create a request.
* @return Result of the ListTables operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListTables
* @see AWS
* API Documentation
*/
default ListTablesResponse listTables(Consumer listTablesRequest) throws InternalServerException,
ThrottlingException, ValidationException, ResourceNotFoundException, AccessDeniedException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
return listTables(ListTablesRequest.builder().applyMutation(listTablesRequest).build());
}
/**
*
* A list of tables, along with the name, status and retention properties of each table.
*
*
*
* This is a variant of {@link #listTables(software.amazon.awssdk.services.timestreamwrite.model.ListTablesRequest)}
* 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.timestreamwrite.paginators.ListTablesIterable responses = client.listTablesPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamwrite.paginators.ListTablesIterable responses = client.listTablesPaginator(request);
* for (software.amazon.awssdk.services.timestreamwrite.model.ListTablesResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamwrite.paginators.ListTablesIterable responses = client.listTablesPaginator(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 #listTables(software.amazon.awssdk.services.timestreamwrite.model.ListTablesRequest)} operation.
*
*
* @param listTablesRequest
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListTables
* @see AWS
* API Documentation
*/
default ListTablesIterable listTablesPaginator(ListTablesRequest listTablesRequest) throws InternalServerException,
ThrottlingException, ValidationException, ResourceNotFoundException, AccessDeniedException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* A list of tables, along with the name, status and retention properties of each table.
*
*
*
* This is a variant of {@link #listTables(software.amazon.awssdk.services.timestreamwrite.model.ListTablesRequest)}
* 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.timestreamwrite.paginators.ListTablesIterable responses = client.listTablesPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamwrite.paginators.ListTablesIterable responses = client.listTablesPaginator(request);
* for (software.amazon.awssdk.services.timestreamwrite.model.ListTablesResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamwrite.paginators.ListTablesIterable responses = client.listTablesPaginator(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 #listTables(software.amazon.awssdk.services.timestreamwrite.model.ListTablesRequest)} operation.
*
*
* This is a convenience which creates an instance of the {@link ListTablesRequest.Builder} avoiding the need to
* create one manually via {@link ListTablesRequest#builder()}
*
*
* @param listTablesRequest
* A {@link Consumer} that will call methods on {@link ListTablesRequest.Builder} to create a request.
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListTables
* @see AWS
* API Documentation
*/
default ListTablesIterable listTablesPaginator(Consumer listTablesRequest)
throws InternalServerException, ThrottlingException, ValidationException, ResourceNotFoundException,
AccessDeniedException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return listTablesPaginator(ListTablesRequest.builder().applyMutation(listTablesRequest).build());
}
/**
*
* List all tags on a Timestream resource.
*
*
* @param listTagsForResourceRequest
* @return Result of the ListTagsForResource operation returned by the service.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListTagsForResource
* @see AWS API Documentation
*/
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
throws ResourceNotFoundException, ThrottlingException, ValidationException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* List all tags on a Timestream 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 ListTagsForResourceRequest.Builder} to create a
* request.
* @return Result of the ListTagsForResource operation returned by the service.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.ListTagsForResource
* @see AWS API Documentation
*/
default ListTagsForResourceResponse listTagsForResource(
Consumer listTagsForResourceRequest) throws ResourceNotFoundException,
ThrottlingException, ValidationException, InvalidEndpointException, AwsServiceException, SdkClientException,
TimestreamWriteException {
return listTagsForResource(ListTagsForResourceRequest.builder().applyMutation(listTagsForResourceRequest).build());
}
/**
*
* Associate a set of tags with a Timestream resource. You can then activate these user-defined tags so that they
* appear on the Billing and Cost Management console for cost allocation tracking.
*
*
* @param tagResourceRequest
* @return Result of the TagResource operation returned by the service.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.TagResource
* @see AWS
* API Documentation
*/
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ResourceNotFoundException,
ServiceQuotaExceededException, ThrottlingException, ValidationException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Associate a set of tags with a Timestream resource. You can then activate these user-defined tags so that they
* appear on the Billing and Cost Management console for cost allocation tracking.
*
*
*
* 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 TagResourceRequest.Builder} to create a request.
* @return Result of the TagResource operation returned by the service.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.TagResource
* @see AWS
* API Documentation
*/
default TagResourceResponse tagResource(Consumer tagResourceRequest)
throws ResourceNotFoundException, ServiceQuotaExceededException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return tagResource(TagResourceRequest.builder().applyMutation(tagResourceRequest).build());
}
/**
*
* Removes the association of tags from a Timestream resource.
*
*
* @param untagResourceRequest
* @return Result of the UntagResource operation returned by the service.
* @throws ValidationException
* Invalid or malformed request.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.UntagResource
* @see AWS API Documentation
*/
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ValidationException,
ServiceQuotaExceededException, ThrottlingException, ResourceNotFoundException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Removes the association of tags from a Timestream resource.
*
*
*
* 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 UntagResourceRequest.Builder} to create a request.
* @return Result of the UntagResource operation returned by the service.
* @throws ValidationException
* Invalid or malformed request.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.UntagResource
* @see AWS API Documentation
*/
default UntagResourceResponse untagResource(Consumer untagResourceRequest)
throws ValidationException, ServiceQuotaExceededException, ThrottlingException, ResourceNotFoundException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return untagResource(UntagResourceRequest.builder().applyMutation(untagResourceRequest).build());
}
/**
*
* Modifies the KMS key for an existing database. While updating the database, you must specify the database name
* and the identifier of the new KMS key to be used (KmsKeyId). If there are any concurrent
* UpdateDatabase requests, first writer wins.
*
*
* @param updateDatabaseRequest
* @return Result of the UpdateDatabase operation returned by the service.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.UpdateDatabase
* @see AWS API Documentation
*/
default UpdateDatabaseResponse updateDatabase(UpdateDatabaseRequest updateDatabaseRequest) throws ValidationException,
AccessDeniedException, ResourceNotFoundException, ServiceQuotaExceededException, ThrottlingException,
InternalServerException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Modifies the KMS key for an existing database. While updating the database, you must specify the database name
* and the identifier of the new KMS key to be used (KmsKeyId). If there are any concurrent
* UpdateDatabase requests, first writer wins.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateDatabaseRequest.Builder} avoiding the need to
* create one manually via {@link UpdateDatabaseRequest#builder()}
*
*
* @param updateDatabaseRequest
* A {@link Consumer} that will call methods on {@link UpdateDatabaseRequest.Builder} to create a request.
* @return Result of the UpdateDatabase operation returned by the service.
* @throws ValidationException
* Invalid or malformed request.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws ServiceQuotaExceededException
* Instance quota of resource exceeded for this account.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.UpdateDatabase
* @see AWS API Documentation
*/
default UpdateDatabaseResponse updateDatabase(Consumer updateDatabaseRequest)
throws ValidationException, AccessDeniedException, ResourceNotFoundException, ServiceQuotaExceededException,
ThrottlingException, InternalServerException, InvalidEndpointException, AwsServiceException, SdkClientException,
TimestreamWriteException {
return updateDatabase(UpdateDatabaseRequest.builder().applyMutation(updateDatabaseRequest).build());
}
/**
*
* Modifies the retention duration of the memory store and magnetic store for your Timestream table. Note that the
* change in retention duration takes effect immediately. For example, if the retention period of the memory store
* was initially set to 2 hours and then changed to 24 hours, the memory store will be capable of holding 24 hours
* of data, but will be populated with 24 hours of data 22 hours after this change was made. Timestream does not
* retrieve data from the magnetic store to populate the memory store.
*
*
* Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
* @param updateTableRequest
* @return Result of the UpdateTable operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.UpdateTable
* @see AWS
* API Documentation
*/
default UpdateTableResponse updateTable(UpdateTableRequest updateTableRequest) throws InternalServerException,
ThrottlingException, ValidationException, ResourceNotFoundException, AccessDeniedException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* Modifies the retention duration of the memory store and magnetic store for your Timestream table. Note that the
* change in retention duration takes effect immediately. For example, if the retention period of the memory store
* was initially set to 2 hours and then changed to 24 hours, the memory store will be capable of holding 24 hours
* of data, but will be populated with 24 hours of data 22 hours after this change was made. Timestream does not
* retrieve data from the magnetic store to populate the memory store.
*
*
* Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateTableRequest.Builder} avoiding the need to
* create one manually via {@link UpdateTableRequest#builder()}
*
*
* @param updateTableRequest
* A {@link Consumer} that will call methods on {@link UpdateTableRequest.Builder} to create a request.
* @return Result of the UpdateTable operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.UpdateTable
* @see AWS
* API Documentation
*/
default UpdateTableResponse updateTable(Consumer updateTableRequest)
throws InternalServerException, ThrottlingException, ValidationException, ResourceNotFoundException,
AccessDeniedException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
return updateTable(UpdateTableRequest.builder().applyMutation(updateTableRequest).build());
}
/**
*
* The WriteRecords operation enables you to write your time series data into Timestream. You can specify a single
* data point or a batch of data points to be inserted into the system. Timestream offers you with a flexible schema
* that auto detects the column names and data types for your Timestream tables based on the dimension names and
* data types of the data points you specify when invoking writes into the database. Timestream support eventual
* consistency read semantics. This means that when you query data immediately after writing a batch of data into
* Timestream, the query results might not reflect the results of a recently completed write operation. The results
* may also include some stale data. If you repeat the query request after a short time, the results should return
* the latest data. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
* @param writeRecordsRequest
* @return Result of the WriteRecords operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws RejectedRecordsException
* WriteRecords would throw this exception in the following cases:
*
* -
*
* Records with duplicate data where there are multiple records with the same dimensions, timestamps, and
* measure names but different measure values.
*
*
* -
*
* Records with timestamps that lie outside the retention duration of the memory store
*
*
* -
*
* Records with dimensions or measures that exceed the Timestream defined limits.
*
*
*
*
* For more information, see Access Management
* in the Timestream Developer Guide.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.WriteRecords
* @see AWS
* API Documentation
*/
default WriteRecordsResponse writeRecords(WriteRecordsRequest writeRecordsRequest) throws InternalServerException,
ThrottlingException, ValidationException, ResourceNotFoundException, AccessDeniedException, RejectedRecordsException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamWriteException {
throw new UnsupportedOperationException();
}
/**
*
* The WriteRecords operation enables you to write your time series data into Timestream. You can specify a single
* data point or a batch of data points to be inserted into the system. Timestream offers you with a flexible schema
* that auto detects the column names and data types for your Timestream tables based on the dimension names and
* data types of the data points you specify when invoking writes into the database. Timestream support eventual
* consistency read semantics. This means that when you query data immediately after writing a batch of data into
* Timestream, the query results might not reflect the results of a recently completed write operation. The results
* may also include some stale data. If you repeat the query request after a short time, the results should return
* the latest data. Service quotas apply. For more information, see Access Management in the
* Timestream Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link WriteRecordsRequest.Builder} avoiding the need to
* create one manually via {@link WriteRecordsRequest#builder()}
*
*
* @param writeRecordsRequest
* A {@link Consumer} that will call methods on {@link WriteRecordsRequest.Builder} to create a request.
* @return Result of the WriteRecords operation returned by the service.
* @throws InternalServerException
* Timestream was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* Too many requests were made by a user exceeding service quotas. The request was throttled.
* @throws ValidationException
* Invalid or malformed request.
* @throws ResourceNotFoundException
* The operation tried to access a nonexistent resource. The resource might not be specified correctly, or
* its status might not be ACTIVE.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws RejectedRecordsException
* WriteRecords would throw this exception in the following cases:
*
* -
*
* Records with duplicate data where there are multiple records with the same dimensions, timestamps, and
* measure names but different measure values.
*
*
* -
*
* Records with timestamps that lie outside the retention duration of the memory store
*
*
* -
*
* Records with dimensions or measures that exceed the Timestream defined limits.
*
*
*
*
* For more information, see Access Management
* in the Timestream Developer Guide.
* @throws InvalidEndpointException
* The requested endpoint was invalid.
* @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 TimestreamWriteException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamWriteClient.WriteRecords
* @see AWS
* API Documentation
*/
default WriteRecordsResponse writeRecords(Consumer writeRecordsRequest)
throws InternalServerException, ThrottlingException, ValidationException, ResourceNotFoundException,
AccessDeniedException, RejectedRecordsException, InvalidEndpointException, AwsServiceException, SdkClientException,
TimestreamWriteException {
return writeRecords(WriteRecordsRequest.builder().applyMutation(writeRecordsRequest).build());
}
static ServiceMetadata serviceMetadata() {
return ServiceMetadata.of(SERVICE_METADATA_ID);
}
}