aws-sdk-athena 1.8.0 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: f3f05a7acb18b1ee76dfa81d9655f46a47c20839
4
- data.tar.gz: 80399f4c18a7669cf3a4462aa9ee98e4539ae17a
3
+ metadata.gz: b8d603ad65e7a52c3f033efb690041b5836016e3
4
+ data.tar.gz: 148707c10497f347c08035498456f5f3ea95cc7c
5
5
  SHA512:
6
- metadata.gz: 249d007ee5b2c81ef8bf8ba5d4eb64bb75c7f7cc6d451d0ebfa554f54071ffbbf574dfa43d02333d269fcd1dfd55168d899498d4041be1fcb230cc3e50530347
7
- data.tar.gz: ead2cb8ef4ee5bde5e05a1b855b5c385a1b185fd383c662c63878b1382423879c70d7c700e1457772ac4ccf12e81f568818458500747e785b9bd9cfc99de44d9
6
+ metadata.gz: 72277faa382c5f4cb7d690edf7ffe16ce20393d86623e0a65b4f6c80662663f0b3e89d3230a2d5c2d0da762518c558d1b22857cf24c95a177491357d7358e91d
7
+ data.tar.gz: 894cc276be6c6f716dd1b186f9a154345683aa4b80f42d98d23cb93856bcbc84d9634840ef5c501c54a695a578b216f903e27be6fa5edb1c4f56124113525474
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-athena/customizations'
42
42
  # @service
43
43
  module Aws::Athena
44
44
 
45
- GEM_VERSION = '1.8.0'
45
+ GEM_VERSION = '1.9.0'
46
46
 
47
47
  end
@@ -403,6 +403,10 @@ module Aws::Athena
403
403
  # @option params [String] :description
404
404
  # The workgroup description.
405
405
  #
406
+ # @option params [Array<Types::Tag>] :tags
407
+ # One or more tags, separated by commas, that you want to attach to the
408
+ # workgroup as you create it.
409
+ #
406
410
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
407
411
  #
408
412
  # @example Request syntax with placeholder values
@@ -422,6 +426,12 @@ module Aws::Athena
422
426
  # bytes_scanned_cutoff_per_query: 1,
423
427
  # },
424
428
  # description: "WorkGroupDescriptionString",
429
+ # tags: [
430
+ # {
431
+ # key: "TagKey",
432
+ # value: "TagValue",
433
+ # },
434
+ # ],
425
435
  # })
426
436
  #
427
437
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateWorkGroup AWS API Documentation
@@ -629,7 +639,7 @@ module Aws::Athena
629
639
  req.send_request(options)
630
640
  end
631
641
 
632
- # Returns information about the workgroup with the speficied name.
642
+ # Returns information about the workgroup with the specified name.
633
643
  #
634
644
  # @option params [required, String] :work_group
635
645
  # The name of the workgroup.
@@ -764,6 +774,49 @@ module Aws::Athena
764
774
  req.send_request(options)
765
775
  end
766
776
 
777
+ # Lists the tags associated with this workgroup.
778
+ #
779
+ # @option params [required, String] :resource_arn
780
+ # Lists the tags for the workgroup resource with the specified ARN.
781
+ #
782
+ # @option params [String] :next_token
783
+ # The token for the next set of results, or null if there are no
784
+ # additional results for this request, where the request lists the tags
785
+ # for the workgroup resource with the specified ARN.
786
+ #
787
+ # @option params [Integer] :max_results
788
+ # The maximum number of results to be returned per request that lists
789
+ # the tags for the workgroup resource.
790
+ #
791
+ # @return [Types::ListTagsForResourceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
792
+ #
793
+ # * {Types::ListTagsForResourceOutput#tags #tags} => Array&lt;Types::Tag&gt;
794
+ # * {Types::ListTagsForResourceOutput#next_token #next_token} => String
795
+ #
796
+ # @example Request syntax with placeholder values
797
+ #
798
+ # resp = client.list_tags_for_resource({
799
+ # resource_arn: "AmazonResourceName", # required
800
+ # next_token: "Token",
801
+ # max_results: 1,
802
+ # })
803
+ #
804
+ # @example Response structure
805
+ #
806
+ # resp.tags #=> Array
807
+ # resp.tags[0].key #=> String
808
+ # resp.tags[0].value #=> String
809
+ # resp.next_token #=> String
810
+ #
811
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListTagsForResource AWS API Documentation
812
+ #
813
+ # @overload list_tags_for_resource(params = {})
814
+ # @param [Hash] params ({})
815
+ def list_tags_for_resource(params = {}, options = {})
816
+ req = build_request(:list_tags_for_resource, params)
817
+ req.send_request(options)
818
+ end
819
+
767
820
  # Lists available workgroups for the account.
