aws-sdk-cloudtrail 1.51.0 → 1.52.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d913bff17768e79888c389935ccc3082f330e732957750fbc50e886567982c6
-  data.tar.gz: 691cb628f9e15c1f9b31663796bef4c358ea9590f36cff7e4dcb082c4c6b3c29
+  metadata.gz: 9fd98c848dea62b03bdbe8b53bd0697af08f98035546f4f0fd11bcac9b0916cc
+  data.tar.gz: 67792ad77475cb8ee735d3f66a6acc0c9fc7be108c65f7f6dd31c5487c33a2bf
 SHA512:
-  metadata.gz: f8bceeac781dab3962b59a9b193385094d3bab825a9f9ae2ce7ef015417ac3d4ea3774d9792b730c5b2726193d6c504d9b9c34182c955c77bdb6562f5e2d886b
-  data.tar.gz: 16c2d8a4a3a07c860911b7ac83ff706bd42f696ae9641a2328ef7e215dc721a8eaf98d15a718731924a8f97f45f311140675da8c6ac562c094e494e8c44aa3d5
+  metadata.gz: 3c8e1be6d40035da296cda86d2ef3f730721adf4c7b36c14b4c427f484183aaff97690116f9763293450b269f76edee57ce1ef6b469449044e4b5f736ce22329
+  data.tar.gz: 4660fc6a4bc8580998fc3fe02ea802a6d852d2957e5d70f0758cf4b3011d6122ebce0b2b5146dc5d6b81a48eff645d7d29be2af8246f2209fcb3033d463ddc3f

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.52.0 (2022-10-19)
+------------------
+
+* Feature - This release includes support for exporting CloudTrail Lake query results to an Amazon S3 bucket.
+
 1.51.0 (2022-09-19)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.51.0
+1.52.0

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

@@ -644,7 +644,7 @@ module Aws::CloudTrail
     #
     # @option params [String] :kms_key_id
     #   Specifies the KMS key ID to use to encrypt the logs delivered by
-    #   CloudTrail. The value can be an alias name prefixed by "alias/", a
+    #   CloudTrail. The value can be an alias name prefixed by `alias/`, a
     #   fully specified ARN to an alias, a fully specified ARN to a key, or a
     #   globally unique identifier.
     #
@@ -654,13 +654,13 @@ module Aws::CloudTrail
     #
     #   Examples:
     #
-    #   * alias/MyAliasName
+    #   * `alias/MyAliasName`
     #
-    #   * arn:aws:kms:us-east-2:123456789012:alias/MyAliasName
+    #   * `arn:aws:kms:us-east-2:123456789012:alias/MyAliasName`
     #
-    #   * arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012
+    #   * `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
     #
-    #   * 12345678-1234-1234-1234-123456789012
+    #   * `12345678-1234-1234-1234-123456789012`
     #
     #
     #
@@ -820,6 +820,8 @@ module Aws::CloudTrail
     #   * {Types::DescribeQueryResponse#query_status #query_status} => String
     #   * {Types::DescribeQueryResponse#query_statistics #query_statistics} => Types::QueryStatisticsForDescribeQuery
     #   * {Types::DescribeQueryResponse#error_message #error_message} => String
+    #   * {Types::DescribeQueryResponse#delivery_s3_uri #delivery_s3_uri} => String
+    #   * {Types::DescribeQueryResponse#delivery_status #delivery_status} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -839,6 +841,8 @@ module Aws::CloudTrail
     #   resp.query_statistics.execution_time_in_millis #=> Integer
     #   resp.query_statistics.creation_time #=> Time
     #   resp.error_message #=> String
+    #   resp.delivery_s3_uri #=> String
+    #   resp.delivery_status #=> String, one of "SUCCESS", "FAILED", "FAILED_SIGNING_FILE", "PENDING", "RESOURCE_NOT_FOUND", "ACCESS_DENIED", "ACCESS_DENIED_SIGNING_FILE", "CANCELLED", "UNKNOWN"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DescribeQuery AWS API Documentation
     #
@@ -923,13 +927,18 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # Returns the specified CloudTrail service-linked channel. Amazon Web
-    # Services services create service-linked channels to view CloudTrail
-    # events.
+    # Returns information about a specific channel. Amazon Web Services
+    # services create service-linked channels to get information about
+    # CloudTrail events on your behalf. For more information about
+    # service-linked channels, see [Viewing service-linked channels for
+    # CloudTrail by using the CLI.][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/viewing-service-linked-channels.html
     #
     # @option params [required, String] :channel
