software.amazon.awssdk.services.timestreamquery.TimestreamQueryClient Maven / Gradle / Ivy
Show all versions of timestreamquery 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.timestreamquery;
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.timestreamquery.model.AccessDeniedException;
import software.amazon.awssdk.services.timestreamquery.model.CancelQueryRequest;
import software.amazon.awssdk.services.timestreamquery.model.CancelQueryResponse;
import software.amazon.awssdk.services.timestreamquery.model.ConflictException;
import software.amazon.awssdk.services.timestreamquery.model.CreateScheduledQueryRequest;
import software.amazon.awssdk.services.timestreamquery.model.CreateScheduledQueryResponse;
import software.amazon.awssdk.services.timestreamquery.model.DeleteScheduledQueryRequest;
import software.amazon.awssdk.services.timestreamquery.model.DeleteScheduledQueryResponse;
import software.amazon.awssdk.services.timestreamquery.model.DescribeAccountSettingsRequest;
import software.amazon.awssdk.services.timestreamquery.model.DescribeAccountSettingsResponse;
import software.amazon.awssdk.services.timestreamquery.model.DescribeEndpointsRequest;
import software.amazon.awssdk.services.timestreamquery.model.DescribeEndpointsResponse;
import software.amazon.awssdk.services.timestreamquery.model.DescribeScheduledQueryRequest;
import software.amazon.awssdk.services.timestreamquery.model.DescribeScheduledQueryResponse;
import software.amazon.awssdk.services.timestreamquery.model.ExecuteScheduledQueryRequest;
import software.amazon.awssdk.services.timestreamquery.model.ExecuteScheduledQueryResponse;
import software.amazon.awssdk.services.timestreamquery.model.InternalServerException;
import software.amazon.awssdk.services.timestreamquery.model.InvalidEndpointException;
import software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesRequest;
import software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesResponse;
import software.amazon.awssdk.services.timestreamquery.model.ListTagsForResourceRequest;
import software.amazon.awssdk.services.timestreamquery.model.ListTagsForResourceResponse;
import software.amazon.awssdk.services.timestreamquery.model.PrepareQueryRequest;
import software.amazon.awssdk.services.timestreamquery.model.PrepareQueryResponse;
import software.amazon.awssdk.services.timestreamquery.model.QueryExecutionException;
import software.amazon.awssdk.services.timestreamquery.model.QueryRequest;
import software.amazon.awssdk.services.timestreamquery.model.QueryResponse;
import software.amazon.awssdk.services.timestreamquery.model.ResourceNotFoundException;
import software.amazon.awssdk.services.timestreamquery.model.ServiceQuotaExceededException;
import software.amazon.awssdk.services.timestreamquery.model.TagResourceRequest;
import software.amazon.awssdk.services.timestreamquery.model.TagResourceResponse;
import software.amazon.awssdk.services.timestreamquery.model.ThrottlingException;
import software.amazon.awssdk.services.timestreamquery.model.TimestreamQueryException;
import software.amazon.awssdk.services.timestreamquery.model.UntagResourceRequest;
import software.amazon.awssdk.services.timestreamquery.model.UntagResourceResponse;
import software.amazon.awssdk.services.timestreamquery.model.UpdateAccountSettingsRequest;
import software.amazon.awssdk.services.timestreamquery.model.UpdateAccountSettingsResponse;
import software.amazon.awssdk.services.timestreamquery.model.UpdateScheduledQueryRequest;
import software.amazon.awssdk.services.timestreamquery.model.UpdateScheduledQueryResponse;
import software.amazon.awssdk.services.timestreamquery.model.ValidationException;
import software.amazon.awssdk.services.timestreamquery.paginators.ListScheduledQueriesIterable;
import software.amazon.awssdk.services.timestreamquery.paginators.ListTagsForResourceIterable;
import software.amazon.awssdk.services.timestreamquery.paginators.QueryIterable;
/**
* Service client for accessing Timestream Query. This can be created using the static {@link #builder()} method.
*
* Amazon Timestream Query
*
*/
@Generated("software.amazon.awssdk:codegen")
@SdkPublicApi
@ThreadSafe
public interface TimestreamQueryClient extends AwsClient {
String SERVICE_NAME = "timestream";
/**
* Value for looking up the service's metadata from the
* {@link software.amazon.awssdk.regions.ServiceMetadataProvider}.
*/
String SERVICE_METADATA_ID = "query.timestream";
/**
*
* Cancels a query that has been issued. Cancellation is provided only if the query has not completed running before
* the cancellation request was issued. Because cancellation is an idempotent operation, subsequent cancellation
* requests will return a CancellationMessage, indicating that the query has already been canceled. See
* code
* sample for details.
*
*
* @param cancelQueryRequest
* @return Result of the CancelQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.CancelQuery
* @see AWS
* API Documentation
*/
default CancelQueryResponse cancelQuery(CancelQueryRequest cancelQueryRequest) throws AccessDeniedException,
InternalServerException, ThrottlingException, ValidationException, InvalidEndpointException, AwsServiceException,
SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Cancels a query that has been issued. Cancellation is provided only if the query has not completed running before
* the cancellation request was issued. Because cancellation is an idempotent operation, subsequent cancellation
* requests will return a CancellationMessage, indicating that the query has already been canceled. See
* code
* sample for details.
*
*
*
* This is a convenience which creates an instance of the {@link CancelQueryRequest.Builder} avoiding the need to
* create one manually via {@link CancelQueryRequest#builder()}
*
*
* @param cancelQueryRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.CancelQueryRequest.Builder} to create a
* request.
* @return Result of the CancelQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.CancelQuery
* @see AWS
* API Documentation
*/
default CancelQueryResponse cancelQuery(Consumer cancelQueryRequest)
throws AccessDeniedException, InternalServerException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return cancelQuery(CancelQueryRequest.builder().applyMutation(cancelQueryRequest).build());
}
/**
*
* Create a scheduled query that will be run on your behalf at the configured schedule. Timestream assumes the
* execution role provided as part of the ScheduledQueryExecutionRoleArn parameter to run the query.
* You can use the NotificationConfiguration parameter to configure notification for your scheduled
* query operations.
*
*
* @param createScheduledQueryRequest
* @return Result of the CreateScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ConflictException
* Unable to poll results for a cancelled query.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ServiceQuotaExceededException
* You have exceeded the service quota.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.CreateScheduledQuery
* @see AWS API Documentation
*/
default CreateScheduledQueryResponse createScheduledQuery(CreateScheduledQueryRequest createScheduledQueryRequest)
throws AccessDeniedException, ConflictException, InternalServerException, ServiceQuotaExceededException,
ThrottlingException, ValidationException, InvalidEndpointException, AwsServiceException, SdkClientException,
TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Create a scheduled query that will be run on your behalf at the configured schedule. Timestream assumes the
* execution role provided as part of the ScheduledQueryExecutionRoleArn parameter to run the query.
* You can use the NotificationConfiguration parameter to configure notification for your scheduled
* query operations.
*
*
*
* This is a convenience which creates an instance of the {@link CreateScheduledQueryRequest.Builder} avoiding the
* need to create one manually via {@link CreateScheduledQueryRequest#builder()}
*
*
* @param createScheduledQueryRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.CreateScheduledQueryRequest.Builder} to
* create a request.
* @return Result of the CreateScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ConflictException
* Unable to poll results for a cancelled query.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ServiceQuotaExceededException
* You have exceeded the service quota.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.CreateScheduledQuery
* @see AWS API Documentation
*/
default CreateScheduledQueryResponse createScheduledQuery(
Consumer createScheduledQueryRequest) throws AccessDeniedException,
ConflictException, InternalServerException, ServiceQuotaExceededException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return createScheduledQuery(CreateScheduledQueryRequest.builder().applyMutation(createScheduledQueryRequest).build());
}
/**
*
* Deletes a given scheduled query. This is an irreversible operation.
*
*
* @param deleteScheduledQueryRequest
* @return Result of the DeleteScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.DeleteScheduledQuery
* @see AWS API Documentation
*/
default DeleteScheduledQueryResponse deleteScheduledQuery(DeleteScheduledQueryRequest deleteScheduledQueryRequest)
throws AccessDeniedException, InternalServerException, ResourceNotFoundException, ThrottlingException,
ValidationException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Deletes a given scheduled query. This is an irreversible operation.
*
*
*
* This is a convenience which creates an instance of the {@link DeleteScheduledQueryRequest.Builder} avoiding the
* need to create one manually via {@link DeleteScheduledQueryRequest#builder()}
*
*
* @param deleteScheduledQueryRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.DeleteScheduledQueryRequest.Builder} to
* create a request.
* @return Result of the DeleteScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.DeleteScheduledQuery
* @see AWS API Documentation
*/
default DeleteScheduledQueryResponse deleteScheduledQuery(
Consumer deleteScheduledQueryRequest) throws AccessDeniedException,
InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return deleteScheduledQuery(DeleteScheduledQueryRequest.builder().applyMutation(deleteScheduledQueryRequest).build());
}
/**
*
* Describes the settings for your account that include the query pricing model and the configured maximum TCUs the
* service can use for your query workload.
*
*
* You're charged only for the duration of compute units used for your workloads.
*
*
* @param describeAccountSettingsRequest
* @return Result of the DescribeAccountSettings operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.DescribeAccountSettings
* @see AWS API Documentation
*/
default DescribeAccountSettingsResponse describeAccountSettings(DescribeAccountSettingsRequest describeAccountSettingsRequest)
throws AccessDeniedException, InternalServerException, ThrottlingException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Describes the settings for your account that include the query pricing model and the configured maximum TCUs the
* service can use for your query workload.
*
*
* You're charged only for the duration of compute units used for your workloads.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeAccountSettingsRequest.Builder} avoiding
* the need to create one manually via {@link DescribeAccountSettingsRequest#builder()}
*
*
* @param describeAccountSettingsRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.DescribeAccountSettingsRequest.Builder} to
* create a request.
* @return Result of the DescribeAccountSettings operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.DescribeAccountSettings
* @see AWS API Documentation
*/
default DescribeAccountSettingsResponse describeAccountSettings(
Consumer describeAccountSettingsRequest) throws AccessDeniedException,
InternalServerException, ThrottlingException, InvalidEndpointException, AwsServiceException, SdkClientException,
TimestreamQueryException {
return describeAccountSettings(DescribeAccountSettingsRequest.builder().applyMutation(describeAccountSettingsRequest)
.build());
}
/**
*
* DescribeEndpoints returns a list of available endpoints to make Timestream API calls against. This API is
* available through both Write and Query.
*
*
* Because the Timestream 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:
*
*
* -
*
* You are using VPC endpoints
* (Amazon Web Services PrivateLink) with Timestream
*
*
* -
*
* 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 and when to use and implement DescribeEndpoints, see The Endpoint Discovery Pattern.
*
*
* @param describeEndpointsRequest
* @return Result of the DescribeEndpoints operation returned by the service.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ValidationException
* Invalid or malformed request.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.DescribeEndpoints
* @see AWS API Documentation
*/
default DescribeEndpointsResponse describeEndpoints(DescribeEndpointsRequest describeEndpointsRequest)
throws InternalServerException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException,
TimestreamQueryException {
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 the Timestream 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:
*
*
* -
*
* You are using VPC endpoints
* (Amazon Web Services PrivateLink) with Timestream
*
*
* -
*
* 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 and when to use and implement DescribeEndpoints, see The Endpoint Discovery Pattern.
*
*
*
* 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 software.amazon.awssdk.services.timestreamquery.model.DescribeEndpointsRequest.Builder} to create a
* request.
* @return Result of the DescribeEndpoints operation returned by the service.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ValidationException
* Invalid or malformed request.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.DescribeEndpoints
* @see AWS API Documentation
*/
default DescribeEndpointsResponse describeEndpoints(Consumer describeEndpointsRequest)
throws InternalServerException, ValidationException, ThrottlingException, AwsServiceException, SdkClientException,
TimestreamQueryException {
return describeEndpoints(DescribeEndpointsRequest.builder().applyMutation(describeEndpointsRequest).build());
}
/**
*
* Provides detailed information about a scheduled query.
*
*
* @param describeScheduledQueryRequest
* @return Result of the DescribeScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.DescribeScheduledQuery
* @see AWS API Documentation
*/
default DescribeScheduledQueryResponse describeScheduledQuery(DescribeScheduledQueryRequest describeScheduledQueryRequest)
throws AccessDeniedException, InternalServerException, ResourceNotFoundException, ThrottlingException,
ValidationException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Provides detailed information about a scheduled query.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeScheduledQueryRequest.Builder} avoiding the
* need to create one manually via {@link DescribeScheduledQueryRequest#builder()}
*
*
* @param describeScheduledQueryRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.DescribeScheduledQueryRequest.Builder} to
* create a request.
* @return Result of the DescribeScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.DescribeScheduledQuery
* @see AWS API Documentation
*/
default DescribeScheduledQueryResponse describeScheduledQuery(
Consumer describeScheduledQueryRequest) throws AccessDeniedException,
InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return describeScheduledQuery(DescribeScheduledQueryRequest.builder().applyMutation(describeScheduledQueryRequest)
.build());
}
/**
*
* You can use this API to run a scheduled query manually.
*
*
* @param executeScheduledQueryRequest
* @return Result of the ExecuteScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ExecuteScheduledQuery
* @see AWS API Documentation
*/
default ExecuteScheduledQueryResponse executeScheduledQuery(ExecuteScheduledQueryRequest executeScheduledQueryRequest)
throws AccessDeniedException, InternalServerException, ResourceNotFoundException, ThrottlingException,
ValidationException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* You can use this API to run a scheduled query manually.
*
*
*
* This is a convenience which creates an instance of the {@link ExecuteScheduledQueryRequest.Builder} avoiding the
* need to create one manually via {@link ExecuteScheduledQueryRequest#builder()}
*
*
* @param executeScheduledQueryRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.ExecuteScheduledQueryRequest.Builder} to
* create a request.
* @return Result of the ExecuteScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ExecuteScheduledQuery
* @see AWS API Documentation
*/
default ExecuteScheduledQueryResponse executeScheduledQuery(
Consumer executeScheduledQueryRequest) throws AccessDeniedException,
InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return executeScheduledQuery(ExecuteScheduledQueryRequest.builder().applyMutation(executeScheduledQueryRequest).build());
}
/**
*
* Gets a list of all scheduled queries in the caller's Amazon account and Region. ListScheduledQueries
* is eventually consistent.
*
*
* @param listScheduledQueriesRequest
* @return Result of the ListScheduledQueries operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ListScheduledQueries
* @see AWS API Documentation
*/
default ListScheduledQueriesResponse listScheduledQueries(ListScheduledQueriesRequest listScheduledQueriesRequest)
throws AccessDeniedException, InternalServerException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Gets a list of all scheduled queries in the caller's Amazon account and Region. ListScheduledQueries
* is eventually consistent.
*
*
*
* This is a convenience which creates an instance of the {@link ListScheduledQueriesRequest.Builder} avoiding the
* need to create one manually via {@link ListScheduledQueriesRequest#builder()}
*
*
* @param listScheduledQueriesRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesRequest.Builder} to
* create a request.
* @return Result of the ListScheduledQueries operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ListScheduledQueries
* @see AWS API Documentation
*/
default ListScheduledQueriesResponse listScheduledQueries(
Consumer listScheduledQueriesRequest) throws AccessDeniedException,
InternalServerException, ThrottlingException, ValidationException, InvalidEndpointException, AwsServiceException,
SdkClientException, TimestreamQueryException {
return listScheduledQueries(ListScheduledQueriesRequest.builder().applyMutation(listScheduledQueriesRequest).build());
}
/**
*
* This is a variant of
* {@link #listScheduledQueries(software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesRequest)}
* 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.timestreamquery.paginators.ListScheduledQueriesIterable responses = client.listScheduledQueriesPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamquery.paginators.ListScheduledQueriesIterable responses = client
* .listScheduledQueriesPaginator(request);
* for (software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamquery.paginators.ListScheduledQueriesIterable responses = client.listScheduledQueriesPaginator(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 #listScheduledQueries(software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesRequest)}
* operation.
*
*
* @param listScheduledQueriesRequest
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ListScheduledQueries
* @see AWS API Documentation
*/
default ListScheduledQueriesIterable listScheduledQueriesPaginator(ListScheduledQueriesRequest listScheduledQueriesRequest)
throws AccessDeniedException, InternalServerException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return new ListScheduledQueriesIterable(this, listScheduledQueriesRequest);
}
/**
*
* This is a variant of
* {@link #listScheduledQueries(software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesRequest)}
* 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.timestreamquery.paginators.ListScheduledQueriesIterable responses = client.listScheduledQueriesPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamquery.paginators.ListScheduledQueriesIterable responses = client
* .listScheduledQueriesPaginator(request);
* for (software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamquery.paginators.ListScheduledQueriesIterable responses = client.listScheduledQueriesPaginator(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 #listScheduledQueries(software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesRequest)}
* operation.
*
*
*
* This is a convenience which creates an instance of the {@link ListScheduledQueriesRequest.Builder} avoiding the
* need to create one manually via {@link ListScheduledQueriesRequest#builder()}
*
*
* @param listScheduledQueriesRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.ListScheduledQueriesRequest.Builder} to
* create a request.
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ListScheduledQueries
* @see AWS API Documentation
*/
default ListScheduledQueriesIterable listScheduledQueriesPaginator(
Consumer listScheduledQueriesRequest) throws AccessDeniedException,
InternalServerException, ThrottlingException, ValidationException, InvalidEndpointException, AwsServiceException,
SdkClientException, TimestreamQueryException {
return listScheduledQueriesPaginator(ListScheduledQueriesRequest.builder().applyMutation(listScheduledQueriesRequest)
.build());
}
/**
*
* List all tags on a Timestream query resource.
*
*
* @param listTagsForResourceRequest
* @return Result of the ListTagsForResource operation returned by the service.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ListTagsForResource
* @see AWS API Documentation
*/
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
throws ResourceNotFoundException, ThrottlingException, ValidationException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* List all tags on a Timestream query 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.timestreamquery.model.ListTagsForResourceRequest.Builder} to create
* a request.
* @return Result of the ListTagsForResource operation returned by the service.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ListTagsForResource
* @see AWS API Documentation
*/
default ListTagsForResourceResponse listTagsForResource(
Consumer listTagsForResourceRequest) throws ResourceNotFoundException,
ThrottlingException, ValidationException, InvalidEndpointException, AwsServiceException, SdkClientException,
TimestreamQueryException {
return listTagsForResource(ListTagsForResourceRequest.builder().applyMutation(listTagsForResourceRequest).build());
}
/**
*
* This is a variant of
* {@link #listTagsForResource(software.amazon.awssdk.services.timestreamquery.model.ListTagsForResourceRequest)}
* 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.timestreamquery.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamquery.paginators.ListTagsForResourceIterable responses = client
* .listTagsForResourcePaginator(request);
* for (software.amazon.awssdk.services.timestreamquery.model.ListTagsForResourceResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamquery.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(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 #listTagsForResource(software.amazon.awssdk.services.timestreamquery.model.ListTagsForResourceRequest)}
* operation.
*
*
* @param listTagsForResourceRequest
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ListTagsForResource
* @see AWS API Documentation
*/
default ListTagsForResourceIterable listTagsForResourcePaginator(ListTagsForResourceRequest listTagsForResourceRequest)
throws ResourceNotFoundException, ThrottlingException, ValidationException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamQueryException {
return new ListTagsForResourceIterable(this, listTagsForResourceRequest);
}
/**
*
* This is a variant of
* {@link #listTagsForResource(software.amazon.awssdk.services.timestreamquery.model.ListTagsForResourceRequest)}
* 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.timestreamquery.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamquery.paginators.ListTagsForResourceIterable responses = client
* .listTagsForResourcePaginator(request);
* for (software.amazon.awssdk.services.timestreamquery.model.ListTagsForResourceResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamquery.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(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 #listTagsForResource(software.amazon.awssdk.services.timestreamquery.model.ListTagsForResourceRequest)}
* operation.
*
*
*
* 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.timestreamquery.model.ListTagsForResourceRequest.Builder} to create
* a request.
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.ListTagsForResource
* @see AWS API Documentation
*/
default ListTagsForResourceIterable listTagsForResourcePaginator(
Consumer listTagsForResourceRequest) throws ResourceNotFoundException,
ThrottlingException, ValidationException, InvalidEndpointException, AwsServiceException, SdkClientException,
TimestreamQueryException {
return listTagsForResourcePaginator(ListTagsForResourceRequest.builder().applyMutation(listTagsForResourceRequest)
.build());
}
/**
*
* A synchronous operation that allows you to submit a query with parameters to be stored by Timestream for later
* running. Timestream only supports using this operation with ValidateOnly set to true.
*
*
* @param prepareQueryRequest
* @return Result of the PrepareQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.PrepareQuery
* @see AWS
* API Documentation
*/
default PrepareQueryResponse prepareQuery(PrepareQueryRequest prepareQueryRequest) throws AccessDeniedException,
InternalServerException, ThrottlingException, ValidationException, InvalidEndpointException, AwsServiceException,
SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* A synchronous operation that allows you to submit a query with parameters to be stored by Timestream for later
* running. Timestream only supports using this operation with ValidateOnly set to true.
*
*
*
* This is a convenience which creates an instance of the {@link PrepareQueryRequest.Builder} avoiding the need to
* create one manually via {@link PrepareQueryRequest#builder()}
*
*
* @param prepareQueryRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.PrepareQueryRequest.Builder} to create a
* request.
* @return Result of the PrepareQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.PrepareQuery
* @see AWS
* API Documentation
*/
default PrepareQueryResponse prepareQuery(Consumer prepareQueryRequest)
throws AccessDeniedException, InternalServerException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return prepareQuery(PrepareQueryRequest.builder().applyMutation(prepareQueryRequest).build());
}
/**
*
* Query is a synchronous operation that enables you to run a query against your Amazon Timestream
* data. Query will time out after 60 seconds. You must update the default timeout in the SDK to
* support a timeout of 60 seconds. See the code sample
* for details.
*
*
* Your query request will fail in the following cases:
*
*
* -
*
* If you submit a Query request with the same client token outside of the 5-minute idempotency window.
*
*
* -
*
* If you submit a Query request with the same client token, but change other parameters, within the
* 5-minute idempotency window.
*
*
* -
*
* If the size of the row (including the query metadata) exceeds 1 MB, then the query will fail with the following
* error message:
*
*
* Query aborted as max page response size has been exceeded by the output result row
*
*
* -
*
* If the IAM principal of the query initiator and the result reader are not the same and/or the query initiator and
* the result reader do not have the same query string in the query requests, the query will fail with an
* Invalid pagination token error.
*
*
*
*
* @param queryRequest
* @return Result of the Query operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ConflictException
* Unable to poll results for a cancelled query.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws QueryExecutionException
* Timestream was unable to run the query successfully.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.Query
* @see AWS API
* Documentation
*/
default QueryResponse query(QueryRequest queryRequest) throws AccessDeniedException, ConflictException,
InternalServerException, QueryExecutionException, ThrottlingException, ValidationException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Query is a synchronous operation that enables you to run a query against your Amazon Timestream
* data. Query will time out after 60 seconds. You must update the default timeout in the SDK to
* support a timeout of 60 seconds. See the code sample
* for details.
*
*
* Your query request will fail in the following cases:
*
*
* -
*
* If you submit a Query request with the same client token outside of the 5-minute idempotency window.
*
*
* -
*
* If you submit a Query request with the same client token, but change other parameters, within the
* 5-minute idempotency window.
*
*
* -
*
* If the size of the row (including the query metadata) exceeds 1 MB, then the query will fail with the following
* error message:
*
*
* Query aborted as max page response size has been exceeded by the output result row
*
*
* -
*
* If the IAM principal of the query initiator and the result reader are not the same and/or the query initiator and
* the result reader do not have the same query string in the query requests, the query will fail with an
* Invalid pagination token error.
*
*
*
*
*
* This is a convenience which creates an instance of the {@link QueryRequest.Builder} avoiding the need to create
* one manually via {@link QueryRequest#builder()}
*
*
* @param queryRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.QueryRequest.Builder} to create a request.
* @return Result of the Query operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ConflictException
* Unable to poll results for a cancelled query.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws QueryExecutionException
* Timestream was unable to run the query successfully.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.Query
* @see AWS API
* Documentation
*/
default QueryResponse query(Consumer queryRequest) throws AccessDeniedException, ConflictException,
InternalServerException, QueryExecutionException, ThrottlingException, ValidationException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamQueryException {
return query(QueryRequest.builder().applyMutation(queryRequest).build());
}
/**
*
* This is a variant of {@link #query(software.amazon.awssdk.services.timestreamquery.model.QueryRequest)}
* 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.timestreamquery.paginators.QueryIterable responses = client.queryPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamquery.paginators.QueryIterable responses = client.queryPaginator(request);
* for (software.amazon.awssdk.services.timestreamquery.model.QueryResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamquery.paginators.QueryIterable responses = client.queryPaginator(request);
* responses.iterator().forEachRemaining(....);
* }
*
*
* Please notice that the configuration of MaxRows 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 #query(software.amazon.awssdk.services.timestreamquery.model.QueryRequest)} operation.
*
*
* @param queryRequest
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ConflictException
* Unable to poll results for a cancelled query.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws QueryExecutionException
* Timestream was unable to run the query successfully.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.Query
* @see AWS API
* Documentation
*/
default QueryIterable queryPaginator(QueryRequest queryRequest) throws AccessDeniedException, ConflictException,
InternalServerException, QueryExecutionException, ThrottlingException, ValidationException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamQueryException {
return new QueryIterable(this, queryRequest);
}
/**
*
* This is a variant of {@link #query(software.amazon.awssdk.services.timestreamquery.model.QueryRequest)}
* 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.timestreamquery.paginators.QueryIterable responses = client.queryPaginator(request);
* responses.stream().forEach(....);
* }
*
*
* 2) Using For loop
*
*
* {
* @code
* software.amazon.awssdk.services.timestreamquery.paginators.QueryIterable responses = client.queryPaginator(request);
* for (software.amazon.awssdk.services.timestreamquery.model.QueryResponse response : responses) {
* // do something;
* }
* }
*
*
* 3) Use iterator directly
*
*
* {@code
* software.amazon.awssdk.services.timestreamquery.paginators.QueryIterable responses = client.queryPaginator(request);
* responses.iterator().forEachRemaining(....);
* }
*
*
* Please notice that the configuration of MaxRows 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 #query(software.amazon.awssdk.services.timestreamquery.model.QueryRequest)} operation.
*
*
*
* This is a convenience which creates an instance of the {@link QueryRequest.Builder} avoiding the need to create
* one manually via {@link QueryRequest#builder()}
*
*
* @param queryRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.QueryRequest.Builder} to create a request.
* @return A custom iterable that can be used to iterate through all the response pages.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws ConflictException
* Unable to poll results for a cancelled query.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws QueryExecutionException
* Timestream was unable to run the query successfully.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.Query
* @see AWS API
* Documentation
*/
default QueryIterable queryPaginator(Consumer queryRequest) throws AccessDeniedException,
ConflictException, InternalServerException, QueryExecutionException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return queryPaginator(QueryRequest.builder().applyMutation(queryRequest).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 requested resource could not be found.
* @throws ServiceQuotaExceededException
* You have exceeded the service quota.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.TagResource
* @see AWS
* API Documentation
*/
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ResourceNotFoundException,
ServiceQuotaExceededException, ThrottlingException, ValidationException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamQueryException {
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 software.amazon.awssdk.services.timestreamquery.model.TagResourceRequest.Builder} to create a
* request.
* @return Result of the TagResource operation returned by the service.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ServiceQuotaExceededException
* You have exceeded the service quota.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.TagResource
* @see AWS
* API Documentation
*/
default TagResourceResponse tagResource(Consumer tagResourceRequest)
throws ResourceNotFoundException, ServiceQuotaExceededException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return tagResource(TagResourceRequest.builder().applyMutation(tagResourceRequest).build());
}
/**
*
* Removes the association of tags from a Timestream query resource.
*
*
* @param untagResourceRequest
* @return Result of the UntagResource operation returned by the service.
* @throws ValidationException
* Invalid or malformed request.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.UntagResource
* @see AWS API Documentation
*/
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ValidationException,
ThrottlingException, ResourceNotFoundException, InvalidEndpointException, AwsServiceException, SdkClientException,
TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Removes the association of tags from a Timestream query 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 software.amazon.awssdk.services.timestreamquery.model.UntagResourceRequest.Builder} to create a
* request.
* @return Result of the UntagResource operation returned by the service.
* @throws ValidationException
* Invalid or malformed request.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.UntagResource
* @see AWS API Documentation
*/
default UntagResourceResponse untagResource(Consumer untagResourceRequest)
throws ValidationException, ThrottlingException, ResourceNotFoundException, InvalidEndpointException,
AwsServiceException, SdkClientException, TimestreamQueryException {
return untagResource(UntagResourceRequest.builder().applyMutation(untagResourceRequest).build());
}
/**
*
* Transitions your account to use TCUs for query pricing and modifies the maximum query compute units that you've
* configured. If you reduce the value of MaxQueryTCU to a desired configuration, the new value can
* take up to 24 hours to be effective.
*
*
*
* After you've transitioned your account to use TCUs for query pricing, you can't transition to using bytes scanned
* for query pricing.
*
*
*
* @param updateAccountSettingsRequest
* @return Result of the UpdateAccountSettings operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.UpdateAccountSettings
* @see AWS API Documentation
*/
default UpdateAccountSettingsResponse updateAccountSettings(UpdateAccountSettingsRequest updateAccountSettingsRequest)
throws AccessDeniedException, InternalServerException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Transitions your account to use TCUs for query pricing and modifies the maximum query compute units that you've
* configured. If you reduce the value of MaxQueryTCU to a desired configuration, the new value can
* take up to 24 hours to be effective.
*
*
*
* After you've transitioned your account to use TCUs for query pricing, you can't transition to using bytes scanned
* for query pricing.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateAccountSettingsRequest.Builder} avoiding the
* need to create one manually via {@link UpdateAccountSettingsRequest#builder()}
*
*
* @param updateAccountSettingsRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.UpdateAccountSettingsRequest.Builder} to
* create a request.
* @return Result of the UpdateAccountSettings operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.UpdateAccountSettings
* @see AWS API Documentation
*/
default UpdateAccountSettingsResponse updateAccountSettings(
Consumer updateAccountSettingsRequest) throws AccessDeniedException,
InternalServerException, ThrottlingException, ValidationException, InvalidEndpointException, AwsServiceException,
SdkClientException, TimestreamQueryException {
return updateAccountSettings(UpdateAccountSettingsRequest.builder().applyMutation(updateAccountSettingsRequest).build());
}
/**
*
* Update a scheduled query.
*
*
* @param updateScheduledQueryRequest
* @return Result of the UpdateScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.UpdateScheduledQuery
* @see AWS API Documentation
*/
default UpdateScheduledQueryResponse updateScheduledQuery(UpdateScheduledQueryRequest updateScheduledQueryRequest)
throws AccessDeniedException, InternalServerException, ResourceNotFoundException, ThrottlingException,
ValidationException, InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
throw new UnsupportedOperationException();
}
/**
*
* Update a scheduled query.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateScheduledQueryRequest.Builder} avoiding the
* need to create one manually via {@link UpdateScheduledQueryRequest#builder()}
*
*
* @param updateScheduledQueryRequest
* A {@link Consumer} that will call methods on
* {@link software.amazon.awssdk.services.timestreamquery.model.UpdateScheduledQueryRequest.Builder} to
* create a request.
* @return Result of the UpdateScheduledQuery operation returned by the service.
* @throws AccessDeniedException
* You are not authorized to perform this action.
* @throws InternalServerException
* The service was unable to fully process this request because of an internal server error.
* @throws ResourceNotFoundException
* The requested resource could not be found.
* @throws ThrottlingException
* The request was denied due to request throttling.
* @throws ValidationException
* Invalid or malformed request.
* @throws InvalidEndpointException
* The requested endpoint was not valid.
* @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 TimestreamQueryException
* Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
* @sample TimestreamQueryClient.UpdateScheduledQuery
* @see AWS API Documentation
*/
default UpdateScheduledQueryResponse updateScheduledQuery(
Consumer updateScheduledQueryRequest) throws AccessDeniedException,
InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException,
InvalidEndpointException, AwsServiceException, SdkClientException, TimestreamQueryException {
return updateScheduledQuery(UpdateScheduledQueryRequest.builder().applyMutation(updateScheduledQueryRequest).build());
}
/**
* Create a {@link TimestreamQueryClient} 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 TimestreamQueryClient create() {
return builder().build();
}
/**
* Create a builder that can be used to configure and create a {@link TimestreamQueryClient}.
*/
static TimestreamQueryClientBuilder builder() {
return new DefaultTimestreamQueryClientBuilder();
}
static ServiceMetadata serviceMetadata() {
return ServiceMetadata.of(SERVICE_METADATA_ID);
}
@Override
default TimestreamQueryServiceClientConfiguration serviceClientConfiguration() {
throw new UnsupportedOperationException();
}
}