aws-sdk-resourcegroupstaggingapi 1.32.0 → 1.37.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +251 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-resourcegroupstaggingapi.rb +2 -2
- data/lib/aws-sdk-resourcegroupstaggingapi/client.rb +176 -129
- data/lib/aws-sdk-resourcegroupstaggingapi/client_api.rb +9 -5
- data/lib/aws-sdk-resourcegroupstaggingapi/errors.rb +1 -1
- data/lib/aws-sdk-resourcegroupstaggingapi/resource.rb +1 -1
- data/lib/aws-sdk-resourcegroupstaggingapi/types.rb +148 -120
- metadata +8 -5
data/VERSION
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
1.37.0
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-resourcegroupstaggingapi/customizations'
|
|
48
48
|
# @!group service
|
49
49
|
module Aws::ResourceGroupsTaggingAPI
|
50
50
|
|
51
|
-
GEM_VERSION = '1.
|
51
|
+
GEM_VERSION = '1.37.0'
|
52
52
|
|
53
53
|
end
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -339,7 +339,7 @@ module Aws::ResourceGroupsTaggingAPI
|
|
339
339
|
|
340
340
|
# Describes the status of the `StartReportCreation` operation.
|
341
341
|
#
|
342
|
-
# You can call this operation only from the organization's
|
342
|
+
# You can call this operation only from the organization's management
|
343
343
|
# account and from the us-east-1 Region.
|
344
344
|
#
|
345
345
|
# @return [Types::DescribeReportCreationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
@@ -369,30 +369,39 @@ module Aws::ResourceGroupsTaggingAPI
|
|
369
369
|
# For more information on tag policies, see [Tag Policies][1] in the
|
370
370
|
# *AWS Organizations User Guide.*
|
371
371
|
#
|
372
|
-
# You can call this operation only from the organization's
|
372
|
+
# You can call this operation only from the organization's management
|
373
373
|
# account and from the us-east-1 Region.
|
374
374
|
#
|
375
|
+
# This operation supports pagination, where the response can be sent in
|
376
|
+
# multiple pages. You should check the `PaginationToken` response
|
377
|
+
# parameter to determine if there are additional results available to
|
378
|
+
# return. Repeat the query, passing the `PaginationToken` response
|
379
|
+
# parameter value as an input to the next request until you recieve a
|
380
|
+
# `null` value. A null value for `PaginationToken` indicates that there
|
381
|
+
# are no more results waiting to be returned.
|
375
382
|
#
|
376
383
|
#
|
377
|
-
#
|
384
|
+
#
|
385
|
+
# [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
|
378
386
|
#
|
379
387
|
# @option params [Array<String>] :target_id_filters
|
380
|
-
#
|
381
|
-
# output by. If you use this parameter, the count of returned
|
388
|
+
# Specifies target identifiers (usually, specific account IDs) to limit
|
389
|
+
# the output by. If you use this parameter, the count of returned
|
382
390
|
# noncompliant resources includes only resources with the specified
|
383
391
|
# target IDs.
|
384
392
|
#
|
385
393
|
# @option params [Array<String>] :region_filters
|
386
|
-
#
|
387
|
-
# the count of returned noncompliant resources includes
|
388
|
-
# in the specified Regions.
|
394
|
+
# Specifies a list of AWS Regions to limit the output by. If you use
|
395
|
+
# this parameter, the count of returned noncompliant resources includes
|
396
|
+
# only resources in the specified Regions.
|
389
397
|
#
|
390
398
|
# @option params [Array<String>] :resource_type_filters
|
391
|
-
#
|
392
|
-
# each resource type is
|
393
|
-
# specifying a resource type of
|
394
|
-
# (which includes EC2 instances).
|
395
|
-
# `ec2:instance` returns only EC2
|
399
|
+
# Specifies that you want the response to include information for only
|
400
|
+
# resources of the specified types. The format of each resource type is
|
401
|
+
# `service[:resourceType]`. For example, specifying a resource type of
|
402
|
+
# `ec2` returns all Amazon EC2 resources (which includes EC2 instances).
|
403
|
+
# Specifying a resource type of `ec2:instance` returns only EC2
|
404
|
+
# instances.
|
396
405
|
#
|
397
406
|
# The string for each service name and resource type is the same as that
|
398
407
|
# embedded in a resource's Amazon Resource Name (ARN). Consult the *AWS
|
@@ -405,34 +414,37 @@ module Aws::ResourceGroupsTaggingAPI
|
|
405
414
|
# * For more information about ARNs, see [Amazon Resource Names (ARNs)
|
406
415
|
# and AWS Service Namespaces][3].
|
407
416
|
#
|
408
|
-
# You can specify multiple resource types by using
|
409
|
-
# can include up to 100 items. Note that the length
|
410
|
-
# requirement applies to each resource type filter.
|
417
|
+
# You can specify multiple resource types by using a comma separated
|
418
|
+
# array. The array can include up to 100 items. Note that the length
|
419
|
+
# constraint requirement applies to each resource type filter.
|
411
420
|
#
|
412
421
|
#
|
413
422
|
#
|
414
|
-
# [1]:
|
415
|
-
# [2]:
|
416
|
-
# [3]:
|
423
|
+
# [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces
|
424
|
+
# [2]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax
|
425
|
+
# [3]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
|
417
426
|
#
|
418
427
|
# @option params [Array<String>] :tag_key_filters
|
419
|
-
#
|
420
|
-
# the
|
421
|
-
#
|
428
|
+
# Specifies that you want the response to include information for only
|
429
|
+
# resources that have tags with the specified tag keys. If you use this
|
430
|
+
# parameter, the count of returned noncompliant resources includes only
|
431
|
+
# resources that have the specified tag keys.
|
422
432
|
#
|
423
433
|
# @option params [Array<String>] :group_by
|
424
|
-
#
|
425
|
-
# If supplied, the counts are sorted by those attributes.
|
434
|
+
# Specifies a list of attributes to group the counts of noncompliant
|
435
|
+
# resources by. If supplied, the counts are sorted by those attributes.
|
426
436
|
#
|
427
437
|
# @option params [Integer] :max_results
|
428
|
-
#
|
429
|
-
#
|
438
|
+
# Specifies the maximum number of results to be returned in each page. A
|
439
|
+
# query can return fewer than this maximum, even if there are more
|
440
|
+
# results still to return. You should always check the `PaginationToken`
|
441
|
+
# response value to see if there are more results. You can specify a
|
442
|
+
# minimum of 1 and a maximum value of 100.
|
430
443
|
#
|
431
444
|
# @option params [String] :pagination_token
|
432
|
-
#
|
433
|
-
#
|
434
|
-
#
|
435
|
-
# additional page of data.
|
445
|
+
# Specifies a `PaginationToken` response value from a previous request
|
446
|
+
# to indicate that you want the next page of results. Leave this
|
447
|
+
# parameter empty in your initial request.
|
436
448
|
#
|
437
449
|
# @return [Types::GetComplianceSummaryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
438
450
|
#
|
@@ -487,77 +499,77 @@ module Aws::ResourceGroupsTaggingAPI
|
|
487
499
|
# policy. For more information on tag policies, see [Tag Policies][1]
|
488
500
|
# in the *AWS Organizations User Guide.*
|
489
501
|
#
|
490
|
-
#
|
491
|
-
#
|
492
|
-
#
|
493
|
-
#
|
502
|
+
# This operation supports pagination, where the response can be sent in
|
503
|
+
# multiple pages. You should check the `PaginationToken` response
|
504
|
+
# parameter to determine if there are additional results available to
|
505
|
+
# return. Repeat the query, passing the `PaginationToken` response
|
506
|
+
# parameter value as an input to the next request until you recieve a
|
507
|
+
# `null` value. A null value for `PaginationToken` indicates that there
|
508
|
+
# are no more results waiting to be returned.
|
494
509
|
#
|
495
|
-
# </note>
|
496
510
|
#
|
497
511
|
#
|
498
|
-
#
|
499
|
-
# [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
|
512
|
+
# [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
|
500
513
|
#
|
501
514
|
# @option params [String] :pagination_token
|
502
|
-
#
|
503
|
-
#
|
504
|
-
#
|
505
|
-
# additional page of data.
|
515
|
+
# Specifies a `PaginationToken` response value from a previous request
|
516
|
+
# to indicate that you want the next page of results. Leave this
|
517
|
+
# parameter empty in your initial request.
|
506
518
|
#
|
507
519
|
# @option params [Array<Types::TagFilter>] :tag_filters
|
508
|
-
#
|
509
|
-
#
|
510
|
-
#
|
520
|
+
# Specifies a list of TagFilters (keys and values) to restrict the
|
521
|
+
# output to only those resources that have the specified tag and, if
|
522
|
+
# included, the specified value. Each `TagFilter` must contain a key
|
523
|
+
# with values optional. A request can include up to 50 keys, and each
|
524
|
+
# key can include up to 20 values.
|
511
525
|
#
|
512
526
|
# Note the following when deciding how to use TagFilters:
|
513
527
|
#
|
514
|
-
# * If you *
|
515
|
-
# resources that are currently
|
516
|
-
#
|
517
|
-
#
|
518
|
-
# resources that were ever associated with tags. Resources that
|
519
|
-
# currently don't have associated tags are shown with an empty tag
|
520
|
-
# set, like this: `"Tags": []`.
|
528
|
+
# * If you *don't* specify a `TagFilter`, the response includes all
|
529
|
+
# resources that are currently tagged or ever had a tag. Resources
|
530
|
+
# that currently don't have tags are shown with an empty tag set,
|
531
|
+
# like this: `"Tags": []`.
|
521
532
|
#
|
522
533
|
# * If you specify more than one filter in a single request, the
|
523
|
-
# response returns only those resources that satisfy all
|
524
|
-
# filters.
|
534
|
+
# response returns only those resources that satisfy all filters.
|
525
535
|
#
|
526
536
|
# * If you specify a filter that contains more than one value for a key,
|
527
537
|
# the response returns resources that match any of the specified
|
528
538
|
# values for that key.
|
529
539
|
#
|
530
540
|
# * If you don't specify any values for a key, the response returns
|
531
|
-
# resources that are tagged with that key
|
541
|
+
# resources that are tagged with that key and any or no value.
|
532
542
|
#
|
533
|
-
# For example, for filters: filter1
|
534
|
-
#
|
535
|
-
#
|
543
|
+
# For example, for the following filters: `filter1=
|
544
|
+
# \{keyA,\{value1\}\}`, `filter2=\{keyB,\{value2,value3,value4\}\}`,
|
545
|
+
# `filter3= \{keyC\}`\:
|
536
546
|
#
|
537
|
-
# * GetResources(
|
538
|
-
# key1=value1
|
547
|
+
# * `GetResources(\{filter1\})` returns resources tagged with
|
548
|
+
# `key1=value1`
|
539
549
|
#
|
540
|
-
# * GetResources(
|
541
|
-
# key2=value2 or key2=value3 or key2=value4
|
550
|
+
# * `GetResources(\{filter2\})` returns resources tagged with
|
551
|
+
# `key2=value2` or `key2=value3` or `key2=value4`
|
542
552
|
#
|
543
|
-
# * GetResources(
|
544
|
-
#
|
553
|
+
# * `GetResources(\{filter3\})` returns resources tagged with any tag
|
554
|
+
# with the key `key3`, and with any or no value
|
545
555
|
#
|
546
|
-
# * GetResources(
|
547
|
-
# tagged with (
|
548
|
-
# key2=value4) and (key3,
|
556
|
+
# * `GetResources(\{filter1,filter2,filter3\})` returns resources
|
557
|
+
# tagged with `(key1=value1) and (key2=value2 or key2=value3 or
|
558
|
+
# key2=value4) and (key3, any or no value)`
|
549
559
|
#
|
550
560
|
# @option params [Integer] :resources_per_page
|
551
|
-
#
|
552
|
-
#
|
553
|
-
#
|
561
|
+
# Specifies the maximum number of results to be returned in each page. A
|
562
|
+
# query can return fewer than this maximum, even if there are more
|
563
|
+
# results still to return. You should always check the `PaginationToken`
|
564
|
+
# response value to see if there are more results. You can specify a
|
565
|
+
# minimum of 1 and a maximum value of 100.
|
554
566
|
#
|
555
567
|
# @option params [Integer] :tags_per_page
|
556
568
|
# AWS recommends using `ResourcesPerPage` instead of this parameter.
|
557
569
|
#
|
558
570
|
# A limit that restricts the number of tags (key and value pairs)
|
559
|
-
# returned by GetResources in paginated output. A resource with no
|
560
|
-
# is counted as having one tag (one key and value pair).
|
571
|
+
# returned by `GetResources` in paginated output. A resource with no
|
572
|
+
# tags is counted as having one tag (one key and value pair).
|
561
573
|
#
|
562
574
|
# `GetResources` does not split a resource and its associated tags
|
563
575
|
# across pages. If the specified `TagsPerPage` would cause such a break,
|
@@ -570,26 +582,22 @@ module Aws::ResourceGroupsTaggingAPI
|
|
570
582
|
# second page displays the next 10 resources, each with its 10 tags. The
|
571
583
|
# third page displays the remaining 2 resources, each with its 10 tags.
|
572
584
|
#
|
573
|
-
# You can set `TagsPerPage` to a minimum of 100 items
|
585
|
+
# You can set `TagsPerPage` to a minimum of 100 items up to a maximum of
|
574
586
|
# 500 items.
|
575
587
|
#
|
576
588
|
# @option params [Array<String>] :resource_type_filters
|
577
|
-
#
|
578
|
-
# each resource type is `service[:resourceType]`. For
|
579
|
-
# specifying a resource type of `ec2` returns all Amazon EC2
|
580
|
-
# (which includes EC2 instances). Specifying a resource type
|
581
|
-
# `ec2:instance` returns only EC2 instances.
|
589
|
+
# Specifies the resource types that you want included in the response.
|
590
|
+
# The format of each resource type is `service[:resourceType]`. For
|
591
|
+
# example, specifying a resource type of `ec2` returns all Amazon EC2
|
592
|
+
# resources (which includes EC2 instances). Specifying a resource type
|
593
|
+
# of `ec2:instance` returns only EC2 instances.
|
582
594
|
#
|
583
595
|
# The string for each service name and resource type is the same as that
|
584
596
|
# embedded in a resource's Amazon Resource Name (ARN). Consult the *AWS
|
585
597
|
# General Reference* for the following:
|
586
598
|
#
|
587
|
-
#
|
588
|
-
#
|
589
|
-
# * For resource type strings, see [Example ARNs][2].
|
590
|
-
#
|
591
|
-
# * For more information about ARNs, see [Amazon Resource Names (ARNs)
|
592
|
-
# and AWS Service Namespaces][3].
|
599
|
+
# For more information about ARNs, see [Amazon Resource Names (ARNs) and
|
600
|
+
# AWS Service Namespaces][1].
|
593
601
|
#
|
594
602
|
# You can specify multiple resource types by using an array. The array
|
595
603
|
# can include up to 100 items. Note that the length constraint
|
@@ -597,9 +605,7 @@ module Aws::ResourceGroupsTaggingAPI
|
|
597
605
|
#
|
598
606
|
#
|
599
607
|
#
|
600
|
-
# [1]:
|
601
|
-
# [2]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax
|
602
|
-
# [3]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
|
608
|
+
# [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
|
603
609
|
#
|
604
610
|
# @option params [Boolean] :include_compliance_details
|
605
611
|
# Specifies whether to include details regarding the compliance with the
|
@@ -614,6 +620,24 @@ module Aws::ResourceGroupsTaggingAPI
|
|
614
620
|
# You can use this parameter only if the `IncludeComplianceDetails`
|
615
621
|
# parameter is also set to `true`.
|
616
622
|
#
|
623
|
+
# @option params [Array<String>] :resource_arn_list
|
624
|
+
# Specifies a list of ARNs of resources for which you want to retrieve
|
625
|
+
# tag data. You can't specify both this parameter and any of the
|
626
|
+
# pagination parameters (`ResourcesPerPage`, `TagsPerPage`,
|
627
|
+
# `PaginationToken`) in the same request. If you specify both, you get
|
628
|
+
# an `Invalid Parameter` exception.
|
629
|
+
#
|
630
|
+
# If a resource specified by this parameter doesn't exist, it doesn't
|
631
|
+
# generate an error; it simply isn't included in the response.
|
632
|
+
#
|
633
|
+
# An ARN (Amazon Resource Name) uniquely identifies a resource. For more
|
634
|
+
# information, see [Amazon Resource Names (ARNs) and AWS Service
|
635
|
+
# Namespaces][1] in the *AWS General Reference*.
|
636
|
+
#
|
637
|
+
#
|
638
|
+
#
|
639
|
+
# [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
|
640
|
+
#
|
617
641
|
# @return [Types::GetResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
618
642
|
#
|
619
643
|
# * {Types::GetResourcesOutput#pagination_token #pagination_token} => String
|
@@ -636,6 +660,7 @@ module Aws::ResourceGroupsTaggingAPI
|
|
636
660
|
# resource_type_filters: ["AmazonResourceType"],
|
637
661
|
# include_compliance_details: false,
|
638
662
|
# exclude_compliant_resources: false,
|
663
|
+
# resource_arn_list: ["ResourceARN"],
|
639
664
|
# })
|
640
665
|
#
|
641
666
|
# @example Response structure
|
@@ -661,13 +686,21 @@ module Aws::ResourceGroupsTaggingAPI
|
|
661
686
|
req.send_request(options)
|
662
687
|
end
|
663
688
|
|
664
|
-
# Returns all tag keys in the specified Region for the
|
689
|
+
# Returns all tag keys currently in use in the specified Region for the
|
690
|
+
# calling AWS account.
|
691
|
+
#
|
692
|
+
# This operation supports pagination, where the response can be sent in
|
693
|
+
# multiple pages. You should check the `PaginationToken` response
|
694
|
+
# parameter to determine if there are additional results available to
|
695
|
+
# return. Repeat the query, passing the `PaginationToken` response
|
696
|
+
# parameter value as an input to the next request until you recieve a
|
697
|
+
# `null` value. A null value for `PaginationToken` indicates that there
|
698
|
+
# are no more results waiting to be returned.
|
665
699
|
#
|
666
700
|
# @option params [String] :pagination_token
|
667
|
-
#
|
668
|
-
#
|
669
|
-
#
|
670
|
-
# additional page of data.
|
701
|
+
# Specifies a `PaginationToken` response value from a previous request
|
702
|
+
# to indicate that you want the next page of results. Leave this
|
703
|
+
# parameter empty in your initial request.
|
671
704
|
#
|
672
705
|
# @return [Types::GetTagKeysOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
673
706
|
#
|
@@ -697,18 +730,26 @@ module Aws::ResourceGroupsTaggingAPI
|
|
697
730
|
req.send_request(options)
|
698
731
|
end
|
699
732
|
|
700
|
-
# Returns all tag values for the specified key in the
|
701
|
-
# for the AWS account.
|
733
|
+
# Returns all tag values for the specified key that are used in the
|
734
|
+
# specified AWS Region for the calling AWS account.
|
735
|
+
#
|
736
|
+
# This operation supports pagination, where the response can be sent in
|
737
|
+
# multiple pages. You should check the `PaginationToken` response
|
738
|
+
# parameter to determine if there are additional results available to
|
739
|
+
# return. Repeat the query, passing the `PaginationToken` response
|
740
|
+
# parameter value as an input to the next request until you recieve a
|
741
|
+
# `null` value. A null value for `PaginationToken` indicates that there
|
742
|
+
# are no more results waiting to be returned.
|
702
743
|
#
|
703
744
|
# @option params [String] :pagination_token
|
704
|
-
#
|
705
|
-
#
|
706
|
-
#
|
707
|
-
# additional page of data.
|
745
|
+
# Specifies a `PaginationToken` response value from a previous request
|
746
|
+
# to indicate that you want the next page of results. Leave this
|
747
|
+
# parameter empty in your initial request.
|
708
748
|
#
|
709
749
|
# @option params [required, String] :key
|
710
|
-
#
|
711
|
-
# specified Region for the
|
750
|
+
# Specifies the tag key for which you want to list all existing values
|
751
|
+
# that are currently used in the specified AWS Region for the calling
|
752
|
+
# AWS account.
|
712
753
|
#
|
713
754
|
# @return [Types::GetTagValuesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
714
755
|
#
|
@@ -739,15 +780,16 @@ module Aws::ResourceGroupsTaggingAPI
|
|
739
780
|
req.send_request(options)
|
740
781
|
end
|
741
782
|
|
742
|
-
# Generates a report that lists all tagged resources in accounts
|
743
|
-
# your organization and tells whether each resource is compliant
|
744
|
-
# the effective tag policy. Compliance data is refreshed daily.
|
783
|
+
# Generates a report that lists all tagged resources in the accounts
|
784
|
+
# across your organization and tells whether each resource is compliant
|
785
|
+
# with the effective tag policy. Compliance data is refreshed daily. The
|
786
|
+
# report is generated asynchronously.
|
745
787
|
#
|
746
788
|
# The generated report is saved to the following location:
|
747
789
|
#
|
748
790
|
# `s3://example-bucket/AwsTagPolicies/o-exampleorgid/YYYY-MM-ddTHH:mm:ssZ/report.csv`
|
749
791
|
#
|
750
|
-
# You can call this operation only from the organization's
|
792
|
+
# You can call this operation only from the organization's management
|
751
793
|
# account and from the us-east-1 Region.
|
752
794
|
#
|
753
795
|
# @option params [required, String] :s3_bucket
|
@@ -779,18 +821,20 @@ module Aws::ResourceGroupsTaggingAPI
|
|
779
821
|
# Applies one or more tags to the specified resources. Note the
|
780
822
|
# following:
|
781
823
|
#
|
782
|
-
# * Not all resources can have tags. For a list of services
|
783
|
-
# tagging, see [
|
824
|
+
# * Not all resources can have tags. For a list of services with
|
825
|
+
# resources that support tagging using this operation, see [Services
|
826
|
+
# that support the Resource Groups Tagging API][1].
|
784
827
|
#
|
785
828
|
# * Each resource can have up to 50 tags. For other limits, see [Tag
|
786
829
|
# Naming and Usage Conventions][2] in the *AWS General Reference.*
|
787
830
|
#
|
788
|
-
# * You can only tag resources that are located in the specified
|
789
|
-
# for the AWS account.
|
831
|
+
# * You can only tag resources that are located in the specified AWS
|
832
|
+
# Region for the AWS account.
|
790
833
|
#
|
791
834
|
# * To add tags to a resource, you need the necessary permissions for
|
792
835
|
# the service that the resource belongs to as well as permissions for
|
793
|
-
# adding tags. For more information, see
|
836
|
+
# adding tags. For more information, see the documentation for each
|
837
|
+
# service.
|
794
838
|
#
|
795
839
|
# Do not store personally identifiable information (PII) or other
|
796
840
|
# confidential or sensitive information in tags. We use tags to provide
|
@@ -799,21 +843,24 @@ module Aws::ResourceGroupsTaggingAPI
|
|
799
843
|
#
|
800
844
|
#
|
801
845
|
#
|
802
|
-
# [1]:
|
803
|
-
# [2]:
|
846
|
+
# [1]: https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/supported-services.html
|
847
|
+
# [2]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions
|
804
848
|
#
|
805
849
|
# @option params [required, Array<String>] :resource_arn_list
|
806
|
-
#
|
807
|
-
#
|
808
|
-
#
|
850
|
+
# Specifies the list of ARNs of the resources that you want to apply
|
851
|
+
# tags to.
|
852
|
+
#
|
853
|
+
# An ARN (Amazon Resource Name) uniquely identifies a resource. For more
|
854
|
+
# information, see [Amazon Resource Names (ARNs) and AWS Service
|
855
|
+
# Namespaces][1] in the *AWS General Reference*.
|
809
856
|
#
|
810
857
|
#
|
811
858
|
#
|
812
859
|
# [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
|
813
860
|
#
|
814
861
|
# @option params [required, Hash<String,String>] :tags
|
815
|
-
#
|
816
|
-
# consists of a key and a value that you define.
|
862
|
+
# Specifies a list of tags that you want to add to the specified
|
863
|
+
# resources. A tag consists of a key and a value that you define.
|
817
864
|
#
|
818
865
|
# @return [Types::TagResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
819
866
|
#
|
@@ -851,27 +898,27 @@ module Aws::ResourceGroupsTaggingAPI
|
|
851
898
|
#
|
852
899
|
# * To remove tags from a resource, you need the necessary permissions
|
853
900
|
# for the service that the resource belongs to as well as permissions
|
854
|
-
# for removing tags. For more information, see
|
855
|
-
#
|
856
|
-
# * You can only tag resources that are located in the specified Region
|
857
|
-
# for the AWS account.
|
901
|
+
# for removing tags. For more information, see the documentation for
|
902
|
+
# the service whose resource you want to untag.
|
858
903
|
#
|
859
|
-
#
|
860
|
-
#
|
861
|
-
# [1]: http://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html
|
904
|
+
# * You can only tag resources that are located in the specified AWS
|
905
|
+
# Region for the calling AWS account.
|
862
906
|
#
|
863
907
|
# @option params [required, Array<String>] :resource_arn_list
|
864
|
-
#
|
865
|
-
#
|
866
|
-
#
|
908
|
+
# Specifies a list of ARNs of the resources that you want to remove tags
|
909
|
+
# from.
|
910
|
+
#
|
911
|
+
# An ARN (Amazon Resource Name) uniquely identifies a resource. For more
|
912
|
+
# information, see [Amazon Resource Names (ARNs) and AWS Service
|
913
|
+
# Namespaces][1] in the *AWS General Reference*.
|
867
914
|
#
|
868
915
|
#
|
869
916
|
#
|
870
917
|
# [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
|
871
918
|
#
|
872
919
|
# @option params [required, Array<String>] :tag_keys
|
873
|
-
#
|
874
|
-
# resources.
|
920
|
+
# Specifies a list of tag keys that you want to remove from the
|
921
|
+
# specified resources.
|
875
922
|
#
|
876
923
|
# @return [Types::UntagResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
877
924
|
#
|
@@ -913,7 +960,7 @@ module Aws::ResourceGroupsTaggingAPI
|
|
913
960
|
params: params,
|
914
961
|
config: config)
|
915
962
|
context[:gem_name] = 'aws-sdk-resourcegroupstaggingapi'
|
916
|
-
context[:gem_version] = '1.
|
963
|
+
context[:gem_version] = '1.37.0'
|
917
964
|
Seahorse::Client::Request.new(handlers, context)
|
918
965
|
end
|
919
966
|
|