-    #   The Amazon Resource Name (ARN) of the CloudTrail service-linked
-    #   channel.
+    #   The ARN or `UUID` of a channel.
     #
     # @return [Types::GetChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1138,7 +1147,7 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # Returns information for the specified import.
+    # Returns information about a specific import.
     #
     # @option params [required, String] :import_id
     #   The ID for the import.
@@ -1421,13 +1430,25 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # Returns all CloudTrail channels.
+    # Lists the channels in the current account, and their source names.
+    # Amazon Web Services services create service-linked channels get
+    # information about CloudTrail events on your behalf. For more
+    # information about service-linked channels, see [Viewing service-linked
+    # channels for CloudTrail by using the CLI][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/viewing-service-linked-channels.html
     #
     # @option params [Integer] :max_results
     #   The maximum number of CloudTrail channels to display on a single page.
     #
     # @option params [String] :next_token
-    #   A token you can use to get the next page of results.
+    #   The token to use to get the next page of results after a previous API
+    #   call. This token must be passed in with the same parameters that were
+    #   specified in the original call. For example, if the original call
+    #   specified an AttributeKey of 'Username' with a value of 'root',
+    #   the call with NextToken should include those same parameters.
     #
     # @return [Types::ListChannelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1573,7 +1594,7 @@ module Aws::CloudTrail
     #   The maximum number of imports to display on a single page.
     #
     # @option params [String] :destination
-    #   The destination event data store.
+    #   The ARN of the destination event data store.
     #
     # @option params [String] :import_status
     #   The status of the import.
@@ -2264,22 +2285,30 @@ module Aws::CloudTrail
     end
 
     # Starts an import of logged trail events from a source S3 bucket to a
-    # destination event data store.
+    # destination event data store. By default, CloudTrail only imports
+    # events contained in the S3 bucket's `CloudTrail` prefix and the
+    # prefixes inside the `CloudTrail` prefix, and does not check prefixes
+    # for other Amazon Web Services services. If you want to import
+    # CloudTrail events contained in another prefix, you must include the
+    # prefix in the `S3LocationUri`. For more considerations about importing
+    # trail events, see [Considerations][1].
     #
     # When you start a new import, the `Destinations` and `ImportSource`
     # parameters are required. Before starting a new import, disable any
     # access control lists (ACLs) attached to the source S3 bucket. For more
     # information about disabling ACLs, see [Controlling ownership of
-    # objects and disabling ACLs for your bucket][1].
+    # objects and disabling ACLs for your bucket][2].
     #
     # When you retry an import, the `ImportID` parameter is required.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
+    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-copy-trail-to-lake.html#cloudtrail-trail-copy-considerations
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
     #
     # @option params [Array<String>] :destinations
-    #   The destination event data store. Use this parameter for a new import.
+    #   The ARN of the destination event data store. Use this parameter for a
+    #   new import.
     #
     # @option params [Types::ImportSource] :import_source
     #   The source S3 bucket for the import. Use this parameter for a new
@@ -2288,12 +2317,18 @@ module Aws::CloudTrail
     # @option params [Time,DateTime,Date,Integer,String] :start_event_time
     #   Use with `EndEventTime` to bound a `StartImport` request, and limit
     #   imported trail events to only those events logged within a specified
-    #   time period.
+    #   time period. When you specify a time range, CloudTrail checks the
+    #   prefix and log file names to verify the names contain a date between
+    #   the specified `StartEventTime` and `EndEventTime` before attempting to
+    #   import events.
     #
     # @option params [Time,DateTime,Date,Integer,String] :end_event_time
     #   Use with `StartEventTime` to bound a `StartImport` request, and limit
     #   imported trail events to only those events logged within a specified
-    #   time period.
+    #   time period. When you specify a time range, CloudTrail checks the
+    #   prefix and log file names to verify the names contain a date between
+    #   the specified `StartEventTime` and `EndEventTime` before attempting to
+    #   import events.
     #
     # @option params [String] :import_id
     #   The ID of the import. Use this parameter when you are retrying an
