aws-sdk-athena 1.50.0 → 1.53.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89c891b7136886b602b201e9f40c94d12e6b21546c98beea47d5c8715abaf527
-  data.tar.gz: 24e6da677858fc422993801fe3fc523656b3643bc943689c8e79a3f88a291a0d
+  metadata.gz: d45eafd0db4a2dd576613f0620092497ee6adcf1ed681f4ba4a1500b04ae14e3
+  data.tar.gz: a53b56f8fbf2a72fb9ca8dcb7c7563ac2bee565c5895f3a149e77b3f25c3d637
 SHA512:
-  metadata.gz: dc1d0cb1f74cfe9e7d846a087cd4acc249289fdee33c7e2d743eb6b3e9ec0d1902c5060a40985af5fa79fc0d4e8010dce10a08439ca3af630a017c652464c627
-  data.tar.gz: f7024782538b4b37093b25f85de5fd0154fb634c978fe1c9b8d5434f0a56d14cc98e610bad0aa196ead7987c924868e08b068489c1d4982cb72a6ad8f6510c35
+  metadata.gz: 05ea3defd3b925e981cbcde008389fb2223161f14a30a29f1a164cf8ec6655bb50445f31cea00889d6d8446fc53a4cd1142ef5447ca3b23da62096642f6c3156
+  data.tar.gz: f9c403030dbec36516adc375bfd1a50a1d84259e739e68deb130687d13021165f3f70eb54d8af2bf3190a13175e64efab9944dc222c1b4abe7bcb5c0899d871d

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.53.0 (2022-04-15)
+------------------
+
+* Feature - This release adds subfields, ErrorMessage, Retryable, to the AthenaError response object in the GetQueryExecution API when a query fails.
+
+1.52.0 (2022-03-02)
+------------------
+
+* Feature - This release adds support for S3 Object Ownership by allowing the S3 bucket owner full control canned ACL to be set when Athena writes query results to S3 buckets.
+
+1.51.0 (2022-02-28)
+------------------
+
+* Feature - This release adds support for updating an existing named query.
+
 1.50.0 (2022-02-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.50.0
+1.53.0

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

@@ -441,6 +441,7 @@ module Aws::Athena
     #   resp.query_executions[0].result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
     #   resp.query_executions[0].result_configuration.encryption_configuration.kms_key #=> String
     #   resp.query_executions[0].result_configuration.expected_bucket_owner #=> String
+    #   resp.query_executions[0].result_configuration.acl_configuration.s3_acl_option #=> String, one of "BUCKET_OWNER_FULL_CONTROL"
     #   resp.query_executions[0].query_execution_context.database #=> String
     #   resp.query_executions[0].query_execution_context.catalog #=> String
     #   resp.query_executions[0].status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
@@ -449,6 +450,8 @@ module Aws::Athena
     #   resp.query_executions[0].status.completion_date_time #=> Time
     #   resp.query_executions[0].status.athena_error.error_category #=> Integer
     #   resp.query_executions[0].status.athena_error.error_type #=> Integer
+    #   resp.query_executions[0].status.athena_error.retryable #=> Boolean
+    #   resp.query_executions[0].status.athena_error.error_message #=> String
     #   resp.query_executions[0].statistics.engine_execution_time_in_millis #=> Integer
     #   resp.query_executions[0].statistics.data_scanned_in_bytes #=> Integer
     #   resp.query_executions[0].statistics.data_manifest_location #=> String
@@ -708,6 +711,9 @@ module Aws::Athena
     #           kms_key: "String",
     #         },
     #         expected_bucket_owner: "String",
+    #         acl_configuration: {
+    #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #         },
     #       },
     #       enforce_work_group_configuration: false,
     #       publish_cloud_watch_metrics_enabled: false,
@@ -1011,6 +1017,7 @@ module Aws::Athena
     #   resp.query_execution.result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
     #   resp.query_execution.result_configuration.encryption_configuration.kms_key #=> String
     #   resp.query_execution.result_configuration.expected_bucket_owner #=> String
+    #   resp.query_execution.result_configuration.acl_configuration.s3_acl_option #=> String, one of "BUCKET_OWNER_FULL_CONTROL"
     #   resp.query_execution.query_execution_context.database #=> String
     #   resp.query_execution.query_execution_context.catalog #=> String
     #   resp.query_execution.status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
@@ -1019,6 +1026,8 @@ module Aws::Athena
     #   resp.query_execution.status.completion_date_time #=> Time
     #   resp.query_execution.status.athena_error.error_category #=> Integer
     #   resp.query_execution.status.athena_error.error_type #=> Integer
+    #   resp.query_execution.status.athena_error.retryable #=> Boolean
+    #   resp.query_execution.status.athena_error.error_message #=> String
     #   resp.query_execution.statistics.engine_execution_time_in_millis #=> Integer
     #   resp.query_execution.statistics.data_scanned_in_bytes #=> Integer
     #   resp.query_execution.statistics.data_manifest_location #=> String
@@ -1188,6 +1197,7 @@ module Aws::Athena
     #   resp.work_group.configuration.result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
     #   resp.work_group.configuration.result_configuration.encryption_configuration.kms_key #=> String
     #   resp.work_group.configuration.result_configuration.expected_bucket_owner #=> String
+    #   resp.work_group.configuration.result_configuration.acl_configuration.s3_acl_option #=> String, one of "BUCKET_OWNER_FULL_CONTROL"
     #   resp.work_group.configuration.enforce_work_group_configuration #=> Boolean
     #   resp.work_group.configuration.publish_cloud_watch_metrics_enabled #=> Boolean
     #   resp.work_group.configuration.bytes_scanned_cutoff_per_query #=> Integer
@@ -1715,6 +1725,9 @@ module Aws::Athena
     #         kms_key: "String",
     #       },
     #       expected_bucket_owner: "String",
+    #       acl_configuration: {
+    #         s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #       },
     #     },
     #     work_group: "WorkGroupName",
     #   })
@@ -1907,6 +1920,41 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Updates a NamedQuery object. The database or workgroup cannot be
+    # updated.
+    #
+    # @option params [required, String] :named_query_id
+    #   The unique identifier (UUID) of the query.
+    #
+    # @option params [required, String] :name
+    #   The name of the query.
+    #
+    # @option params [String] :description
+    #   The query description.
+    #
+    # @option params [required, String] :query_string
+    #   The contents of the query with all query statements.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_named_query({
+    #     named_query_id: "NamedQueryId", # required
+    #     name: "NameString", # required
+    #     description: "NamedQueryDescriptionString",
+    #     query_string: "QueryString", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UpdateNamedQuery AWS API Documentation
+    #
+    # @overload update_named_query(params = {})
+    # @param [Hash] params ({})
+    def update_named_query(params = {}, options = {})
+      req = build_request(:update_named_query, params)
+      req.send_request(options)
+    end
+
     # Updates a prepared statement.
     #
     # @option params [required, String] :statement_name
@@ -1976,6 +2024,10 @@ module Aws::Athena
     #         remove_encryption_configuration: false,
     #         expected_bucket_owner: "String",
     #         remove_expected_bucket_owner: false,
+    #         acl_configuration: {
+    #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #         },
+    #         remove_acl_configuration: false,
     #       },
     #       publish_cloud_watch_metrics_enabled: false,
     #       bytes_scanned_cutoff_per_query: 1,
@@ -2011,7 +2063,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.50.0'
+      context[:gem_version] = '1.53.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -13,6 +13,7 @@ module Aws::Athena
 
     include Seahorse::Model
 
+    AclConfiguration = Shapes::StructureShape.new(name: 'AclConfiguration')
     AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
     AthenaError = Shapes::StructureShape.new(name: 'AthenaError')
     BatchGetNamedQueryInput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryInput')
@@ -117,6 +118,7 @@ module Aws::Athena
     MetadataException = Shapes::StructureShape.new(name: 'MetadataException')
     NameString = Shapes::StringShape.new(name: 'NameString')
     NamedQuery = Shapes::StructureShape.new(name: 'NamedQuery')
+    NamedQueryDescriptionString = Shapes::StringShape.new(name: 'NamedQueryDescriptionString')
     NamedQueryId = Shapes::StringShape.new(name: 'NamedQueryId')
     NamedQueryIdList = Shapes::ListShape.new(name: 'NamedQueryIdList')
     NamedQueryList = Shapes::ListShape.new(name: 'NamedQueryList')
@@ -141,6 +143,7 @@ module Aws::Athena
     ResultSetMetadata = Shapes::StructureShape.new(name: 'ResultSetMetadata')
     Row = Shapes::StructureShape.new(name: 'Row')
     RowList = Shapes::ListShape.new(name: 'RowList')
+    S3AclOption = Shapes::StringShape.new(name: 'S3AclOption')
     StartQueryExecutionInput = Shapes::StructureShape.new(name: 'StartQueryExecutionInput')
     StartQueryExecutionOutput = Shapes::StructureShape.new(name: 'StartQueryExecutionOutput')
     StatementName = Shapes::StringShape.new(name: 'StatementName')
@@ -171,6 +174,8 @@ module Aws::Athena
     UntagResourceOutput = Shapes::StructureShape.new(name: 'UntagResourceOutput')
     UpdateDataCatalogInput = Shapes::StructureShape.new(name: 'UpdateDataCatalogInput')
     UpdateDataCatalogOutput = Shapes::StructureShape.new(name: 'UpdateDataCatalogOutput')
+    UpdateNamedQueryInput = Shapes::StructureShape.new(name: 'UpdateNamedQueryInput')
+    UpdateNamedQueryOutput = Shapes::StructureShape.new(name: 'UpdateNamedQueryOutput')
     UpdatePreparedStatementInput = Shapes::StructureShape.new(name: 'UpdatePreparedStatementInput')
     UpdatePreparedStatementOutput = Shapes::StructureShape.new(name: 'UpdatePreparedStatementOutput')
     UpdateWorkGroupInput = Shapes::StructureShape.new(name: 'UpdateWorkGroupInput')
@@ -186,8 +191,13 @@ module Aws::Athena
     datumList = Shapes::ListShape.new(name: 'datumList')
     datumString = Shapes::StringShape.new(name: 'datumString')
 
+    AclConfiguration.add_member(:s3_acl_option, Shapes::ShapeRef.new(shape: S3AclOption, required: true, location_name: "S3AclOption"))
+    AclConfiguration.struct_class = Types::AclConfiguration
+
     AthenaError.add_member(:error_category, Shapes::ShapeRef.new(shape: ErrorCategory, location_name: "ErrorCategory"))
     AthenaError.add_member(:error_type, Shapes::ShapeRef.new(shape: ErrorType, location_name: "ErrorType"))
+    AthenaError.add_member(:retryable, Shapes::ShapeRef.new(shape: Boolean, location_name: "Retryable"))
+    AthenaError.add_member(:error_message, Shapes::ShapeRef.new(shape: String, location_name: "ErrorMessage"))
     AthenaError.struct_class = Types::AthenaError
 
     BatchGetNamedQueryInput.add_member(:named_query_ids, Shapes::ShapeRef.new(shape: NamedQueryIdList, required: true, location_name: "NamedQueryIds"))
@@ -531,6 +541,7 @@ module Aws::Athena
     ResultConfiguration.add_member(:output_location, Shapes::ShapeRef.new(shape: String, location_name: "OutputLocation"))
     ResultConfiguration.add_member(:encryption_configuration, Shapes::ShapeRef.new(shape: EncryptionConfiguration, location_name: "EncryptionConfiguration"))
     ResultConfiguration.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: String, location_name: "ExpectedBucketOwner"))
