aws-sdk-athena 1.62.0 → 1.64.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4a4c22e8952ea1dd742f01f5b203f29812b5552bffd03f4331c9a6679dec358
-  data.tar.gz: 17d2a692e4c12c919f739dbe98f84449dc8c556ae441d7c92f46bb8e6e37a08c
+  metadata.gz: ef4f565c264acbdf2e8231ff320670a5a809e877e71265e84529aee3060a3e24
+  data.tar.gz: 8fc2bc53535c4a9ea120231a3ec2deb2eeb82faa6842d98da3e6552c4d1e71e2
 SHA512:
-  metadata.gz: '0283bcc1f9848c71a877f6946f3986212ac546117cb385c883b04d8e467566ded299cca035702c425c8b4f718608866e9532312587e9351bba0db436cbbbbc69'
-  data.tar.gz: 4c6f835a21d72118d53ff1c4437eb890ddd9bf95359281894ee4b03c307ba4bd445bb992261132a0b2c91fb28c813430708c71e0c98523b7c9382e10cf1c4af1
+  metadata.gz: 7e47325bfb2ddf6cc4a4f05adb381b19c9e25d1601fce6adc0b4748df3f9d856f3725f9aa3a6e6899ca070b15fb460a69f1a19be3702fd09666ee1c3ea6ce06f
+  data.tar.gz: 7b262a69c7faac4b11fa0847ac78928a4b6b8e127a065110834ab9d7bce6850e452cd293c2a9d80402850e940491afafde26bf46ae1b6bb5b7b7186463ee59f8

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.64.0 (2023-03-30)
+------------------
+
+* Feature - Make DefaultExecutorDpuSize and CoordinatorDpuSize  fields optional  in StartSession
+
+1.63.0 (2023-03-27)
+------------------
+
+* Feature - Enforces a minimal level of encryption for the workgroup for query and calculation results that are written to Amazon S3. When enabled, workgroup users can set encryption only to the minimum level set by the administrator or higher when they submit queries.
+
 1.62.0 (2023-03-08)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.62.0
+1.64.0

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

@@ -794,6 +794,12 @@ module Aws::Athena
     # Gets an authentication token and the URL at which the notebook can be
     # accessed. During programmatic access, `CreatePresignedNotebookUrl`
     # must be called every 10 minutes to refresh the authentication token.
+    # For information about granting programmatic access, see [Grant
+    # programmatic access][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/athena/latest/ug/setting-up.html#setting-up-grant-programmatic-access
     #
     # @option params [required, String] :session_id
     #   The session ID.
@@ -825,24 +831,22 @@ module Aws::Athena
       req.send_request(options)
     end
 
-    # Creates a workgroup with the specified name. Only one of
-    # `Configurations` or `Configuration` can be specified; `Configurations`
-    # for a workgroup with multi engine support (for example, an Apache
-    # Spark enabled workgroup) or `Configuration` for an Athena SQL
-    # workgroup.
+    # Creates a workgroup with the specified name. A workgroup can be an
+    # Apache Spark enabled workgroup or an Athena SQL workgroup.
     #
     # @option params [required, String] :name
     #   The workgroup name.
     #
     # @option params [Types::WorkGroupConfiguration] :configuration
     #   Contains configuration information for creating an Athena SQL
-    #   workgroup, which includes the location in Amazon S3 where query
-    #   results are stored, the encryption configuration, if any, used for
-    #   encrypting query results, whether the Amazon CloudWatch Metrics are
-    #   enabled for the workgroup, the limit for the amount of bytes scanned
-    #   (cutoff) per query, if it is specified, and whether workgroup's
-    #   settings (specified with `EnforceWorkGroupConfiguration`) in the
-    #   `WorkGroupConfiguration` override client-side settings. See
+    #   workgroup or Spark enabled Athena workgroup. Athena SQL workgroup
+    #   configuration includes the location in Amazon S3 where query and
+    #   calculation results are stored, the encryption configuration, if any,
+    #   used for encrypting query results, whether the Amazon CloudWatch
+    #   Metrics are enabled for the workgroup, the limit for the amount of
+    #   bytes scanned (cutoff) per query, if it is specified, and whether
+    #   workgroup's settings (specified with `EnforceWorkGroupConfiguration`)
+    #   in the `WorkGroupConfiguration` override client-side settings. See
     #   WorkGroupConfiguration$EnforceWorkGroupConfiguration.
     #
     # @option params [String] :description