@@ -2382,10 +2417,15 @@ module Aws::CloudTrail
 
     # Starts a CloudTrail Lake query. The required `QueryStatement`
     # parameter provides your SQL query, enclosed in single quotation marks.
+    # Use the optional `DeliveryS3Uri` parameter to deliver the query
+    # results to an S3 bucket.
     #
     # @option params [required, String] :query_statement
     #   The SQL code of your query.
     #
+    # @option params [String] :delivery_s3_uri
+    #   The URI for the S3 bucket where CloudTrail delivers the query results.
+    #
     # @return [Types::StartQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartQueryResponse#query_id #query_id} => String
@@ -2394,6 +2434,7 @@ module Aws::CloudTrail
     #
     #   resp = client.start_query({
     #     query_statement: "QueryStatement", # required
+    #     delivery_s3_uri: "DeliveryS3Uri",
     #   })
     #
     # @example Response structure
@@ -2804,7 +2845,7 @@ module Aws::CloudTrail
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudtrail'
-      context[:gem_version] = '1.51.0'
+      context[:gem_version] = '1.52.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -47,6 +47,8 @@ module Aws::CloudTrail
     DeleteEventDataStoreResponse = Shapes::StructureShape.new(name: 'DeleteEventDataStoreResponse')
     DeleteTrailRequest = Shapes::StructureShape.new(name: 'DeleteTrailRequest')
     DeleteTrailResponse = Shapes::StructureShape.new(name: 'DeleteTrailResponse')
+    DeliveryS3Uri = Shapes::StringShape.new(name: 'DeliveryS3Uri')
+    DeliveryStatus = Shapes::StringShape.new(name: 'DeliveryStatus')
     DescribeQueryRequest = Shapes::StructureShape.new(name: 'DescribeQueryRequest')
     DescribeQueryResponse = Shapes::StructureShape.new(name: 'DescribeQueryResponse')
     DescribeTrailsRequest = Shapes::StructureShape.new(name: 'DescribeTrailsRequest')
@@ -377,6 +379,8 @@ module Aws::CloudTrail
     DescribeQueryResponse.add_member(:query_status, Shapes::ShapeRef.new(shape: QueryStatus, location_name: "QueryStatus"))
     DescribeQueryResponse.add_member(:query_statistics, Shapes::ShapeRef.new(shape: QueryStatisticsForDescribeQuery, location_name: "QueryStatistics"))
     DescribeQueryResponse.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "ErrorMessage"))
+    DescribeQueryResponse.add_member(:delivery_s3_uri, Shapes::ShapeRef.new(shape: DeliveryS3Uri, location_name: "DeliveryS3Uri"))
+    DescribeQueryResponse.add_member(:delivery_status, Shapes::ShapeRef.new(shape: DeliveryStatus, location_name: "DeliveryStatus"))
     DescribeQueryResponse.struct_class = Types::DescribeQueryResponse
 
     DescribeTrailsRequest.add_member(:trail_name_list, Shapes::ShapeRef.new(shape: TrailNameList, location_name: "trailNameList"))
@@ -873,6 +877,7 @@ module Aws::CloudTrail
     StartLoggingResponse.struct_class = Types::StartLoggingResponse
 
     StartQueryRequest.add_member(:query_statement, Shapes::ShapeRef.new(shape: QueryStatement, required: true, location_name: "QueryStatement"))
+    StartQueryRequest.add_member(:delivery_s3_uri, Shapes::ShapeRef.new(shape: DeliveryS3Uri, location_name: "DeliveryS3Uri"))
     StartQueryRequest.struct_class = Types::StartQueryRequest
 
     StartQueryResponse.add_member(:query_id, Shapes::ShapeRef.new(shape: UUID, location_name: "QueryId"))
@@ -1562,6 +1567,10 @@ module Aws::CloudTrail
         o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidQueryStatementException)
         o.errors << Shapes::ShapeRef.new(shape: MaxConcurrentQueriesException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidS3PrefixException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidS3BucketNameException)
+        o.errors << Shapes::ShapeRef.new(shape: InsufficientS3BucketPolicyException)
+        o.errors << Shapes::ShapeRef.new(shape: S3BucketDoesNotExistException)
         o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
         o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
       end)

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

@@ -373,7 +373,7 @@ module Aws::CloudTrail
     # Contains information about a returned CloudTrail channel.
     #
     # @!attribute [rw] channel_arn
