The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Paws::IoTAnalytics - Perl Interface to AWS AWS IoT Analytics

SYNOPSIS

  use Paws;

  my $obj = Paws->service('IoTAnalytics');
  my $res = $obj->Method(
    Arg1 => $val1,
    Arg2 => [ 'V1', 'V2' ],
    # if Arg3 is an object, the HashRef will be used as arguments to the constructor
    # of the arguments type
    Arg3 => { Att1 => 'Val1' },
    # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
    # the constructor of the arguments type
    Arg4 => [ { Att1 => 'Val1'  }, { Att1 => 'Val2' } ],
  );

DESCRIPTION

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.

For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/iotanalytics-2017-11-27

METHODS

BatchPutMessage

ChannelName => Str
Messages => ArrayRef[Paws::IoTAnalytics::Message]

Each argument is described in detail in: Paws::IoTAnalytics::BatchPutMessage

Returns: a Paws::IoTAnalytics::BatchPutMessageResponse instance

Sends messages to a channel.

CancelPipelineReprocessing

PipelineName => Str
ReprocessingId => Str

Each argument is described in detail in: Paws::IoTAnalytics::CancelPipelineReprocessing

Returns: a Paws::IoTAnalytics::CancelPipelineReprocessingResponse instance

Cancels the reprocessing of data through the pipeline.

CreateChannel

ChannelName => Str
[ChannelStorage => Paws::IoTAnalytics::ChannelStorage]
[RetentionPeriod => Paws::IoTAnalytics::RetentionPeriod]
[Tags => ArrayRef[Paws::IoTAnalytics::Tag]]

Each argument is described in detail in: Paws::IoTAnalytics::CreateChannel

Returns: a Paws::IoTAnalytics::CreateChannelResponse instance

Creates a channel. A channel collects data from an MQTT topic and archives the raw, unprocessed messages before publishing the data to a pipeline.

CreateDataset

Actions => ArrayRef[Paws::IoTAnalytics::DatasetAction]
DatasetName => Str
[ContentDeliveryRules => ArrayRef[Paws::IoTAnalytics::DatasetContentDeliveryRule]]
[RetentionPeriod => Paws::IoTAnalytics::RetentionPeriod]
[Tags => ArrayRef[Paws::IoTAnalytics::Tag]]
[Triggers => ArrayRef[Paws::IoTAnalytics::DatasetTrigger]]
[VersioningConfiguration => Paws::IoTAnalytics::VersioningConfiguration]

Each argument is described in detail in: Paws::IoTAnalytics::CreateDataset

Returns: a Paws::IoTAnalytics::CreateDatasetResponse instance

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.

CreateDatasetContent

DatasetName => Str

Each argument is described in detail in: Paws::IoTAnalytics::CreateDatasetContent

Returns: a Paws::IoTAnalytics::CreateDatasetContentResponse instance

Creates the content of a data set by applying a "queryAction" (a SQL query) or a "containerAction" (executing a containerized application).

CreateDatastore

DatastoreName => Str
[DatastoreStorage => Paws::IoTAnalytics::DatastoreStorage]
[RetentionPeriod => Paws::IoTAnalytics::RetentionPeriod]
[Tags => ArrayRef[Paws::IoTAnalytics::Tag]]

Each argument is described in detail in: Paws::IoTAnalytics::CreateDatastore

Returns: a Paws::IoTAnalytics::CreateDatastoreResponse instance

Creates a data store, which is a repository for messages.

CreatePipeline

PipelineActivities => ArrayRef[Paws::IoTAnalytics::PipelineActivity]
PipelineName => Str
[Tags => ArrayRef[Paws::IoTAnalytics::Tag]]

Each argument is described in detail in: Paws::IoTAnalytics::CreatePipeline

Returns: a Paws::IoTAnalytics::CreatePipelineResponse instance

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.

DeleteChannel

ChannelName => Str

Each argument is described in detail in: Paws::IoTAnalytics::DeleteChannel

Returns: nothing

Deletes the specified channel.

DeleteDataset

DatasetName => Str

Each argument is described in detail in: Paws::IoTAnalytics::DeleteDataset

Returns: nothing

Deletes the specified data set.

You do not have to delete the content of the data set before you perform this operation.

DeleteDatasetContent

DatasetName => Str
[VersionId => Str]

Each argument is described in detail in: Paws::IoTAnalytics::DeleteDatasetContent