+    ResultConfiguration.add_member(:acl_configuration, Shapes::ShapeRef.new(shape: AclConfiguration, location_name: "AclConfiguration"))
     ResultConfiguration.struct_class = Types::ResultConfiguration
 
     ResultConfigurationUpdates.add_member(:output_location, Shapes::ShapeRef.new(shape: String, location_name: "OutputLocation"))
@@ -539,6 +550,8 @@ module Aws::Athena
     ResultConfigurationUpdates.add_member(:remove_encryption_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveEncryptionConfiguration"))
     ResultConfigurationUpdates.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: String, location_name: "ExpectedBucketOwner"))
     ResultConfigurationUpdates.add_member(:remove_expected_bucket_owner, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveExpectedBucketOwner"))
+    ResultConfigurationUpdates.add_member(:acl_configuration, Shapes::ShapeRef.new(shape: AclConfiguration, location_name: "AclConfiguration"))
+    ResultConfigurationUpdates.add_member(:remove_acl_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveAclConfiguration"))
     ResultConfigurationUpdates.struct_class = Types::ResultConfigurationUpdates
 
     ResultSet.add_member(:rows, Shapes::ShapeRef.new(shape: RowList, location_name: "Rows"))
@@ -625,6 +638,14 @@ module Aws::Athena
 
     UpdateDataCatalogOutput.struct_class = Types::UpdateDataCatalogOutput
 
+    UpdateNamedQueryInput.add_member(:named_query_id, Shapes::ShapeRef.new(shape: NamedQueryId, required: true, location_name: "NamedQueryId"))
+    UpdateNamedQueryInput.add_member(:name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "Name"))
+    UpdateNamedQueryInput.add_member(:description, Shapes::ShapeRef.new(shape: NamedQueryDescriptionString, location_name: "Description"))
+    UpdateNamedQueryInput.add_member(:query_string, Shapes::ShapeRef.new(shape: QueryString, required: true, location_name: "QueryString"))
+    UpdateNamedQueryInput.struct_class = Types::UpdateNamedQueryInput
+
+    UpdateNamedQueryOutput.struct_class = Types::UpdateNamedQueryOutput
+
     UpdatePreparedStatementInput.add_member(:statement_name, Shapes::ShapeRef.new(shape: StatementName, required: true, location_name: "StatementName"))
     UpdatePreparedStatementInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, required: true, location_name: "WorkGroup"))
     UpdatePreparedStatementInput.add_member(:query_statement, Shapes::ShapeRef.new(shape: QueryString, required: true, location_name: "QueryStatement"))
@@ -1078,6 +1099,16 @@ module Aws::Athena
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
       end)
 
+      api.add_operation(:update_named_query, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateNamedQuery"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: UpdateNamedQueryInput)
+        o.output = Shapes::ShapeRef.new(shape: UpdateNamedQueryOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+      end)
+
       api.add_operation(:update_prepared_statement, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdatePreparedStatement"
         o.http_method = "POST"

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

@@ -10,12 +10,51 @@
 module Aws::Athena
   module Types
 
+    # Indicates that an Amazon S3 canned ACL should be set to control
+    # ownership of stored query results. When Athena stores query results in
+    # Amazon S3, the canned ACL is set with the `x-amz-acl` request header.
+    # For more information about S3 Object Ownership, see [Object Ownership
+    # settings][1] in the *Amazon S3 User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html#object-ownership-overview
+    #
+    # @note When making an API call, you may pass AclConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #       }
+    #
+    # @!attribute [rw] s3_acl_option
+    #   The Amazon S3 canned ACL that Athena should specify when storing
+    #   query results. Currently the only supported canned ACL is
+    #   `BUCKET_OWNER_FULL_CONTROL`. If a query runs in a workgroup and the
+    #   workgroup overrides client-side settings, then the Amazon S3 canned
+    #   ACL specified in the workgroup's settings is used for all queries
+    #   that run in the workgroup. For more information about Amazon S3
+    #   canned ACLs, see [Canned ACL][1] in the *Amazon S3 User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/AclConfiguration AWS API Documentation
+    #
+    class AclConfiguration < Struct.new(
+      :s3_acl_option)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides information about an Athena query error. The `AthenaError`
     # feature provides standardized error information to help you understand
     # failed queries and take steps after a query failure occurs.
     # `AthenaError` includes an `ErrorCategory` field that specifies whether
     # the cause of the failed query is due to system error, user error, or
-    # unknown error.
+    # other error.
     #
     # @!attribute [rw] error_category
     #   An integer value that specifies the category of a query failure
@@ -25,7 +64,7 @@ module Aws::Athena
     #
     #   **2** - User
     #
-    #   **3** - Unknown
+    #   **3** - Other
     #   @return [Integer]
     #
     # @!attribute [rw] error_type
@@ -38,11 +77,21 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/athena/latest/ug/error-reference.html#error-reference-error-type-reference
     #   @return [Integer]
     #
+    # @!attribute [rw] retryable
+    #   True if the query might succeed if resubmitted.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] error_message
+    #   Contains a short description of the error that occurred.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/AthenaError AWS API Documentation
     #
     class AthenaError < Struct.new(
       :error_category,
-      :error_type)
+      :error_type,
+      :retryable,
+      :error_message)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -434,6 +483,9 @@ module Aws::Athena
     #               kms_key: "String",
     #             },
     #             expected_bucket_owner: "String",
+    #             acl_configuration: {
+    #               s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #             },
     #           },
     #           enforce_work_group_configuration: false,
     #           publish_cloud_watch_metrics_enabled: false,
@@ -736,7 +788,7 @@ 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.
+    # option used (for example, `SSE_KMS` or `CSE_KMS`) and key information.
     #
     # @note When making an API call, you may pass EncryptionConfiguration
     #   data as a hash:
@@ -748,9 +800,9 @@ module Aws::Athena
     #
     # @!attribute [rw] encryption_option
     #   Indicates whether Amazon S3 server-side encryption with Amazon
-    #   S3-managed keys (`SSE-S3`), server-side encryption with KMS-managed
-    #   keys (`SSE-KMS`), or client-side encryption with KMS-managed keys
-    #   (CSE-KMS) is used.
+    #   S3-managed keys (`SSE_S3`), server-side encryption with KMS-managed
+    #   keys (`SSE_KMS`), or client-side encryption with KMS-managed keys
+    #   (`CSE_KMS`) is used.
     #
     #   If a query runs in a workgroup and the workgroup overrides
     #   client-side settings, then the workgroup's setting for encryption
@@ -759,7 +811,7 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] kms_key
-    #   For `SSE-KMS` and `CSE-KMS`, this is the KMS key ARN or ID.
+    #   For `SSE_KMS` and `CSE_KMS`, this is the KMS key ARN or ID.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/EncryptionConfiguration AWS API Documentation
@@ -1642,8 +1694,8 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # A query, where `QueryString` is the list of SQL query statements that
-    # comprise the query.
+    # A query, where `QueryString` contains the SQL statements that make up
+    # the query.
     #
     # @!attribute [rw] name
     #   The query name.
@@ -1658,7 +1710,7 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] query_string
-    #   The SQL query statements that comprise the query.
+    #   The SQL statements that make up the query.
     #   @return [String]
     #
     # @!attribute [rw] named_query_id
@@ -1973,6 +2025,9 @@ module Aws::Athena
     #           kms_key: "String",
     #         },
     #         expected_bucket_owner: "String",
+    #         acl_configuration: {
+    #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #         },
     #       }
     #
     # @!attribute [rw] output_location
@@ -1994,7 +2049,7 @@ module Aws::Athena
     #
     # @!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
+    #   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
@@ -2028,12 +2083,29 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
     #   @return [String]
     #
+    # @!attribute [rw] acl_configuration
+    #   Indicates that an Amazon S3 canned ACL should be set to control
+    #   ownership of stored query results. Currently the only supported
+    #   canned ACL is `BUCKET_OWNER_FULL_CONTROL`. This is a client-side
+    #   setting. If workgroup settings override client-side settings, then
+    #   the query uses the ACL configuration that is specified for the
+    #   workgroup, and also uses the location for storing query results
+    #   specified in the workgroup. For more information, see
+    #   WorkGroupConfiguration$EnforceWorkGroupConfiguration and [Workgroup
+    #   Settings Override Client-Side Settings][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
+    #   @return [Types::AclConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultConfiguration AWS API Documentation
     #
     class ResultConfiguration < Struct.new(
       :output_location,
       :encryption_configuration,
-      :expected_bucket_owner)
+      :expected_bucket_owner,
+      :acl_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2054,6 +2126,10 @@ module Aws::Athena
     #         remove_encryption_configuration: false,
     #         expected_bucket_owner: "String",
     #         remove_expected_bucket_owner: false,
