/** * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * SPDX-License-Identifier: Apache-2.0. */ #pragma once #include #include #include #include #include #include namespace Aws { namespace CloudTrail { namespace Model { /** *

Specifies the settings for each trail.

*/ class CreateTrailRequest : public CloudTrailRequest { public: AWS_CLOUDTRAIL_API CreateTrailRequest(); // Service request name is the Operation name which will send this request out, // each operation should has unique request name, so that we can get operation's name from this request. // Note: this is not true for response, multiple operations may have the same response name, // so we can not get operation's name from response. inline virtual const char* GetServiceRequestName() const override { return "CreateTrail"; } AWS_CLOUDTRAIL_API Aws::String SerializePayload() const override; AWS_CLOUDTRAIL_API Aws::Http::HeaderValueCollection GetRequestSpecificHeaders() const override; /** *

Specifies the name of the trail. The name must meet the following * requirements:

Contain only ASCII letters (a-z, A-Z), numbers * (0-9), periods (.), underscores (_), or dashes (-)
Start with * a letter or number, and end with a letter or number
Be between * 3 and 128 characters
Have no adjacent periods, underscores or * dashes. Names like my-_namespace and my--namespace are * not valid.
Not be in IP address format (for example, * 192.168.5.4)

*/ inline const Aws::String& GetName() const{ return m_name; } /** *

Specifies the name of the trail. The name must meet the following * requirements:

Contain only ASCII letters (a-z, A-Z), numbers * (0-9), periods (.), underscores (_), or dashes (-)
Start with * a letter or number, and end with a letter or number
Be between * 3 and 128 characters
Have no adjacent periods, underscores or * dashes. Names like my-_namespace and my--namespace are * not valid.
Not be in IP address format (for example, * 192.168.5.4)

*/ inline bool NameHasBeenSet() const { return m_nameHasBeenSet; } /** *

Specifies the name of the trail. The name must meet the following * requirements:

Contain only ASCII letters (a-z, A-Z), numbers * (0-9), periods (.), underscores (_), or dashes (-)
Start with * a letter or number, and end with a letter or number
Be between * 3 and 128 characters
Have no adjacent periods, underscores or * dashes. Names like my-_namespace and my--namespace are * not valid.
Not be in IP address format (for example, * 192.168.5.4)

*/ inline void SetName(const Aws::String& value) { m_nameHasBeenSet = true; m_name = value; } /** *

Specifies the name of the trail. The name must meet the following * requirements:

Contain only ASCII letters (a-z, A-Z), numbers * (0-9), periods (.), underscores (_), or dashes (-)
Start with * a letter or number, and end with a letter or number
Be between * 3 and 128 characters
Have no adjacent periods, underscores or * dashes. Names like my-_namespace and my--namespace are * not valid.
Not be in IP address format (for example, * 192.168.5.4)

*/ inline void SetName(Aws::String&& value) { m_nameHasBeenSet = true; m_name = std::move(value); } /** *

Specifies the name of the trail. The name must meet the following * requirements:

Contain only ASCII letters (a-z, A-Z), numbers * (0-9), periods (.), underscores (_), or dashes (-)
Start with * a letter or number, and end with a letter or number
Be between * 3 and 128 characters
Have no adjacent periods, underscores or * dashes. Names like my-_namespace and my--namespace are * not valid.
Not be in IP address format (for example, * 192.168.5.4)

*/ inline void SetName(const char* value) { m_nameHasBeenSet = true; m_name.assign(value); } /** *

Specifies the name of the trail. The name must meet the following * requirements:

Contain only ASCII letters (a-z, A-Z), numbers * (0-9), periods (.), underscores (_), or dashes (-)
Start with * a letter or number, and end with a letter or number
Be between * 3 and 128 characters
Have no adjacent periods, underscores or * dashes. Names like my-_namespace and my--namespace are * not valid.
Not be in IP address format (for example, * 192.168.5.4)

*/ inline CreateTrailRequest& WithName(const Aws::String& value) { SetName(value); return *this;} /** *

Specifies the name of the trail. The name must meet the following * requirements:

Contain only ASCII letters (a-z, A-Z), numbers * (0-9), periods (.), underscores (_), or dashes (-)
Start with * a letter or number, and end with a letter or number
Be between * 3 and 128 characters
Have no adjacent periods, underscores or * dashes. Names like my-_namespace and my--namespace are * not valid.
Not be in IP address format (for example, * 192.168.5.4)

*/ inline CreateTrailRequest& WithName(Aws::String&& value) { SetName(std::move(value)); return *this;} /** *

Specifies the name of the trail. The name must meet the following * requirements:

Contain only ASCII letters (a-z, A-Z), numbers * (0-9), periods (.), underscores (_), or dashes (-)
Start with * a letter or number, and end with a letter or number
Be between * 3 and 128 characters
Have no adjacent periods, underscores or * dashes. Names like my-_namespace and my--namespace are * not valid.
Not be in IP address format (for example, * 192.168.5.4)

*/ inline CreateTrailRequest& WithName(const char* value) { SetName(value); return *this;} /** *

Specifies the name of the Amazon S3 bucket designated for publishing log * files. See Amazon * S3 Bucket Naming Requirements.

*/ inline const Aws::String& GetS3BucketName() const{ return m_s3BucketName; } /** *

Specifies the name of the Amazon S3 bucket designated for publishing log * files. See Amazon * S3 Bucket Naming Requirements.

*/ inline bool S3BucketNameHasBeenSet() const { return m_s3BucketNameHasBeenSet; } /** *

Specifies the name of the Amazon S3 bucket designated for publishing log * files. See Amazon * S3 Bucket Naming Requirements.

*/ inline void SetS3BucketName(const Aws::String& value) { m_s3BucketNameHasBeenSet = true; m_s3BucketName = value; } /** *

Specifies the name of the Amazon S3 bucket designated for publishing log * files. See Amazon * S3 Bucket Naming Requirements.

*/ inline void SetS3BucketName(Aws::String&& value) { m_s3BucketNameHasBeenSet = true; m_s3BucketName = std::move(value); } /** *

Specifies the name of the Amazon S3 bucket designated for publishing log * files. See Amazon * S3 Bucket Naming Requirements.

*/ inline void SetS3BucketName(const char* value) { m_s3BucketNameHasBeenSet = true; m_s3BucketName.assign(value); } /** *

Specifies the name of the Amazon S3 bucket designated for publishing log * files. See Amazon * S3 Bucket Naming Requirements.

*/ inline CreateTrailRequest& WithS3BucketName(const Aws::String& value) { SetS3BucketName(value); return *this;} /** *

Specifies the name of the Amazon S3 bucket designated for publishing log * files. See Amazon * S3 Bucket Naming Requirements.

*/ inline CreateTrailRequest& WithS3BucketName(Aws::String&& value) { SetS3BucketName(std::move(value)); return *this;} /** *

Specifies the name of the Amazon S3 bucket designated for publishing log * files. See Amazon * S3 Bucket Naming Requirements.

*/ inline CreateTrailRequest& WithS3BucketName(const char* value) { SetS3BucketName(value); return *this;} /** *

Specifies the Amazon S3 key prefix that comes after the name of the bucket * you have designated for log file delivery. For more information, see Finding * Your CloudTrail Log Files. The maximum length is 200 characters.

*/ inline const Aws::String& GetS3KeyPrefix() const{ return m_s3KeyPrefix; } /** *

*/ inline bool S3KeyPrefixHasBeenSet() const { return m_s3KeyPrefixHasBeenSet; } /** *

*/ inline void SetS3KeyPrefix(const Aws::String& value) { m_s3KeyPrefixHasBeenSet = true; m_s3KeyPrefix = value; } /** *

*/ inline void SetS3KeyPrefix(Aws::String&& value) { m_s3KeyPrefixHasBeenSet = true; m_s3KeyPrefix = std::move(value); } /** *

*/ inline void SetS3KeyPrefix(const char* value) { m_s3KeyPrefixHasBeenSet = true; m_s3KeyPrefix.assign(value); } /** *

*/ inline CreateTrailRequest& WithS3KeyPrefix(const Aws::String& value) { SetS3KeyPrefix(value); return *this;} /** *

*/ inline CreateTrailRequest& WithS3KeyPrefix(Aws::String&& value) { SetS3KeyPrefix(std::move(value)); return *this;} /** *

*/ inline CreateTrailRequest& WithS3KeyPrefix(const char* value) { SetS3KeyPrefix(value); return *this;} /** *

Specifies the name of the Amazon SNS topic defined for notification of log * file delivery. The maximum length is 256 characters.

*/ inline const Aws::String& GetSnsTopicName() const{ return m_snsTopicName; } /** *

Specifies the name of the Amazon SNS topic defined for notification of log * file delivery. The maximum length is 256 characters.

*/ inline bool SnsTopicNameHasBeenSet() const { return m_snsTopicNameHasBeenSet; } /** *

Specifies the name of the Amazon SNS topic defined for notification of log * file delivery. The maximum length is 256 characters.

*/ inline void SetSnsTopicName(const Aws::String& value) { m_snsTopicNameHasBeenSet = true; m_snsTopicName = value; } /** *

Specifies the name of the Amazon SNS topic defined for notification of log * file delivery. The maximum length is 256 characters.

*/ inline void SetSnsTopicName(Aws::String&& value) { m_snsTopicNameHasBeenSet = true; m_snsTopicName = std::move(value); } /** *

Specifies the name of the Amazon SNS topic defined for notification of log * file delivery. The maximum length is 256 characters.

*/ inline void SetSnsTopicName(const char* value) { m_snsTopicNameHasBeenSet = true; m_snsTopicName.assign(value); } /** *

Specifies the name of the Amazon SNS topic defined for notification of log * file delivery. The maximum length is 256 characters.

*/ inline CreateTrailRequest& WithSnsTopicName(const Aws::String& value) { SetSnsTopicName(value); return *this;} /** *

Specifies the name of the Amazon SNS topic defined for notification of log * file delivery. The maximum length is 256 characters.

*/ inline CreateTrailRequest& WithSnsTopicName(Aws::String&& value) { SetSnsTopicName(std::move(value)); return *this;} /** *

Specifies the name of the Amazon SNS topic defined for notification of log * file delivery. The maximum length is 256 characters.

*/ inline CreateTrailRequest& WithSnsTopicName(const char* value) { SetSnsTopicName(value); return *this;} /** *

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

*/ inline bool GetIncludeGlobalServiceEvents() const{ return m_includeGlobalServiceEvents; } /** *

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

*/ inline bool IncludeGlobalServiceEventsHasBeenSet() const { return m_includeGlobalServiceEventsHasBeenSet; } /** *

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

*/ inline void SetIncludeGlobalServiceEvents(bool value) { m_includeGlobalServiceEventsHasBeenSet = true; m_includeGlobalServiceEvents = value; } /** *

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

*/ inline CreateTrailRequest& WithIncludeGlobalServiceEvents(bool value) { SetIncludeGlobalServiceEvents(value); return *this;} /** *

Specifies whether the trail is created in the current Region or in all * Regions. The default is false, which creates a trail only in the Region where * you are signed in. As a best practice, consider creating trails that log events * in all Regions.

*/ inline bool GetIsMultiRegionTrail() const{ return m_isMultiRegionTrail; } /** *

*/ inline bool IsMultiRegionTrailHasBeenSet() const { return m_isMultiRegionTrailHasBeenSet; } /** *

*/ inline void SetIsMultiRegionTrail(bool value) { m_isMultiRegionTrailHasBeenSet = true; m_isMultiRegionTrail = value; } /** *

*/ inline CreateTrailRequest& WithIsMultiRegionTrail(bool value) { SetIsMultiRegionTrail(value); return *this;} /** *

Specifies whether log file integrity validation is enabled. The default is * false.

When you disable log file integrity validation, the chain * of digest files is broken after one hour. CloudTrail does not create digest * files for log files that were delivered during a period in which log file * integrity validation was disabled. For example, if you enable log file integrity * validation at noon on January 1, disable it at noon on January 2, and re-enable * it at noon on January 10, digest files will not be created for the log files * delivered from noon on January 2 to noon on January 10. The same applies * whenever you stop CloudTrail logging or delete a trail.

*/ inline bool GetEnableLogFileValidation() const{ return m_enableLogFileValidation; } /** *

Specifies whether log file integrity validation is enabled. The default is * false.

*/ inline bool EnableLogFileValidationHasBeenSet() const { return m_enableLogFileValidationHasBeenSet; } /** *

Specifies whether log file integrity validation is enabled. The default is * false.

*/ inline void SetEnableLogFileValidation(bool value) { m_enableLogFileValidationHasBeenSet = true; m_enableLogFileValidation = value; } /** *

Specifies whether log file integrity validation is enabled. The default is * false.

*/ inline CreateTrailRequest& WithEnableLogFileValidation(bool value) { SetEnableLogFileValidation(value); return *this;} /** *

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. You must use a log group that exists in your account.