-    #   The Amazon Resource Name (ARN) of the channel.
+    #   The Amazon Resource Name (ARN) of a channel.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -393,8 +393,8 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
-    # The specified channel ARN is not valid or does not map to a channel in
-    # your account.
+    # This exception is thrown when the specified value of `ChannelARN` is
+    # not valid.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ChannelARNInvalidException AWS API Documentation
     #
@@ -720,7 +720,7 @@ module Aws::CloudTrail
     #
     # @!attribute [rw] kms_key_id
     #   Specifies the KMS key ID to use to encrypt the logs delivered by
-    #   CloudTrail. The value can be an alias name prefixed by "alias/", a
+    #   CloudTrail. The value can be an alias name prefixed by `alias/`, a
     #   fully specified ARN to an alias, a fully specified ARN to a key, or
     #   a globally unique identifier.
     #
@@ -730,13 +730,13 @@ module Aws::CloudTrail
     #
     #   Examples:
     #
-    #   * alias/MyAliasName
+    #   * `alias/MyAliasName`
     #
-    #   * arn:aws:kms:us-east-2:123456789012:alias/MyAliasName
+    #   * `arn:aws:kms:us-east-2:123456789012:alias/MyAliasName`
     #
-    #   * arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012
+    #   * `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
     #
-    #   * 12345678-1234-1234-1234-123456789012
+    #   * `12345678-1234-1234-1234-123456789012`
     #
     #
     #
@@ -839,7 +839,7 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] kms_key_id
-    #   Specifies the KMS key ID that encrypts the logs delivered by
+    #   Specifies the KMS key ID that encrypts the events delivered by
     #   CloudTrail. The value is a fully specified ARN to a KMS key in the
     #   following format.
     #
@@ -945,7 +945,7 @@ module Aws::CloudTrail
     #
     #   * `AWS::DynamoDB::Table`
     #
-    #   The following resource types are also availble through *advanced*
+    #   The following resource types are also available through *advanced*
     #   event selectors. Basic event selector resource types are valid in
     #   advanced event selectors, but advanced event selector resource types
     #   are not valid in basic event selectors. For more information, see
@@ -1129,6 +1129,15 @@ module Aws::CloudTrail
     #   The error message returned if a query failed.
     #   @return [String]
     #
+    # @!attribute [rw] delivery_s3_uri
+    #   The URI for the S3 bucket where CloudTrail delivered query results,
+    #   if applicable.
+    #   @return [String]
+    #
+    # @!attribute [rw] delivery_status
+    #   The delivery status.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DescribeQueryResponse AWS API Documentation
     #
     class DescribeQueryResponse < Struct.new(
@@ -1136,7 +1145,9 @@ module Aws::CloudTrail
       :query_string,
       :query_status,
       :query_statistics,
-      :error_message)
+      :error_message,
+      :delivery_s3_uri,
+      :delivery_status)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1218,13 +1229,13 @@ module Aws::CloudTrail
     # events.
     #
     # @!attribute [rw] type
-    #   The type of service. For service-linked channels, the value is
-    #   `AWS_SERVICE`.
+    #   The type of destination for events arriving from a channel. For
+    #   service-linked channels, the value is `AWS_SERVICE`.
     #   @return [String]
     #
     # @!attribute [rw] location
-    #   The location of the service. For service-linked channels, this is
-    #   the name of the Amazon Web Services service.
+    #   For service-linked channels, the value is the name of the Amazon Web
+    #   Services service.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/Destination AWS API Documentation
@@ -1515,8 +1526,7 @@ module Aws::CloudTrail
     #       }
     #
     # @!attribute [rw] channel
-    #   The Amazon Resource Name (ARN) of the CloudTrail service-linked
-    #   channel.
+    #   The ARN or `UUID` of a channel.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelRequest AWS API Documentation
@@ -1528,32 +1538,30 @@ module Aws::CloudTrail
     end
 
     # @!attribute [rw] channel_arn
-    #   The ARN of the CloudTrail service-linked channel.
+    #   The ARN of an channel returned by a `GetChannel` request.
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The name of the CloudTrail service-linked channel. For
-    #   service-linked channels, the value is
-    #   `aws-service-channel/service-name/custom-suffix` where
+    #   The name of the CloudTrail channel. For service-linked channels, the
+    #   value is `aws-service-channel/service-name/custom-suffix` where
     #   `service-name` represents the name of the Amazon Web Services
     #   service that created the channel and `custom-suffix` represents the
     #   suffix generated by the Amazon Web Services service.
     #   @return [String]
     #
     # @!attribute [rw] source
