@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSIoTAnalyticsClient extends AmazonWebServiceClient implements AWSIoTAnalytics
AWS IoT Analytics allows you to collect large amounts of device data, process messages, and store them. You can then query the data and run sophisticated analytics on it. AWS IoT Analytics enables advanced data exploration through integration with Jupyter Notebooks and data visualization through integration with Amazon QuickSight.
Traditional analytics and business intelligence tools are designed to process structured data. IoT data often comes from devices that record noisy processes (such as temperature, motion, or sound). As a result the data from these devices can have significant gaps, corrupted messages, and false readings that must be cleaned up before analysis can occur. Also, IoT data is often only meaningful in the context of other data from external sources.
AWS IoT Analytics automates the steps required to analyze data from IoT devices. AWS IoT Analytics filters, transforms, and enriches IoT data before storing it in a time-series data store for analysis. You can set up the service to collect only the data you need from your devices, apply mathematical transforms to process the data, and enrich the data with device-specific metadata such as device type and location before storing it. Then, you can analyze your data by running queries using the built-in SQL query engine, or perform more complex analytics and machine learning inference. AWS IoT Analytics includes pre-built models for common IoT use cases so you can answer questions like which devices are about to fail or which customers are at risk of abandoning their wearable devices.
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIX| Modifier and Type | Method and Description | 
|---|---|
| BatchPutMessageResult | batchPutMessage(BatchPutMessageRequest request)
 Sends messages to a channel. | 
| static AWSIoTAnalyticsClientBuilder | builder() | 
| CancelPipelineReprocessingResult | cancelPipelineReprocessing(CancelPipelineReprocessingRequest request)
 Cancels the reprocessing of data through the pipeline. | 
| CreateChannelResult | createChannel(CreateChannelRequest request)
 Creates a channel. | 
| CreateDatasetResult | createDataset(CreateDatasetRequest request)
 Creates a dataset. | 
| CreateDatasetContentResult | createDatasetContent(CreateDatasetContentRequest request)
 Creates the content of a data set by applying a  queryAction(a SQL query) or acontainerAction(executing a containerized application). | 
| CreateDatastoreResult | createDatastore(CreateDatastoreRequest request)
 Creates a data store, which is a repository for messages. | 
| CreatePipelineResult | createPipeline(CreatePipelineRequest request)
 Creates a pipeline. | 
| DeleteChannelResult | deleteChannel(DeleteChannelRequest request)
 Deletes the specified channel. | 
| DeleteDatasetResult | deleteDataset(DeleteDatasetRequest request)
 Deletes the specified dataset. | 
| DeleteDatasetContentResult | deleteDatasetContent(DeleteDatasetContentRequest request)
 Deletes the content of the specified dataset. | 
| DeleteDatastoreResult | deleteDatastore(DeleteDatastoreRequest request)
 Deletes the specified data store. | 
| DeletePipelineResult | deletePipeline(DeletePipelineRequest request)
 Deletes the specified pipeline. | 
| DescribeChannelResult | describeChannel(DescribeChannelRequest request)
 Retrieves information about a channel. | 
| DescribeDatasetResult | describeDataset(DescribeDatasetRequest request)
 Retrieves information about a dataset. | 
| DescribeDatastoreResult | describeDatastore(DescribeDatastoreRequest request)
 Retrieves information about a data store. | 
| DescribeLoggingOptionsResult | describeLoggingOptions(DescribeLoggingOptionsRequest request)
 Retrieves the current settings of the AWS IoT Analytics logging options. | 
| DescribePipelineResult | describePipeline(DescribePipelineRequest request)
 Retrieves information about a pipeline. | 
| ResponseMetadata | getCachedResponseMetadata(AmazonWebServiceRequest request)Returns additional metadata for a previously executed successful, request, typically used for debugging issues
 where a service isn't acting as expected. | 
| GetDatasetContentResult | getDatasetContent(GetDatasetContentRequest request)
 Retrieves the contents of a data set as presigned URIs. | 
