aws-sdk-athena 1.44.0 → 1.48.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8af6176c954aba6cac2b0903c10da26f76c00522cf9493c9fde454f8c997f95b
4
- data.tar.gz: 52772728101cc5877aee01bae406b44ae7ca97209daa0a0317d562f5bad9869f
3
+ metadata.gz: da7467e550bf620597ceef165f353fc3808321b98e63d7d7d676aeab464bea29
4
+ data.tar.gz: 4cf673e0808b660cf7362bbc01353a4b3dbc9a86b4e82c55d8edafce913e5dda
5
5
  SHA512:
6
- metadata.gz: d2d8cc26d15b7b4d6ba4d23b3f2278c7c7cf15420828253938a3629a30efde077ebe54b50e002e449030d124eb6943abbfe35bbb76b544e051f75a1a0a2a013f
7
- data.tar.gz: 8cd3ed287a204a6049d28b56274f8a13b73d621af4085ad202349fd4adbcccfa072c0dfab8b5a6630965ec211b7709c5ba347bb069bc0a663f295096bb17814f
6
+ metadata.gz: e4018d1f3ab5c934357ced0d31157c3433675f762d5bc4b0d24afb28b4dd9198b0a03ec6d16a01bf7774ab9ff2aac714e8d84641408a943603c3ace013043fef
7
+ data.tar.gz: 8c38f7b1b66adc538ae7c0aafa55d841b547c505a4d10d4cec3feb2e4c82af23aeb3e53d973246bf53ac72d8001fbd2d46e6ff49d0531e7c3190733fa9a19077
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.48.0 (2022-02-04)
5
+ ------------------
6
+
7
+ * 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.
8
+
9
+ 1.47.0 (2022-02-03)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.46.0 (2022-01-28)
15
+ ------------------
16
+
17
+ * Feature - This release adds a field, AthenaError, to the GetQueryExecution response object when a query fails.
18
+
19
+ 1.45.0 (2021-12-21)
20
+ ------------------
21
+
22
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
23
+
4
24
  1.44.0 (2021-11-30)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.44.0
1
+ 1.48.0
@@ -27,6 +27,8 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
31
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
30
32
  require 'aws-sdk-core/plugins/signature_v4.rb'
31
33
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
32
34
 
@@ -73,6 +75,8 @@ module Aws::Athena
73
75
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
74
76
  add_plugin(Aws::Plugins::TransferEncoding)
75
77
  add_plugin(Aws::Plugins::HttpChecksum)
78
+ add_plugin(Aws::Plugins::DefaultsMode)
79
+ add_plugin(Aws::Plugins::RecursionDetection)
76
80
  add_plugin(Aws::Plugins::SignatureV4)
77
81
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
78
82
 
@@ -175,6 +179,10 @@ module Aws::Athena
175
179
  # Used only in `standard` and adaptive retry modes. Specifies whether to apply
176
180
  # a clock skew correction and retry requests with skewed client clocks.
177
181
  #
182
+ # @option options [String] :defaults_mode ("legacy")
183
+ # See {Aws::DefaultsModeConfiguration} for a list of the
184
+ # accepted modes and the configuration defaults that are included.
185
+ #
178
186
  # @option options [Boolean] :disable_host_prefix_injection (false)
179
187
  # Set to true to disable SDK automatically adding host prefix
180
188
  # to default service endpoint when available.
@@ -307,7 +315,7 @@ module Aws::Athena
307
315
  # seconds to wait when opening a HTTP session before raising a
308
316
  # `Timeout::Error`.
309
317
  #
310
- # @option options [Integer] :http_read_timeout (60) The default
318
+ # @option options [Float] :http_read_timeout (60) The default
311
319
  # number of seconds to wait for response data. This value can
312
320
  # safely be set per-request on the session.
313
321
  #
@@ -323,6 +331,9 @@ module Aws::Athena
323
331
  # disables this behaviour. This value can safely be set per
324
332
  # request on the session.
325
333
  #
