aws-sdk-cloudtrail 1.18.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d8f92efb7bb2ae7f28a9b46e951f2058480481cb
-  data.tar.gz: e1dc43b670ac7c9e30429766a1608342f3323c30
+  metadata.gz: 6895c447d0feae813da5dc055dac76e59f266a08
+  data.tar.gz: 31ecefd18da65a7489e73aab3ad2af32af118846
 SHA512:
-  metadata.gz: 5e8c30dc48a779c151cecfc63d5d4a52f9817789daac3297bfe22c67371a5e510547566acc396c590f1922e2cfbf0867b5ab91b74a383a994d4160a6930601ae
-  data.tar.gz: f967c1a7286796d54dbb2c69f15ce1889b5aeab97ebbae4faba828510126b656a052492d65e90bc0fd63763e113465974b8e5d912dd67f2f827f70db7b690438
+  metadata.gz: b6a4f7937fe8895ca01284ca5807be215fa81147ea77e22c702e32b5303d1eb437d17f8156fd6aadd88e7d8af1a5c204f2c486f2c83d11bd922e7c03f2c63662
+  data.tar.gz: 66ec1893d9a4b30683f9fa03eed0db42d4615df816208d53baf9bad8ce8d69448bbab4e4407686c7d297650a75f99a42e42a83168c669ae5a0c2e55444c228ce

data/lib/aws-sdk-cloudtrail.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-cloudtrail/customizations'
 # @service
 module Aws::CloudTrail
 
-  GEM_VERSION = '1.18.0'
+  GEM_VERSION = '1.19.0'
 
 end

data/lib/aws-sdk-cloudtrail/client.rb

@@ -264,12 +264,14 @@ module Aws::CloudTrail
 
     # @!group API Operations
 
-    # Adds one or more tags to a trail, up to a limit of 50. Tags must be
-    # unique per trail. Overwrites an existing tag's value when a new value
-    # is specified for an existing tag key. If you specify a key without a
-    # value, the tag will be created with the specified key and a value of
-    # null. You can tag a trail that applies to all regions only from the
-    # region in which the trail was created (that is, from its home region).
+    # Adds one or more tags to a trail, up to a limit of 50. Overwrites an
+    # existing tag's value when a new value is specified for an existing
+    # tag key. Tag key names must be unique for a trail; you cannot have two
+    # keys with the same name but different values. If you specify a key
+    # without a value, the tag will be created with the specified key and a
+    # value of null. You can tag a trail that applies to all AWS Regions
+    # only from the Region in which the trail was created (also known as its
+    # home region).
     #
     # @option params [required, String] :resource_id
     #   Specifies the ARN of the trail to which one or more tags will be
@@ -304,8 +306,7 @@ module Aws::CloudTrail
     end
 
     # Creates a trail that specifies the settings for delivery of log data
-    # to an Amazon S3 bucket. A maximum of five trails can exist in a
-    # region, irrespective of the region in which they were created.
+    # to an Amazon S3 bucket.
     #
     # @option params [required, String] :name
     #   Specifies the name of the trail. The name must meet the following
@@ -329,7 +330,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
     #
     # @option params [String] :s3_key_prefix
     #   Specifies the Amazon S3 key prefix that comes after the name of the
@@ -339,7 +340,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
     #
     # @option params [String] :sns_topic_name
     #   Specifies the name of the Amazon SNS topic defined for notification of
@@ -351,7 +352,9 @@ module Aws::CloudTrail
     #
     # @option params [Boolean] :is_multi_region_trail
     #   Specifies whether the trail is created in the current region or in all
-    #   regions. The default is false.
+    #   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.
     #
     # @option params [Boolean] :enable_log_file_validation
     #   Specifies whether log file integrity validation is enabled. The
@@ -402,6 +405,9 @@ module Aws::CloudTrail
     #   made on behalf of an AWS account that is the master account for an
     #   organization in AWS Organizations.
     #
+    # @option params [Array<Types::Tag>] :tags_list
+    #   A list of tags.
+    #
     # @return [Types::CreateTrailResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTrailResponse#name #name} => String
@@ -432,6 +438,12 @@ module Aws::CloudTrail
     #     cloud_watch_logs_role_arn: "String",
     #     kms_key_id: "String",
     #     is_organization_trail: false,