-    #   The trail or event data store for the CloudTrail service-linked
-    #   channel.
+    #   The event source for the CloudTrail channel.
     #   @return [String]
     #
     # @!attribute [rw] source_config
     #   Provides information about the advanced event selectors configured
-    #   for the service-linked channel, and whether the service-linked
-    #   channel applies to all regions or one region.
+    #   for the channel, and whether the channel applies to all regions or a
+    #   single region.
     #   @return [Types::SourceConfig]
     #
     # @!attribute [rw] destinations
-    #   The Amazon Web Services service that created the CloudTrail
-    #   service-linked channel.
+    #   The Amazon Web Services service that created the service-linked
+    #   channel.
     #   @return [Array<Types::Destination>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelResponse AWS API Documentation
@@ -1733,7 +1741,7 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] destinations
-    #   The destination event data store.
+    #   The ARN of the destination event data store.
     #   @return [Array<String>]
     #
     # @!attribute [rw] import_source
@@ -1765,7 +1773,11 @@ module Aws::CloudTrail
     #   @return [Time]
     #
     # @!attribute [rw] import_statistics
-    #   Provides statistics for the import.
+    #   Provides statistics for the import. CloudTrail does not update
+    #   import statistics in real-time. Returned values for parameters such
+    #   as `EventsCompleted` may be lower than the actual value, because
+    #   CloudTrail updates statistics incrementally over the course of the
+    #   import.
     #   @return [Types::ImportStatistics]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetImportResponse AWS API Documentation
@@ -2174,7 +2186,11 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
-    # Provides statistics for the specified `ImportID`.
+    # Provides statistics for the specified `ImportID`. CloudTrail does not
+    # update import statistics in real-time. Returned values for parameters
+    # such as `EventsCompleted` may be lower than the actual value, because
+    # CloudTrail updates statistics incrementally over the course of the
+    # import.
     #
     # @!attribute [rw] prefixes_found
     #   The number of S3 prefixes found for the import.
@@ -2185,11 +2201,11 @@ module Aws::CloudTrail
     #   @return [Integer]
     #
     # @!attribute [rw] files_completed
-    #   The number of files that completed import.
+    #   The number of log files that completed import.
     #   @return [Integer]
     #
     # @!attribute [rw] events_completed
-    #   The number of trail events imported.
+    #   The number of trail events imported into the event data store.
     #   @return [Integer]
     #
     # @!attribute [rw] failed_entries
@@ -2220,7 +2236,7 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] destinations
-    #   The destination event data store.
+    #   The ARN of the destination event data store.
     #   @return [Array<String>]
     #
     # @!attribute [rw] created_timestamp
@@ -2297,7 +2313,7 @@ module Aws::CloudTrail
     class InsufficientDependencyServiceAccessPermissionException < Aws::EmptyStructure; end
 
     # This exception is thrown when the policy on the S3 bucket or KMS key
-    # is not sufficient.
+    # does not have sufficient permissions for the operation.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InsufficientEncryptionPolicyException AWS API Documentation
     #
@@ -2350,8 +2366,8 @@ module Aws::CloudTrail
     #
     class InvalidEventCategoryException < Aws::EmptyStructure; end
 
-    # This exception is thrown when the event data store category is not
-    # valid for the import.
+    # This exception is thrown when event categories of specified event data
+    # stores are not valid.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InvalidEventDataStoreCategoryException AWS API Documentation
     #
@@ -2570,7 +2586,12 @@ module Aws::CloudTrail
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
-    #   A token you can use to get the next page of results.
+    #   The token to use to get the next page of results after a previous
+    #   API call. This token must be passed in with the same parameters that
+    #   were specified in the original call. For example, if the original
+    #   call specified an AttributeKey of 'Username' with a value of
+    #   'root', the call with NextToken should include those same
+    #   parameters.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsRequest AWS API Documentation
@@ -2583,11 +2604,12 @@ module Aws::CloudTrail
     end
 
     # @!attribute [rw] channels
-    #   The list of CloudTrail channels.
+    #   The list of channels in the account.
     #   @return [Array<Types::Channel>]
     #
     # @!attribute [rw] next_token
-    #   A token used to get the next page of results.
+    #   The token to use to get the next page of results after a previous
+    #   API call.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsResponse AWS API Documentation
@@ -2706,7 +2728,7 @@ module Aws::CloudTrail
     #   @return [Integer]
     #
     # @!attribute [rw] destination
-    #   The destination event data store.
+    #   The ARN of the destination event data store.
     #   @return [String]
     #
     # @!attribute [rw] import_status
@@ -3674,16 +3696,15 @@ module Aws::CloudTrail
       include Aws::Structure
     end
 
-    # Contains configuration information about the service-linked channel.
+    # Contains configuration information about the channel.
     #
     # @!attribute [rw] apply_to_all_regions
-    #   Specifies whether the service-linked channel applies to one region
-    #   or all regions.
+    #   Specifies whether the channel applies to a single region or to all
+    #   regions.
     #   @return [Boolean]
     #
     # @!attribute [rw] advanced_event_selectors
-    #   The advanced event selectors configured for the service-linked
-    #   channel.
+    #   The advanced event selectors that are configured for the channel.
     #   @return [Array<Types::AdvancedEventSelector>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/SourceConfig AWS API Documentation
@@ -3713,8 +3734,8 @@ module Aws::CloudTrail
     #       }
     #
     # @!attribute [rw] destinations
-    #   The destination event data store. Use this parameter for a new
-    #   import.
+    #   The ARN of the destination event data store. Use this parameter for
+    #   a new import.
     #   @return [Array<String>]
     #
     # @!attribute [rw] import_source
@@ -3725,13 +3746,19 @@ module Aws::CloudTrail
     # @!attribute [rw] start_event_time
     #   Use with `EndEventTime` to bound a `StartImport` request, and limit
     #   imported trail events to only those events logged within a specified
-    #   time period.
+    #   time period. When you specify a time range, CloudTrail checks the
+    #   prefix and log file names to verify the names contain a date between
+    #   the specified `StartEventTime` and `EndEventTime` before attempting
+    #   to import events.
     #   @return [Time]
     #
     # @!attribute [rw] end_event_time
     #   Use with `StartEventTime` to bound a `StartImport` request, and
     #   limit imported trail events to only those events logged within a
-    #   specified time period.
+    #   specified time period. When you specify a time range, CloudTrail
+    #   checks the prefix and log file names to verify the names contain a
+    #   date between the specified `StartEventTime` and `EndEventTime`
+    #   before attempting to import events.
     #   @return [Time]
     #
     # @!attribute [rw] import_id
@@ -3756,11 +3783,11 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] destinations
-    #   The destination event data store.
+    #   The ARN of the destination event data store.
     #   @return [Array<String>]
     #
     # @!attribute [rw] import_source
-    #   The source S3 bucket.
+    #   The source S3 bucket for the import.
     #   @return [Types::ImportSource]
     #
     # @!attribute [rw] start_event_time
@@ -3842,16 +3869,23 @@ module Aws::CloudTrail
     #
     #       {
     #         query_statement: "QueryStatement", # required
+    #         delivery_s3_uri: "DeliveryS3Uri",
     #       }
     #
     # @!attribute [rw] query_statement
     #   The SQL code of your query.
     #   @return [String]
     #
+    # @!attribute [rw] delivery_s3_uri
+    #   The URI for the S3 bucket where CloudTrail delivers the query
+    #   results.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartQueryRequest AWS API Documentation
     #
     class StartQueryRequest < Struct.new(
-      :query_statement)
+      :query_statement,
+      :delivery_s3_uri)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3892,11 +3926,11 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] import_source
-    #   The source S3 bucket.
+    #   The source S3 bucket for the import.
     #   @return [Types::ImportSource]
     #
     # @!attribute [rw] destinations
-    #   The destination event data store.
+    #   The ARN of the destination event data store.
     #   @return [Array<String>]
     #
     # @!attribute [rw] import_status

data/lib/aws-sdk-cloudtrail.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-cloudtrail/customizations'
 # @!group service
 module Aws::CloudTrail
 
-  GEM_VERSION = '1.51.0'
+  GEM_VERSION = '1.52.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudtrail
 version: !ruby/object:Gem::Version
-  version: 1.51.0
+  version: 1.52.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-09-19 00:00:00.000000000 Z
+date: 2022-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core