334
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
335
+ # in seconds.
336
+ #
326
337
  # @option options [Boolean] :http_wire_trace (false) When `true`,
327
338
  # HTTP debug output will be sent to the `:logger`.
328
339
  #
@@ -427,12 +438,14 @@ module Aws::Athena
427
438
  # resp.query_executions[0].result_configuration.output_location #=> String
428
439
  # resp.query_executions[0].result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
429
440
  # resp.query_executions[0].result_configuration.encryption_configuration.kms_key #=> String
441
+ # resp.query_executions[0].result_configuration.expected_bucket_owner #=> String
430
442
  # resp.query_executions[0].query_execution_context.database #=> String
431
443
  # resp.query_executions[0].query_execution_context.catalog #=> String
432
444
  # resp.query_executions[0].status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
433
445
  # resp.query_executions[0].status.state_change_reason #=> String
434
446
  # resp.query_executions[0].status.submission_date_time #=> Time
435
447
  # resp.query_executions[0].status.completion_date_time #=> Time
448
+ # resp.query_executions[0].status.athena_error.error_category #=> Integer
436
449
  # resp.query_executions[0].statistics.engine_execution_time_in_millis #=> Integer
437
450
  # resp.query_executions[0].statistics.data_scanned_in_bytes #=> Integer
438
451
  # resp.query_executions[0].statistics.data_manifest_location #=> String
@@ -464,7 +477,9 @@ module Aws::Athena
464
477
  # @option params [required, String] :name
465
478
  # The name of the data catalog to create. The catalog name must be
466
479
  # unique for the Amazon Web Services account and can use a maximum of
467
- # 128 alphanumeric, underscore, at sign, or hyphen characters.
480
+ # 127 alphanumeric, underscore, at sign, or hyphen characters. The
481
+ # remainder of the length constraint of 256 is reserved for use by
482
+ # Athena.
468
483
  #
469
484
  # @option params [required, String] :type
470
485
  # The type of data catalog to create: `LAMBDA` for a federated catalog,
@@ -689,6 +704,7 @@ module Aws::Athena
689
704
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
690
705
  # kms_key: "String",
691
706
  # },
707
+ # expected_bucket_owner: "String",
692
708
  # },
693
709
  # enforce_work_group_configuration: false,
694
710
  # publish_cloud_watch_metrics_enabled: false,
@@ -991,12 +1007,14 @@ module Aws::Athena
991
1007
  # resp.query_execution.result_configuration.output_location #=> String
992
1008
  # resp.query_execution.result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
993
1009
  # resp.query_execution.result_configuration.encryption_configuration.kms_key #=> String
1010
+ # resp.query_execution.result_configuration.expected_bucket_owner #=> String
994
1011
  # resp.query_execution.query_execution_context.database #=> String
995
1012
  # resp.query_execution.query_execution_context.catalog #=> String
996
1013
  # resp.query_execution.status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
997
1014
  # resp.query_execution.status.state_change_reason #=> String
998
1015
  # resp.query_execution.status.submission_date_time #=> Time
999
1016
  # resp.query_execution.status.completion_date_time #=> Time
1017
+ # resp.query_execution.status.athena_error.error_category #=> Integer
1000
1018
  # resp.query_execution.statistics.engine_execution_time_in_millis #=> Integer
1001
1019
  # resp.query_execution.statistics.data_scanned_in_bytes #=> Integer
1002
1020
  # resp.query_execution.statistics.data_manifest_location #=> String
@@ -1023,6 +1041,14 @@ module Aws::Athena
1023
1041
  # User Guide*. This request does not execute the query but returns
1024
1042
  # results. Use StartQueryExecution to run a query.
1025
1043
  #
1044
+ # If the original query execution ran using an
1045
+ # ResultConfiguration$ExpectedBucketOwner setting, the setting also
1046
+ # applies to Amazon S3 read operations when `GetQueryResults` is called.
1047
+ # If an expected bucket owner has been specified and the query results
1048
+ # are in an Amazon S3 bucket whose owner account ID is different from
1049
+ # the expected bucket owner, the `GetQueryResults` call fails with an
1050
+ # Amazon S3 permissions error.
1051
+ #
1026
1052
  # To stream query results successfully, the IAM principal with
