NAME

Paws::IoTAnalytics::CreateDataset - Arguments for method CreateDataset on Paws::IoTAnalytics

DESCRIPTION

This class represents the parameters used for calling the method CreateDataset on the AWS IoT Analytics service. Use the attributes of this class as arguments to method CreateDataset.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to CreateDataset.

SYNOPSIS

my $iotanalytics = Paws->service('IoTAnalytics');
my $CreateDatasetResponse = $iotanalytics->CreateDataset(
  Actions => [
    {
      ActionName      => 'MyDatasetActionName', # min: 1, max: 128; OPTIONAL
      ContainerAction => {
        ExecutionRoleArn      => 'MyRoleArn',    # min: 20, max: 2048
        Image                 => 'MyImage',      # max: 255
        ResourceConfiguration => {
          ComputeType    => 'ACU_1',             # values: ACU_1, ACU_2
          VolumeSizeInGB => 1,                   # min: 1, max: 50

        },
        Variables => [
          {
            Name => 'MyVariableName',            # min: 1, max: 256
            DatasetContentVersionValue => {
              DatasetName => 'MyDatasetName',    # min: 1, max: 128

            },    # OPTIONAL
            DoubleValue        => 1,    # OPTIONAL
            OutputFileUriValue => {
              FileName => 'MyOutputFileName',

            },                          # OPTIONAL
            StringValue => 'MyStringValue',    # max: 1024; OPTIONAL
          },
          ...
        ],    # max: 50; OPTIONAL
      },    # OPTIONAL
      QueryAction => {
        SqlQuery => 'MySqlQuery',
        Filters  => [
          {
            DeltaTime => {
              OffsetSeconds  => 1,
              TimeExpression => 'MyTimeExpression',

            },    # OPTIONAL
          },
          ...
        ],    # max: 1; OPTIONAL
      },    # OPTIONAL
    },
    ...
  ],
  DatasetName          => 'MyDatasetName',
  ContentDeliveryRules => [
    {
      Destination => {
        IotEventsDestinationConfiguration => {
          InputName => 'MyIotEventsInputName',    # min: 1, max: 128
          RoleArn   => 'MyRoleArn',               # min: 20, max: 2048

        },    # OPTIONAL
        S3DestinationConfiguration => {
          Bucket            => 'MyBucketName',          # min: 3, max: 255
          Key               => 'MyBucketKeyExpression', # min: 1, max: 255
          RoleArn           => 'MyRoleArn',             # min: 20, max: 2048
          GlueConfiguration => {
            DatabaseName => 'MyGlueDatabaseName',       # min: 1, max: 150
            TableName    => 'MyGlueTableName',          # min: 1, max: 150

          },    # OPTIONAL
        },    # OPTIONAL
      },
      EntryName => 'MyEntryName',    # OPTIONAL
    },
    ...
  ],    # OPTIONAL
  LateDataRules => [
    {
      RuleConfiguration => {
        DeltaTimeSessionWindowConfiguration => {
          TimeoutInMinutes => 1,    # min: 1, max: 60

        },    # OPTIONAL
      },
      RuleName => 'MyLateDataRuleName',    # min: 1, max: 128; OPTIONAL
    },
    ...
  ],    # OPTIONAL
  RetentionPeriod => {
    NumberOfDays => 1,    # min: 1; OPTIONAL
    Unlimited    => 1,    # OPTIONAL
  },    # OPTIONAL
  Tags => [
    {
      Key   => 'MyTagKey',      # min: 1, max: 256
      Value => 'MyTagValue',    # min: 1, max: 256

    },
    ...
  ],    # OPTIONAL
  Triggers => [
    {
      Dataset => {
        Name => 'MyDatasetName',    # min: 1, max: 128

      },    # OPTIONAL
      Schedule => {
        Expression => 'MyScheduleExpression',    # OPTIONAL
      },    # OPTIONAL
    },
    ...
  ],    # OPTIONAL
  VersioningConfiguration => {
    MaxVersions => 1,    # min: 1, max: 1000; OPTIONAL
    Unlimited   => 1,    # OPTIONAL
  },    # OPTIONAL
);

# Results:
my $DatasetArn      = $CreateDatasetResponse->DatasetArn;
my $DatasetName     = $CreateDatasetResponse->DatasetName;
my $RetentionPeriod = $CreateDatasetResponse->RetentionPeriod;

# Returns a L<Paws::IoTAnalytics::CreateDatasetResponse> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/iotanalytics/CreateDataset

ATTRIBUTES

REQUIRED Actions => ArrayRef[Paws::IoTAnalytics::DatasetAction]

A list of actions that create the data set contents.

ContentDeliveryRules => ArrayRef[Paws::IoTAnalytics::DatasetContentDeliveryRule]

When dataset contents are created, they are delivered to destinations specified here.

REQUIRED DatasetName => Str

The name of the data set.

LateDataRules => ArrayRef[Paws::IoTAnalytics::LateDataRule]

A list of data rules that send notifications to Amazon CloudWatch, when data arrives late. To specify lateDataRules, the dataset must use a DeltaTimer (https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeltaTime.html) filter.

RetentionPeriod => Paws::IoTAnalytics::RetentionPeriod

Optional. How long, in days, versions of dataset contents are kept for the dataset. If not specified or set to null, versions of dataset contents are retained for at most 90 days. The number of versions of dataset contents retained is determined by the versioningConfiguration parameter. For more information, see Keeping Multiple Versions of AWS IoT Analytics Data Sets (https://docs.aws.amazon.com/iotanalytics/latest/userguide/getting-started.html#aws-iot-analytics-dataset-versions) in the AWS IoT Analytics User Guide.

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

Metadata which can be used to manage the data set.

Triggers => ArrayRef[Paws::IoTAnalytics::DatasetTrigger]

A list of triggers. A trigger causes data set contents to be populated at a specified time interval or when another data set's contents are created. The list of triggers can be empty or contain up to five DataSetTrigger objects.

VersioningConfiguration => Paws::IoTAnalytics::VersioningConfiguration

Optional. How many versions of dataset contents are kept. If not specified or set to null, only the latest version plus the latest succeeded version (if they are different) are kept for the time period specified by the retentionPeriod parameter. For more information, see Keeping Multiple Versions of AWS IoT Analytics Data Sets (https://docs.aws.amazon.com/iotanalytics/latest/userguide/getting-started.html#aws-iot-analytics-dataset-versions) in the AWS IoT Analytics User Guide.

SEE ALSO

This class forms part of Paws, documenting arguments for method CreateDataset in Paws::IoTAnalytics

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