Network.AWS.CloudTrail.CreateTrail

From the command line, use 'create-subscription'.

Creates a trail that specifies the settings for delivery of log data to an Amazon S3 bucket.

See: AWS API Reference for CreateTrail.

Creating a Request

createTrail

Arguments

:: Text

ctName

-> Text

ctS3BucketName

-> CreateTrail

Creates a value of CreateTrail with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• ctS3KeyPrefix
• ctSNSTopicName
• ctCloudWatchLogsLogGroupARN
• ctIncludeGlobalServiceEvents
• ctCloudWatchLogsRoleARN
• ctName
• ctS3BucketName

data CreateTrail

Specifies the settings for each trail.

See: createTrail smart constructor.

Instances

Eq CreateTrail

Data CreateTrail

Read CreateTrail

Show CreateTrail

Generic CreateTrail

ToJSON CreateTrail

AWSRequest CreateTrail

ToPath CreateTrail

ToHeaders CreateTrail

ToQuery CreateTrail

Typeable * CreateTrail

type Rep CreateTrail

type Rs CreateTrail = CreateTrailResponse

Request Lenses

ctS3KeyPrefix :: Lens' CreateTrail (Maybe Text)

Specifies the Amazon S3 key prefix that precedes the name of the bucket you have designated for log file delivery.

ctSNSTopicName :: Lens' CreateTrail (Maybe Text)

Specifies the name of the Amazon SNS topic defined for notification of log file delivery.

ctCloudWatchLogsLogGroupARN :: Lens' CreateTrail (Maybe Text)

Specifies a log group name using an Amazon Resource Name (ARN), a unique identifier that represents the log group to which CloudTrail logs will be delivered. Not required unless you specify CloudWatchLogsRoleArn.

ctIncludeGlobalServiceEvents :: Lens' CreateTrail (Maybe Bool)

Specifies whether the trail is publishing events from global services such as IAM to the log files.

ctCloudWatchLogsRoleARN :: Lens' CreateTrail (Maybe Text)

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user’s log group.

ctName :: Lens' CreateTrail Text

Specifies the name of the trail.

ctS3BucketName :: Lens' CreateTrail Text

Specifies the name of the Amazon S3 bucket designated for publishing log files.

Destructuring the Response

createTrailResponse

Arguments

:: Int

ctrsResponseStatus

-> CreateTrailResponse

Creates a value of CreateTrailResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• ctrsS3KeyPrefix
• ctrsSNSTopicName
• ctrsCloudWatchLogsLogGroupARN
• ctrsName
• ctrsIncludeGlobalServiceEvents
• ctrsCloudWatchLogsRoleARN
• ctrsS3BucketName
• ctrsResponseStatus

data CreateTrailResponse

Returns the objects or data listed below if successful. Otherwise, returns an error.

See: createTrailResponse smart constructor.

Instances

Eq CreateTrailResponse

Data CreateTrailResponse

Read CreateTrailResponse

Show CreateTrailResponse

Generic CreateTrailResponse

Typeable * CreateTrailResponse

type Rep CreateTrailResponse

Response Lenses

ctrsS3KeyPrefix :: Lens' CreateTrailResponse (Maybe Text)

Specifies the Amazon S3 key prefix that precedes the name of the bucket you have designated for log file delivery.

ctrsSNSTopicName :: Lens' CreateTrailResponse (Maybe Text)

Specifies the name of the Amazon SNS topic defined for notification of log file delivery.

ctrsCloudWatchLogsLogGroupARN :: Lens' CreateTrailResponse (Maybe Text)

Specifies the Amazon Resource Name (ARN) of the log group to which CloudTrail logs will be delivered.

ctrsName :: Lens' CreateTrailResponse (Maybe Text)

Specifies the name of the trail.

ctrsIncludeGlobalServiceEvents :: Lens' CreateTrailResponse (Maybe Bool)

Specifies whether the trail is publishing events from global services such as IAM to the log files.

ctrsCloudWatchLogsRoleARN :: Lens' CreateTrailResponse (Maybe Text)

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user’s log group.

ctrsS3BucketName :: Lens' CreateTrailResponse (Maybe Text)

Specifies the name of the Amazon S3 bucket designated for publishing log files.

ctrsResponseStatus :: Lens' CreateTrailResponse Int

The response status code.