| ListChannelsResult | listChannels(ListChannelsRequest request)
 Retrieves a list of channels. | 
| ListDatasetContentsResult | listDatasetContents(ListDatasetContentsRequest request)
 Lists information about data set contents that have been created. | 
| ListDatasetsResult | listDatasets(ListDatasetsRequest request)
 Retrieves information about data sets. | 
| ListDatastoresResult | listDatastores(ListDatastoresRequest request)
 Retrieves a list of data stores. | 
| ListPipelinesResult | listPipelines(ListPipelinesRequest request)
 Retrieves a list of pipelines. | 
| ListTagsForResourceResult | listTagsForResource(ListTagsForResourceRequest request)
 Lists the tags (metadata) that you have assigned to the resource. | 
| PutLoggingOptionsResult | putLoggingOptions(PutLoggingOptionsRequest request)
 Sets or updates the AWS IoT Analytics logging options. | 
| RunPipelineActivityResult | runPipelineActivity(RunPipelineActivityRequest request)
 Simulates the results of running a pipeline activity on a message payload. | 
| SampleChannelDataResult | sampleChannelData(SampleChannelDataRequest request)
 Retrieves a sample of messages from the specified channel ingested during the specified timeframe. | 
| void | shutdown()Shuts down this client object, releasing any resources that might be held
 open. | 
| StartPipelineReprocessingResult | startPipelineReprocessing(StartPipelineReprocessingRequest request)
 Starts the reprocessing of raw message data through the pipeline. | 
| TagResourceResult | tagResource(TagResourceRequest request)
 Adds to or modifies the tags of the given resource. | 
| UntagResourceResult | untagResource(UntagResourceRequest request)
 Removes the given tags (metadata) from the resource. | 
| UpdateChannelResult | updateChannel(UpdateChannelRequest request)
 Updates the settings of a channel. | 
| UpdateDatasetResult | updateDataset(UpdateDatasetRequest request)
 Updates the settings of a data set. | 
| UpdateDatastoreResult | updateDatastore(UpdateDatastoreRequest request)
 Updates the settings of a data store. | 
| UpdatePipelineResult | updatePipeline(UpdatePipelineRequest request)
 Updates the settings of a pipeline. | 
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetpublic static AWSIoTAnalyticsClientBuilder builder()
public BatchPutMessageResult batchPutMessage(BatchPutMessageRequest request)
Sends messages to a channel.
batchPutMessage in interface AWSIoTAnalyticsbatchPutMessageRequest - ResourceNotFoundException - A resource with the specified name could not be found.InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public CancelPipelineReprocessingResult cancelPipelineReprocessing(CancelPipelineReprocessingRequest request)
Cancels the reprocessing of data through the pipeline.
cancelPipelineReprocessing in interface AWSIoTAnalyticscancelPipelineReprocessingRequest - ResourceNotFoundException - A resource with the specified name could not be found.InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public CreateChannelResult createChannel(CreateChannelRequest request)
Creates a channel. A channel collects data from an MQTT topic and archives the raw, unprocessed messages before publishing the data to a pipeline.
createChannel in interface AWSIoTAnalyticscreateChannelRequest - InvalidRequestException - The request was not valid.ResourceAlreadyExistsException - A resource with the same name already exists.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.LimitExceededException - The command caused an internal limit to be exceeded.public CreateDatasetResult createDataset(CreateDatasetRequest request)
 Creates a dataset. A dataset stores data retrieved from a data store by applying a queryAction (a
 SQL query) or a containerAction (executing a containerized application). This operation creates the
 skeleton of a dataset. The dataset can be populated manually by calling CreateDatasetContent or
 automatically according to a trigger you specify.
 
createDataset in interface AWSIoTAnalyticscreateDatasetRequest - InvalidRequestException - The request was not valid.ResourceAlreadyExistsException - A resource with the same name already exists.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.LimitExceededException - The command caused an internal limit to be exceeded.public CreateDatasetContentResult createDatasetContent(CreateDatasetContentRequest request)
 Creates the content of a data set by applying a queryAction (a SQL query) or a
 containerAction (executing a containerized application).
 
