aws-sdk-cloudtrail 1.92.0 → 1.94.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7274c5f7fb833a4db6a9c64caf184e2bed45a9f5c883c1685c81b7e222a4a75b
-  data.tar.gz: f1dc30a16abbb7eaf4ea8252f127c889e940d4676b75d917219308d5f01e72cc
+  metadata.gz: 40acd8bcc6dded700013fbeaed424602161420c9fe228143db79d9a04a0d98e8
+  data.tar.gz: 12fbad4fe420619ae4b245d41c54a54c9b1b76a055bfc67ad95b2d5b3f487501
 SHA512:
-  metadata.gz: ba12fe4b6290b74ab29e1f15b0c3884e753e5ccde56ebf7f933cd76648b8213d128a1a41e68d72e2b481b8280e22849322381790a92835459039a12840492309
-  data.tar.gz: ad2f1b0307963c4099f3e7702bc749621c665870539f91f6d785c6352e0ac1e1cd031b736630e2a00b8e793e2a36a39886abe9623caaca4cfe5ca51c9fa12f9d
+  metadata.gz: 9bb3f1a932d77fe82f530107c2c6e9d52bbd960ccb79a39883b0c6aeeec8ae659169d40bb72e3d31ae97d21d7e9166963292b7f4cd08ad732b64bc8ce8f47b9d
+  data.tar.gz: 0d697553b988eb198bc0f9834e200425b08dea2e31a48a231e324f4285e0b9eb74919f0d9394ac4ef85d6b6432786a4673793f47c546590ef9cab9a97f626418

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.94.0 (2024-11-13)
+------------------
+
+* Feature - This release adds a new API GenerateQuery that generates a query from a natural language prompt about the event data in your event data store. This operation uses generative artificial intelligence (generative AI) to produce a ready-to-use SQL query from the prompt.
+
+1.93.0 (2024-10-18)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.92.0 (2024-09-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.92.0
+1.94.0

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

@@ -1185,6 +1185,7 @@ module Aws::CloudTrail
     #   * {Types::DescribeQueryResponse#error_message #error_message} => String
     #   * {Types::DescribeQueryResponse#delivery_s3_uri #delivery_s3_uri} => String
     #   * {Types::DescribeQueryResponse#delivery_status #delivery_status} => String
+    #   * {Types::DescribeQueryResponse#prompt #prompt} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -1207,6 +1208,7 @@ module Aws::CloudTrail
     #   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"
+    #   resp.prompt #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DescribeQuery AWS API Documentation
     #
@@ -1395,6 +1397,71 @@ module Aws::CloudTrail
       req.send_request(options)
     end
 
+    # Generates a query from a natural language prompt. This operation uses
+    # generative artificial intelligence (generative AI) to produce a
+    # ready-to-use SQL query from the prompt.
+    #
+    # The prompt can be a question or a statement about the event data in
+    # your event data store. For example, you can enter prompts like "What
+    # are my top errors in the past month?" and “Give me a list of users
+    # that used SNS.”
+    #
+    # The prompt must be in English. For information about limitations,
+    # permissions, and supported Regions, see [Create CloudTrail Lake
+    # queries from natural language prompts][1] in the <i>CloudTrail </i>
+    # user guide.
+    #
+    # <note markdown="1"> Do not include any personally identifying, confidential, or sensitive
+    # information in your prompts.
+    #
+    #  This feature uses generative AI large language models (LLMs); we
+    # recommend double-checking the LLM response.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/lake-query-generator.html
+    #
+    # @option params [required, Array<String>] :event_data_stores
+    #   The ARN (or ID suffix of the ARN) of the event data store that you
+    #   want to query. You can only specify one event data store.
+    #
+    # @option params [required, String] :prompt
+    #   The prompt that you want to use to generate the query. The prompt must
+    #   be in English. For example prompts, see [Example prompts][1] in the
+    #   <i>CloudTrail </i> user guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/lake-query-generator.html#lake-query-generator-examples
+    #
+    # @return [Types::GenerateQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GenerateQueryResponse#query_statement #query_statement} => String
+    #   * {Types::GenerateQueryResponse#query_alias #query_alias} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.generate_query({
+    #     event_data_stores: ["EventDataStoreArn"], # required
+    #     prompt: "Prompt", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.query_statement #=> String
+    #   resp.query_alias #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GenerateQuery AWS API Documentation
+    #
+    # @overload generate_query(params = {})
+    # @param [Hash] params ({})
+    def generate_query(params = {}, options = {})
+      req = build_request(:generate_query, params)
+      req.send_request(options)
+    end
+
     # Returns information about a specific channel.
     #
     # @option params [required, String] :channel
@@ -3958,7 +4025,7 @@ module Aws::CloudTrail
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudtrail'
-      context[:gem_version] = '1.92.0'
+      context[:gem_version] = '1.94.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -93,6 +93,7 @@ module Aws::CloudTrail
     EventDataStoreFederationEnabledException = Shapes::StructureShape.new(name: 'EventDataStoreFederationEnabledException')
     EventDataStoreHasOngoingImportException = Shapes::StructureShape.new(name: 'EventDataStoreHasOngoingImportException')
     EventDataStoreKmsKeyId = Shapes::StringShape.new(name: 'EventDataStoreKmsKeyId')
+    EventDataStoreList = Shapes::ListShape.new(name: 'EventDataStoreList')
     EventDataStoreMaxLimitExceededException = Shapes::StructureShape.new(name: 'EventDataStoreMaxLimitExceededException')
     EventDataStoreName = Shapes::StringShape.new(name: 'EventDataStoreName')
     EventDataStoreNotFoundException = Shapes::StructureShape.new(name: 'EventDataStoreNotFoundException')
@@ -107,6 +108,9 @@ module Aws::CloudTrail
     ExcludeManagementEventSources = Shapes::ListShape.new(name: 'ExcludeManagementEventSources')
     FederationRoleArn = Shapes::StringShape.new(name: 'FederationRoleArn')
     FederationStatus = Shapes::StringShape.new(name: 'FederationStatus')
+    GenerateQueryRequest = Shapes::StructureShape.new(name: 'GenerateQueryRequest')
+    GenerateQueryResponse = Shapes::StructureShape.new(name: 'GenerateQueryResponse')
+    GenerateResponseException = Shapes::StructureShape.new(name: 'GenerateResponseException')
     GetChannelRequest = Shapes::StructureShape.new(name: 'GetChannelRequest')
     GetChannelResponse = Shapes::StructureShape.new(name: 'GetChannelResponse')
     GetEventDataStoreRequest = Shapes::StructureShape.new(name: 'GetEventDataStoreRequest')
@@ -230,6 +234,7 @@ module Aws::CloudTrail
     PartitionKeyList = Shapes::ListShape.new(name: 'PartitionKeyList')
     PartitionKeyName = Shapes::StringShape.new(name: 'PartitionKeyName')
     PartitionKeyType = Shapes::StringShape.new(name: 'PartitionKeyType')
+    Prompt = Shapes::StringShape.new(name: 'Prompt')
     PublicKey = Shapes::StructureShape.new(name: 'PublicKey')
     PublicKeyList = Shapes::ListShape.new(name: 'PublicKeyList')
     PutEventSelectorsRequest = Shapes::StructureShape.new(name: 'PutEventSelectorsRequest')
@@ -506,6 +511,7 @@ module Aws::CloudTrail
     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.add_member(:prompt, Shapes::ShapeRef.new(shape: Prompt, location_name: "Prompt"))
     DescribeQueryResponse.struct_class = Types::DescribeQueryResponse
 
     DescribeTrailsRequest.add_member(:trail_name_list, Shapes::ShapeRef.new(shape: TrailNameList, location_name: "trailNameList"))
@@ -568,6 +574,8 @@ module Aws::CloudTrail
 
     EventDataStoreHasOngoingImportException.struct_class = Types::EventDataStoreHasOngoingImportException
 
+    EventDataStoreList.member = Shapes::ShapeRef.new(shape: EventDataStoreArn)
+
     EventDataStoreMaxLimitExceededException.struct_class = Types::EventDataStoreMaxLimitExceededException
 
     EventDataStoreNotFoundException.struct_class = Types::EventDataStoreNotFoundException
@@ -588,6 +596,16 @@ module Aws::CloudTrail
 
     ExcludeManagementEventSources.member = Shapes::ShapeRef.new(shape: String)
 
+    GenerateQueryRequest.add_member(:event_data_stores, Shapes::ShapeRef.new(shape: EventDataStoreList, required: true, location_name: "EventDataStores"))
+    GenerateQueryRequest.add_member(:prompt, Shapes::ShapeRef.new(shape: Prompt, required: true, location_name: "Prompt"))
+    GenerateQueryRequest.struct_class = Types::GenerateQueryRequest
+
+    GenerateQueryResponse.add_member(:query_statement, Shapes::ShapeRef.new(shape: QueryStatement, location_name: "QueryStatement"))
+    GenerateQueryResponse.add_member(:query_alias, Shapes::ShapeRef.new(shape: QueryAlias, location_name: "QueryAlias"))
+    GenerateQueryResponse.struct_class = Types::GenerateQueryResponse
+
+    GenerateResponseException.struct_class = Types::GenerateResponseException
+
     GetChannelRequest.add_member(:channel, Shapes::ShapeRef.new(shape: ChannelArn, required: true, location_name: "Channel"))
     GetChannelRequest.struct_class = Types::GetChannelRequest
 
@@ -1567,6 +1585,22 @@ module Aws::CloudTrail
         o.errors << Shapes::ShapeRef.new(shape: EventDataStoreFederationEnabledException)
       end)
 