+    #         acl_configuration: {
+    #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #         },
+    #         remove_acl_configuration: false,
     #       }
     #
     # @!attribute [rw] output_location
@@ -2143,6 +2219,24 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
     #   @return [Boolean]
     #
+    # @!attribute [rw] acl_configuration
+    #   The ACL configuration for the query results.
+    #   @return [Types::AclConfiguration]
+    #
+    # @!attribute [rw] remove_acl_configuration
+    #   If set to `true`, indicates that the previously-specified ACL
+    #   configuration for queries in this workgroup should be ignored and
+    #   set to null. If set to `false` or not set, and a value is present in
+    #   the `AclConfiguration` of `ResultConfigurationUpdates`, the
+    #   `AclConfiguration` in the workgroup's `ResultConfiguration` is
+    #   updated with the new value. For more information, see [Workgroup
+    #   Settings Override Client-Side Settings][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultConfigurationUpdates AWS API Documentation
     #
     class ResultConfigurationUpdates < Struct.new(
@@ -2151,12 +2245,14 @@ module Aws::Athena
       :encryption_configuration,
       :remove_encryption_configuration,
       :expected_bucket_owner,
-      :remove_expected_bucket_owner)
+      :remove_expected_bucket_owner,
+      :acl_configuration,
+      :remove_acl_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # The metadata and rows that comprise a query result set. The metadata
+    # The metadata and rows that make up a query result set. The metadata
     # describes the column structure and data types. To return a `ResultSet`
     # object, use GetQueryResults.
     #
@@ -2194,7 +2290,7 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # The rows that comprise a query result table.
+    # The rows that make up a query result table.
     #
     # @!attribute [rw] data
     #   The data that populates a row in a query result table.
@@ -2225,6 +2321,9 @@ module Aws::Athena
     #             kms_key: "String",
     #           },
     #           expected_bucket_owner: "String",
+    #           acl_configuration: {
+    #             s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #           },
     #         },
     #         work_group: "WorkGroupName",
     #       }
@@ -2620,6 +2719,47 @@ module Aws::Athena
     #
     class UpdateDataCatalogOutput < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass UpdateNamedQueryInput
+    #   data as a hash:
+    #
+    #       {
+    #         named_query_id: "NamedQueryId", # required
+    #         name: "NameString", # required
+    #         description: "NamedQueryDescriptionString",
+    #         query_string: "QueryString", # required
+    #       }
+    #
+    # @!attribute [rw] named_query_id
+    #   The unique identifier (UUID) of the query.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the query.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The query description.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_string
+    #   The contents of the query with all query statements.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UpdateNamedQueryInput AWS API Documentation
+    #
+    class UpdateNamedQueryInput < Struct.new(
+      :named_query_id,
+      :name,
+      :description,
+      :query_string)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UpdateNamedQueryOutput AWS API Documentation
+    #
+    class UpdateNamedQueryOutput < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass UpdatePreparedStatementInput
     #   data as a hash:
     #
@@ -2679,6 +2819,10 @@ module Aws::Athena
     #             remove_encryption_configuration: false,
     #             expected_bucket_owner: "String",
     #             remove_expected_bucket_owner: false,
+    #             acl_configuration: {
+    #               s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #             },
+    #             remove_acl_configuration: false,
     #           },
     #           publish_cloud_watch_metrics_enabled: false,
     #           bytes_scanned_cutoff_per_query: 1,
@@ -2798,6 +2942,9 @@ module Aws::Athena
     #             kms_key: "String",
     #           },
     #           expected_bucket_owner: "String",
+    #           acl_configuration: {
+    #             s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #           },
     #         },
     #         enforce_work_group_configuration: false,
     #         publish_cloud_watch_metrics_enabled: false,
@@ -2901,6 +3048,10 @@ module Aws::Athena
     #           remove_encryption_configuration: false,
     #           expected_bucket_owner: "String",
     #           remove_expected_bucket_owner: false,
+    #           acl_configuration: {
+    #             s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #           },
+    #           remove_acl_configuration: false,
     #         },
     #         publish_cloud_watch_metrics_enabled: false,
     #         bytes_scanned_cutoff_per_query: 1,

data/lib/aws-sdk-athena.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @!group service
 module Aws::Athena
 
-  GEM_VERSION = '1.50.0'
+  GEM_VERSION = '1.53.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-athena
 version: !ruby/object:Gem::Version
-  version: 1.50.0
+  version: 1.53.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-24 00:00:00.000000000 Z
+date: 2022-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core