@@ -883,6 +887,7 @@ module Aws::Athena
     #       customer_content_encryption_configuration: {
     #         kms_key: "KmsKey", # required
     #       },
+    #       enable_minimum_encryption_configuration: false,
     #     },
     #     description: "WorkGroupDescriptionString",
     #     tags: [
@@ -1014,7 +1019,7 @@ module Aws::Athena
     #
     # @option params [Boolean] :recursive_delete_option
     #   The option to delete the workgroup and its contents even if the
-    #   workgroup contains any named queries or query executions.
+    #   workgroup contains any named queries, query executions, or notebooks.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1116,8 +1121,7 @@ module Aws::Athena
       req.send_request(options)
     end
 
-    # Retrieves a pre-signed URL to a copy of the code that was executed for
-    # the calculation.
+    # Retrieves the unencrypted code that was executed for the calculation.
     #
     # @option params [required, String] :calculation_execution_id
     #   The calculation execution UUID.
@@ -1416,9 +1420,10 @@ module Aws::Athena
 
     # Streams the results of a single query execution specified by
     # `QueryExecutionId` from the Athena query results location in Amazon
-    # S3. For more information, see [Query Results][1] in the *Amazon Athena
-    # User Guide*. This request does not execute the query but returns
-    # results. Use StartQueryExecution to run a query.
+    # S3. For more information, see [Working with query results, recent
+    # queries, and output files][1] in the *Amazon Athena User Guide*. This
+    # request does not execute the query but returns results. Use
+    # StartQueryExecution to run a query.
     #
     # To stream query results successfully, the IAM principal with
     # permission to call `GetQueryResults` also must have permissions to the
@@ -1723,6 +1728,7 @@ module Aws::Athena
     #   resp.work_group.configuration.additional_configuration #=> String
     #   resp.work_group.configuration.execution_role #=> String
     #   resp.work_group.configuration.customer_content_encryption_configuration.kms_key #=> String
+    #   resp.work_group.configuration.enable_minimum_encryption_configuration #=> Boolean
     #   resp.work_group.description #=> String
     #   resp.work_group.creation_time #=> Time
     #
@@ -1790,7 +1796,7 @@ module Aws::Athena
     end
 
     # Returns the supported DPU sizes for the supported application runtimes
-    # (for example, `Jupyter 1.0`).
+    # (for example, `Athena notebook version 1`).
     #
     # @option params [Integer] :max_results
     #   Specifies the maximum number of results to return.
@@ -2039,9 +2045,9 @@ module Aws::Athena
       req.send_request(options)
     end
 
-    # Lists, in descending order, the executors that have been submitted to
-    # a session. Newer executors are listed first; older executors are
-    # listed later. The result can be optionally filtered by state.
+    # Lists, in descending order, the executors that joined a session. Newer
+    # executors are listed first; older executors are listed later. The
+    # result can be optionally filtered by state.
     #
     # @option params [required, String] :session_id
     #   The session ID.
@@ -2606,8 +2612,7 @@ module Aws::Athena
     end
 
     # Submits calculations for execution within a session. You can supply
-    # the code to run as an inline code block within the request or as an
-    # Amazon S3 URL.
+    # the code to run as an inline code block within the request.
     #
     # @option params [required, String] :session_id
     #   The session ID.
@@ -2779,9 +2784,12 @@ module Aws::Athena
     #   parameter mappings.
     #
     # @option params [String] :notebook_version
-    #   The notebook version. This value is required only when requesting that
-    #   a notebook server be started for the session. The only valid notebook
-    #   version is `Jupyter1.0`.
+    #   The notebook version. This value is supplied automatically for
+    #   notebook sessions in the Athena console and is not required for
+    #   programmatic session access. The only valid notebook version is
+    #   `Athena notebook version 1`. If you specify a value for
+    #   `NotebookVersion`, you must also specify a value for `NotebookId`. See
+    #   EngineConfiguration$AdditionalConfigs.
     #
     # @option params [Integer] :session_idle_timeout_in_minutes
     #   The idle timeout in minutes for the session.
@@ -2924,7 +2932,7 @@ module Aws::Athena
     #
     #
     #
-    # [1]: https://aws.amazon.com/answers/account-management/aws-tagging-strategies/
+    # [1]: https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html
     #
     # @option params [required, String] :resource_arn
     #   Specifies the ARN of the Athena resource (workgroup or data catalog)