768
821
  #
769
822
  # @option params [String] :next_token
@@ -913,6 +966,85 @@ module Aws::Athena
913
966
  req.send_request(options)
914
967
  end
915
968
 
969
+ # Adds one or more tags to the resource, such as a workgroup. A tag is a
970
+ # label that you assign to an AWS Athena resource (a workgroup). Each
971
+ # tag consists of a key and an optional value, both of which you define.
972
+ # Tags enable you to categorize resources (workgroups) in Athena, for
973
+ # example, by purpose, owner, or environment. Use a consistent set of
974
+ # tag keys to make it easier to search and filter workgroups in your
975
+ # account. For best practices, see [AWS Tagging Strategies][1]. The key
976
+ # length is from 1 (minimum) to 128 (maximum) Unicode characters in
977
+ # UTF-8. The tag value length is from 0 (minimum) to 256 (maximum)
978
+ # Unicode characters in UTF-8. You can use letters and numbers
979
+ # representable in UTF-8, and the following characters: + - = . \_ : /
980
+ # @. Tag keys and values are case-sensitive. Tag keys must be unique per
981
+ # resource. If you specify more than one, separate them by commas.
982
+ #
983
+ #
984
+ #
985
+ # [1]: https://aws.amazon.com/answers/account-management/aws-tagging-strategies/
986
+ #
987
+ # @option params [required, String] :resource_arn
988
+ # Requests that one or more tags are added to the resource (such as a
989
+ # workgroup) for the specified ARN.
990
+ #
991
+ # @option params [required, Array<Types::Tag>] :tags
992
+ # One or more tags, separated by commas, to be added to the resource,
993
+ # such as a workgroup.
994
+ #
995
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
996
+ #
997
+ # @example Request syntax with placeholder values
998
+ #
999
+ # resp = client.tag_resource({
1000
+ # resource_arn: "AmazonResourceName", # required
1001
+ # tags: [ # required
1002
+ # {
1003
+ # key: "TagKey",
1004
+ # value: "TagValue",
1005
+ # },
1006
+ # ],
1007
+ # })
1008
+ #
1009
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/TagResource AWS API Documentation
1010
+ #
1011
+ # @overload tag_resource(params = {})
1012
+ # @param [Hash] params ({})
1013
+ def tag_resource(params = {}, options = {})
1014
+ req = build_request(:tag_resource, params)
1015
+ req.send_request(options)
1016
+ end
1017
+
1018
+ # Removes one or more tags from the workgroup resource. Takes as an
1019
+ # input a list of TagKey Strings separated by commas, and removes their
1020
+ # tags at the same time.
1021
+ #
1022
+ # @option params [required, String] :resource_arn
1023
+ # Removes one or more tags from the workgroup resource for the specified
1024
+ # ARN.
1025
+ #
1026
+ # @option params [required, Array<String>] :tag_keys
1027
+ # Removes the tags associated with one or more tag keys from the
1028
+ # workgroup resource.
1029
+ #
1030
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1031
+ #
1032
+ # @example Request syntax with placeholder values
1033
+ #
1034
+ # resp = client.untag_resource({
1035
+ # resource_arn: "AmazonResourceName", # required
1036
+ # tag_keys: ["TagKey"], # required
1037
+ # })
1038
+ #
1039
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UntagResource AWS API Documentation
1040
+ #
1041
+ # @overload untag_resource(params = {})
1042
+ # @param [Hash] params ({})
1043
+ def untag_resource(params = {}, options = {})
1044
+ req = build_request(:untag_resource, params)
1045
+ req.send_request(options)
1046
+ end
1047
+
916
1048
  # Updates the workgroup with the specified name. The workgroup's name