Returns: nothing

Deletes the content of the specified data set.

DeleteDatastore

DatastoreName => Str

Each argument is described in detail in: Paws::IoTAnalytics::DeleteDatastore

Returns: nothing

Deletes the specified data store.

DeletePipeline

PipelineName => Str

Each argument is described in detail in: Paws::IoTAnalytics::DeletePipeline

Returns: nothing

Deletes the specified pipeline.

DescribeChannel

ChannelName => Str
[IncludeStatistics => Bool]

Each argument is described in detail in: Paws::IoTAnalytics::DescribeChannel

Returns: a Paws::IoTAnalytics::DescribeChannelResponse instance

Retrieves information about a channel.

DescribeDataset

DatasetName => Str

Each argument is described in detail in: Paws::IoTAnalytics::DescribeDataset

Returns: a Paws::IoTAnalytics::DescribeDatasetResponse instance

Retrieves information about a data set.

DescribeDatastore

DatastoreName => Str
[IncludeStatistics => Bool]

Each argument is described in detail in: Paws::IoTAnalytics::DescribeDatastore

Returns: a Paws::IoTAnalytics::DescribeDatastoreResponse instance

Retrieves information about a data store.

DescribeLoggingOptions

Each argument is described in detail in: Paws::IoTAnalytics::DescribeLoggingOptions

Returns: a Paws::IoTAnalytics::DescribeLoggingOptionsResponse instance

Retrieves the current settings of the AWS IoT Analytics logging options.

DescribePipeline

PipelineName => Str

Each argument is described in detail in: Paws::IoTAnalytics::DescribePipeline

Returns: a Paws::IoTAnalytics::DescribePipelineResponse instance

Retrieves information about a pipeline.

GetDatasetContent

DatasetName => Str
[VersionId => Str]

Each argument is described in detail in: Paws::IoTAnalytics::GetDatasetContent

Returns: a Paws::IoTAnalytics::GetDatasetContentResponse instance

Retrieves the contents of a data set as pre-signed URIs.

ListChannels