@@ -3129,7 +3137,8 @@ module Aws::Athena
     #   The notebook content type. Currently, the only valid type is `IPYNB`.
     #
     # @option params [String] :session_id
-    #   The ID of the session in which the notebook will be updated.
+    #   The active notebook session ID. Required if the notebook has an active
+    #   session.
     #
     # @option params [String] :client_request_token
     #   A unique case-sensitive string used to ensure the request to create
@@ -3234,11 +3243,7 @@ module Aws::Athena
     end
 
     # Updates the workgroup with the specified name. The workgroup's name
-    # cannot be changed. Only one of `ConfigurationsUpdates` or
-    # `ConfigurationUpdates` can be specified; `ConfigurationsUpdates` for a
-    # workgroup with multi engine support (for example, an Apache Spark
-    # enabled workgroup) or `ConfigurationUpdates` for an Athena SQL
-    # workgroup.
+    # cannot be changed. Only `ConfigurationUpdates` can be specified.
     #
     # @option params [required, String] :work_group
     #   The specified workgroup that will be updated.
@@ -3290,6 +3295,7 @@ module Aws::Athena
     #       customer_content_encryption_configuration: {
     #         kms_key: "KmsKey", # required
     #       },
+    #       enable_minimum_encryption_configuration: false,
     #     },
     #     state: "ENABLED", # accepts ENABLED, DISABLED
     #   })
@@ -3316,7 +3322,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.62.0'
+      context[:gem_version] = '1.64.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1184,6 +1184,7 @@ module Aws::Athena
     WorkGroupConfiguration.add_member(:additional_configuration, Shapes::ShapeRef.new(shape: NameString, location_name: "AdditionalConfiguration"))
     WorkGroupConfiguration.add_member(:execution_role, Shapes::ShapeRef.new(shape: RoleArn, location_name: "ExecutionRole"))
     WorkGroupConfiguration.add_member(:customer_content_encryption_configuration, Shapes::ShapeRef.new(shape: CustomerContentEncryptionConfiguration, location_name: "CustomerContentEncryptionConfiguration"))
+    WorkGroupConfiguration.add_member(:enable_minimum_encryption_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "EnableMinimumEncryptionConfiguration"))
     WorkGroupConfiguration.struct_class = Types::WorkGroupConfiguration
 
     WorkGroupConfigurationUpdates.add_member(:enforce_work_group_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "EnforceWorkGroupConfiguration"))
@@ -1197,6 +1198,7 @@ module Aws::Athena
     WorkGroupConfigurationUpdates.add_member(:additional_configuration, Shapes::ShapeRef.new(shape: NameString, location_name: "AdditionalConfiguration"))
     WorkGroupConfigurationUpdates.add_member(:execution_role, Shapes::ShapeRef.new(shape: RoleArn, location_name: "ExecutionRole"))
     WorkGroupConfigurationUpdates.add_member(:customer_content_encryption_configuration, Shapes::ShapeRef.new(shape: CustomerContentEncryptionConfiguration, location_name: "CustomerContentEncryptionConfiguration"))
+    WorkGroupConfigurationUpdates.add_member(:enable_minimum_encryption_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "EnableMinimumEncryptionConfiguration"))
     WorkGroupConfigurationUpdates.struct_class = Types::WorkGroupConfigurationUpdates
 
     WorkGroupSummary.add_member(:name, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "Name"))

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

@@ -45,8 +45,8 @@ module Aws::Athena
     # Contains the application runtime IDs and their supported DPU sizes.
     #
     # @!attribute [rw] application_runtime_id
-    #   The name of the supported application runtime (for example, `Jupyter
-    #   1.0`).
+    #   The name of the supported application runtime (for example, `Athena
+    #   notebook version 1`).
     #   @return [String]
     #
     # @!attribute [rw] supported_dpu_sizes
@@ -690,13 +690,15 @@ module Aws::Athena
     #
     # @!attribute [rw] configuration
     #   Contains configuration information for creating an Athena SQL