createDatasetContent in interface AWSIoTAnalyticscreateDatasetContentRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public CreateDatastoreResult createDatastore(CreateDatastoreRequest request)
Creates a data store, which is a repository for messages.
createDatastore in interface AWSIoTAnalyticscreateDatastoreRequest - InvalidRequestException - The request was not valid.ResourceAlreadyExistsException - A resource with the same name already exists.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.LimitExceededException - The command caused an internal limit to be exceeded.public CreatePipelineResult createPipeline(CreatePipelineRequest request)
 Creates a pipeline. A pipeline consumes messages from a channel and allows you to process the messages before
 storing them in a data store. You must specify both a channel and a datastore activity
 and, optionally, as many as 23 additional activities in the pipelineActivities array.
 
createPipeline in interface AWSIoTAnalyticscreatePipelineRequest - InvalidRequestException - The request was not valid.ResourceAlreadyExistsException - A resource with the same name already exists.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.LimitExceededException - The command caused an internal limit to be exceeded.public DeleteChannelResult deleteChannel(DeleteChannelRequest request)
Deletes the specified channel.
deleteChannel in interface AWSIoTAnalyticsdeleteChannelRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public DeleteDatasetResult deleteDataset(DeleteDatasetRequest request)
Deletes the specified dataset.
You do not have to delete the content of the dataset before you perform this operation.
deleteDataset in interface AWSIoTAnalyticsdeleteDatasetRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public DeleteDatasetContentResult deleteDatasetContent(DeleteDatasetContentRequest request)
Deletes the content of the specified dataset.
deleteDatasetContent in interface AWSIoTAnalyticsdeleteDatasetContentRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public DeleteDatastoreResult deleteDatastore(DeleteDatastoreRequest request)
Deletes the specified data store.
deleteDatastore in interface AWSIoTAnalyticsdeleteDatastoreRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public DeletePipelineResult deletePipeline(DeletePipelineRequest request)
Deletes the specified pipeline.
deletePipeline in interface AWSIoTAnalyticsdeletePipelineRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public DescribeChannelResult describeChannel(DescribeChannelRequest request)
Retrieves information about a channel.
describeChannel in interface AWSIoTAnalyticsdescribeChannelRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public DescribeDatasetResult describeDataset(DescribeDatasetRequest request)
Retrieves information about a dataset.
describeDataset in interface AWSIoTAnalyticsdescribeDatasetRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public DescribeDatastoreResult describeDatastore(DescribeDatastoreRequest request)
Retrieves information about a data store.
describeDatastore in interface AWSIoTAnalyticsdescribeDatastoreRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public DescribeLoggingOptionsResult describeLoggingOptions(DescribeLoggingOptionsRequest request)
Retrieves the current settings of the AWS IoT Analytics logging options.
describeLoggingOptions in interface AWSIoTAnalyticsdescribeLoggingOptionsRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public DescribePipelineResult describePipeline(DescribePipelineRequest request)
Retrieves information about a pipeline.
describePipeline in interface AWSIoTAnalyticsdescribePipelineRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public GetDatasetContentResult getDatasetContent(GetDatasetContentRequest request)
Retrieves the contents of a data set as presigned URIs.
getDatasetContent in interface AWSIoTAnalyticsgetDatasetContentRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public ListChannelsResult listChannels(ListChannelsRequest request)
Retrieves a list of channels.
listChannels in interface AWSIoTAnalyticslistChannelsRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public ListDatasetContentsResult listDatasetContents(ListDatasetContentsRequest request)
Lists information about data set contents that have been created.
listDatasetContents in interface AWSIoTAnalyticslistDatasetContentsRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.ResourceNotFoundException - A resource with the specified name could not be found.public ListDatasetsResult listDatasets(ListDatasetsRequest request)
Retrieves information about data sets.
listDatasets in interface AWSIoTAnalyticslistDatasetsRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public ListDatastoresResult listDatastores(ListDatastoresRequest request)
Retrieves a list of data stores.
listDatastores in interface AWSIoTAnalyticslistDatastoresRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public ListPipelinesResult listPipelines(ListPipelinesRequest request)
Retrieves a list of pipelines.
listPipelines in interface AWSIoTAnalyticslistPipelinesRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Lists the tags (metadata) that you have assigned to the resource.
listTagsForResource in interface AWSIoTAnalyticslistTagsForResourceRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.LimitExceededException - The command caused an internal limit to be exceeded.ResourceNotFoundException - A resource with the specified name could not be found.public PutLoggingOptionsResult putLoggingOptions(PutLoggingOptionsRequest request)
Sets or updates the AWS IoT Analytics logging options.
 If you update the value of any loggingOptions field, it takes up to one minute for the change to
 take effect. Also, if you change the policy attached to the role you specified in the roleArn field
 (for example, to correct an invalid policy), it takes up to five minutes for that change to take effect.
 