917
1049
  # cannot be changed.
918
1050
  #
@@ -976,7 +1108,7 @@ module Aws::Athena
976
1108
  params: params,
977
1109
  config: config)
978
1110
  context[:gem_name] = 'aws-sdk-athena'
979
- context[:gem_version] = '1.8.0'
1111
+ context[:gem_version] = '1.9.0'
980
1112
  Seahorse::Client::Request.new(handlers, context)
981
1113
  end
982
1114
 
@@ -11,6 +11,7 @@ module Aws::Athena
11
11
 
12
12
  include Seahorse::Model
13
13
 
14
+ AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
14
15
  BatchGetNamedQueryInput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryInput')
15
16
  BatchGetNamedQueryOutput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryOutput')
16
17
  BatchGetQueryExecutionInput = Shapes::StructureShape.new(name: 'BatchGetQueryExecutionInput')
@@ -53,12 +54,15 @@ module Aws::Athena
53
54
  ListNamedQueriesOutput = Shapes::StructureShape.new(name: 'ListNamedQueriesOutput')
54
55
  ListQueryExecutionsInput = Shapes::StructureShape.new(name: 'ListQueryExecutionsInput')
55
56
  ListQueryExecutionsOutput = Shapes::StructureShape.new(name: 'ListQueryExecutionsOutput')
57
+ ListTagsForResourceInput = Shapes::StructureShape.new(name: 'ListTagsForResourceInput')
58
+ ListTagsForResourceOutput = Shapes::StructureShape.new(name: 'ListTagsForResourceOutput')
56
59
  ListWorkGroupsInput = Shapes::StructureShape.new(name: 'ListWorkGroupsInput')
57
60
  ListWorkGroupsOutput = Shapes::StructureShape.new(name: 'ListWorkGroupsOutput')
58
61
  Long = Shapes::IntegerShape.new(name: 'Long')
59
62
  MaxNamedQueriesCount = Shapes::IntegerShape.new(name: 'MaxNamedQueriesCount')
60
63
  MaxQueryExecutionsCount = Shapes::IntegerShape.new(name: 'MaxQueryExecutionsCount')
61
64
  MaxQueryResults = Shapes::IntegerShape.new(name: 'MaxQueryResults')
65
+ MaxTagsCount = Shapes::IntegerShape.new(name: 'MaxTagsCount')
62
66
  MaxWorkGroupsCount = Shapes::IntegerShape.new(name: 'MaxWorkGroupsCount')
63
67
  NameString = Shapes::StringShape.new(name: 'NameString')
64
68
  NamedQuery = Shapes::StructureShape.new(name: 'NamedQuery')
@@ -74,6 +78,7 @@ module Aws::Athena
74
78
  QueryExecutionStatistics = Shapes::StructureShape.new(name: 'QueryExecutionStatistics')
75
79
  QueryExecutionStatus = Shapes::StructureShape.new(name: 'QueryExecutionStatus')
76
80
  QueryString = Shapes::StringShape.new(name: 'QueryString')
81
+ ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
77
82
  ResultConfiguration = Shapes::StructureShape.new(name: 'ResultConfiguration')
78
83
  ResultConfigurationUpdates = Shapes::StructureShape.new(name: 'ResultConfigurationUpdates')
79
84
  ResultSet = Shapes::StructureShape.new(name: 'ResultSet')
@@ -86,6 +91,13 @@ module Aws::Athena
86
91
  StopQueryExecutionInput = Shapes::StructureShape.new(name: 'StopQueryExecutionInput')
87
92
  StopQueryExecutionOutput = Shapes::StructureShape.new(name: 'StopQueryExecutionOutput')
88
93
  String = Shapes::StringShape.new(name: 'String')
