> For the complete documentation index, see [llms.txt](https://docs.skeddly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skeddly.com/data-types/actionparameters-object/amazoncreatecloudtrailtrailsparameters-object.md).

# AmazonCreateCloudTrailTrailsParameters Object

## Description

Parameters for the Amazon Create CloudTrail Trails action.

## Properties

### bucketName

Name of the S3 bucket used to store the trail events.

Type: `string`

Required: Yes

### cloudWatchLogsProperties

Enables CloudWatch logs on the new trails.

Type: [CloudTrailCloudWatchLogsProperties](/data-types/cloudtrailcloudwatchlogsproperties-object.md) object

Required: No

### creationRule

Rule determining if the trails will be created.

Type: string

Valid Values:

* `create-always`
* `create-if-needed`
* `created-if-name-does-not-exist`

Required: Yes

### credentialIds

Registered credentials to use with the action. One and only one credential must be specified.

Type: Array of `string`

Required: Yes

### globalServicesEventsLocation

Indicates which trails will be enabled as targets for global services events.

Type: string

Valid Values:

* `none`
* `all-regions`
* `executing-region-only`

Required: Yes

### isEnableLogFileValidation

Indicates whether log file validation is enabled on the trail.

Type: `boolean`

Required: No

Default: false

### kmsKeyId

ID of the KMS key to use to encrypt the objects stored in the S3 bucket.

Type: `string`

Required: No

### multiRegionLocation

Indicates which trails will be enabled as "multi-region".

Type: string

Valid Values:

* `none`
* `all-regions`
* `executing-region-only`

Required: Yes

### prefix

Prefix applied to all event objects stored into the S3 bucket.

Type: `string`

Required: No

### regionNames

Regions to use with the action. One and only one region must be specified.

Type: Array of `string`

Required: Yes

### regionsToApply

Regions to create the regions in.

Type: string

Valid Values:

* `all-regions`
* `executing-region-only`

Required: Yes

### snsTopicName

Name of the SNS topic to send notifications to.

Type: `string`

Required: No

### tags

Resource tags to apply to the new trails.

Type: Array of [Tag](/data-types/tag-object.md) objects

Required: No

### trailName

Name of the trail to be created.

Type: `string`

Required: Yes

## Sample JSON

```javascript
{
    "credentialIds": [
        "cred-00000001"
    ],
    "regionNames": [
        "us-east-1"
    ],
    
    "stackName": "stack-$(DATE)",
    "templateFormat": "s3-bucket",
    "templateBucketName": "bucket1",
    "templateObjectKey": "template.json",
    
    "parameters": [
        "key": "param1",
        "value": "value1"
    ],
    
    "capabilities": [
        "iam"
    ],
    
    "tags": [
        {
            "key": "Environment",
            "value": "Development"
        }
    ],
    
    "failureBehaviour": "delete-stack",
    
    "deleteTimeInSeconds": 3600
}
```