putLoggingOptions in interface AWSIoTAnalyticsputLoggingOptionsRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public RunPipelineActivityResult runPipelineActivity(RunPipelineActivityRequest request)
Simulates the results of running a pipeline activity on a message payload.
runPipelineActivity in interface AWSIoTAnalyticsrunPipelineActivityRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public SampleChannelDataResult sampleChannelData(SampleChannelDataRequest request)
Retrieves a sample of messages from the specified channel ingested during the specified timeframe. Up to 10 messages can be retrieved.
sampleChannelData in interface AWSIoTAnalyticssampleChannelDataRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public StartPipelineReprocessingResult startPipelineReprocessing(StartPipelineReprocessingRequest request)
Starts the reprocessing of raw message data through the pipeline.
startPipelineReprocessing in interface AWSIoTAnalyticsstartPipelineReprocessingRequest - ResourceNotFoundException - A resource with the specified name could not be found.ResourceAlreadyExistsException - A resource with the same name already exists.InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public TagResourceResult tagResource(TagResourceRequest request)
Adds to or modifies the tags of the given resource. Tags are metadata that can be used to manage a resource.
tagResource in interface AWSIoTAnalyticstagResourceRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.LimitExceededException - The command caused an internal limit to be exceeded.ResourceNotFoundException - A resource with the specified name could not be found.public UntagResourceResult untagResource(UntagResourceRequest request)
Removes the given tags (metadata) from the resource.
untagResource in interface AWSIoTAnalyticsuntagResourceRequest - InvalidRequestException - The request was not valid.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.LimitExceededException - The command caused an internal limit to be exceeded.ResourceNotFoundException - A resource with the specified name could not be found.public UpdateChannelResult updateChannel(UpdateChannelRequest request)
Updates the settings of a channel.
updateChannel in interface AWSIoTAnalyticsupdateChannelRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public UpdateDatasetResult updateDataset(UpdateDatasetRequest request)
Updates the settings of a data set.
updateDataset in interface AWSIoTAnalyticsupdateDatasetRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public UpdateDatastoreResult updateDatastore(UpdateDatastoreRequest request)
Updates the settings of a data store.
updateDatastore in interface AWSIoTAnalyticsupdateDatastoreRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.public UpdatePipelineResult updatePipeline(UpdatePipelineRequest request)
 Updates the settings of a pipeline. You must specify both a channel and a datastore
 activity and, optionally, as many as 23 additional activities in the pipelineActivities array.
 
updatePipeline in interface AWSIoTAnalyticsupdatePipelineRequest - InvalidRequestException - The request was not valid.ResourceNotFoundException - A resource with the specified name could not be found.InternalFailureException - There was an internal failure.ServiceUnavailableException - The service is temporarily unavailable.ThrottlingException - The request was denied due to request throttling.LimitExceededException - The command caused an internal limit to be exceeded.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata in interface AWSIoTAnalyticsrequest - The originally executed requestpublic void shutdown()
AmazonWebServiceClientshutdown in interface AWSIoTAnalyticsshutdown in class AmazonWebServiceClient