+    #     tags_list: [
+    #       {
+    #         key: "String", # required
+    #         value: "String",
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -486,8 +498,8 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # Retrieves settings for the trail associated with the current region
-    # for your account.
+    # Retrieves settings for one or more trails associated with the current
+    # region for your account.
     #
     # @option params [Array<String>] :trail_name_list
     #   Specifies a list of trail names, trail ARNs, or both, of the trails to
@@ -577,7 +589,7 @@ module Aws::CloudTrail
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html
+    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html
     #
     # @option params [required, String] :trail_name
     #   Specifies the name of the trail or trail ARN. If you specify a trail
@@ -630,6 +642,49 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
+    # Returns settings information for a specified trail.
+    #
+    # @option params [required, String] :name
+    #   The name or the Amazon Resource Name (ARN) of the trail for which you
+    #   want to retrieve settings information.
+    #
+    # @return [Types::GetTrailResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetTrailResponse#trail #trail} => Types::Trail
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_trail({
+    #     name: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.trail.name #=> String
+    #   resp.trail.s3_bucket_name #=> String
+    #   resp.trail.s3_key_prefix #=> String
+    #   resp.trail.sns_topic_name #=> String
+    #   resp.trail.sns_topic_arn #=> String
+    #   resp.trail.include_global_service_events #=> Boolean
+    #   resp.trail.is_multi_region_trail #=> Boolean
+    #   resp.trail.home_region #=> String
+    #   resp.trail.trail_arn #=> String
+    #   resp.trail.log_file_validation_enabled #=> Boolean
+    #   resp.trail.cloud_watch_logs_log_group_arn #=> String
+    #   resp.trail.cloud_watch_logs_role_arn #=> String
+    #   resp.trail.kms_key_id #=> String
+    #   resp.trail.has_custom_event_selectors #=> Boolean
+    #   resp.trail.is_organization_trail #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetTrail AWS API Documentation
+    #
+    # @overload get_trail(params = {})
+    # @param [Hash] params ({})
+    def get_trail(params = {}, options = {})
+      req = build_request(:get_trail, params)
+      req.send_request(options)
+    end
+
     # Returns a JSON-formatted list of information about the specified
     # trail. Fields include information on delivery errors, Amazon SNS and
     # Amazon S3 errors, and start and stop logging times for each trail.
@@ -797,8 +852,40 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # Looks up [management events][1] captured by CloudTrail. Events for a
-    # region can be looked up in that region during the last 90 days. Lookup
+    # Lists trails that are in the current account.
+    #
+    # @option params [String] :next_token
+    #
+    # @return [Types::ListTrailsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTrailsResponse#trails #trails} => Array&lt;Types::TrailInfo&gt;
+    #   * {Types::ListTrailsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_trails({
+    #     next_token: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.trails #=> Array
+    #   resp.trails[0].trail_arn #=> String
+    #   resp.trails[0].name #=> String
+    #   resp.trails[0].home_region #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListTrails AWS API Documentation
+    #
+    # @overload list_trails(params = {})
+    # @param [Hash] params ({})
+    def list_trails(params = {}, options = {})
+      req = build_request(:list_trails, params)
+      req.send_request(options)
+    end
+
+    # Looks up [management events][1] captured by CloudTrail. You can look
+    # up events that occurred in a region within the last 90 days. Lookup
     # supports the following attributes:
     #
     # * AWS access key
@@ -824,7 +911,7 @@ module Aws::CloudTrail
     # The rate of lookup requests is limited to one per second per account.
     # If this limit is exceeded, a throttling error occurs.
     #
-    # Events that occurred during the selected time range will not be
+    #  Events that occurred during the selected time range will not be
     # available for lookup if CloudTrail logging was not enabled when the
     # events occurred.
     #
@@ -940,7 +1027,7 @@ module Aws::CloudTrail
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html
+    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html
     # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html
     #
     # @option params [required, String] :trail_name
@@ -1140,7 +1227,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
     #
     # @option params [String] :s3_key_prefix
     #   Specifies the Amazon S3 key prefix that comes after the name of the
@@ -1150,7 +1237,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
     #
     # @option params [String] :sns_topic_name
     #   Specifies the name of the Amazon SNS topic defined for notification of
@@ -1167,7 +1254,8 @@ module Aws::CloudTrail
     #   (replications of the trail) will be created in the other regions. If
     #   the trail exists in all regions and this value is set to false, the
     #   trail will remain in the region where it was created, and its shadow
-    #   trails in other regions will be deleted.
+    #   trails in other regions will be deleted. As a best practice, consider
+    #   using trails that log events in all regions.
     #
     # @option params [Boolean] :enable_log_file_validation
     #   Specifies whether log file validation is enabled. The default is
@@ -1293,7 +1381,7 @@ module Aws::CloudTrail
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudtrail'
-      context[:gem_version] = '1.18.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudtrail/client_api.rb

@@ -34,6 +34,8 @@ module Aws::CloudTrail
     EventsList = Shapes::ListShape.new(name: 'EventsList')
     GetEventSelectorsRequest = Shapes::StructureShape.new(name: 'GetEventSelectorsRequest')
     GetEventSelectorsResponse = Shapes::StructureShape.new(name: 'GetEventSelectorsResponse')
+    GetTrailRequest = Shapes::StructureShape.new(name: 'GetTrailRequest')
+    GetTrailResponse = Shapes::StructureShape.new(name: 'GetTrailResponse')
     GetTrailStatusRequest = Shapes::StructureShape.new(name: 'GetTrailStatusRequest')
     GetTrailStatusResponse = Shapes::StructureShape.new(name: 'GetTrailStatusResponse')
     InsufficientDependencyServiceAccessPermissionException = Shapes::StructureShape.new(name: 'InsufficientDependencyServiceAccessPermissionException')
@@ -63,6 +65,8 @@ module Aws::CloudTrail
     ListPublicKeysResponse = Shapes::StructureShape.new(name: 'ListPublicKeysResponse')
     ListTagsRequest = Shapes::StructureShape.new(name: 'ListTagsRequest')
     ListTagsResponse = Shapes::StructureShape.new(name: 'ListTagsResponse')
+    ListTrailsRequest = Shapes::StructureShape.new(name: 'ListTrailsRequest')
+    ListTrailsResponse = Shapes::StructureShape.new(name: 'ListTrailsResponse')
     LookupAttribute = Shapes::StructureShape.new(name: 'LookupAttribute')
     LookupAttributeKey = Shapes::StringShape.new(name: 'LookupAttributeKey')
     LookupAttributesList = Shapes::ListShape.new(name: 'LookupAttributesList')
@@ -100,10 +104,12 @@ module Aws::CloudTrail
     TagsList = Shapes::ListShape.new(name: 'TagsList')
     Trail = Shapes::StructureShape.new(name: 'Trail')
     TrailAlreadyExistsException = Shapes::StructureShape.new(name: 'TrailAlreadyExistsException')
+    TrailInfo = Shapes::StructureShape.new(name: 'TrailInfo')
     TrailList = Shapes::ListShape.new(name: 'TrailList')
     TrailNameList = Shapes::ListShape.new(name: 'TrailNameList')
     TrailNotFoundException = Shapes::StructureShape.new(name: 'TrailNotFoundException')
     TrailNotProvidedException = Shapes::StructureShape.new(name: 'TrailNotProvidedException')
+    Trails = Shapes::ListShape.new(name: 'Trails')
     UnsupportedOperationException = Shapes::StructureShape.new(name: 'UnsupportedOperationException')
     UpdateTrailRequest = Shapes::StructureShape.new(name: 'UpdateTrailRequest')
     UpdateTrailResponse = Shapes::StructureShape.new(name: 'UpdateTrailResponse')
@@ -125,6 +131,7 @@ module Aws::CloudTrail
     CreateTrailRequest.add_member(:cloud_watch_logs_role_arn, Shapes::ShapeRef.new(shape: String, location_name: "CloudWatchLogsRoleArn"))
     CreateTrailRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
     CreateTrailRequest.add_member(:is_organization_trail, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsOrganizationTrail"))
+    CreateTrailRequest.add_member(:tags_list, Shapes::ShapeRef.new(shape: TagsList, location_name: "TagsList"))
     CreateTrailRequest.struct_class = Types::CreateTrailRequest
 
     CreateTrailResponse.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
@@ -189,6 +196,12 @@ module Aws::CloudTrail
     GetEventSelectorsResponse.add_member(:event_selectors, Shapes::ShapeRef.new(shape: EventSelectors, location_name: "EventSelectors"))
     GetEventSelectorsResponse.struct_class = Types::GetEventSelectorsResponse
 
+    GetTrailRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
+    GetTrailRequest.struct_class = Types::GetTrailRequest
+
+    GetTrailResponse.add_member(:trail, Shapes::ShapeRef.new(shape: Trail, location_name: "Trail"))
+    GetTrailResponse.struct_class = Types::GetTrailResponse
+
     GetTrailStatusRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
     GetTrailStatusRequest.struct_class = Types::GetTrailStatusRequest
 
@@ -228,6 +241,13 @@ module Aws::CloudTrail
     ListTagsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     ListTagsResponse.struct_class = Types::ListTagsResponse
 
+    ListTrailsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    ListTrailsRequest.struct_class = Types::ListTrailsRequest
+
+    ListTrailsResponse.add_member(:trails, Shapes::ShapeRef.new(shape: Trails, location_name: "Trails"))
+    ListTrailsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    ListTrailsResponse.struct_class = Types::ListTrailsResponse
+
     LookupAttribute.add_member(:attribute_key, Shapes::ShapeRef.new(shape: LookupAttributeKey, required: true, location_name: "AttributeKey"))
     LookupAttribute.add_member(:attribute_value, Shapes::ShapeRef.new(shape: String, required: true, location_name: "AttributeValue"))
     LookupAttribute.struct_class = Types::LookupAttribute
@@ -314,10 +334,17 @@ module Aws::CloudTrail
     Trail.add_member(:is_organization_trail, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsOrganizationTrail"))
     Trail.struct_class = Types::Trail
 
+    TrailInfo.add_member(:trail_arn, Shapes::ShapeRef.new(shape: String, location_name: "TrailARN"))
+    TrailInfo.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
+    TrailInfo.add_member(:home_region, Shapes::ShapeRef.new(shape: String, location_name: "HomeRegion"))
+    TrailInfo.struct_class = Types::TrailInfo
+
     TrailList.member = Shapes::ShapeRef.new(shape: Trail)
 
     TrailNameList.member = Shapes::ShapeRef.new(shape: String)
 
+    Trails.member = Shapes::ShapeRef.new(shape: TrailInfo)
+
     UpdateTrailRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
     UpdateTrailRequest.add_member(:s3_bucket_name, Shapes::ShapeRef.new(shape: String, location_name: "S3BucketName"))
     UpdateTrailRequest.add_member(:s3_key_prefix, Shapes::ShapeRef.new(shape: String, location_name: "S3KeyPrefix"))
@@ -407,6 +434,7 @@ module Aws::CloudTrail
         o.errors << Shapes::ShapeRef.new(shape: InvalidCloudWatchLogsLogGroupArnException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidCloudWatchLogsRoleArnException)
         o.errors << Shapes::ShapeRef.new(shape: CloudWatchLogsDeliveryUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidTagParameterException)
         o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
         o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
         o.errors << Shapes::ShapeRef.new(shape: CloudTrailAccessNotEnabledException)
@@ -453,6 +481,18 @@ module Aws::CloudTrail
         o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
       end)
 
+      api.add_operation(:get_trail, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetTrail"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetTrailRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetTrailResponse)
+        o.errors << Shapes::ShapeRef.new(shape: TrailNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidTrailNameException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
+      end)
+
       api.add_operation(:get_trail_status, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetTrailStatus"
         o.http_method = "POST"
@@ -473,6 +513,11 @@ module Aws::CloudTrail
         o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
         o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidTokenException)
+        o[:pager] = Aws::Pager.new(
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:list_tags, Seahorse::Model::Operation.new.tap do |o|
@@ -488,6 +533,26 @@ module Aws::CloudTrail
         o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
         o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidTokenException)
+        o[:pager] = Aws::Pager.new(
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
+      api.add_operation(:list_trails, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListTrails"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListTrailsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListTrailsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
+        o[:pager] = Aws::Pager.new(
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:lookup_events, Seahorse::Model::Operation.new.tap do |o|

data/lib/aws-sdk-cloudtrail/types.rb

@@ -66,6 +66,12 @@ module Aws::CloudTrail
     #         cloud_watch_logs_role_arn: "String",
     #         kms_key_id: "String",
     #         is_organization_trail: false,
+    #         tags_list: [
+    #           {
+    #             key: "String", # required
+    #             value: "String",
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] name
@@ -91,7 +97,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
     #   @return [String]
     #
     # @!attribute [rw] s3_key_prefix
@@ -102,7 +108,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_name
@@ -117,7 +123,9 @@ module Aws::CloudTrail
     #
     # @!attribute [rw] is_multi_region_trail
     #   Specifies whether the trail is created in the current region or in
-    #   all regions. The default is false.
+    #   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.
     #   @return [Boolean]
     #
     # @!attribute [rw] enable_log_file_validation
@@ -174,6 +182,10 @@ module Aws::CloudTrail
     #   organization in AWS Organizations.
     #   @return [Boolean]
     #
+    # @!attribute [rw] tags_list
+    #   A list of tags.
+    #   @return [Array<Types::Tag>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateTrailRequest AWS API Documentation
     #
     class CreateTrailRequest < Struct.new(
@@ -187,7 +199,8 @@ module Aws::CloudTrail
       :cloud_watch_logs_log_group_arn,
       :cloud_watch_logs_role_arn,
       :kms_key_id,
-      :is_organization_trail)
+      :is_organization_trail,
+      :tags_list)
       include Aws::Structure
     end
 
@@ -210,11 +223,11 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_name
-    #   This field is deprecated. Use SnsTopicARN.
+    #   This field is no longer in use. Use SnsTopicARN.
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_arn
@@ -300,7 +313,7 @@ module Aws::CloudTrail
     #
     # The following example demonstrates how logging works when you
     # configure logging of all data events for an S3 bucket named
-    # `bucket-1`. In this example, the CloudTrail user spcified an empty
+    # `bucket-1`. In this example, the CloudTrail user specified an empty
     # prefix, and the option to log both `Read` and `Write` data events.
     #
     # 1.  A user uploads an image file to `bucket-1`.
@@ -364,11 +377,6 @@ module Aws::CloudTrail
     #
     #      </note>
     #
-    #   * To log data events for all objects in all S3 buckets that include
-    #     *my-bucket* in their names, specify the prefix as
-    #     `aws:s3:::my-bucket`. The trail logs data events for all objects
-    #     in all buckets whose name contains a match for *my-bucket*.
-    #
     #   * To log data events for all objects in an S3 bucket, specify the
     #     bucket and an empty object prefix such as
     #     `arn:aws:s3:::bucket-1/`. The trail logs data events for all
@@ -388,11 +396,11 @@ module Aws::CloudTrail
     #
     #      </note>
     #
-    #   * To log data eents for a specific Lambda function, specify the
+    #   * To log data events for a specific Lambda function, specify the
     #     function ARN.
     #
-    #     <note markdown="1"> Lambda function ARNs are exact. Unlike S3, you cannot use
-    #     matching. For example, if you specify a function ARN
+    #     <note markdown="1"> Lambda function ARNs are exact. For example, if you specify a
+    #     function ARN
     #     *arn:aws:lambda:us-west-2:111111111111:function:helloworld*, data
     #     events will only be logged for
     #     *arn:aws:lambda:us-west-2:111111111111:function:helloworld*. They
@@ -608,7 +616,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-management-events
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-management-events
     #   @return [Boolean]
     #
     # @!attribute [rw] data_resources
@@ -624,7 +632,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-data-events
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-data-events
     #   [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html
     #   @return [Array<Types::DataResource>]
     #
@@ -688,6 +696,36 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetTrailRequest
+    #   data as a hash:
+    #
+    #       {
+    #         name: "String", # required
+    #       }
+    #
+    # @!attribute [rw] name
+    #   The name or the Amazon Resource Name (ARN) of the trail for which
+    #   you want to retrieve settings information.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetTrailRequest AWS API Documentation
+    #
+    class GetTrailRequest < Struct.new(
+      :name)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] trail
+    #   The settings for a trail.
+    #   @return [Types::Trail]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetTrailResponse AWS API Documentation
+    #
+    class GetTrailResponse < Struct.new(
+      :trail)
+      include Aws::Structure
+    end
+
     # The name of a trail about which you want the current status.
     #
     # @note When making an API call, you may pass GetTrailStatusRequest
@@ -736,7 +774,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
     #   @return [String]
     #
     # @!attribute [rw] latest_notification_error
@@ -746,7 +784,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/sns/latest/dg/welcome.html
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/welcome.html
     #   @return [String]
     #
     # @!attribute [rw] latest_delivery_time
@@ -801,31 +839,31 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
     #   @return [String]
     #
     # @!attribute [rw] latest_delivery_attempt_time
-    #   This field is deprecated.
+    #   This field is no longer in use.
     #   @return [String]
     #
     # @!attribute [rw] latest_notification_attempt_time
-    #   This field is deprecated.
+    #   This field is no longer in use.
     #   @return [String]
     #
     # @!attribute [rw] latest_notification_attempt_succeeded
-    #   This field is deprecated.
+    #   This field is no longer in use.
     #   @return [String]
     #
     # @!attribute [rw] latest_delivery_attempt_succeeded
-    #   This field is deprecated.
+    #   This field is no longer in use.
     #   @return [String]
     #
     # @!attribute [rw] time_logging_started
-    #   This field is deprecated.
+    #   This field is no longer in use.
     #   @return [String]
     #
     # @!attribute [rw] time_logging_stopped
-    #   This field is deprecated.
+    #   This field is no longer in use.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetTrailStatusResponse AWS API Documentation
@@ -958,6 +996,39 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListTrailsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         next_token: "String",
+    #       }
+    #
+    # @!attribute [rw] next_token
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListTrailsRequest AWS API Documentation
+    #
+    class ListTrailsRequest < Struct.new(
+      :next_token)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] trails
+    #   Returns the name, ARN, and home region of trails in the current
+    #   account.
+    #   @return [Array<Types::TrailInfo>]
+    #
+    # @!attribute [rw] next_token
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListTrailsResponse AWS API Documentation
+    #
+    class ListTrailsResponse < Struct.new(
+      :trails,
+      :next_token)
+      include Aws::Structure
+    end
+
     # Specifies an attribute and value that filter the events returned.
     #
     # @note When making an API call, you may pass LookupAttribute
@@ -1216,13 +1287,13 @@ module Aws::CloudTrail
     #   The type of a resource referenced by the event returned. When the
     #   resource type cannot be determined, null is returned. Some examples
     #   of resource types are: **Instance** for EC2, **Trail** for
-    #   CloudTrail, **DBInstance** for RDS, and **AccessKey** for IAM. For a
-    #   list of resource types supported for event lookup, see [Resource
-    #   Types Supported for Event Lookup][1].
+    #   CloudTrail, **DBInstance** for RDS, and **AccessKey** for IAM. To
+    #   learn more about how to look up and filter events by the resource
+    #   types supported for a service, see [Filtering CloudTrail Events][1].
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/lookup_supported_resourcetypes.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events-console.html#filtering-cloudtrail-events
     #   @return [String]
     #
     # @!attribute [rw] resource_name
@@ -1364,7 +1435,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
     #   @return [String]
     #
     # @!attribute [rw] s3_key_prefix
@@ -1375,11 +1446,11 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_name
-    #   This field is deprecated. Use SnsTopicARN.
+    #   This field is no longer in use. Use SnsTopicARN.
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_arn
@@ -1396,7 +1467,7 @@ module Aws::CloudTrail
     #   @return [Boolean]
     #
     # @!attribute [rw] is_multi_region_trail
-    #   Specifies whether the trail belongs only to one region or exists in
+    #   Specifies whether the trail exists only in one region or exists in
     #   all regions.
     #   @return [Boolean]
     #
@@ -1461,6 +1532,30 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
+    # Information about a CloudTrail trail, including the trail's name,
+    # home region, and Amazon Resource Name (ARN).
+    #
+    # @!attribute [rw] trail_arn
+    #   The ARN of a trail.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of a trail.
+    #   @return [String]
+    #
+    # @!attribute [rw] home_region
+    #   The AWS region in which a trail was created.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/TrailInfo AWS API Documentation
+    #
+    class TrailInfo < Struct.new(
+      :trail_arn,
+      :name,
+      :home_region)
+      include Aws::Structure
+    end
+
     # Specifies settings to update for the trail.
     #
     # @note When making an API call, you may pass UpdateTrailRequest
@@ -1507,7 +1602,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/create_trail_naming_policy.html
     #   @return [String]
     #
     # @!attribute [rw] s3_key_prefix
@@ -1518,7 +1613,7 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_name
@@ -1538,7 +1633,8 @@ module Aws::CloudTrail
     #   (replications of the trail) will be created in the other regions. If
     #   the trail exists in all regions and this value is set to false, the
     #   trail will remain in the region where it was created, and its shadow
-    #   trails in other regions will be deleted.
+    #   trails in other regions will be deleted. As a best practice,
+    #   consider using trails that log events in all regions.
     #   @return [Boolean]
     #
     # @!attribute [rw] enable_log_file_validation
@@ -1636,11 +1732,11 @@ module Aws::CloudTrail
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-find-log-files.html
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_name
-    #   This field is deprecated. Use SnsTopicARN.
+    #   This field is no longer in use. Use SnsTopicARN.
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_arn

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudtrail
 version: !ruby/object:Gem::Version
-  version: 1.18.0
+  version: 1.19.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-23 00:00:00.000000000 Z
+date: 2019-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core