aws-sdk-timestreamquery 1.46.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: fb59ed80152c28419c4294a46f6c5f19d5e42f0bdb5b3ca722ed8e28a2c5ad6b
4
- data.tar.gz: c1e00cdb5ffe446e2010b6347ed03e975ac7c77f69f79733d6f1958037b12455
3
+ metadata.gz: c84fa249643cc4536ffcd0b3ca1a6fe31a36c462b4d6ef532e97a30a6a133b42
4
+ data.tar.gz: 9a0104c56f6e1bdc7a655c511c7436c954192bf0ae055884a1c173a01768c76a
5
5
  SHA512:
6
- metadata.gz: 95159c2b95fbaecd30729f8a74c3d310a4ac4f677854c4e4c4eddc71f8d6ee5d94a7679d7996dff83578f3670cd57088f85e09cccfae166f0c354118219f8c16
7
- data.tar.gz: 2930945cfcdd863fc7780eda3e463f1640161d581ce5d680f9f74ff20eca0817f231e1f747de875f5c9a7072a263ea86c885c5d156476dc568ec25ac45167f01
6
+ metadata.gz: ec5516e2e1c8296246c0d70554b342d7a81cfab109f5cb579e5413adab04c4af61d4e64d2476090cdfde4b479d219a2a440e4b2711ef70bb1f478377f5289a49
7
+ data.tar.gz: a903e6ae66055aec6352b040d2464e6d1ddc1f9e6ce96e47fc8ee6c939624f842bbfa658e165fe66443a885ab11b8a55e6d7a79b236d3729efb194d99986903c
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.48.0 (2025-01-15)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.47.0 (2024-11-20)
10
+ ------------------
11
+
12
+ * Feature - This release adds support for Provisioning Timestream Compute Units (TCUs), a new feature that allows provisioning dedicated compute resources for your queries, providing predictable and cost-effective query performance.
13
+
4
14
  1.46.0 (2024-10-22)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.46.0
1
+ 1.48.0
@@ -257,11 +257,34 @@ module Aws::TimestreamQuery
257
257
  # Used when loading credentials from the shared credentials file
258
258
  # at HOME/.aws/credentials. When not specified, 'default' is used.
259
259
  #
260
+ # @option options [String] :request_checksum_calculation ("when_supported")
261
+ # Determines when a checksum will be calculated for request payloads. Values are:
262
+ #
263
+ # * `when_supported` - (default) When set, a checksum will be
264
+ # calculated for all request payloads of operations modeled with the
265
+ # `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
266
+ # `requestAlgorithmMember` is modeled.
267
+ # * `when_required` - When set, a checksum will only be calculated for
268
+ # request payloads of operations modeled with the `httpChecksum` trait where
269
+ # `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
270
+ # is modeled and supplied.
271
+ #
260
272
  # @option options [Integer] :request_min_compression_size_bytes (10240)
261
273
  # The minimum size in bytes that triggers compression for request
262
274
  # bodies. The value must be non-negative integer value between 0
263
275
  # and 10485780 bytes inclusive.
264
276
  #
277
+ # @option options [String] :response_checksum_validation ("when_supported")
278
+ # Determines when checksum validation will be performed on response payloads. Values are:
279
+ #
280
+ # * `when_supported` - (default) When set, checksum validation is performed on all
281
+ # response payloads of operations modeled with the `httpChecksum` trait where
282
+ # `responseAlgorithms` is modeled, except when no modeled checksum algorithms
283
+ # are supported.
284
+ # * `when_required` - When set, checksum validation is not performed on
285
+ # response payloads of operations unless the checksum algorithm is supported and
286
+ # the `requestValidationModeMember` member is set to `ENABLED`.
287
+ #
265
288
  # @option options [Proc] :retry_backoff
266
289
  # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
267
290
  # This option is only used in the `legacy` retry mode.
@@ -681,11 +704,19 @@ module Aws::TimestreamQuery
681
704
  #
682
705
  # * {Types::DescribeAccountSettingsResponse#max_query_tcu #max_query_tcu} => Integer
683
706
  # * {Types::DescribeAccountSettingsResponse#query_pricing_model #query_pricing_model} => String
707
+ # * {Types::DescribeAccountSettingsResponse#query_compute #query_compute} => Types::QueryComputeResponse
684
708
  #
685
709
  # @example Response structure
686
710
  #
687
711
  # resp.max_query_tcu #=> Integer
688
712
  # resp.query_pricing_model #=> String, one of "BYTES_SCANNED", "COMPUTE_UNITS"
713
+ # resp.query_compute.compute_mode #=> String, one of "ON_DEMAND", "PROVISIONED"
714
+ # resp.query_compute.provisioned_capacity.active_query_tcu #=> Integer
715
+ # resp.query_compute.provisioned_capacity.notification_configuration.sns_configuration.topic_arn #=> String
716
+ # resp.query_compute.provisioned_capacity.notification_configuration.role_arn #=> String
717
+ # resp.query_compute.provisioned_capacity.last_update.target_query_tcu #=> Integer
718
+ # resp.query_compute.provisioned_capacity.last_update.status #=> String, one of "PENDING", "FAILED", "SUCCEEDED"
719
+ # resp.query_compute.provisioned_capacity.last_update.status_message #=> String
689
720
  #
690
721
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/DescribeAccountSettings AWS API Documentation
691
722
  #
@@ -850,7 +881,12 @@ module Aws::TimestreamQuery
850
881
  # If you enabled `QueryInsights`, this API also returns insights and
851
882
  # metrics related to the query that you executed as part of an Amazon
852
883
  # SNS notification. `QueryInsights` helps with performance tuning of
853
- # your query.
884
+ # your query. For more information about `QueryInsights`, see [Using
885
+ # query insights to optimize queries in Amazon Timestream][1].
886
+ #
887
+ #
888
+ #
889
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html
854
890
  #
855
891
  # @option params [required, String] :scheduled_query_arn
856
892
  # ARN of the scheduled query.
@@ -1058,7 +1094,9 @@ module Aws::TimestreamQuery
1058
1094
  #
1059
1095
  # If you enabled `QueryInsights`, this API also returns insights and
1060
1096
  # metrics related to the query that you executed. `QueryInsights` helps
1061
- # with performance tuning of your query.
1097
+ # with performance tuning of your query. For more information about
1098
+ # `QueryInsights`, see [Using query insights to optimize queries in
1099
+ # Amazon Timestream][1].
1062
1100
  #
1063
1101
  # <note markdown="1"> The maximum number of `Query` API requests you're allowed to make
1064
1102
  # with `QueryInsights` enabled is 1 query per second (QPS). If you
@@ -1068,7 +1106,7 @@ module Aws::TimestreamQuery
1068
1106
  #
1069
1107
  # `Query` will time out after 60 seconds. You must update the default
1070
1108
  # timeout in the SDK to support a timeout of 60 seconds. See the [code
1071
- # sample][1] for details.
1109
+ # sample][2] for details.
1072
1110
  #
1073
1111
  # Your query request will fail in the following cases:
1074
1112
  #
@@ -1091,7 +1129,8 @@ module Aws::TimestreamQuery
1091
1129
  #
1092
1130
  #
1093
1131
  #
1094
- # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html
1132
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html
1133
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html
1095
1134
  #
1096
1135
  # @option params [required, String] :query_string
1097
1136
  # The query to be run by Timestream.
@@ -1324,11 +1363,16 @@ module Aws::TimestreamQuery
1324
1363
  # The maximum number of compute units the service will use at any point
1325
1364
  # in time to serve your queries. To run queries, you must set a minimum
1326
1365
  # capacity of 4 TCU. You can set the maximum number of TCU in multiples
1327
- # of 4, for example, 4, 8, 16, 32, and so on.
1366
+ # of 4, for example, 4, 8, 16, 32, and so on. The maximum value
1367
+ # supported for `MaxQueryTCU` is 1000. To request an increase to this
1368
+ # soft limit, contact Amazon Web Services Support. For information about
1369
+ # the default quota for maxQueryTCU, see Default quotas. This
1370
+ # configuration is applicable only for on-demand usage of Timestream
1371
+ # Compute Units (TCUs).
1328
1372
  #
1329
1373
  # The maximum value supported for `MaxQueryTCU` is 1000. To request an
1330
1374
  # increase to this soft limit, contact Amazon Web Services Support. For
1331
- # information about the default quota for maxQueryTCU, see [Default
1375
+ # information about the default quota for `maxQueryTCU`, see [Default
1332
1376
  # quotas][1].
1333
1377
  #
1334
1378
  #
@@ -1344,22 +1388,52 @@ module Aws::TimestreamQuery
1344
1388
  #
1345
1389
  # </note>
1346
1390
  #
1391
+ # @option params [Types::QueryComputeRequest] :query_compute
1392
+ # Modifies the query compute settings configured in your account,
1393
+ # including the query pricing model and provisioned Timestream Compute
1394
+ # Units (TCUs) in your account.
1395
+ #
1396
+ # <note markdown="1"> This API is idempotent, meaning that making the same request multiple
1397
+ # times will have the same effect as making the request once.
1398
+ #
1399
+ # </note>
1400
+ #
1347
1401
  # @return [Types::UpdateAccountSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1348
1402
  #
1349
1403
  # * {Types::UpdateAccountSettingsResponse#max_query_tcu #max_query_tcu} => Integer
1350
1404
  # * {Types::UpdateAccountSettingsResponse#query_pricing_model #query_pricing_model} => String
1405
+ # * {Types::UpdateAccountSettingsResponse#query_compute #query_compute} => Types::QueryComputeResponse
1351
1406
  #
1352
1407
  # @example Request syntax with placeholder values
1353
1408
  #
1354
1409
  # resp = client.update_account_settings({
1355
1410
  # max_query_tcu: 1,
1356
1411
  # query_pricing_model: "BYTES_SCANNED", # accepts BYTES_SCANNED, COMPUTE_UNITS
1412
+ # query_compute: {
1413
+ # compute_mode: "ON_DEMAND", # accepts ON_DEMAND, PROVISIONED
1414
+ # provisioned_capacity: {
1415
+ # target_query_tcu: 1, # required
1416
+ # notification_configuration: {
1417
+ # sns_configuration: {
1418
+ # topic_arn: "AmazonResourceName", # required
1419
+ # },
1420
+ # role_arn: "AmazonResourceName", # required
1421
+ # },
1422
+ # },
1423
+ # },
1357
1424
  # })
1358
1425
  #
1359
1426
  # @example Response structure
1360
1427
  #
1361
1428
  # resp.max_query_tcu #=> Integer
1362
1429
  # resp.query_pricing_model #=> String, one of "BYTES_SCANNED", "COMPUTE_UNITS"
