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
  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 data set contents are created they are delivered to destinations specified here.

REQUIRED DatasetName => Str

The name of the data set.

RetentionPeriod => Paws::IoTAnalytics::RetentionPeriod

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

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 data set 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 https://docs.aws.amazon.com/iotanalytics/latest/userguide/getting-started.html#aws-iot-analytics-dataset-versions)

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