+      api.add_operation(:generate_query, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GenerateQuery"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GenerateQueryRequest)
+        o.output = Shapes::ShapeRef.new(shape: GenerateQueryResponse)
+        o.errors << Shapes::ShapeRef.new(shape: EventDataStoreARNInvalidException)
+        o.errors << Shapes::ShapeRef.new(shape: EventDataStoreNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InactiveEventDataStoreException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: GenerateResponseException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
+        o.errors << Shapes::ShapeRef.new(shape: NoManagementAccountSLRExistsException)
+      end)
+
       api.add_operation(:get_channel, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetChannel"
         o.http_method = "POST"
@@ -1993,6 +2027,7 @@ module Aws::CloudTrail
         o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
         o.errors << Shapes::ShapeRef.new(shape: NotOrganizationMasterAccountException)
         o.errors << Shapes::ShapeRef.new(shape: NoManagementAccountSLRExistsException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
       end)
 
       api.add_operation(:restore_event_data_store, Seahorse::Model::Operation.new.tap do |o|

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

@@ -52,15 +52,18 @@ module Aws::CloudTrail
       self[:region] = options[:region]
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
-      if self[:use_dual_stack].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
-      end
       self[:use_fips] = options[:use_fips]
       self[:use_fips] = false if self[:use_fips].nil?
-      if self[:use_fips].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :use_fips"
-      end
       self[:endpoint] = options[:endpoint]
     end
+
+    def self.create(config, options={})
+      new({
+        region: config.region,
+        use_dual_stack: config.use_dualstack_endpoint,
+        use_fips: config.use_fips_endpoint,
+        endpoint: (config.endpoint.to_s unless config.regional_endpoint),
+      }.merge(options))
+    end
   end
 end