[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::IoTAnalytics::ListChannels

Returns: a Paws::IoTAnalytics::ListChannelsResponse instance

Retrieves a list of channels.

ListDatasetContents

DatasetName => Str
[MaxResults => Int]
[NextToken => Str]
[ScheduledBefore => Str]
[ScheduledOnOrAfter => Str]

Each argument is described in detail in: Paws::IoTAnalytics::ListDatasetContents

Returns: a Paws::IoTAnalytics::ListDatasetContentsResponse instance

Lists information about data set contents that have been created.

ListDatasets

[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::IoTAnalytics::ListDatasets

Returns: a Paws::IoTAnalytics::ListDatasetsResponse instance

Retrieves information about data sets.

ListDatastores

[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::IoTAnalytics::ListDatastores

Returns: a Paws::IoTAnalytics::ListDatastoresResponse instance

Retrieves a list of data stores.

ListPipelines

[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::IoTAnalytics::ListPipelines

Returns: a Paws::IoTAnalytics::ListPipelinesResponse instance

Retrieves a list of pipelines.

ListTagsForResource

ResourceArn => Str

Each argument is described in detail in: Paws::IoTAnalytics::ListTagsForResource

Returns: a Paws::IoTAnalytics::ListTagsForResourceResponse instance

Lists the tags (metadata) which you have assigned to the resource.

PutLoggingOptions

LoggingOptions => Paws::IoTAnalytics::LoggingOptions

Each argument is described in detail in: Paws::IoTAnalytics::PutLoggingOptions

Returns: nothing

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.

RunPipelineActivity

Payloads => ArrayRef[Str|Undef]
PipelineActivity => Paws::IoTAnalytics::PipelineActivity

Each argument is described in detail in: Paws::IoTAnalytics::RunPipelineActivity

Returns: a Paws::IoTAnalytics::RunPipelineActivityResponse instance

Simulates the results of running a pipeline activity on a message payload.

SampleChannelData

ChannelName => Str
[EndTime => Str]
[MaxMessages => Int]
[StartTime => Str]

Each argument is described in detail in: Paws::IoTAnalytics::SampleChannelData

Returns: a Paws::IoTAnalytics::SampleChannelDataResponse instance

Retrieves a sample of messages from the specified channel ingested during the specified timeframe. Up to 10 messages can be retrieved.

StartPipelineReprocessing

PipelineName => Str
[EndTime => Str]
[StartTime => Str]

Each argument is described in detail in: Paws::IoTAnalytics::StartPipelineReprocessing

Returns: a Paws::IoTAnalytics::StartPipelineReprocessingResponse instance

Starts the reprocessing of raw message data through the pipeline.

TagResource

ResourceArn => Str
Tags => ArrayRef[Paws::IoTAnalytics::Tag]

Each argument is described in detail in: Paws::IoTAnalytics::TagResource

Returns: a Paws::IoTAnalytics::TagResourceResponse instance

Adds to or modifies the tags of the given resource. Tags are metadata which can be used to manage a resource.

UntagResource

ResourceArn => Str
TagKeys => ArrayRef[Str|Undef]

Each argument is described in detail in: Paws::IoTAnalytics::UntagResource

Returns: a Paws::IoTAnalytics::UntagResourceResponse instance

Removes the given tags (metadata) from the resource.

UpdateChannel

ChannelName => Str
[ChannelStorage => Paws::IoTAnalytics::ChannelStorage]
[RetentionPeriod => Paws::IoTAnalytics::RetentionPeriod]

Each argument is described in detail in: Paws::IoTAnalytics::UpdateChannel

Returns: nothing

Updates the settings of a channel.

UpdateDataset

Actions => ArrayRef[Paws::IoTAnalytics::DatasetAction]
DatasetName => Str
[ContentDeliveryRules => ArrayRef[Paws::IoTAnalytics::DatasetContentDeliveryRule]]
[RetentionPeriod => Paws::IoTAnalytics::RetentionPeriod]
[Triggers => ArrayRef[Paws::IoTAnalytics::DatasetTrigger]]
[VersioningConfiguration => Paws::IoTAnalytics::VersioningConfiguration]

Each argument is described in detail in: Paws::IoTAnalytics::UpdateDataset

Returns: nothing

Updates the settings of a data set.

UpdateDatastore

DatastoreName => Str
[DatastoreStorage => Paws::IoTAnalytics::DatastoreStorage]
[RetentionPeriod => Paws::IoTAnalytics::RetentionPeriod]

Each argument is described in detail in: Paws::IoTAnalytics::UpdateDatastore

Returns: nothing

Updates the settings of a data store.

UpdatePipeline

PipelineActivities => ArrayRef[Paws::IoTAnalytics::PipelineActivity]
PipelineName => Str

Each argument is described in detail in: Paws::IoTAnalytics::UpdatePipeline

Returns: nothing

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.

PAGINATORS

Paginator methods are helpers that repetively call methods that return partial results

ListAllChannels(sub { },[MaxResults => Int, NextToken => Str])

ListAllChannels([MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - channelSummaries, passing the object as the first parameter, and the string 'channelSummaries' as the second parameter 

If not, it will return a a Paws::IoTAnalytics::ListChannelsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllDatasetContents(sub { },DatasetName => Str, [MaxResults => Int, NextToken => Str, ScheduledBefore => Str, ScheduledOnOrAfter => Str])

ListAllDatasetContents(DatasetName => Str, [MaxResults => Int, NextToken => Str, ScheduledBefore => Str, ScheduledOnOrAfter => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - datasetContentSummaries, passing the object as the first parameter, and the string 'datasetContentSummaries' as the second parameter 

If not, it will return a a Paws::IoTAnalytics::ListDatasetContentsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllDatasets(sub { },[MaxResults => Int, NextToken => Str])

ListAllDatasets([MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - datasetSummaries, passing the object as the first parameter, and the string 'datasetSummaries' as the second parameter 

If not, it will return a a Paws::IoTAnalytics::ListDatasetsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllDatastores(sub { },[MaxResults => Int, NextToken => Str])

ListAllDatastores([MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - datastoreSummaries, passing the object as the first parameter, and the string 'datastoreSummaries' as the second parameter 

If not, it will return a a Paws::IoTAnalytics::ListDatastoresResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllPipelines(sub { },[MaxResults => Int, NextToken => Str])

ListAllPipelines([MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - pipelineSummaries, passing the object as the first parameter, and the string 'pipelineSummaries' as the second parameter 

If not, it will return a a Paws::IoTAnalytics::ListPipelinesResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

SEE ALSO

This service class forms part of Paws

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues