aws-sdk-athena 1.47.0 → 1.50.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2fe9003ba1094fae9aa14881613746f812fd66d1fa884c5cd36658a139585bb0
-  data.tar.gz: cd0573a8ce853bc3d22e220a35dea9efef7586d7bb5f08a9efd1cfc4f2e44cd8
+  metadata.gz: 89c891b7136886b602b201e9f40c94d12e6b21546c98beea47d5c8715abaf527
+  data.tar.gz: 24e6da677858fc422993801fe3fc523656b3643bc943689c8e79a3f88a291a0d
 SHA512:
-  metadata.gz: 15aefea7187c5f80ff87e7c1ba6ba26dd2f4a43832e5d154646e9cbe81792d0170347f4f04b4804cd318c43627302f21e8eea9aac3cee57c12e8b72d43b9b542
-  data.tar.gz: 87de8497408bff649a91198326d155ccc66281a923bf87a2c83808339af4b8eed032b2f99d932323ab32f5f9dfcea5a1b140e276772ed5923c909f5b0cadd9db
+  metadata.gz: dc1d0cb1f74cfe9e7d846a087cd4acc249289fdee33c7e2d743eb6b3e9ec0d1902c5060a40985af5fa79fc0d4e8010dce10a08439ca3af630a017c652464c627
+  data.tar.gz: f7024782538b4b37093b25f85de5fd0154fb634c978fe1c9b8d5434f0a56d14cc98e610bad0aa196ead7987c924868e08b068489c1d4982cb72a6ad8f6510c35

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.50.0 (2022-02-24)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.49.0 (2022-02-14)
+------------------
+
+* Feature - This release adds a subfield, ErrorType, to the AthenaError response object in the GetQueryExecution API when a query fails.
+
+1.48.0 (2022-02-04)
+------------------
+
+* Feature - You can now optionally specify the account ID that you expect to be the owner of your query results output location bucket in Athena. If the account ID of the query results bucket owner does not match the specified account ID, attempts to output to the bucket will fail with an S3 permissions error.
+
 1.47.0 (2022-02-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.47.0
+1.50.0

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

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -75,6 +76,7 @@ module Aws::Athena
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
@@ -438,6 +440,7 @@ module Aws::Athena
     #   resp.query_executions[0].result_configuration.output_location #=> String
     #   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].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"
@@ -445,6 +448,7 @@ module Aws::Athena
     #   resp.query_executions[0].status.submission_date_time #=> Time
     #   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].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
@@ -703,6 +707,7 @@ module Aws::Athena
     #           encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #           kms_key: "String",
     #         },
+    #         expected_bucket_owner: "String",
     #       },
     #       enforce_work_group_configuration: false,
     #       publish_cloud_watch_metrics_enabled: false,
@@ -1005,6 +1010,7 @@ module Aws::Athena
     #   resp.query_execution.result_configuration.output_location #=> String
     #   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.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"
@@ -1012,6 +1018,7 @@ module Aws::Athena
     #   resp.query_execution.status.submission_date_time #=> Time
     #   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.statistics.engine_execution_time_in_millis #=> Integer
     #   resp.query_execution.statistics.data_scanned_in_bytes #=> Integer
     #   resp.query_execution.statistics.data_manifest_location #=> String
@@ -1180,6 +1187,7 @@ module Aws::Athena
     #   resp.work_group.configuration.result_configuration.output_location #=> String
     #   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.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
@@ -1706,6 +1714,7 @@ module Aws::Athena
     #         encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #         kms_key: "String",
     #       },
+    #       expected_bucket_owner: "String",
     #     },
     #     work_group: "WorkGroupName",
     #   })
@@ -1965,6 +1974,8 @@ module Aws::Athena
     #           kms_key: "String",
     #         },
     #         remove_encryption_configuration: false,
+    #         expected_bucket_owner: "String",
+    #         remove_expected_bucket_owner: false,
     #       },
     #       publish_cloud_watch_metrics_enabled: false,
     #       bytes_scanned_cutoff_per_query: 1,
@@ -2000,7 +2011,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.47.0'
+      context[:gem_version] = '1.50.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -62,6 +62,7 @@ module Aws::Athena
     ErrorCategory = Shapes::IntegerShape.new(name: 'ErrorCategory')
     ErrorCode = Shapes::StringShape.new(name: 'ErrorCode')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
+    ErrorType = Shapes::IntegerShape.new(name: 'ErrorType')
     ExpressionString = Shapes::StringShape.new(name: 'ExpressionString')
     GetDataCatalogInput = Shapes::StructureShape.new(name: 'GetDataCatalogInput')
     GetDataCatalogOutput = Shapes::StructureShape.new(name: 'GetDataCatalogOutput')
@@ -186,6 +187,7 @@ module Aws::Athena
     datumString = Shapes::StringShape.new(name: 'datumString')
 
     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.struct_class = Types::AthenaError
 
     BatchGetNamedQueryInput.add_member(:named_query_ids, Shapes::ShapeRef.new(shape: NamedQueryIdList, required: true, location_name: "NamedQueryIds"))
@@ -528,12 +530,15 @@ 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.struct_class = Types::ResultConfiguration
 
     ResultConfigurationUpdates.add_member(:output_location, Shapes::ShapeRef.new(shape: String, location_name: "OutputLocation"))
     ResultConfigurationUpdates.add_member(:remove_output_location, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveOutputLocation"))
     ResultConfigurationUpdates.add_member(:encryption_configuration, Shapes::ShapeRef.new(shape: EncryptionConfiguration, location_name: "EncryptionConfiguration"))
     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.struct_class = Types::ResultConfigurationUpdates
 
     ResultSet.add_member(:rows, Shapes::ShapeRef.new(shape: RowList, location_name: "Rows"))

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

@@ -28,10 +28,21 @@ module Aws::Athena
     #   **3** - Unknown
     #   @return [Integer]
     #
+    # @!attribute [rw] error_type
+    #   An integer value that provides specific information about an Athena
+    #   query error. For the meaning of specific values, see the [Error Type
+    #   Reference][1] in the *Amazon Athena User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/error-reference.html#error-reference-error-type-reference
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/AthenaError AWS API Documentation
     #
     class AthenaError < Struct.new(
-      :error_category)
+      :error_category,
+      :error_type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -422,6 +433,7 @@ module Aws::Athena
     #               encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #               kms_key: "String",
     #             },
+    #             expected_bucket_owner: "String",
     #           },
     #           enforce_work_group_configuration: false,
     #           publish_cloud_watch_metrics_enabled: false,
@@ -1960,6 +1972,7 @@ module Aws::Athena
     #           encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #           kms_key: "String",
     #         },
+    #         expected_bucket_owner: "String",
     #       }
     #
     # @!attribute [rw] output_location
@@ -1994,11 +2007,33 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
     #   @return [Types::EncryptionConfiguration]
     #
+    # @!attribute [rw] expected_bucket_owner
+    #   The Amazon Web Services account ID that you expect to be the owner
+    #   of the Amazon S3 bucket specified by
+    #   ResultConfiguration$OutputLocation. If set, Athena uses the value
+    #   for `ExpectedBucketOwner` when it makes Amazon S3 calls to your
+    #   specified output location. If the `ExpectedBucketOwner` Amazon Web
+    #   Services account ID does not match the actual owner of the Amazon S3
+    #   bucket, the call fails with a permissions error.
+    #
+    #   This is a client-side setting. If workgroup settings override
+    #   client-side settings, then the query uses the `ExpectedBucketOwner`
+    #   setting 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].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultConfiguration AWS API Documentation
     #
     class ResultConfiguration < Struct.new(
       :output_location,
-      :encryption_configuration)
+      :encryption_configuration,
+      :expected_bucket_owner)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2017,6 +2052,8 @@ module Aws::Athena
     #           kms_key: "String",
     #         },
     #         remove_encryption_configuration: false,
+    #         expected_bucket_owner: "String",
+    #         remove_expected_bucket_owner: false,
     #       }
     #
     # @!attribute [rw] output_location
@@ -2070,13 +2107,51 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
     #   @return [Boolean]
     #
+    # @!attribute [rw] expected_bucket_owner
+    #   The Amazon Web Services account ID that you expect to be the owner
+    #   of the Amazon S3 bucket specified by
+    #   ResultConfiguration$OutputLocation. If set, Athena uses the value
+    #   for `ExpectedBucketOwner` when it makes Amazon S3 calls to your
+    #   specified output location. If the `ExpectedBucketOwner` Amazon Web
+    #   Services account ID does not match the actual owner of the Amazon S3
+    #   bucket, the call fails with a permissions error.
+    #
+    #   If workgroup settings override client-side settings, then the query
+    #   uses the `ExpectedBucketOwner` setting 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].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
+    #   @return [String]
+    #
+    # @!attribute [rw] remove_expected_bucket_owner
+    #   If set to "true", removes the Amazon Web Services account ID
+    #   previously specified for ResultConfiguration$ExpectedBucketOwner. If
+    #   set to "false" or not set, and a value is present in the
+    #   `ExpectedBucketOwner` in `ResultConfigurationUpdates` (the
+    #   client-side setting), the `ExpectedBucketOwner` 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(
       :output_location,
       :remove_output_location,
       :encryption_configuration,
-      :remove_encryption_configuration)
+      :remove_encryption_configuration,
+      :expected_bucket_owner,
+      :remove_expected_bucket_owner)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2149,6 +2224,7 @@ module Aws::Athena
     #             encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #             kms_key: "String",
     #           },
