# CfnDatasetProps

Properties for defining a `CfnDataset`.

Extends: CfnDatasetProps
Used as props by: CfnDataset

- Source: Generated code

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_iotanalytics as iotanalytics } from 'aws-cdk-lib';
const cfnDatasetProps: iotanalytics.CfnDatasetProps = {
  actions: [{
    actionName: 'actionName',

    // the properties below are optional
    containerAction: {
      executionRoleArn: 'executionRoleArn',
      image: 'image',
      resourceConfiguration: {
        computeType: 'computeType',
        volumeSizeInGb: 123,
      },

      // the properties below are optional
      variables: [{
        variableName: 'variableName',

        // the properties below are optional
        datasetContentVersionValue: {
          datasetName: 'datasetName',
        },
        doubleValue: 123,
        outputFileUriValue: {
          fileName: 'fileName',
        },
        stringValue: 'stringValue',
      }],
    },
    queryAction: {
      sqlQuery: 'sqlQuery',

      // the properties below are optional
      filters: [{
        deltaTime: {
          offsetSeconds: 123,
          timeExpression: 'timeExpression',
        },
      }],
    },
  }],

  // the properties below are optional
  contentDeliveryRules: [{
    destination: {
      iotEventsDestinationConfiguration: {
        inputName: 'inputName',
        roleArn: 'roleArn',
      },
      s3DestinationConfiguration: {
        bucket: 'bucket',
        key: 'key',
        roleArn: 'roleArn',

        // the properties below are optional
        glueConfiguration: {
          databaseName: 'databaseName',
          tableName: 'tableName',
        },
      },
    },

    // the properties below are optional
    entryName: 'entryName',
  }],
  datasetName: 'datasetName',
  lateDataRules: [{
    ruleConfiguration: {
      deltaTimeSessionWindowConfiguration: {
        timeoutInMinutes: 123,
      },
    },

    // the properties below are optional
    ruleName: 'ruleName',
  }],
  retentionPeriod: {
    numberOfDays: 123,
    unlimited: false,
  },
  tags: [{
    key: 'key',
    value: 'value',
  }],
  triggers: [{
    schedule: {
      scheduleExpression: 'scheduleExpression',
    },
    triggeringDataset: {
      datasetName: 'datasetName',
    },
  }],
  versioningConfiguration: {
    maxVersions: 123,
    unlimited: false,
  },
};
```

## Properties

- `actions`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnDataset.ActionProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_iotanalytics.CfnDataset.ActionProperty.html)[] (required) — The `DatasetAction` objects that automatically create the dataset contents.

- `contentDeliveryRules`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnDataset.DatasetContentDeliveryRuleProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_iotanalytics.CfnDataset.DatasetContentDeliveryRuleProperty.html)[] — When dataset contents are created they are delivered to destinations specified here.

- `datasetName`: string — The name of the dataset.

- `lateDataRules`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnDataset.LateDataRuleProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_iotanalytics.CfnDataset.LateDataRuleProperty.html)[] — A list of data rules that send notifications to 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`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnDataset.RetentionPeriodProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_iotanalytics.CfnDataset.RetentionPeriodProperty.html) — Optional.

  How long, in days, message data is kept for the dataset.

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — Metadata which can be used to manage the data set.

  For more information, see [Tag](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html) .

- `triggers`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnDataset.TriggerProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_iotanalytics.CfnDataset.TriggerProperty.html)[] — The `DatasetTrigger` objects that specify when the dataset is automatically updated.

- `versioningConfiguration`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnDataset.VersioningConfigurationProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_iotanalytics.CfnDataset.VersioningConfigurationProperty.html) — 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 ITA datasets](https://docs.aws.amazon.com/iotanalytics/latest/userguide/getting-started.html#aws-iot-analytics-dataset-versions) in the *ITA User Guide* .