94
+ Tag = Shapes::StructureShape.new(name: 'Tag')
95
+ TagKey = Shapes::StringShape.new(name: 'TagKey')
96
+ TagKeyList = Shapes::ListShape.new(name: 'TagKeyList')
97
+ TagList = Shapes::ListShape.new(name: 'TagList')
98
+ TagResourceInput = Shapes::StructureShape.new(name: 'TagResourceInput')
99
+ TagResourceOutput = Shapes::StructureShape.new(name: 'TagResourceOutput')
100
+ TagValue = Shapes::StringShape.new(name: 'TagValue')
89
101
  ThrottleReason = Shapes::StringShape.new(name: 'ThrottleReason')
90
102
  Token = Shapes::StringShape.new(name: 'Token')
91
103
  TooManyRequestsException = Shapes::StructureShape.new(name: 'TooManyRequestsException')
@@ -93,6 +105,8 @@ module Aws::Athena
93
105
  UnprocessedNamedQueryIdList = Shapes::ListShape.new(name: 'UnprocessedNamedQueryIdList')
94
106
  UnprocessedQueryExecutionId = Shapes::StructureShape.new(name: 'UnprocessedQueryExecutionId')
95
107
  UnprocessedQueryExecutionIdList = Shapes::ListShape.new(name: 'UnprocessedQueryExecutionIdList')
108
+ UntagResourceInput = Shapes::StructureShape.new(name: 'UntagResourceInput')
109
+ UntagResourceOutput = Shapes::StructureShape.new(name: 'UntagResourceOutput')
96
110
  UpdateWorkGroupInput = Shapes::StructureShape.new(name: 'UpdateWorkGroupInput')
97
111
  UpdateWorkGroupOutput = Shapes::StructureShape.new(name: 'UpdateWorkGroupOutput')
98
112
  WorkGroup = Shapes::StructureShape.new(name: 'WorkGroup')
@@ -148,6 +162,7 @@ module Aws::Athena
148
162
  CreateWorkGroupInput.add_member(:name, Shapes::ShapeRef.new(shape: WorkGroupName, required: true, location_name: "Name"))
149
163
  CreateWorkGroupInput.add_member(:configuration, Shapes::ShapeRef.new(shape: WorkGroupConfiguration, location_name: "Configuration"))
150
164
  CreateWorkGroupInput.add_member(:description, Shapes::ShapeRef.new(shape: WorkGroupDescriptionString, location_name: "Description"))
165
+ CreateWorkGroupInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
151
166
  CreateWorkGroupInput.struct_class = Types::CreateWorkGroupInput
152
167
 
153
168
  CreateWorkGroupOutput.struct_class = Types::CreateWorkGroupOutput
@@ -216,6 +231,15 @@ module Aws::Athena
216
231
  ListQueryExecutionsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
217
232
  ListQueryExecutionsOutput.struct_class = Types::ListQueryExecutionsOutput
218
233
 
234
+ ListTagsForResourceInput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, required: true, location_name: "ResourceARN"))
235
+ ListTagsForResourceInput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
236
+ ListTagsForResourceInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxTagsCount, location_name: "MaxResults"))
237
+ ListTagsForResourceInput.struct_class = Types::ListTagsForResourceInput
238
+
239
+ ListTagsForResourceOutput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
240
+ ListTagsForResourceOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
241
+ ListTagsForResourceOutput.struct_class = Types::ListTagsForResourceOutput
242
+
219
243
  ListWorkGroupsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
220
244
  ListWorkGroupsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxWorkGroupsCount, location_name: "MaxResults"))
221
245
  ListWorkGroupsInput.struct_class = Types::ListWorkGroupsInput
@@ -300,6 +324,20 @@ module Aws::Athena
300
324
 
301
325
  StopQueryExecutionOutput.struct_class = Types::StopQueryExecutionOutput
302
326
 
327
+ Tag.add_member(:key, Shapes::ShapeRef.new(shape: TagKey, location_name: "Key"))
328
+ Tag.add_member(:value, Shapes::ShapeRef.new(shape: TagValue, location_name: "Value"))
329
+ Tag.struct_class = Types::Tag
330
+
331
+ TagKeyList.member = Shapes::ShapeRef.new(shape: TagKey)
332
+
333
+ TagList.member = Shapes::ShapeRef.new(shape: Tag)
334
+
335
+ TagResourceInput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, required: true, location_name: "ResourceARN"))
336
+ TagResourceInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, required: true, location_name: "Tags"))
337
+ TagResourceInput.struct_class = Types::TagResourceInput
338
+
339
+ TagResourceOutput.struct_class = Types::TagResourceOutput
340
+
303
341
  UnprocessedNamedQueryId.add_member(:named_query_id, Shapes::ShapeRef.new(shape: NamedQueryId, location_name: "NamedQueryId"))
304
342
  UnprocessedNamedQueryId.add_member(:error_code, Shapes::ShapeRef.new(shape: ErrorCode, location_name: "ErrorCode"))
305
343
  UnprocessedNamedQueryId.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "ErrorMessage"))
@@ -314,6 +352,12 @@ module Aws::Athena
314
352
 
315
353
  UnprocessedQueryExecutionIdList.member = Shapes::ShapeRef.new(shape: UnprocessedQueryExecutionId)
316
354
 
355
+ UntagResourceInput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, required: true, location_name: "ResourceARN"))
356
+ UntagResourceInput.add_member(:tag_keys, Shapes::ShapeRef.new(shape: TagKeyList, required: true, location_name: "TagKeys"))
357
+ UntagResourceInput.struct_class = Types::UntagResourceInput
358
+
359
+ UntagResourceOutput.struct_class = Types::UntagResourceOutput
360
+
317
361
  UpdateWorkGroupInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, required: true, location_name: "WorkGroup"))
318
362
  UpdateWorkGroupInput.add_member(:description, Shapes::ShapeRef.new(shape: WorkGroupDescriptionString, location_name: "Description"))
319
363
  UpdateWorkGroupInput.add_member(:configuration_updates, Shapes::ShapeRef.new(shape: WorkGroupConfigurationUpdates, location_name: "ConfigurationUpdates"))
@@ -508,6 +552,17 @@ module Aws::Athena
508
552
  )
509
553
  end)
510
554
 
555
+ api.add_operation(:list_tags_for_resource, Seahorse::Model::Operation.new.tap do |o|
556
+ o.name = "ListTagsForResource"
557
+ o.http_method = "POST"
558
+ o.http_request_uri = "/"
559
+ o.input = Shapes::ShapeRef.new(shape: ListTagsForResourceInput)
560
+ o.output = Shapes::ShapeRef.new(shape: ListTagsForResourceOutput)
561
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
562
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
563
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
564
+ end)
565
+
511
566
  api.add_operation(:list_work_groups, Seahorse::Model::Operation.new.tap do |o|
512
567
  o.name = "ListWorkGroups"
513
568
  o.http_method = "POST"
@@ -545,6 +600,28 @@ module Aws::Athena
545
600
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
546
601
  end)
547
602
 
603
+ api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|
604
+ o.name = "TagResource"
605
+ o.http_method = "POST"
606
+ o.http_request_uri = "/"
607
+ o.input = Shapes::ShapeRef.new(shape: TagResourceInput)
608
+ o.output = Shapes::ShapeRef.new(shape: TagResourceOutput)
609
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
610
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
611
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
612
+ end)
613
+
614
+ api.add_operation(:untag_resource, Seahorse::Model::Operation.new.tap do |o|
615
+ o.name = "UntagResource"
616
+ o.http_method = "POST"
617
+ o.http_request_uri = "/"
618
+ o.input = Shapes::ShapeRef.new(shape: UntagResourceInput)
619
+ o.output = Shapes::ShapeRef.new(shape: UntagResourceOutput)
620
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
621
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
622
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
623
+ end)
624
+
548
625
  api.add_operation(:update_work_group, Seahorse::Model::Operation.new.tap do |o|
549
626
  o.name = "UpdateWorkGroup"
550
627
  o.http_method = "POST"
@@ -225,6 +225,12 @@ module Aws::Athena
225
225
  # bytes_scanned_cutoff_per_query: 1,
226
226
  # },
227
227
  # description: "WorkGroupDescriptionString",
228
+ # tags: [
229
+ # {
230
+ # key: "TagKey",
231
+ # value: "TagValue",
232
+ # },
233
+ # ],
228
234
  # }
229
235
  #
230
236
  # @!attribute [rw] name
@@ -247,12 +253,18 @@ module Aws::Athena
247
253
  # The workgroup description.
248
254
  # @return [String]
249
255
  #
256
+ # @!attribute [rw] tags
257
+ # One or more tags, separated by commas, that you want to attach to
258
+ # the workgroup as you create it.
259
+ # @return [Array<Types::Tag>]
260
+ #
250
261
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateWorkGroupInput AWS API Documentation
251
262
  #
252
263
  class CreateWorkGroupInput < Struct.new(
253
264
  :name,
254
265
  :configuration,
255
- :description)
266
+ :description,
267
+ :tags)
256
268
  include Aws::Structure
257
269
  end
258
270
 
@@ -596,6 +608,55 @@ module Aws::Athena
596
608
  include Aws::Structure
597
609
  end
598
610
 
611
+ # @note When making an API call, you may pass ListTagsForResourceInput
612
+ # data as a hash:
613
+ #
614
+ # {
615
+ # resource_arn: "AmazonResourceName", # required
616
+ # next_token: "Token",
617
+ # max_results: 1,
618
+ # }
619
+ #
620
+ # @!attribute [rw] resource_arn
621
+ # Lists the tags for the workgroup resource with the specified ARN.
622
+ # @return [String]
623
+ #
624
+ # @!attribute [rw] next_token
625
+ # The token for the next set of results, or null if there are no
626
+ # additional results for this request, where the request lists the
627
+ # tags for the workgroup resource with the specified ARN.
628
+ # @return [String]
629
+ #
630
+ # @!attribute [rw] max_results
631
+ # The maximum number of results to be returned per request that lists
632
+ # the tags for the workgroup resource.
633
+ # @return [Integer]
634
+ #
635
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListTagsForResourceInput AWS API Documentation
636
+ #
637
+ class ListTagsForResourceInput < Struct.new(
638
+ :resource_arn,
639
+ :next_token,
640
+ :max_results)
641
+ include Aws::Structure
642
+ end
643
+
644
+ # @!attribute [rw] tags
645
+ # The list of tags associated with this workgroup.
646
+ # @return [Array<Types::Tag>]
647
+ #
648
+ # @!attribute [rw] next_token
649
+ # A token to be used by the next request if this request is truncated.
650
+ # @return [String]
651
+ #
652
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListTagsForResourceOutput AWS API Documentation
653
+ #
654
+ class ListTagsForResourceOutput < Struct.new(
655
+ :tags,
656
+ :next_token)
657
+ include Aws::Structure
658
+ end
659
+
599
660
  # @note When making an API call, you may pass ListWorkGroupsInput
600
661
  # data as a hash:
601
662
  #
@@ -1096,6 +1157,83 @@ module Aws::Athena
1096
1157
  #
1097
1158
  class StopQueryExecutionOutput < Aws::EmptyStructure; end
1098
1159
 
1160
+ # A tag that you can add to a resource. A tag is a label that you assign
1161
+ # to an AWS Athena resource (a workgroup). Each tag consists of a key
1162
+ # and an optional value, both of which you define. Tags enable you to
1163
+ # categorize workgroups in Athena, for example, by purpose, owner, or
1164
+ # environment. Use a consistent set of tag keys to make it easier to
1165
+ # search and filter workgroups in your account. The maximum tag key
1166
+ # length is 128 Unicode characters in UTF-8. The maximum tag value
1167
+ # length is 256 Unicode characters in UTF-8. You can use letters and
1168
+ # numbers representable in UTF-8, and the following characters: + - = .
1169
+ # \_ : / @. Tag keys and values are case-sensitive. Tag keys must be
1170
+ # unique per resource.
1171
+ #
1172
+ # @note When making an API call, you may pass Tag
1173
+ # data as a hash:
1174
+ #
1175
+ # {
1176
+ # key: "TagKey",
1177
+ # value: "TagValue",
1178
+ # }
1179
+ #
1180
+ # @!attribute [rw] key
1181
+ # A tag key. The tag key length is from 1 to 128 Unicode characters in
1182
+ # UTF-8. You can use letters and numbers representable in UTF-8, and
1183
+ # the following characters: + - = . \_ : / @. Tag keys are
1184
+ # case-sensitive and must be unique per resource.
1185
+ # @return [String]
1186
+ #
1187
+ # @!attribute [rw] value
1188
+ # A tag value. The tag value length is from 0 to 256 Unicode
1189
+ # characters in UTF-8. You can use letters and numbers representable
1190
+ # in UTF-8, and the following characters: + - = . \_ : / @. Tag values
1191
+ # are case-sensitive.
1192
+ # @return [String]
1193
+ #
1194
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/Tag AWS API Documentation
1195
+ #
1196
+ class Tag < Struct.new(
1197
+ :key,
1198
+ :value)
1199
+ include Aws::Structure
1200
+ end
1201
+
1202
+ # @note When making an API call, you may pass TagResourceInput
1203
+ # data as a hash:
1204
+ #
1205
+ # {
1206
+ # resource_arn: "AmazonResourceName", # required
1207
+ # tags: [ # required
1208
+ # {
1209
+ # key: "TagKey",
1210
+ # value: "TagValue",
1211
+ # },
1212
+ # ],
1213
+ # }
1214
+ #
1215
+ # @!attribute [rw] resource_arn
1216
+ # Requests that one or more tags are added to the resource (such as a
1217
+ # workgroup) for the specified ARN.
1218
+ # @return [String]
1219
+ #
1220
+ # @!attribute [rw] tags
1221
+ # One or more tags, separated by commas, to be added to the resource,
1222
+ # such as a workgroup.
1223
+ # @return [Array<Types::Tag>]
1224
+ #
1225
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/TagResourceInput AWS API Documentation
1226
+ #
1227
+ class TagResourceInput < Struct.new(
1228
+ :resource_arn,
1229
+ :tags)
1230
+ include Aws::Structure
1231
+ end
1232
+
1233
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/TagResourceOutput AWS API Documentation
1234
+ #
1235
+ class TagResourceOutput < Aws::EmptyStructure; end
1236
+
1099
1237
  # Information about a named query ID that could not be processed.
1100
1238
  #
1101
1239
  # @!attribute [rw] named_query_id
@@ -1146,6 +1284,36 @@ module Aws::Athena
1146
1284
  include Aws::Structure
1147
1285
  end
1148
1286
 
1287
+ # @note When making an API call, you may pass UntagResourceInput
1288
+ # data as a hash:
1289
+ #
1290
+ # {
1291
+ # resource_arn: "AmazonResourceName", # required
1292
+ # tag_keys: ["TagKey"], # required
1293
+ # }
1294
+ #
1295
+ # @!attribute [rw] resource_arn
1296
+ # Removes one or more tags from the workgroup resource for the
1297
+ # specified ARN.
1298
+ # @return [String]
1299
+ #
1300
+ # @!attribute [rw] tag_keys
1301
+ # Removes the tags associated with one or more tag keys from the
1302
+ # workgroup resource.
1303
+ # @return [Array<String>]
1304
+ #
1305
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UntagResourceInput AWS API Documentation
1306
+ #
1307
+ class UntagResourceInput < Struct.new(
1308
+ :resource_arn,
1309
+ :tag_keys)
1310
+ include Aws::Structure
1311
+ end
1312
+
1313
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UntagResourceOutput AWS API Documentation
1314
+ #
1315
+ class UntagResourceOutput < Aws::EmptyStructure; end
1316
+
1149
1317
  # @note When making an API call, you may pass UpdateWorkGroupInput
1150
1318
  # data as a hash:
1151
1319
  #
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.8.0
4
+ version: 1.9.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: 2019-02-18 00:00:00.000000000 Z
11
+ date: 2019-02-22 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core