1430
+ # resp.query_compute.compute_mode #=> String, one of "ON_DEMAND", "PROVISIONED"
1431
+ # resp.query_compute.provisioned_capacity.active_query_tcu #=> Integer
1432
+ # resp.query_compute.provisioned_capacity.notification_configuration.sns_configuration.topic_arn #=> String
1433
+ # resp.query_compute.provisioned_capacity.notification_configuration.role_arn #=> String
1434
+ # resp.query_compute.provisioned_capacity.last_update.target_query_tcu #=> Integer
1435
+ # resp.query_compute.provisioned_capacity.last_update.status #=> String, one of "PENDING", "FAILED", "SUCCEEDED"
1436
+ # resp.query_compute.provisioned_capacity.last_update.status_message #=> String
1363
1437
  #
1364
1438
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/UpdateAccountSettings AWS API Documentation
1365
1439
  #
@@ -1414,7 +1488,7 @@ module Aws::TimestreamQuery
1414
1488
  tracer: tracer
1415
1489
  )
1416
1490
  context[:gem_name] = 'aws-sdk-timestreamquery'
1417
- context[:gem_version] = '1.46.0'
1491
+ context[:gem_version] = '1.48.0'
1418
1492
  Seahorse::Client::Request.new(handlers, context)
1419
1493
  end
1420
1494
 
@@ -15,6 +15,7 @@ module Aws::TimestreamQuery
15
15
  include Seahorse::Model
16
16
 
17
17
  AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
18
+ AccountSettingsNotificationConfiguration = Shapes::StructureShape.new(name: 'AccountSettingsNotificationConfiguration')
18
19
  AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
19
20
  CancelQueryRequest = Shapes::StructureShape.new(name: 'CancelQueryRequest')
20
21
  CancelQueryResponse = Shapes::StructureShape.new(name: 'CancelQueryResponse')
@@ -22,6 +23,7 @@ module Aws::TimestreamQuery
22
23
  ClientToken = Shapes::StringShape.new(name: 'ClientToken')
23
24
  ColumnInfo = Shapes::StructureShape.new(name: 'ColumnInfo')
24
25
  ColumnInfoList = Shapes::ListShape.new(name: 'ColumnInfoList')
26
+ ComputeMode = Shapes::StringShape.new(name: 'ComputeMode')
25
27
  ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
26
28
  CreateScheduledQueryRequest = Shapes::StructureShape.new(name: 'CreateScheduledQueryRequest')
27
29
  CreateScheduledQueryResponse = Shapes::StructureShape.new(name: 'CreateScheduledQueryResponse')
@@ -47,6 +49,8 @@ module Aws::TimestreamQuery
47
49
  ExecutionStats = Shapes::StructureShape.new(name: 'ExecutionStats')
48
50
  InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
49
51
  InvalidEndpointException = Shapes::StructureShape.new(name: 'InvalidEndpointException')
52
+ LastUpdate = Shapes::StructureShape.new(name: 'LastUpdate')
53
+ LastUpdateStatus = Shapes::StringShape.new(name: 'LastUpdateStatus')
50
54
  ListScheduledQueriesRequest = Shapes::StructureShape.new(name: 'ListScheduledQueriesRequest')
51
55
  ListScheduledQueriesResponse = Shapes::StructureShape.new(name: 'ListScheduledQueriesResponse')
52
56
  ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
@@ -73,6 +77,10 @@ module Aws::TimestreamQuery
73
77
  PartitionKeyList = Shapes::ListShape.new(name: 'PartitionKeyList')
74
78
  PrepareQueryRequest = Shapes::StructureShape.new(name: 'PrepareQueryRequest')
75
79
  PrepareQueryResponse = Shapes::StructureShape.new(name: 'PrepareQueryResponse')
80
+ ProvisionedCapacityRequest = Shapes::StructureShape.new(name: 'ProvisionedCapacityRequest')
81
+ ProvisionedCapacityResponse = Shapes::StructureShape.new(name: 'ProvisionedCapacityResponse')
82
+ QueryComputeRequest = Shapes::StructureShape.new(name: 'QueryComputeRequest')
83
+ QueryComputeResponse = Shapes::StructureShape.new(name: 'QueryComputeResponse')
76
84
  QueryExecutionException = Shapes::StructureShape.new(name: 'QueryExecutionException')
77
85
  QueryId = Shapes::StringShape.new(name: 'QueryId')
78
86
  QueryInsights = Shapes::StructureShape.new(name: 'QueryInsights')
@@ -85,6 +93,7 @@ module Aws::TimestreamQuery
85
93
  QuerySpatialCoverageMax = Shapes::StructureShape.new(name: 'QuerySpatialCoverageMax')
86
94
  QueryStatus = Shapes::StructureShape.new(name: 'QueryStatus')
87
95
  QueryString = Shapes::StringShape.new(name: 'QueryString')
96
+ QueryTCU = Shapes::IntegerShape.new(name: 'QueryTCU')
88
97
  QueryTemporalRange = Shapes::StructureShape.new(name: 'QueryTemporalRange')
89
98
  QueryTemporalRangeMax = Shapes::StructureShape.new(name: 'QueryTemporalRangeMax')
90
99
  ResourceName = Shapes::StringShape.new(name: 'ResourceName')
@@ -148,6 +157,10 @@ module Aws::TimestreamQuery
148
157
  AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: ServiceErrorMessage, location_name: "Message"))
149
158
  AccessDeniedException.struct_class = Types::AccessDeniedException
150
159
 