1027
1053
  # permission to call `GetQueryResults` also must have permissions to the
1028
1054
  # Amazon S3 `GetObject` action for the Athena query results location.
@@ -1165,6 +1191,7 @@ module Aws::Athena
1165
1191
  # resp.work_group.configuration.result_configuration.output_location #=> String
1166
1192
  # resp.work_group.configuration.result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
1167
1193
  # resp.work_group.configuration.result_configuration.encryption_configuration.kms_key #=> String
1194
+ # resp.work_group.configuration.result_configuration.expected_bucket_owner #=> String
1168
1195
  # resp.work_group.configuration.enforce_work_group_configuration #=> Boolean
1169
1196
  # resp.work_group.configuration.publish_cloud_watch_metrics_enabled #=> Boolean
1170
1197
  # resp.work_group.configuration.bytes_scanned_cutoff_per_query #=> Integer
@@ -1691,6 +1718,7 @@ module Aws::Athena
1691
1718
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
1692
1719
  # kms_key: "String",
1693
1720
  # },
1721
+ # expected_bucket_owner: "String",
1694
1722
  # },
1695
1723
  # work_group: "WorkGroupName",
1696
1724
  # })
@@ -1822,7 +1850,9 @@ module Aws::Athena
1822
1850
  # @option params [required, String] :name
1823
1851
  # The name of the data catalog to update. The catalog name must be
1824
1852
  # unique for the Amazon Web Services account and can use a maximum of
1825
- # 128 alphanumeric, underscore, at sign, or hyphen characters.
1853
+ # 127 alphanumeric, underscore, at sign, or hyphen characters. The
1854
+ # remainder of the length constraint of 256 is reserved for use by
1855
+ # Athena.
1826
1856
  #
1827
1857
  # @option params [required, String] :type
1828
1858
  # Specifies the type of data catalog to update. Specify `LAMBDA` for a
@@ -1948,6 +1978,8 @@ module Aws::Athena
1948
1978
  # kms_key: "String",
1949
1979
  # },
1950
1980
  # remove_encryption_configuration: false,
1981
+ # expected_bucket_owner: "String",
1982
+ # remove_expected_bucket_owner: false,
1951
1983
  # },
1952
1984
  # publish_cloud_watch_metrics_enabled: false,
1953
1985
  # bytes_scanned_cutoff_per_query: 1,
@@ -1983,7 +2015,7 @@ module Aws::Athena
1983
2015
  params: params,
1984
2016
  config: config)
1985
2017
  context[:gem_name] = 'aws-sdk-athena'
1986
- context[:gem_version] = '1.44.0'
2018
+ context[:gem_version] = '1.48.0'
1987
2019
  Seahorse::Client::Request.new(handlers, context)
1988
2020
  end
1989
2021
 
@@ -14,6 +14,7 @@ module Aws::Athena
14
14
  include Seahorse::Model
15
15
 
16
16
  AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
17
+ AthenaError = Shapes::StructureShape.new(name: 'AthenaError')
17
18
  BatchGetNamedQueryInput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryInput')
18
19
  BatchGetNamedQueryOutput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryOutput')
19
20
  BatchGetQueryExecutionInput = Shapes::StructureShape.new(name: 'BatchGetQueryExecutionInput')
@@ -58,6 +59,7 @@ module Aws::Athena
58
59
  EncryptionOption = Shapes::StringShape.new(name: 'EncryptionOption')
59
60
  EngineVersion = Shapes::StructureShape.new(name: 'EngineVersion')
60
61
  EngineVersionsList = Shapes::ListShape.new(name: 'EngineVersionsList')
62
+ ErrorCategory = Shapes::IntegerShape.new(name: 'ErrorCategory')
61
63
  ErrorCode = Shapes::StringShape.new(name: 'ErrorCode')
62
64
  ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
63
65
  ExpressionString = Shapes::StringShape.new(name: 'ExpressionString')
@@ -183,6 +185,9 @@ module Aws::Athena
183
185
  datumList = Shapes::ListShape.new(name: 'datumList')
184
186
  datumString = Shapes::StringShape.new(name: 'datumString')
185
187
 
188
+ AthenaError.add_member(:error_category, Shapes::ShapeRef.new(shape: ErrorCategory, location_name: "ErrorCategory"))
189
+ AthenaError.struct_class = Types::AthenaError
190
+
186
191
  BatchGetNamedQueryInput.add_member(:named_query_ids, Shapes::ShapeRef.new(shape: NamedQueryIdList, required: true, location_name: "NamedQueryIds"))
187
192
  BatchGetNamedQueryInput.struct_class = Types::BatchGetNamedQueryInput
188
193
 
@@ -514,6 +519,7 @@ module Aws::Athena
514
519
  QueryExecutionStatus.add_member(:state_change_reason, Shapes::ShapeRef.new(shape: String, location_name: "StateChangeReason"))
515
520
  QueryExecutionStatus.add_member(:submission_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "SubmissionDateTime"))
516
521
  QueryExecutionStatus.add_member(:completion_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "CompletionDateTime"))
522
+ QueryExecutionStatus.add_member(:athena_error, Shapes::ShapeRef.new(shape: AthenaError, location_name: "AthenaError"))
517
523
  QueryExecutionStatus.struct_class = Types::QueryExecutionStatus
518
524
 
519
525
  ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
@@ -522,12 +528,15 @@ module Aws::Athena
522
528
 
523
529
  ResultConfiguration.add_member(:output_location, Shapes::ShapeRef.new(shape: String, location_name: "OutputLocation"))
524
530
  ResultConfiguration.add_member(:encryption_configuration, Shapes::ShapeRef.new(shape: EncryptionConfiguration, location_name: "EncryptionConfiguration"))
531
+ ResultConfiguration.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: String, location_name: "ExpectedBucketOwner"))
525
532
  ResultConfiguration.struct_class = Types::ResultConfiguration
526
533
 
527
534
  ResultConfigurationUpdates.add_member(:output_location, Shapes::ShapeRef.new(shape: String, location_name: "OutputLocation"))
528
535
  ResultConfigurationUpdates.add_member(:remove_output_location, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveOutputLocation"))
529
536
  ResultConfigurationUpdates.add_member(:encryption_configuration, Shapes::ShapeRef.new(shape: EncryptionConfiguration, location_name: "EncryptionConfiguration"))
530
537
  ResultConfigurationUpdates.add_member(:remove_encryption_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveEncryptionConfiguration"))
538
+ ResultConfigurationUpdates.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: String, location_name: "ExpectedBucketOwner"))
539
+ ResultConfigurationUpdates.add_member(:remove_expected_bucket_owner, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveExpectedBucketOwner"))
531
540
  ResultConfigurationUpdates.struct_class = Types::ResultConfigurationUpdates
532
541
 
533
542
  ResultSet.add_member(:rows, Shapes::ShapeRef.new(shape: RowList, location_name: "Rows"))
@@ -10,6 +10,32 @@
10
10
  module Aws::Athena
11
11
  module Types
12
12
 
13
+ # Provides information about an Athena query error. The `AthenaError`
14
+ # feature provides standardized error information to help you understand
15
+ # failed queries and take steps after a query failure occurs.
16
+ # `AthenaError` includes an `ErrorCategory` field that specifies whether
17
+ # the cause of the failed query is due to system error, user error, or
18
+ # unknown error.
19
+ #
20
+ # @!attribute [rw] error_category
21
+ # An integer value that specifies the category of a query failure
22
+ # error. The following list shows the category for each integer value.
23
+ #
24
+ # **1** - System
25
+ #
26
+ # **2** - User
27
+ #
28
+ # **3** - Unknown
29
+ # @return [Integer]
30
+ #
31
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/AthenaError AWS API Documentation
32
+ #
33
+ class AthenaError < Struct.new(
34
+ :error_category)
35
+ SENSITIVE = []
36
+ include Aws::Structure
37
+ end
38
+
13
39
  # @note When making an API call, you may pass BatchGetNamedQueryInput
14
40
  # data as a hash:
15
41
  #
@@ -188,7 +214,9 @@ module Aws::Athena
188
214
  # @!attribute [rw] name
189
215
  # The name of the data catalog to create. The catalog name must be
190
216
  # unique for the Amazon Web Services account and can use a maximum of
191
- # 128 alphanumeric, underscore, at sign, or hyphen characters.
217
+ # 127 alphanumeric, underscore, at sign, or hyphen characters. The
218
+ # remainder of the length constraint of 256 is reserved for use by
219
+ # Athena.
192
220
  # @return [String]
193
221
  #
194
222
  # @!attribute [rw] type
@@ -394,6 +422,7 @@ module Aws::Athena
394
422
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
395
423
  # kms_key: "String",
396
424
  # },
425
+ # expected_bucket_owner: "String",
397
426
  # },
398
427
  # enforce_work_group_configuration: false,
399
428
  # publish_cloud_watch_metrics_enabled: false,
@@ -458,8 +487,10 @@ module Aws::Athena
458
487
  #
459
488
  # @!attribute [rw] name
460
489
  # The name of the data catalog. The catalog name must be unique for
461
- # the Amazon Web Services account and can use a maximum of 128
462
- # alphanumeric, underscore, at sign, or hyphen characters.
490
+ # the Amazon Web Services account and can use a maximum of 127
491
+ # alphanumeric, underscore, at sign, or hyphen characters. The
492
+ # remainder of the length constraint of 256 is reserved for use by
493
+ # Athena.
463
494
  # @return [String]
464
495
  #
465
496
  # @!attribute [rw] description
@@ -527,7 +558,11 @@ module Aws::Athena
527
558
  # and type.
528
559
  #
529
560
  # @!attribute [rw] catalog_name
530
- # The name of the data catalog.
561
+ # The name of the data catalog. The catalog name is unique for the
562
+ # Amazon Web Services account and can use a maximum of 127
563
+ # alphanumeric, underscore, at sign, or hyphen characters. The
564
+ # remainder of the length constraint of 256 is reserved for use by
565
+ # Athena.
531
566
  # @return [String]
532
567
  #
533
568
  # @!attribute [rw] type
@@ -1879,13 +1914,18 @@ module Aws::Athena
1879
1914
  # The date and time that the query completed.
1880
1915
  # @return [Time]
1881
1916
  #
1917
+ # @!attribute [rw] athena_error
1918
+ # Provides information about an Athena query error.
1919
+ # @return [Types::AthenaError]
1920
+ #
1882
1921
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecutionStatus AWS API Documentation
1883
1922
  #
1884
1923
  class QueryExecutionStatus < Struct.new(
1885
1924
  :state,
1886
1925
  :state_change_reason,
1887
1926
  :submission_date_time,
1888
- :completion_date_time)
1927
+ :completion_date_time,
1928
+ :athena_error)
1889
1929
  SENSITIVE = []
1890
1930
  include Aws::Structure
1891
1931
  end
@@ -1921,6 +1961,7 @@ module Aws::Athena
1921
1961
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
1922
1962
  # kms_key: "String",
1923
1963
  # },
1964
+ # expected_bucket_owner: "String",
1924
1965
  # }
1925
1966
  #
1926
1967
  # @!attribute [rw] output_location
@@ -1955,11 +1996,33 @@ module Aws::Athena
1955
1996
  # [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
1956
1997
  # @return [Types::EncryptionConfiguration]
1957
1998
  #