-    #   workgroup, which includes the location in Amazon S3 where query
-    #   results are stored, the encryption configuration, if any, used for
-    #   encrypting query results, whether the Amazon CloudWatch Metrics are
-    #   enabled for the workgroup, the limit for the amount of bytes scanned
-    #   (cutoff) per query, if it is specified, and whether workgroup's
-    #   settings (specified with `EnforceWorkGroupConfiguration`) in the
-    #   `WorkGroupConfiguration` override client-side settings. See
+    #   workgroup or Spark enabled Athena workgroup. Athena SQL workgroup
+    #   configuration includes the location in Amazon S3 where query and
+    #   calculation results are stored, the encryption configuration, if
+    #   any, used for encrypting query results, whether the Amazon
+    #   CloudWatch Metrics are enabled for the workgroup, the limit for the
+    #   amount of bytes scanned (cutoff) per query, if it is specified, and
+    #   whether workgroup's settings (specified with
+    #   `EnforceWorkGroupConfiguration`) in the `WorkGroupConfiguration`
+    #   override client-side settings. See
     #   WorkGroupConfiguration$EnforceWorkGroupConfiguration.
     #   @return [Types::WorkGroupConfiguration]
     #
@@ -957,7 +959,8 @@ module Aws::Athena
     #
     # @!attribute [rw] recursive_delete_option
     #   The option to delete the workgroup and its contents even if the
-    #   workgroup contains any named queries or query executions.
+    #   workgroup contains any named queries, query executions, or
+    #   notebooks.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteWorkGroupInput AWS API Documentation
@@ -973,8 +976,9 @@ module Aws::Athena
     #
     class DeleteWorkGroupOutput < Aws::EmptyStructure; end
 
-    # If query results are encrypted in Amazon S3, indicates the encryption
-    # option used (for example, `SSE_KMS` or `CSE_KMS`) and key information.
+    # If query and calculation results are encrypted in Amazon S3, indicates
+    # the encryption option used (for example, `SSE_KMS` or `CSE_KMS`) and
+    # key information.
     #
     # @!attribute [rw] encryption_option
     #   Indicates whether Amazon S3 server-side encryption with Amazon
@@ -1022,11 +1026,11 @@ module Aws::Athena
     #
     # @!attribute [rw] additional_configs
     #   Contains additional notebook engine `MAP<string, string>` parameter
-    #   mappings in the form of key-value pairs. To specify an Amazon S3 URI
-    #   that the Jupyter server will download and serve, specify a value for
-    #   the StartSessionRequest$NotebookVersion field, and then add a key
-    #   named `NotebookFileURI` to `AdditionalConfigs` that has value of the
-    #   Amazon S3 URI.
+    #   mappings in the form of key-value pairs. To specify an Athena
+    #   notebook that the Jupyter server will download and serve, specify a
+    #   value for the StartSessionRequest$NotebookVersion field, and then
+    #   add a key named `NotebookId` to `AdditionalConfigs` that has the
+    #   value of the Athena notebook ID.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/EngineConfiguration AWS API Documentation
@@ -1181,7 +1185,7 @@ module Aws::Athena
     end
 
     # @!attribute [rw] code_block
-    #   A pre-signed URL to the code that executed the calculation.
+    #   The unencrypted code that was executed for the calculation.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetCalculationExecutionCodeResponse AWS API Documentation
@@ -1703,7 +1707,7 @@ module Aws::Athena
     end
 
     # @!attribute [rw] notebook_id
-    #   The ID of the notebook to import.
+    #   The ID assigned to the imported notebook.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ImportNotebookOutput AWS API Documentation
@@ -2681,12 +2685,12 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] result_configuration
-    #   The location in Amazon S3 where query results were stored and the
-    #   encryption option, if any, used for query results. These are known
-    #   as "client-side settings". If workgroup settings override
-    #   client-side settings, then the query uses the location for the query
-    #   results and the encryption configuration that are specified for the
-    #   workgroup.
+    #   The location in Amazon S3 where query and calculation results are
+    #   stored and the encryption option, if any, used for query results.
+    #   These are known as "client-side settings". If workgroup settings
+    #   override client-side settings, then the query uses the location for
+    #   the query results and the encryption configuration that are
+    #   specified for the workgroup.
     #   @return [Types::ResultConfiguration]
     #
     # @!attribute [rw] result_reuse_configuration
@@ -3096,19 +3100,21 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # The location in Amazon S3 where query results are stored and the
-    # encryption option, if any, used for query results. These are known as
-    # "client-side settings". If workgroup settings override client-side
-    # settings, then the query uses the workgroup settings.
+    # The location in Amazon S3 where query and calculation results are
+    # stored and the encryption option, if any, used for query and
+    # calculation results. These are known as "client-side settings". If
+    # workgroup settings override client-side settings, then the query uses
+    # the workgroup settings.
     #
     # @!attribute [rw] output_location
-    #   The location in Amazon S3 where your query results are stored, such
-    #   as `s3://path/to/query/bucket/`. To run the query, you must specify
-    #   the query results location using one of the ways: either for
-    #   individual queries using either this setting (client-side), or in
-    #   the workgroup, using WorkGroupConfiguration. If none of them is set,
-    #   Athena issues an error that no output location is provided. For more
-    #   information, see [Query Results][1]. If workgroup settings override
+    #   The location in Amazon S3 where your query and calculation results
+    #   are stored, such as `s3://path/to/query/bucket/`. To run the query,
+    #   you must specify the query results location using one of the ways:
+    #   either for individual queries using either this setting
+    #   (client-side), or in the workgroup, using WorkGroupConfiguration. If
+    #   none of them is set, Athena issues an error that no output location
+    #   is provided. For more information, see [Working with query results,
+    #   recent queries, and output files][1]. If workgroup settings override
     #   client-side settings, then the query uses the settings specified for
     #   the workgroup. See
     #   WorkGroupConfiguration$EnforceWorkGroupConfiguration.
@@ -3119,12 +3125,13 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] encryption_configuration
-    #   If query results are encrypted in Amazon S3, indicates the
-    #   encryption option used (for example, `SSE_KMS` or `CSE_KMS`) and key
-    #   information. This is a client-side setting. If workgroup settings
-    #   override client-side settings, then the query uses the encryption
-    #   configuration that is specified for the workgroup, and also uses the
-    #   location for storing query results specified in the workgroup. See
+    #   If query and calculation results are encrypted in Amazon S3,
+    #   indicates the encryption option used (for example, `SSE_KMS` or
+    #   `CSE_KMS`) and key information. This is a client-side setting. If
+    #   workgroup settings override client-side settings, then the query
+    #   uses the encryption configuration that is specified for the
+    #   workgroup, and also uses the location for storing query results
+    #   specified in the workgroup. See
     #   WorkGroupConfiguration$EnforceWorkGroupConfiguration and [Workgroup
     #   Settings Override Client-Side Settings][1].
     #
@@ -3185,12 +3192,13 @@ module Aws::Athena
     # location and encryption configuration for the query results.
     #
     # @!attribute [rw] output_location
-    #   The location in Amazon S3 where your query results are stored, such
-    #   as `s3://path/to/query/bucket/`. For more information, see [Query
-    #   Results][1] If workgroup settings override client-side settings,
-    #   then the query uses the location for the query results and the
-    #   encryption configuration that are specified for the workgroup. The
-    #   "workgroup settings override" is specified in
+    #   The location in Amazon S3 where your query and calculation results
+    #   are stored, such as `s3://path/to/query/bucket/`. For more
+    #   information, see [Working with query results, recent queries, and
+    #   output files][1]. If workgroup settings override client-side
+    #   settings, then the query uses the location for the query results and
+    #   the encryption configuration that are specified for the workgroup.
+    #   The "workgroup settings override" is specified in
     #   `EnforceWorkGroupConfiguration` (true/false) in the
     #   `WorkGroupConfiguration`. See
     #   WorkGroupConfiguration$EnforceWorkGroupConfiguration.
@@ -3216,7 +3224,7 @@ module Aws::Athena
     #   @return [Boolean]
     #
     # @!attribute [rw] encryption_configuration
-    #   The encryption configuration for the query results.
+    #   The encryption configuration for query and calculation results.
     #   @return [Types::EncryptionConfiguration]
     #
     # @!attribute [rw] remove_encryption_configuration
@@ -3437,9 +3445,9 @@ module Aws::Athena
     #   @return [Integer]
     #
     # @!attribute [rw] encryption_configuration
-    #   If query results are encrypted in Amazon S3, indicates the
-    #   encryption option used (for example, `SSE_KMS` or `CSE_KMS`) and key
-    #   information.
+    #   If query and calculation results are encrypted in Amazon S3,
+    #   indicates the encryption option used (for example, `SSE_KMS` or
+    #   `CSE_KMS`) and key information.
     #   @return [Types::EncryptionConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/SessionConfiguration AWS API Documentation
@@ -3453,7 +3461,7 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # Contains statistics for a notebook session.
+    # Contains statistics for a session.
     #
     # @!attribute [rw] dpu_execution_in_millis
     #   The data processing unit execution time for a session in
@@ -3468,7 +3476,7 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # Contains information about the status of a notebook session.
+    # Contains information about the status of a session.
     #
     # @!attribute [rw] start_date_time
     #   The date and time that the session started.
@@ -3528,7 +3536,7 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # Contains summary information about a notebook session.
+    # Contains summary information about a session.
     #
     # @!attribute [rw] session_id
     #   The session ID.
@@ -3727,9 +3735,12 @@ module Aws::Athena
     #   @return [Types::EngineConfiguration]
     #
     # @!attribute [rw] notebook_version
-    #   The notebook version. This value is required only when requesting
-    #   that a notebook server be started for the session. The only valid
-    #   notebook version is `Jupyter1.0`.
+    #   The notebook version. This value is supplied automatically for
+    #   notebook sessions in the Athena console and is not required for
+    #   programmatic session access. The only valid notebook version is
+    #   `Athena notebook version 1`. If you specify a value for
+    #   `NotebookVersion`, you must also specify a value for `NotebookId`.
+    #   See EngineConfiguration$AdditionalConfigs.
     #   @return [String]
     #
     # @!attribute [rw] session_idle_timeout_in_minutes
@@ -3917,7 +3928,7 @@ module Aws::Athena
     #
     #
     #
-    # [1]: https://aws.amazon.com/answers/account-management/aws-tagging-strategies/
+    # [1]: https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html
     #
     # @!attribute [rw] key
     #   A tag key. The tag key length is from 1 to 128 Unicode characters in
@@ -4243,7 +4254,8 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] session_id
-    #   The ID of the session in which the notebook will be updated.
+    #   The active notebook session ID. Required if the notebook has an
+    #   active session.
     #   @return [String]
     #
     # @!attribute [rw] client_request_token
@@ -4390,12 +4402,12 @@ module Aws::Athena
     #
     # @!attribute [rw] configuration
     #   The configuration of the workgroup, which includes the location in
-    #   Amazon S3 where query results are stored, the encryption
-    #   configuration, if any, used for query results; whether the Amazon
-    #   CloudWatch Metrics are enabled for the workgroup; whether workgroup
-    #   settings override client-side settings; and the data usage limits
-    #   for the amount of data scanned per query or per workgroup. The
-    #   workgroup settings override is specified in
+    #   Amazon S3 where query and calculation results are stored, the
+    #   encryption configuration, if any, used for query and calculation
+    #   results; whether the Amazon CloudWatch Metrics are enabled for the
+    #   workgroup; whether workgroup settings override client-side settings;
+    #   and the data usage limits for the amount of data scanned per query
+    #   or per workgroup. The workgroup settings override is specified in
     #   `EnforceWorkGroupConfiguration` (true/false) in the
     #   `WorkGroupConfiguration`. See
     #   WorkGroupConfiguration$EnforceWorkGroupConfiguration.
@@ -4422,24 +4434,27 @@ module Aws::Athena
     end
 
     # The configuration of the workgroup, which includes the location in
-    # Amazon S3 where query results are stored, the encryption option, if
-    # any, used for query results, whether the Amazon CloudWatch Metrics are
-    # enabled for the workgroup and whether workgroup settings override
-    # query settings, and the data usage limits for the amount of data
-    # scanned per query or per workgroup. The workgroup settings override is
-    # specified in `EnforceWorkGroupConfiguration` (true/false) in the
+    # Amazon S3 where query and calculation results are stored, the
+    # encryption option, if any, used for query and calculation results,
+    # whether the Amazon CloudWatch Metrics are enabled for the workgroup
+    # and whether workgroup settings override query settings, and the data
+    # usage limits for the amount of data scanned per query or per
+    # workgroup. The workgroup settings override is specified in
+    # `EnforceWorkGroupConfiguration` (true/false) in the
     # `WorkGroupConfiguration`. See
     # WorkGroupConfiguration$EnforceWorkGroupConfiguration.
     #
     # @!attribute [rw] result_configuration
     #   The configuration for the workgroup, which includes the location in
-    #   Amazon S3 where query results are stored and the encryption option,
-    #   if any, used for query results. To run the query, you must specify
-    #   the query results location using one of the ways: either in the
-    #   workgroup using this setting, or for individual queries
-    #   (client-side), using ResultConfiguration$OutputLocation. If none of
-    #   them is set, Athena issues an error that no output location is
-    #   provided. For more information, see [Query Results][1].
+    #   Amazon S3 where query and calculation results are stored and the
+    #   encryption option, if any, used for query and calculation results.
+    #   To run the query, you must specify the query results location using
+    #   one of the ways: either in the workgroup using this setting, or for
+    #   individual queries (client-side), using
+    #   ResultConfiguration$OutputLocation. If none of them is set, Athena
+    #   issues an error that no output location is provided. For more
+    #   information, see [Working with query results, recent queries, and
+    #   output files][1].
     #
     #
     #
@@ -4493,7 +4508,7 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] execution_role
-    #   Role used in a notebook session for accessing the user's resources.
+    #   Role used in a session for accessing the user's resources.
     #   @return [String]
     #
     # @!attribute [rw] customer_content_encryption_configuration
@@ -4501,6 +4516,19 @@ module Aws::Athena
     #   stores in Athena.
     #   @return [Types::CustomerContentEncryptionConfiguration]
     #
+    # @!attribute [rw] enable_minimum_encryption_configuration
+    #   Enforces a minimal level of encryption for the workgroup for query
+    #   and calculation results that are written to Amazon S3. When enabled,
+    #   workgroup users can set encryption only to the minimum level set by
+    #   the administrator or higher when they submit queries.
+    #
+    #   The `EnforceWorkGroupConfiguration` setting takes precedence over
+    #   the `EnableMinimumEncryptionConfiguration` flag. This means that if
+    #   `EnforceWorkGroupConfiguration` is true, the
+    #   `EnableMinimumEncryptionConfiguration` flag is ignored, and the
+    #   workgroup configuration for encryption is used.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/WorkGroupConfiguration AWS API Documentation
     #
     class WorkGroupConfiguration < Struct.new(
@@ -4512,18 +4540,19 @@ module Aws::Athena
       :engine_version,
       :additional_configuration,
       :execution_role,
-      :customer_content_encryption_configuration)
+      :customer_content_encryption_configuration,
+      :enable_minimum_encryption_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
 
     # The configuration information that will be updated for this workgroup,
-    # which includes the location in Amazon S3 where query results are
-    # stored, the encryption option, if any, used for query results, whether
-    # the Amazon CloudWatch Metrics are enabled for the workgroup, whether
-    # the workgroup settings override the client-side settings, and the data
-    # usage limit for the amount of bytes scanned per query, if it is
-    # specified.
+    # which includes the location in Amazon S3 where query and calculation
+    # results are stored, the encryption option, if any, used for query
+    # results, whether the Amazon CloudWatch Metrics are enabled for the
+    # workgroup, whether the workgroup settings override the client-side
+    # settings, and the data usage limit for the amount of bytes scanned per
+    # query, if it is specified.
     #
     # @!attribute [rw] enforce_work_group_configuration
     #   If set to "true", the settings for the workgroup override
@@ -4597,6 +4626,20 @@ module Aws::Athena
     #   stores in Athena.
     #   @return [Types::CustomerContentEncryptionConfiguration]
     #
+    # @!attribute [rw] enable_minimum_encryption_configuration
+    #   Enforces a minimal level of encryption for the workgroup for query
+    #   and calculation results that are written to Amazon S3. When enabled,
+    #   workgroup users can set encryption only to the minimum level set by
+    #   the administrator or higher when they submit queries. This setting
+    #   does not apply to Spark-enabled workgroups.
+    #
+    #   The `EnforceWorkGroupConfiguration` setting takes precedence over
+    #   the `EnableMinimumEncryptionConfiguration` flag. This means that if
+    #   `EnforceWorkGroupConfiguration` is true, the
+    #   `EnableMinimumEncryptionConfiguration` flag is ignored, and the
+    #   workgroup configuration for encryption is used.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/WorkGroupConfigurationUpdates AWS API Documentation
     #
     class WorkGroupConfigurationUpdates < Struct.new(
@@ -4610,7 +4653,8 @@ module Aws::Athena
       :remove_customer_content_encryption_configuration,
       :additional_configuration,
       :execution_role,
-      :customer_content_encryption_configuration)
+      :customer_content_encryption_configuration,
+      :enable_minimum_encryption_configuration)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-athena.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @!group service
 module Aws::Athena
 
-  GEM_VERSION = '1.62.0'
+  GEM_VERSION = '1.64.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-athena
 version: !ruby/object:Gem::Version
-  version: 1.62.0
+  version: 1.64.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-08 00:00:00.000000000 Z
+date: 2023-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core