160
+ AccountSettingsNotificationConfiguration.add_member(:sns_configuration, Shapes::ShapeRef.new(shape: SnsConfiguration, location_name: "SnsConfiguration"))
161
+ AccountSettingsNotificationConfiguration.add_member(:role_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, required: true, location_name: "RoleArn"))
162
+ AccountSettingsNotificationConfiguration.struct_class = Types::AccountSettingsNotificationConfiguration
163
+
151
164
  CancelQueryRequest.add_member(:query_id, Shapes::ShapeRef.new(shape: QueryId, required: true, location_name: "QueryId"))
152
165
  CancelQueryRequest.struct_class = Types::CancelQueryRequest
153
166
 
@@ -194,6 +207,7 @@ module Aws::TimestreamQuery
194
207
 
195
208
  DescribeAccountSettingsResponse.add_member(:max_query_tcu, Shapes::ShapeRef.new(shape: MaxQueryCapacity, location_name: "MaxQueryTCU"))
196
209
  DescribeAccountSettingsResponse.add_member(:query_pricing_model, Shapes::ShapeRef.new(shape: QueryPricingModel, location_name: "QueryPricingModel"))
210
+ DescribeAccountSettingsResponse.add_member(:query_compute, Shapes::ShapeRef.new(shape: QueryComputeResponse, location_name: "QueryCompute"))
197
211
  DescribeAccountSettingsResponse.struct_class = Types::DescribeAccountSettingsResponse
198
212
 
199
213
  DescribeEndpointsRequest.struct_class = Types::DescribeEndpointsRequest
@@ -245,6 +259,11 @@ module Aws::TimestreamQuery
245
259
  InvalidEndpointException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
246
260
  InvalidEndpointException.struct_class = Types::InvalidEndpointException
247
261
 
262
+ LastUpdate.add_member(:target_query_tcu, Shapes::ShapeRef.new(shape: QueryTCU, location_name: "TargetQueryTCU"))
263
+ LastUpdate.add_member(:status, Shapes::ShapeRef.new(shape: LastUpdateStatus, location_name: "Status"))
264
+ LastUpdate.add_member(:status_message, Shapes::ShapeRef.new(shape: String, location_name: "StatusMessage"))
265
+ LastUpdate.struct_class = Types::LastUpdate
266
+
248
267
  ListScheduledQueriesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxScheduledQueriesResults, location_name: "MaxResults"))
249
268
  ListScheduledQueriesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextScheduledQueriesResultsToken, location_name: "NextToken"))
250
269
  ListScheduledQueriesRequest.struct_class = Types::ListScheduledQueriesRequest
@@ -302,6 +321,23 @@ module Aws::TimestreamQuery
302
321
  PrepareQueryResponse.add_member(:parameters, Shapes::ShapeRef.new(shape: ParameterMappingList, required: true, location_name: "Parameters"))
303
322
  PrepareQueryResponse.struct_class = Types::PrepareQueryResponse
304
323
 
324
+ ProvisionedCapacityRequest.add_member(:target_query_tcu, Shapes::ShapeRef.new(shape: QueryTCU, required: true, location_name: "TargetQueryTCU"))
325
+ ProvisionedCapacityRequest.add_member(:notification_configuration, Shapes::ShapeRef.new(shape: AccountSettingsNotificationConfiguration, location_name: "NotificationConfiguration"))
326
+ ProvisionedCapacityRequest.struct_class = Types::ProvisionedCapacityRequest
327
+
328
+ ProvisionedCapacityResponse.add_member(:active_query_tcu, Shapes::ShapeRef.new(shape: QueryTCU, location_name: "ActiveQueryTCU"))
329
+ ProvisionedCapacityResponse.add_member(:notification_configuration, Shapes::ShapeRef.new(shape: AccountSettingsNotificationConfiguration, location_name: "NotificationConfiguration"))
330
+ ProvisionedCapacityResponse.add_member(:last_update, Shapes::ShapeRef.new(shape: LastUpdate, location_name: "LastUpdate"))
331
+ ProvisionedCapacityResponse.struct_class = Types::ProvisionedCapacityResponse
332
+
333
+ QueryComputeRequest.add_member(:compute_mode, Shapes::ShapeRef.new(shape: ComputeMode, location_name: "ComputeMode"))
334
+ QueryComputeRequest.add_member(:provisioned_capacity, Shapes::ShapeRef.new(shape: ProvisionedCapacityRequest, location_name: "ProvisionedCapacity"))
335
+ QueryComputeRequest.struct_class = Types::QueryComputeRequest
336
+
337
+ QueryComputeResponse.add_member(:compute_mode, Shapes::ShapeRef.new(shape: ComputeMode, location_name: "ComputeMode"))
338
+ QueryComputeResponse.add_member(:provisioned_capacity, Shapes::ShapeRef.new(shape: ProvisionedCapacityResponse, location_name: "ProvisionedCapacity"))
339
+ QueryComputeResponse.struct_class = Types::QueryComputeResponse
340
+
305
341
  QueryExecutionException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
306
342
  QueryExecutionException.struct_class = Types::QueryExecutionException
307
343
 
@@ -496,10 +532,12 @@ module Aws::TimestreamQuery
496
532
 
497
533
  UpdateAccountSettingsRequest.add_member(:max_query_tcu, Shapes::ShapeRef.new(shape: MaxQueryCapacity, location_name: "MaxQueryTCU"))
498
534
  UpdateAccountSettingsRequest.add_member(:query_pricing_model, Shapes::ShapeRef.new(shape: QueryPricingModel, location_name: "QueryPricingModel"))
535
+ UpdateAccountSettingsRequest.add_member(:query_compute, Shapes::ShapeRef.new(shape: QueryComputeRequest, location_name: "QueryCompute"))
499
536
  UpdateAccountSettingsRequest.struct_class = Types::UpdateAccountSettingsRequest
500
537
 
501
538
  UpdateAccountSettingsResponse.add_member(:max_query_tcu, Shapes::ShapeRef.new(shape: MaxQueryCapacity, location_name: "MaxQueryTCU"))
502
539
  UpdateAccountSettingsResponse.add_member(:query_pricing_model, Shapes::ShapeRef.new(shape: QueryPricingModel, location_name: "QueryPricingModel"))
540
+ UpdateAccountSettingsResponse.add_member(:query_compute, Shapes::ShapeRef.new(shape: QueryComputeResponse, location_name: "QueryCompute"))
503
541
  UpdateAccountSettingsResponse.struct_class = Types::UpdateAccountSettingsResponse
504
542
 
505
543
  UpdateScheduledQueryRequest.add_member(:scheduled_query_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, required: true, location_name: "ScheduledQueryArn"))
@@ -10,7 +10,8 @@
10
10
  module Aws::TimestreamQuery
11
11
  module Types
12
12
 
13
- # You are not authorized to perform this action.
13
+ # You do not have the necessary permissions to access the account
14
+ # settings.
14
15
  #
15
16
  # @!attribute [rw] message
16
17
  # @return [String]
@@ -23,6 +24,27 @@ module Aws::TimestreamQuery
23
24
  include Aws::Structure
24
25
  end
25
26
 
27
+ # Configuration settings for notifications related to account settings.
28
+ #
29
+ # @!attribute [rw] sns_configuration
30
+ # Details on SNS that are required to send the notification.
31
+ # @return [Types::SnsConfiguration]
32
+ #
33
+ # @!attribute [rw] role_arn
34
+ # An Amazon Resource Name (ARN) that grants Timestream permission to
35
+ # publish notifications. This field is only visible if SNS Topic is
36
+ # provided when updating the account settings.
37
+ # @return [String]
38
+ #
39
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration AWS API Documentation
40
+ #
41
+ class AccountSettingsNotificationConfiguration < Struct.new(
42
+ :sns_configuration,
43
+ :role_arn)
44
+ SENSITIVE = []
45
+ include Aws::Structure
46
+ end
47
+
26
48
  # @!attribute [rw] query_id
27
49
  # The ID of the query that needs to be cancelled. `QueryID` is
28
50
  # returned as part of the query result.
@@ -244,7 +266,11 @@ module Aws::TimestreamQuery
244
266
 
245
267
  # @!attribute [rw] max_query_tcu
246
268
  # The maximum number of [Timestream compute units][1] (TCUs) the
247
- # service will use at any point in time to serve your queries.
269
+ # service will use at any point in time to serve your queries. To run
270
+ # queries, you must set a minimum capacity of 4 TCU. You can set the
271
+ # maximum number of TCU in multiples of 4, for example, 4, 8, 16, 32,
272
+ # and so on. This configuration is applicable only for on-demand usage
273
+ # of (TCUs).
248
274
  #
249
275
  #
250
276
  #
@@ -253,13 +279,25 @@ module Aws::TimestreamQuery
253
279
  #
254
280
  # @!attribute [rw] query_pricing_model
255
281
  # The pricing model for queries in your account.
282
+ #
283
+ # <note markdown="1"> The `QueryPricingModel` parameter is used by several Timestream
284
+ # operations; however, the `UpdateAccountSettings` API operation
285
+ # doesn't recognize any values other than `COMPUTE_UNITS`.
286
+ #
287
+ # </note>
256
288
  # @return [String]
257
289
  #
290
+ # @!attribute [rw] query_compute
291
+ # An object that contains the usage settings for Timestream Compute
292
+ # Units (TCUs) in your account for the query workload.
293
+ # @return [Types::QueryComputeResponse]
294
+ #
258
295
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/DescribeAccountSettingsResponse AWS API Documentation
259
296
  #
260
297
  class DescribeAccountSettingsResponse < Struct.new(
261
298
  :max_query_tcu,
262
- :query_pricing_model)
299
+ :query_pricing_model,
300
+ :query_compute)
263
301
  SENSITIVE = []
264
302
  include Aws::Structure
265
303
  end
@@ -453,8 +491,7 @@ module Aws::TimestreamQuery
453
491
  include Aws::Structure
454
492
  end
455
493
 
456
- # The service was unable to fully process this request because of an
457
- # internal server error.
494
+ # An internal server error occurred while processing the request.
458
495
  #
459
496
  # @!attribute [rw] message
460
497
  # @return [String]
@@ -467,7 +504,7 @@ module Aws::TimestreamQuery
467
504
  include Aws::Structure
468
505
  end
469
506
 
470
- # The requested endpoint was not valid.
507
+ # The requested endpoint is invalid.
471
508
  #
472
509
  # @!attribute [rw] message
473
510
  # @return [String]
@@ -480,6 +517,34 @@ module Aws::TimestreamQuery
480
517
  include Aws::Structure
481
518
  end
482
519
 
520
+ # Configuration object that contains the most recent account settings
521
+ # update, visible only if settings have been updated previously.
522
+ #
523
+ # @!attribute [rw] target_query_tcu
524
+ # The number of TimeStream Compute Units (TCUs) requested in the last
525
+ # account settings update.
526
+ # @return [Integer]
527
+ #
528
+ # @!attribute [rw] status
529
+ # The status of the last update. Can be either `PENDING`, `FAILED`, or
530
+ # `SUCCEEDED`.
531
+ # @return [String]
532
+ #
533
+ # @!attribute [rw] status_message
534
+ # Error message describing the last account settings update status,
535
+ # visible only if an error occurred.
536
+ # @return [String]
537
+ #
538
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/LastUpdate AWS API Documentation
539
+ #
540
+ class LastUpdate < Struct.new(
541
+ :target_query_tcu,
542
+ :status,
543
+ :status_message)
544
+ SENSITIVE = []
545
+ include Aws::Structure
546
+ end
547
+
483
548
  # @!attribute [rw] max_results
484
549
  # The maximum number of items to return in the output. If the total
485
550
  # number of items available is more than the value specified, a
@@ -656,7 +721,9 @@ module Aws::TimestreamQuery
656
721
  # updated or when it is deleted.
657
722
  #
658
723
  # @!attribute [rw] sns_configuration
659
- # Details on SNS configuration.
724
+ # Details about the Amazon Simple Notification Service (SNS)
725
+ # configuration. This field is visible only when SNS Topic is provided
726
+ # when updating the account settings.
660
727
  # @return [Types::SnsConfiguration]
661
728
  #
662
729
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/NotificationConfiguration AWS API Documentation
@@ -733,6 +800,104 @@ module Aws::TimestreamQuery
733
800
  include Aws::Structure
734
801
  end
735
802
 
803
+ # A request to update the provisioned capacity settings for querying
804
+ # data.
805
+ #
806
+ # @!attribute [rw] target_query_tcu
807
+ # The target compute capacity for querying data, specified in
808
+ # Timestream Compute Units (TCUs).
809
+ # @return [Integer]
810
+ #
811
+ # @!attribute [rw] notification_configuration
812
+ # Configuration settings for notifications related to the provisioned
813
+ # capacity update.
814
+ # @return [Types::AccountSettingsNotificationConfiguration]
815
+ #
816
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/ProvisionedCapacityRequest AWS API Documentation
817
+ #
818
+ class ProvisionedCapacityRequest < Struct.new(
819
+ :target_query_tcu,
820
+ :notification_configuration)
821
+ SENSITIVE = []
822
+ include Aws::Structure
823
+ end
824
+
825
+ # The response to a request to update the provisioned capacity settings
826
+ # for querying data.
827
+ #
828
+ # @!attribute [rw] active_query_tcu
829
+ # The number of Timestream Compute Units (TCUs) provisioned in the
830
+ # account. This field is only visible when the compute mode is
831
+ # `PROVISIONED`.
832
+ # @return [Integer]
833
+ #
834
+ # @!attribute [rw] notification_configuration
835
+ # An object that contains settings for notifications that are sent
836
+ # whenever the provisioned capacity settings are modified. This field
837
+ # is only visible when the compute mode is `PROVISIONED`.
838
+ # @return [Types::AccountSettingsNotificationConfiguration]
839
+ #
840
+ # @!attribute [rw] last_update
841
+ # Information about the last update to the provisioned capacity
842
+ # settings.
843
+ # @return [Types::LastUpdate]
844
+ #
845
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/ProvisionedCapacityResponse AWS API Documentation
846
+ #
847
+ class ProvisionedCapacityResponse < Struct.new(
848
+ :active_query_tcu,
849
+ :notification_configuration,
850
+ :last_update)
851
+ SENSITIVE = []
852
+ include Aws::Structure
853
+ end
854
+
855
+ # A request to retrieve or update the compute capacity settings for
856
+ # querying data.
857
+ #
858
+ # @!attribute [rw] compute_mode
859
+ # The mode in which Timestream Compute Units (TCUs) are allocated and
860
+ # utilized within an account. Note that in the Asia Pacific (Mumbai)
861
+ # region, the API operation only recognizes the value `PROVISIONED`.
862
+ # @return [String]
863
+ #
864
+ # @!attribute [rw] provisioned_capacity
865
+ # Configuration object that contains settings for provisioned
866
+ # Timestream Compute Units (TCUs) in your account.
867
+ # @return [Types::ProvisionedCapacityRequest]
868
+ #
869
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/QueryComputeRequest AWS API Documentation
870
+ #
871
+ class QueryComputeRequest < Struct.new(
872
+ :compute_mode,
873
+ :provisioned_capacity)
874
+ SENSITIVE = []
875
+ include Aws::Structure
876
+ end
877
+
878
+ # The response to a request to retrieve or update the compute capacity
879
+ # settings for querying data.
880
+ #
881
+ # @!attribute [rw] compute_mode
882
+ # The mode in which Timestream Compute Units (TCUs) are allocated and
883
+ # utilized within an account. Note that in the Asia Pacific (Mumbai)
884
+ # region, the API operation only recognizes the value `PROVISIONED`.
885
+ # @return [String]
886
+ #
887
+ # @!attribute [rw] provisioned_capacity
888
+ # Configuration object that contains settings for provisioned
889
+ # Timestream Compute Units (TCUs) in your account.
890
+ # @return [Types::ProvisionedCapacityResponse]
891
+ #
892
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/QueryComputeResponse AWS API Documentation
893
+ #
894
+ class QueryComputeResponse < Struct.new(
895
+ :compute_mode,
896
+ :provisioned_capacity)
897
+ SENSITIVE = []
898
+ include Aws::Structure
899
+ end
900
+
736
901
  # Timestream was unable to run the query successfully.
737
902
  #
738
903
  # @!attribute [rw] message
@@ -1653,7 +1818,7 @@ module Aws::TimestreamQuery
1653
1818
  include Aws::Structure
1654
1819
  end
1655
1820
 
1656
- # The request was denied due to request throttling.
1821
+ # The request was throttled due to excessive requests.
1657
1822
  #
1658
1823
  # @!attribute [rw] message
1659
1824
  # @return [String]
@@ -1825,11 +1990,16 @@ module Aws::TimestreamQuery
1825
1990
  # The maximum number of compute units the service will use at any
1826
1991
  # point in time to serve your queries. To run queries, you must set a
1827
1992
  # minimum capacity of 4 TCU. You can set the maximum number of TCU in
1828
- # multiples of 4, for example, 4, 8, 16, 32, and so on.
1993
+ # multiples of 4, for example, 4, 8, 16, 32, and so on. The maximum
1994
+ # value supported for `MaxQueryTCU` is 1000. To request an increase to
1995
+ # this soft limit, contact Amazon Web Services Support. For
1996
+ # information about the default quota for maxQueryTCU, see Default
1997
+ # quotas. This configuration is applicable only for on-demand usage of
1998
+ # Timestream Compute Units (TCUs).
1829
1999
  #
1830
2000
  # The maximum value supported for `MaxQueryTCU` is 1000. To request an
1831
2001
  # increase to this soft limit, contact Amazon Web Services Support.
1832
- # For information about the default quota for maxQueryTCU, see
2002
+ # For information about the default quota for `maxQueryTCU`, see
1833
2003
  # [Default quotas][1].
1834
2004
  #
1835
2005
  #
@@ -1847,11 +2017,23 @@ module Aws::TimestreamQuery
1847
2017
  # </note>
1848
2018
  # @return [String]
1849
2019
  #
2020
+ # @!attribute [rw] query_compute
2021
+ # Modifies the query compute settings configured in your account,
2022
+ # including the query pricing model and provisioned Timestream Compute
2023
+ # Units (TCUs) in your account.
2024
+ #
2025
+ # <note markdown="1"> This API is idempotent, meaning that making the same request
2026
+ # multiple times will have the same effect as making the request once.
2027
+ #
2028
+ # </note>
2029
+ # @return [Types::QueryComputeRequest]
2030
+ #
1850
2031
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/UpdateAccountSettingsRequest AWS API Documentation
1851
2032
  #
1852
2033
  class UpdateAccountSettingsRequest < Struct.new(
1853
2034
  :max_query_tcu,
1854
- :query_pricing_model)
2035
+ :query_pricing_model,
2036
+ :query_compute)
1855
2037
  SENSITIVE = []
1856
2038
  include Aws::Structure
1857
2039
  end
@@ -1865,11 +2047,17 @@ module Aws::TimestreamQuery
1865
2047
  # The pricing model for an account.
1866
2048
  # @return [String]
1867
2049
  #
2050
+ # @!attribute [rw] query_compute
2051
+ # Confirms the updated account settings for querying data in your
2052
+ # account.
2053
+ # @return [Types::QueryComputeResponse]
2054
+ #
1868
2055
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-query-2018-11-01/UpdateAccountSettingsResponse AWS API Documentation
1869
2056
  #
1870
2057
  class UpdateAccountSettingsResponse < Struct.new(
1871
2058
  :max_query_tcu,
1872
- :query_pricing_model)
2059
+ :query_pricing_model,
2060
+ :query_compute)
1873
2061
  SENSITIVE = []
1874
2062
  include Aws::Structure
1875
2063
  end
@@ -54,7 +54,7 @@ module Aws::TimestreamQuery
54
54
  autoload :EndpointProvider, 'aws-sdk-timestreamquery/endpoint_provider'
55
55
  autoload :Endpoints, 'aws-sdk-timestreamquery/endpoints'
56
56
 
57
- GEM_VERSION = '1.46.0'
57
+ GEM_VERSION = '1.48.0'
58
58
 
59
59
  end
60
60
 
data/sig/client.rbs CHANGED
@@ -39,7 +39,9 @@ module Aws
39
39
  ?logger: untyped,
40
40
  ?max_attempts: Integer,
41
41
  ?profile: String,
42
+ ?request_checksum_calculation: String,
42
43
  ?request_min_compression_size_bytes: Integer,
44
+ ?response_checksum_validation: String,
43
45
  ?retry_backoff: Proc,
44
46
  ?retry_base_delay: Float,
45
47
  ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),
@@ -170,6 +172,7 @@ module Aws
170
172
  include ::Seahorse::Client::_ResponseSuccess[Types::DescribeAccountSettingsResponse]
171
173
  def max_query_tcu: () -> ::Integer
172
174
  def query_pricing_model: () -> ("BYTES_SCANNED" | "COMPUTE_UNITS")
175
+ def query_compute: () -> Types::QueryComputeResponse
173
176
  end
174
177
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/TimestreamQuery/Client.html#describe_account_settings-instance_method
175
178
  def describe_account_settings: (
@@ -294,11 +297,24 @@ module Aws
294
297
  include ::Seahorse::Client::_ResponseSuccess[Types::UpdateAccountSettingsResponse]
295
298
  def max_query_tcu: () -> ::Integer
296
299
  def query_pricing_model: () -> ("BYTES_SCANNED" | "COMPUTE_UNITS")
300
+ def query_compute: () -> Types::QueryComputeResponse
297
301
  end
298
302
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/TimestreamQuery/Client.html#update_account_settings-instance_method
299
303
  def update_account_settings: (
300
304
  ?max_query_tcu: ::Integer,
301
- ?query_pricing_model: ("BYTES_SCANNED" | "COMPUTE_UNITS")
305
+ ?query_pricing_model: ("BYTES_SCANNED" | "COMPUTE_UNITS"),
306
+ ?query_compute: {
307
+ compute_mode: ("ON_DEMAND" | "PROVISIONED")?,
308
+ provisioned_capacity: {
309
+ target_query_tcu: ::Integer,
310
+ notification_configuration: {
311
+ sns_configuration: {
312
+ topic_arn: ::String
313
+ }?,
314
+ role_arn: ::String
315
+ }?
316
+ }?
317
+ }
302
318
  ) -> _UpdateAccountSettingsResponseSuccess
303
319
  | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateAccountSettingsResponseSuccess
304
320
 
data/sig/resource.rbs CHANGED
@@ -39,7 +39,9 @@ module Aws
39
39
  ?logger: untyped,
40
40
  ?max_attempts: Integer,
41
41
  ?profile: String,
42
+ ?request_checksum_calculation: String,
42
43
  ?request_min_compression_size_bytes: Integer,
44
+ ?response_checksum_validation: String,
43
45
  ?retry_backoff: Proc,
44
46
  ?retry_base_delay: Float,
45
47
  ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),
data/sig/types.rbs CHANGED
@@ -13,6 +13,12 @@ module Aws::TimestreamQuery
13
13
  SENSITIVE: []
14
14
  end
15
15
 
16
+ class AccountSettingsNotificationConfiguration
17
+ attr_accessor sns_configuration: Types::SnsConfiguration
18
+ attr_accessor role_arn: ::String
19
+ SENSITIVE: []
20
+ end
21
+
16
22
  class CancelQueryRequest
17
23
  attr_accessor query_id: ::String
18
24
  SENSITIVE: []
@@ -73,6 +79,7 @@ module Aws::TimestreamQuery
73
79
  class DescribeAccountSettingsResponse
74
80
  attr_accessor max_query_tcu: ::Integer
75
81
  attr_accessor query_pricing_model: ("BYTES_SCANNED" | "COMPUTE_UNITS")
82
+ attr_accessor query_compute: Types::QueryComputeResponse
76
83
  SENSITIVE: []
77
84
  end
78
85
 
@@ -144,6 +151,13 @@ module Aws::TimestreamQuery
144
151
  SENSITIVE: []
145
152
  end
146
153
 
154
+ class LastUpdate
155
+ attr_accessor target_query_tcu: ::Integer
156
+ attr_accessor status: ("PENDING" | "FAILED" | "SUCCEEDED")
157
+ attr_accessor status_message: ::String
158
+ SENSITIVE: []
159
+ end
160
+
147
161
  class ListScheduledQueriesRequest
148
162
  attr_accessor max_results: ::Integer
149
163
  attr_accessor next_token: ::String
@@ -215,6 +229,31 @@ module Aws::TimestreamQuery
215
229
  SENSITIVE: [:query_string]
216
230
  end
217
231
 
232
+ class ProvisionedCapacityRequest
233
+ attr_accessor target_query_tcu: ::Integer
234
+ attr_accessor notification_configuration: Types::AccountSettingsNotificationConfiguration
235
+ SENSITIVE: []
236
+ end
237
+
238
+ class ProvisionedCapacityResponse
239
+ attr_accessor active_query_tcu: ::Integer
240
+ attr_accessor notification_configuration: Types::AccountSettingsNotificationConfiguration
241
+ attr_accessor last_update: Types::LastUpdate
242
+ SENSITIVE: []
243
+ end
244
+
245
+ class QueryComputeRequest
246
+ attr_accessor compute_mode: ("ON_DEMAND" | "PROVISIONED")
247
+ attr_accessor provisioned_capacity: Types::ProvisionedCapacityRequest
248
+ SENSITIVE: []
249
+ end
250
+
251
+ class QueryComputeResponse
252
+ attr_accessor compute_mode: ("ON_DEMAND" | "PROVISIONED")
253
+ attr_accessor provisioned_capacity: Types::ProvisionedCapacityResponse
254
+ SENSITIVE: []
255
+ end
256
+
218
257
  class QueryExecutionException
219
258
  attr_accessor message: ::String
220
259
  SENSITIVE: []
@@ -464,12 +503,14 @@ module Aws::TimestreamQuery
464
503
  class UpdateAccountSettingsRequest
465
504
  attr_accessor max_query_tcu: ::Integer
466
505
  attr_accessor query_pricing_model: ("BYTES_SCANNED" | "COMPUTE_UNITS")
506
+ attr_accessor query_compute: Types::QueryComputeRequest
467
507
  SENSITIVE: []
468
508
  end
469
509
 
470
510
  class UpdateAccountSettingsResponse
471
511
  attr_accessor max_query_tcu: ::Integer
472
512
  attr_accessor query_pricing_model: ("BYTES_SCANNED" | "COMPUTE_UNITS")
513
+ attr_accessor query_compute: Types::QueryComputeResponse
473
514
  SENSITIVE: []
474
515
  end
475
516
 
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-timestreamquery
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.46.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: 2024-10-22 00:00:00.000000000 Z
11
+ date: 2025-01-15 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.210.0
22
+ version: 3.216.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.210.0
32
+ version: 3.216.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement