aws-sdk-cloudtrail 1.61.0 → 1.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 552835fa9020cb2d845ab5481ac3f5af7e7ca56e948f52fa8fa528197bdd97d4
-  data.tar.gz: 59b0f1f716909d88d66027ee4e7dc9327bf4734a5e767305b79a987a8ab574b6
+  metadata.gz: 6240f69b330164bda213408a5ce5ed3d7ba9582b60572b3afa82d109a498cdc6
+  data.tar.gz: 0fa14ff83c8ea9aa7c3951825cd20457eb66c566395582805bce412010fd1c2b
 SHA512:
-  metadata.gz: 3bcb544e6d7feb0e1bfd113c898ab21526fc81913ff25fc21e6d4f202446ff18f409d24b8af686712ae12ee57a64b5301560e062bc6ef3efe297e0bcb42e035e
-  data.tar.gz: 07c077d084804f3c62c7203e20c076982b72f188482ab68375c842aff70be01c220f6bfc31c41c7bdc0dd1d89df830e60308ca1eae131bc8954ebe4026262eff
+  metadata.gz: 14045e4930af4b1da780abf31e71d24de607291873435443ed3f4b1c433d34f9ec2745cfae562e5af354d73d579b1dbf05fedba3654274c090612aa423f9833b
+  data.tar.gz: 113a4d05421a25631fed6d0cfab5250a51c65f346796418dbd34ba1ec387fb3539ce973e909058a3a3653b4d802fa406ce57d5328e1cbc858d3dee5b4069a482

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.62.0 (2023-06-13)
+------------------
+
+* Feature - This feature allows users to view dashboards for CloudTrail Lake event data stores.
+
 1.61.0 (2023-06-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.61.0
+1.62.0

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

@@ -1039,16 +1039,23 @@ module Aws::CloudTrail
 
     # Returns metadata about a query, including query run time in
     # milliseconds, number of events scanned and matched, and query status.
-    # You must specify an ARN for `EventDataStore`, and a value for
-    # `QueryID`.
+    # If the query results were delivered to an S3 bucket, the response also
+    # provides the S3 URI and the delivery status.
+    #
+    # You must specify either a `QueryID` or a `QueryAlias`. Specifying the
+    # `QueryAlias` parameter returns information about the last query run
+    # for the alias.
     #
     # @option params [String] :event_data_store
     #   The ARN (or the ID suffix of the ARN) of an event data store on which
     #   the specified query was run.
     #
-    # @option params [required, String] :query_id
+    # @option params [String] :query_id
     #   The query ID.
     #
+    # @option params [String] :query_alias
+    #   The alias that identifies a query template.
+    #
     # @return [Types::DescribeQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeQueryResponse#query_id #query_id} => String
@@ -1063,7 +1070,8 @@ module Aws::CloudTrail
     #
     #   resp = client.describe_query({
     #     event_data_store: "EventDataStoreArn",
-    #     query_id: "UUID", # required
+    #     query_id: "UUID",
+    #     query_alias: "QueryAlias",
     #   })
     #
     # @example Response structure
@@ -1495,8 +1503,7 @@ module Aws::CloudTrail
     end
 
     # Gets event data results of a query. You must specify the `QueryID`
-    # value returned by the `StartQuery` operation, and an ARN for
-    # `EventDataStore`.
+    # value returned by the `StartQuery` operation.
     #
     # @option params [String] :event_data_store
     #   The ARN (or ID suffix of the ARN) of the event data store against
@@ -2821,17 +2828,28 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
-    # 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.
+    # Starts a CloudTrail Lake query. Use the `QueryStatement` parameter to
+    # provide your SQL query, enclosed in single quotation marks. Use the
+    # optional `DeliveryS3Uri` parameter to deliver the query results to an
+    # S3 bucket.
+    #
+    # `StartQuery` requires you specify either the `QueryStatement`
+    # parameter, or a `QueryAlias` and any `QueryParameters`. In the current
+    # release, the `QueryAlias` and `QueryParameters` parameters are used
+    # only for the queries that populate the CloudTrail Lake dashboards.
     #
-    # @option params [required, String] :query_statement
+    # @option params [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.
     #
+    # @option params [String] :query_alias
+    #   The alias that identifies a query template.
+    #
+    # @option params [Array<String>] :query_parameters
+    #   The query parameters for the specified `QueryAlias`.
+    #
     # @return [Types::StartQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartQueryResponse#query_id #query_id} => String
@@ -2839,8 +2857,10 @@ module Aws::CloudTrail
     # @example Request syntax with placeholder values
     #
     #   resp = client.start_query({
-    #     query_statement: "QueryStatement", # required
+    #     query_statement: "QueryStatement",
     #     delivery_s3_uri: "DeliveryS3Uri",
+    #     query_alias: "QueryAlias",
+    #     query_parameters: ["QueryParameter"],
     #   })
     #
     # @example Response structure
@@ -3027,12 +3047,16 @@ module Aws::CloudTrail
     # For event data stores for CloudTrail events, `AdvancedEventSelectors`
     # includes or excludes management and data events in your event data
     # store. For more information about `AdvancedEventSelectors`, see
-    # PutEventSelectorsRequest$AdvancedEventSelectors.
+    # [AdvancedEventSelectors][1].
     #
     # For event data stores for Config configuration items, Audit Manager
     # evidence, or non-Amazon Web Services events, `AdvancedEventSelectors`
     # includes events of that type in your event data store.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedEventSelector.html
+    #
     # @option params [required, String] :event_data_store
     #   The ARN (or the ID suffix of the ARN) of the event data store that you
     #   want to update.
@@ -3372,7 +3396,7 @@ module Aws::CloudTrail
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudtrail'
-      context[:gem_version] = '1.61.0'
+      context[:gem_version] = '1.62.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -214,7 +214,10 @@ module Aws::CloudTrail
     PutResourcePolicyResponse = Shapes::StructureShape.new(name: 'PutResourcePolicyResponse')
     Queries = Shapes::ListShape.new(name: 'Queries')
     Query = Shapes::StructureShape.new(name: 'Query')
+    QueryAlias = Shapes::StringShape.new(name: 'QueryAlias')
     QueryIdNotFoundException = Shapes::StructureShape.new(name: 'QueryIdNotFoundException')
+    QueryParameter = Shapes::StringShape.new(name: 'QueryParameter')
+    QueryParameters = Shapes::ListShape.new(name: 'QueryParameters')
     QueryResultColumn = Shapes::MapShape.new(name: 'QueryResultColumn')
     QueryResultKey = Shapes::StringShape.new(name: 'QueryResultKey')
     QueryResultRow = Shapes::ListShape.new(name: 'QueryResultRow')
@@ -458,7 +461,8 @@ module Aws::CloudTrail
     DeregisterOrganizationDelegatedAdminResponse.struct_class = Types::DeregisterOrganizationDelegatedAdminResponse
 
     DescribeQueryRequest.add_member(:event_data_store, Shapes::ShapeRef.new(shape: EventDataStoreArn, deprecated: true, location_name: "EventDataStore", metadata: {"deprecatedMessage"=>"EventDataStore is no longer required by DescribeQueryRequest"}))
-    DescribeQueryRequest.add_member(:query_id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "QueryId"))
+    DescribeQueryRequest.add_member(:query_id, Shapes::ShapeRef.new(shape: UUID, location_name: "QueryId"))
+    DescribeQueryRequest.add_member(:query_alias, Shapes::ShapeRef.new(shape: QueryAlias, location_name: "QueryAlias"))
     DescribeQueryRequest.struct_class = Types::DescribeQueryRequest
 
     DescribeQueryResponse.add_member(:query_id, Shapes::ShapeRef.new(shape: UUID, location_name: "QueryId"))
@@ -902,6 +906,8 @@ module Aws::CloudTrail
 
     QueryIdNotFoundException.struct_class = Types::QueryIdNotFoundException
 
+    QueryParameters.member = Shapes::ShapeRef.new(shape: QueryParameter)
+
     QueryResultColumn.key = Shapes::ShapeRef.new(shape: QueryResultKey)
     QueryResultColumn.value = Shapes::ShapeRef.new(shape: QueryResultValue)
 
@@ -1010,8 +1016,10 @@ 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(:query_statement, Shapes::ShapeRef.new(shape: QueryStatement, location_name: "QueryStatement"))
     StartQueryRequest.add_member(:delivery_s3_uri, Shapes::ShapeRef.new(shape: DeliveryS3Uri, location_name: "DeliveryS3Uri"))
+    StartQueryRequest.add_member(:query_alias, Shapes::ShapeRef.new(shape: QueryAlias, location_name: "QueryAlias"))
+    StartQueryRequest.add_member(:query_parameters, Shapes::ShapeRef.new(shape: QueryParameters, location_name: "QueryParameters"))
     StartQueryRequest.struct_class = Types::StartQueryRequest
 
     StartQueryResponse.add_member(:query_id, Shapes::ShapeRef.new(shape: UUID, location_name: "QueryId"))
@@ -1981,6 +1989,7 @@ module Aws::CloudTrail
         o.http_request_uri = "/"
         o.input = Shapes::ShapeRef.new(shape: UpdateEventDataStoreRequest)
         o.output = Shapes::ShapeRef.new(shape: UpdateEventDataStoreResponse)
+        o.errors << Shapes::ShapeRef.new(shape: EventDataStoreAlreadyExistsException)
         o.errors << Shapes::ShapeRef.new(shape: EventDataStoreARNInvalidException)
         o.errors << Shapes::ShapeRef.new(shape: EventDataStoreNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidEventSelectorsException)

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

@@ -174,12 +174,16 @@ module Aws::CloudTrail
     #
     #     * `AWS::CloudTrail::Channel`
     #
+    #     * `AWS::CodeWhisperer::Profile`
+    #
     #     * `AWS::Cognito::IdentityPool`
     #
     #     * `AWS::DynamoDB::Stream`
     #
     #     * `AWS::EC2::Snapshot`
     #
+    #     * `AWS::EMRWAL::Workspace`
+    #
     #     * `AWS::FinSpace::Environment`
     #
     #     * `AWS::Glue::Table`
@@ -244,6 +248,14 @@ module Aws::CloudTrail
     #
     #     ^
     #
+    #     When resources.type equals `AWS::CodeWhisperer::Profile`, and the
+    #     operator is set to `Equals` or `NotEquals`, the ARN must be in the
+    #     following format:
+    #
+    #     * `arn:<partition>:codewhisperer:<region>:<account_ID>:profile/<profile_ID>`
+    #
+    #     ^
+    #
     #     When resources.type equals `AWS::Cognito::IdentityPool`, and the
     #     operator is set to `Equals` or `NotEquals`, the ARN must be in the
     #     following format:
@@ -268,6 +280,14 @@ module Aws::CloudTrail
     #
     #     ^
     #
+    #     When `resources.type` equals `AWS::EMRWAL::Workspace`, and the
+    #     operator is set to `Equals` or `NotEquals`, the ARN must be in the
+    #     following format:
+    #
+    #     * `arn:<partition>:emrwal:<region>::workspace/<workspace_name>`
+    #
+    #     ^
+    #
     #     When `resources.type` equals `AWS::FinSpace::Environment`, and the
     #     operator is set to `Equals` or `NotEquals`, the ARN must be in the
     #     following format:
@@ -987,7 +1007,7 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_name
-    #   This field is no longer in use. Use SnsTopicARN.
+    #   This field is no longer in use. Use `SnsTopicARN`.
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_arn
@@ -1131,16 +1151,20 @@ module Aws::CloudTrail
     #   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
-    #   AdvancedFieldSelector$Field.
+    #   [AdvancedFieldSelector][1].
     #
     #   * `AWS::CloudTrail::Channel`
     #
+    #   * `AWS::CodeWhisperer::Profile`
+    #
     #   * `AWS::Cognito::IdentityPool`
     #
     #   * `AWS::DynamoDB::Stream`
     #
     #   * `AWS::EC2::Snapshot`
     #
+    #   * `AWS::EMRWAL::Workspace`
+    #
     #   * `AWS::FinSpace::Environment`
     #
     #   * `AWS::Glue::Table`
@@ -1160,6 +1184,10 @@ module Aws::CloudTrail
     #   * `AWS::S3ObjectLambda::AccessPoint`
     #
     #   * `AWS::S3Outposts::Object`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html
     #   @return [String]
     #
     # @!attribute [rw] values
@@ -1338,11 +1366,16 @@ module Aws::CloudTrail
     #   The query ID.
     #   @return [String]
     #
+    # @!attribute [rw] query_alias
+    #   The alias that identifies a query template.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DescribeQueryRequest AWS API Documentation
     #
     class DescribeQueryRequest < Struct.new(
       :event_data_store,
-      :query_id)
+      :query_id,
+      :query_alias)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4084,11 +4117,21 @@ module Aws::CloudTrail
     #   results.
     #   @return [String]
     #
+    # @!attribute [rw] query_alias
+    #   The alias that identifies a query template.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_parameters
+    #   The query parameters for the specified `QueryAlias`.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartQueryRequest AWS API Documentation
     #
     class StartQueryRequest < Struct.new(
       :query_statement,
-      :delivery_s3_uri)
+      :delivery_s3_uri,
+      :query_alias,
+      :query_parameters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4274,7 +4317,7 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_name
-    #   This field is no longer in use. Use SnsTopicARN.
+    #   This field is no longer in use. Use `SnsTopicARN`.
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_arn
@@ -4797,7 +4840,7 @@ module Aws::CloudTrail
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_name
-    #   This field is no longer in use. Use UpdateTrailResponse$SnsTopicARN.
+    #   This field is no longer in use. Use `SnsTopicARN`.
     #   @return [String]
     #
     # @!attribute [rw] sns_topic_arn

data/lib/aws-sdk-cloudtrail.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-cloudtrail/customizations'
 # @!group service
 module Aws::CloudTrail
 
-  GEM_VERSION = '1.61.0'
+  GEM_VERSION = '1.62.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudtrail
 version: !ruby/object:Gem::Version
-  version: 1.61.0
+  version: 1.62.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-02 00:00:00.000000000 Z
+date: 2023-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core