+    #           expected_bucket_owner: "String",
     #         },
     #         work_group: "WorkGroupName",
     #       }
@@ -2601,6 +2677,8 @@ module Aws::Athena
     #               kms_key: "String",
     #             },
     #             remove_encryption_configuration: false,
+    #             expected_bucket_owner: "String",
+    #             remove_expected_bucket_owner: false,
     #           },
     #           publish_cloud_watch_metrics_enabled: false,
     #           bytes_scanned_cutoff_per_query: 1,
@@ -2719,6 +2797,7 @@ module Aws::Athena
     #             encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #             kms_key: "String",
     #           },
+    #           expected_bucket_owner: "String",
     #         },
     #         enforce_work_group_configuration: false,
     #         publish_cloud_watch_metrics_enabled: false,
@@ -2820,6 +2899,8 @@ module Aws::Athena
     #             kms_key: "String",
     #           },
     #           remove_encryption_configuration: false,
+    #           expected_bucket_owner: "String",
+    #           remove_expected_bucket_owner: 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.47.0'
+  GEM_VERSION = '1.50.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-athena
 version: !ruby/object:Gem::Version
-  version: 1.47.0
+  version: 1.50.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-03 00:00:00.000000000 Z
+date: 2022-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.126.0
+        version: 3.127.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.126.0
+        version: 3.127.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement