@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_METRIC
ENDPOINT_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 data set.
|
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).
|
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 data set.
|
DeleteDatasetContentResult |
deleteDatasetContent(DeleteDatasetContentRequest request)
Deletes the content of the specified data set.
|
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 data set.
|
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 pre-signed 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) which 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.
|
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, shutdown, withEndpoint, withRegion, withRegion, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
shutdown
public static AWSIoTAnalyticsClientBuilder builder()
public BatchPutMessageResult batchPutMessage(BatchPutMessageRequest request)
Sends messages to a channel.
batchPutMessage
in interface AWSIoTAnalytics
batchPutMessageRequest
- 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 AWSIoTAnalytics
cancelPipelineReprocessingRequest
- 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 AWSIoTAnalytics
createChannelRequest
- 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 data set. A data set 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 data set. The data set can be populated manually by calling "CreateDatasetContent" or automatically according to a "trigger" you specify.
createDataset
in interface AWSIoTAnalytics
createDatasetRequest
- 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 AWSIoTAnalytics
createDatasetContentRequest
- 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 AWSIoTAnalytics
createDatastoreRequest
- 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 AWSIoTAnalytics
createPipelineRequest
- 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 AWSIoTAnalytics
deleteChannelRequest
- 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 data set.
You do not have to delete the content of the data set before you perform this operation.
deleteDataset
in interface AWSIoTAnalytics
deleteDatasetRequest
- 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 data set.
deleteDatasetContent
in interface AWSIoTAnalytics
deleteDatasetContentRequest
- 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 AWSIoTAnalytics
deleteDatastoreRequest
- 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 AWSIoTAnalytics
deletePipelineRequest
- 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 AWSIoTAnalytics
describeChannelRequest
- 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 data set.
describeDataset
in interface AWSIoTAnalytics
describeDatasetRequest
- 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 AWSIoTAnalytics
describeDatastoreRequest
- 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 AWSIoTAnalytics
describeLoggingOptionsRequest
- 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 AWSIoTAnalytics
describePipelineRequest
- 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 pre-signed URIs.
getDatasetContent
in interface AWSIoTAnalytics
getDatasetContentRequest
- 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 AWSIoTAnalytics
listChannelsRequest
- 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 AWSIoTAnalytics
listDatasetContentsRequest
- 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 AWSIoTAnalytics
listDatasetsRequest
- 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 AWSIoTAnalytics
listDatastoresRequest
- 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 AWSIoTAnalytics
listPipelinesRequest
- 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) which you have assigned to the resource.
listTagsForResource
in interface AWSIoTAnalytics
listTagsForResourceRequest
- 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.
Note that 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 5 minutes for that change to take effect.
putLoggingOptions
in interface AWSIoTAnalytics
putLoggingOptionsRequest
- 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 AWSIoTAnalytics
runPipelineActivityRequest
- 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 AWSIoTAnalytics
sampleChannelDataRequest
- 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 AWSIoTAnalytics
startPipelineReprocessingRequest
- 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 which can be used to manage a resource.
tagResource
in interface AWSIoTAnalytics
tagResourceRequest
- 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 AWSIoTAnalytics
untagResourceRequest
- 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 AWSIoTAnalytics
updateChannelRequest
- 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 AWSIoTAnalytics
updateDatasetRequest
- 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 AWSIoTAnalytics
updateDatastoreRequest
- 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 AWSIoTAnalytics
updatePipelineRequest
- 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 AWSIoTAnalytics
request
- The originally executed requestCopyright © 2013 Amazon Web Services, Inc. All Rights Reserved.