1999
+ # @!attribute [rw] expected_bucket_owner
2000
+ # The Amazon Web Services account ID that you expect to be the owner
2001
+ # of the Amazon S3 bucket specified by
2002
+ # ResultConfiguration$OutputLocation. If set, Athena uses the value
2003
+ # for `ExpectedBucketOwner` when it makes Amazon S3 calls to your
2004
+ # specified output location. If the `ExpectedBucketOwner` Amazon Web
2005
+ # Services account ID does not match the actual owner of the Amazon S3
2006
+ # bucket, the call fails with a permissions error.
2007
+ #
2008
+ # This is a client-side setting. If workgroup settings override
2009
+ # client-side settings, then the query uses the `ExpectedBucketOwner`
2010
+ # setting that is specified for the workgroup, and also uses the
2011
+ # location for storing query results specified in the workgroup. See
2012
+ # WorkGroupConfiguration$EnforceWorkGroupConfiguration and [Workgroup
2013
+ # Settings Override Client-Side Settings][1].
2014
+ #
2015
+ #
2016
+ #
2017
+ # [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
2018
+ # @return [String]
2019
+ #
1958
2020
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultConfiguration AWS API Documentation
1959
2021
  #
1960
2022
  class ResultConfiguration < Struct.new(
1961
2023
  :output_location,
1962
- :encryption_configuration)
2024
+ :encryption_configuration,
2025
+ :expected_bucket_owner)
1963
2026
  SENSITIVE = []
1964
2027
  include Aws::Structure
1965
2028
  end
@@ -1978,6 +2041,8 @@ module Aws::Athena
1978
2041
  # kms_key: "String",
1979
2042
  # },
1980
2043
  # remove_encryption_configuration: false,
2044
+ # expected_bucket_owner: "String",
2045
+ # remove_expected_bucket_owner: false,
1981
2046
  # }
1982
2047
  #
1983
2048
  # @!attribute [rw] output_location
@@ -2002,7 +2067,7 @@ module Aws::Athena
2002
2067
  # in this workgroup should be ignored and set to null. If set to
2003
2068
  # "false" or not set, and a value is present in the `OutputLocation`
2004
2069
  # in `ResultConfigurationUpdates` (the client-side setting), the
2005
- # `OutputLocation` in the workgroup's `ResultConfiguration` will be
2070
+ # `OutputLocation` in the workgroup's `ResultConfiguration` is
2006
2071
  # updated with the new value. For more information, see [Workgroup
2007
2072
  # Settings Override Client-Side Settings][1].
2008
2073
  #
@@ -2022,9 +2087,45 @@ module Aws::Athena
2022
2087
  # to "false" or not set, and a value is present in the
2023
2088
  # `EncryptionConfiguration` in `ResultConfigurationUpdates` (the
2024
2089
  # client-side setting), the `EncryptionConfiguration` in the
2025
- # workgroup's `ResultConfiguration` will be updated with the new
2026
- # value. For more information, see [Workgroup Settings Override
2027
- # Client-Side Settings][1].
2090
+ # workgroup's `ResultConfiguration` is updated with the new value.
2091
+ # For more information, see [Workgroup Settings Override Client-Side
2092
+ # Settings][1].
2093
+ #
2094
+ #
2095
+ #
2096
+ # [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
2097
+ # @return [Boolean]
2098
+ #
2099
+ # @!attribute [rw] expected_bucket_owner
2100
+ # The Amazon Web Services account ID that you expect to be the owner
2101
+ # of the Amazon S3 bucket specified by
2102
+ # ResultConfiguration$OutputLocation. If set, Athena uses the value
2103
+ # for `ExpectedBucketOwner` when it makes Amazon S3 calls to your
2104
+ # specified output location. If the `ExpectedBucketOwner` Amazon Web
2105
+ # Services account ID does not match the actual owner of the Amazon S3
2106
+ # bucket, the call fails with a permissions error.
2107
+ #
2108
+ # If workgroup settings override client-side settings, then the query
2109
+ # uses the `ExpectedBucketOwner` setting that is specified for the
2110
+ # workgroup, and also uses the location for storing query results
2111
+ # specified in the workgroup. See
2112
+ # WorkGroupConfiguration$EnforceWorkGroupConfiguration and [Workgroup
2113
+ # Settings Override Client-Side Settings][1].
2114
+ #
2115
+ #
2116
+ #
2117
+ # [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
2118
+ # @return [String]
2119
+ #
2120
+ # @!attribute [rw] remove_expected_bucket_owner
2121
+ # If set to "true", removes the Amazon Web Services account ID
2122
+ # previously specified for ResultConfiguration$ExpectedBucketOwner. If
2123
+ # set to "false" or not set, and a value is present in the
2124
+ # `ExpectedBucketOwner` in `ResultConfigurationUpdates` (the
2125
+ # client-side setting), the `ExpectedBucketOwner` in the workgroup's
2126
+ # `ResultConfiguration` is updated with the new value. For more
2127
+ # information, see [Workgroup Settings Override Client-Side
2128
+ # Settings][1].
2028
2129
  #
2029
2130
  #
2030
2131
  #
@@ -2037,7 +2138,9 @@ module Aws::Athena
2037
2138
  :output_location,
2038
2139
  :remove_output_location,
2039
2140
  :encryption_configuration,
2040
- :remove_encryption_configuration)
2141
+ :remove_encryption_configuration,
2142
+ :expected_bucket_owner,
2143
+ :remove_expected_bucket_owner)
2041
2144
  SENSITIVE = []
2042
2145
  include Aws::Structure
2043
2146
  end
@@ -2110,6 +2213,7 @@ module Aws::Athena
2110
2213
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
2111
2214
  # kms_key: "String",
2112
2215
  # },
2216
+ # expected_bucket_owner: "String",
2113
2217
  # },
2114
2218
  # work_group: "WorkGroupName",
2115
2219
  # }
@@ -2447,7 +2551,9 @@ module Aws::Athena
2447
2551
  # @!attribute [rw] name
2448
2552
  # The name of the data catalog to update. The catalog name must be
2449
2553
  # unique for the Amazon Web Services account and can use a maximum of
2450
- # 128 alphanumeric, underscore, at sign, or hyphen characters.
2554
+ # 127 alphanumeric, underscore, at sign, or hyphen characters. The
2555
+ # remainder of the length constraint of 256 is reserved for use by
2556
+ # Athena.
2451
2557
  # @return [String]
2452
2558
  #
2453
2559
  # @!attribute [rw] type
@@ -2560,6 +2666,8 @@ module Aws::Athena
2560
2666
  # kms_key: "String",
2561
2667
  # },
2562
2668
  # remove_encryption_configuration: false,
2669
+ # expected_bucket_owner: "String",
2670
+ # remove_expected_bucket_owner: false,
2563
2671
  # },
2564
2672
  # publish_cloud_watch_metrics_enabled: false,
2565
2673
  # bytes_scanned_cutoff_per_query: 1,
@@ -2678,6 +2786,7 @@ module Aws::Athena
2678
2786
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
2679
2787
  # kms_key: "String",
2680
2788
  # },
2789
+ # expected_bucket_owner: "String",
2681
2790
  # },
2682
2791
  # enforce_work_group_configuration: false,
2683
2792
  # publish_cloud_watch_metrics_enabled: false,
@@ -2779,6 +2888,8 @@ module Aws::Athena
2779
2888
  # kms_key: "String",
2780
2889
  # },
2781
2890
  # remove_encryption_configuration: false,
2891
+ # expected_bucket_owner: "String",
2892
+ # remove_expected_bucket_owner: false,
2782
2893
  # },
2783
2894
  # publish_cloud_watch_metrics_enabled: false,
2784
2895
  # bytes_scanned_cutoff_per_query: 1,
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-athena/customizations'
48
48
  # @!group service
49
49
  module Aws::Athena
50
50
 
51
- GEM_VERSION = '1.44.0'
51
+ GEM_VERSION = '1.48.0'
52
52
 
53
53
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-athena
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.44.0
4
+ version: 1.48.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-11-30 00:00:00.000000000 Z
11
+ date: 2022-02-04 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.122.0
22
+ version: 3.126.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.122.0
32
+ version: 3.126.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement