aws-sdk-resourcegroupstaggingapi 1.30.0 → 1.35.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
  SHA256:
3
- metadata.gz: 479afb7a93fa00605d7bb4eea6f4f485e958314a5dbacaf643716516efd679d1
4
- data.tar.gz: 4d9f7c1e4e07762dac82c5c381c7b27ac8493ecb44d1e04fbfe06b65f3647d26
3
+ metadata.gz: fa68f8d2590469b0b52abf113c87790b5ff84f0f3d6fc967db9cdfefaac52790
4
+ data.tar.gz: ab280823e2a1fe3cf620fc9e1c60bad1a9a7f0a5695061720fde2186aa1fdc34
5
5
  SHA512:
6
- metadata.gz: 48ee1946ea9bbf7ba9f38a13a69d42e826c9c65dfdaebc02fc373fb4973080ca1c0580e9c888efa8cb69adc9397a8bd63e397e0f34eee9cc1cb1b40479cb909c
7
- data.tar.gz: e369ac3900b7e1c798f2b500d3cf8eaa34a7b26ffbbc2bbf2fcc1cb7a401a43964c1e8e3ffc6a2f7d55e1689efbd1efde73e87cfeea3a55c49cd39ff90bb67b3
6
+ metadata.gz: b6a0b099a0d7bda883647a2b2dfb18048d1dfd4140db4ee18c089f84f6b3666959217f15a28f6c7ab2b0dbc8199ebd640ebe437153f525a00311cd7298f55279
7
+ data.tar.gz: 591d79771b12f218c0989eb364754544269d28af891d4fd2dfaef2586f8c781b4971ca3f02b0f5733d5df625aaedd6425fb27c7bf798a4e607c419155b793ab3
@@ -7,6 +7,7 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
+
10
11
  require 'aws-sdk-core'
11
12
  require 'aws-sigv4'
12
13
 
@@ -44,9 +45,9 @@ require_relative 'aws-sdk-resourcegroupstaggingapi/customizations'
44
45
  #
45
46
  # See {Errors} for more information.
46
47
  #
47
- # @service
48
+ # @!group service
48
49
  module Aws::ResourceGroupsTaggingAPI
49
50
 
50
- GEM_VERSION = '1.30.0'
51
+ GEM_VERSION = '1.35.0'
51
52
 
52
53
  end
@@ -85,13 +85,28 @@ module Aws::ResourceGroupsTaggingAPI
85
85
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
86
86
  # credentials.
87
87
  #
88
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
89
+ # shared file, such as `~/.aws/config`.
90
+ #
91
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
92
+ #
93
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
94
+ # assume a role after providing credentials via the web.
95
+ #
96
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
97
+ # access token generated from `aws login`.
98
+ #
99
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
100
+ # process that outputs to stdout.
101
+ #
88
102
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
89
103
  # from an EC2 IMDS on an EC2 instance.
90
104
  #
91
- # * `Aws::SharedCredentials` - Used for loading credentials from a
92
- # shared file, such as `~/.aws/config`.
105
+ # * `Aws::ECSCredentials` - Used for loading credentials from
106
+ # instances running in ECS.
93
107
  #
94
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
108
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
109
+ # from the Cognito Identity service.
95
110
  #
96
111
  # When `:credentials` are not configured directly, the following
97
112
  # locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::ResourceGroupsTaggingAPI
101
116
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
102
117
  # * `~/.aws/credentials`
103
118
  # * `~/.aws/config`
104
- # * EC2 IMDS instance profile - When used by default, the timeouts are
105
- # very aggressive. Construct and pass an instance of
106
- # `Aws::InstanceProfileCredentails` to enable retries and extended
107
- # timeouts.
119
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
+ # are very aggressive. Construct and pass an instance of
121
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
+ # enable retries and extended timeouts.
108
123
  #
109
124
  # @option options [required, String] :region
110
125
  # The AWS region to connect to. The configured `:region` is
@@ -324,7 +339,7 @@ module Aws::ResourceGroupsTaggingAPI
324
339
 
325
340
  # Describes the status of the `StartReportCreation` operation.
326
341
  #
327
- # You can call this operation only from the organization's master
342
+ # You can call this operation only from the organization's management
328
343
  # account and from the us-east-1 Region.
329
344
  #
330
345
  # @return [Types::DescribeReportCreationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -354,30 +369,39 @@ module Aws::ResourceGroupsTaggingAPI
354
369
  # For more information on tag policies, see [Tag Policies][1] in the
355
370
  # *AWS Organizations User Guide.*
356
371
  #
357
- # You can call this operation only from the organization's master
372
+ # You can call this operation only from the organization's management
358
373
  # account and from the us-east-1 Region.
359
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.
360
382
  #
361
383
  #
362
- # [1]: http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
384
+ #
385
+ # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
363
386
  #
364
387
  # @option params [Array<String>] :target_id_filters
365
- # The target identifiers (usually, specific account IDs) to limit the
366
- # 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
367
390
  # noncompliant resources includes only resources with the specified
368
391
  # target IDs.
369
392
  #
370
393
  # @option params [Array<String>] :region_filters
371
- # A list of Regions to limit the output by. If you use this parameter,
372
- # the count of returned noncompliant resources includes only resources
373
- # 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.
374
397
  #
375
398
  # @option params [Array<String>] :resource_type_filters
376
- # The constraints on the resources that you want returned. The format of
377
- # each resource type is `service[:resourceType]`. For example,
378
- # specifying a resource type of `ec2` returns all Amazon EC2 resources
379
- # (which includes EC2 instances). Specifying a resource type of
380
- # `ec2:instance` returns only EC2 instances.
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.
381
405
  #
382
406
  # The string for each service name and resource type is the same as that
383
407
  # embedded in a resource's Amazon Resource Name (ARN). Consult the *AWS
@@ -390,34 +414,37 @@ module Aws::ResourceGroupsTaggingAPI
390
414
  # * For more information about ARNs, see [Amazon Resource Names (ARNs)
391
415
  # and AWS Service Namespaces][3].
392
416
  #
393
- # You can specify multiple resource types by using an array. The array
394
- # can include up to 100 items. Note that the length constraint
395
- # 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.
396
420
  #
397
421
  #
398
422
  #
399
- # [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces
400
- # [2]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax
401
- # [3]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
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
402
426
  #
403
427
  # @option params [Array<String>] :tag_key_filters
404
- # A list of tag keys to limit the output by. If you use this parameter,
405
- # the count of returned noncompliant resources includes only resources
406
- # that have the specified tag keys.
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.
407
432
  #
408
433
  # @option params [Array<String>] :group_by
409
- # A list of attributes to group the counts of noncompliant resources by.
410
- # 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.
411
436
  #
412
437
  # @option params [Integer] :max_results
413
- # A limit that restricts the number of results that are returned per
414
- # page.
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.
415
443
  #
416
444
  # @option params [String] :pagination_token
417
- # A string that indicates that additional data is available. Leave this
418
- # value empty for your initial request. If the response includes a
419
- # `PaginationToken`, use that string for this value to request an
420
- # 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.
421
448
  #
422
449
  # @return [Types::GetComplianceSummaryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
423
450
  #
@@ -472,77 +499,77 @@ module Aws::ResourceGroupsTaggingAPI
472
499
  # policy. For more information on tag policies, see [Tag Policies][1]
473
500
  # in the *AWS Organizations User Guide.*
474
501
  #
475
- # <note markdown="1"> You can check the `PaginationToken` response parameter to determine if
476
- # a query is complete. Queries occasionally return fewer results on a
477
- # page than allowed. The `PaginationToken` response parameter value is
478
- # `null` *only* when there are no more results to display.
479
- #
480
- # </note>
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.
481
509
  #
482
510
  #
483
511
  #
484
- # [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
485
513
  #
486
514
  # @option params [String] :pagination_token
487
- # A string that indicates that additional data is available. Leave this
488
- # value empty for your initial request. If the response includes a
489
- # `PaginationToken`, use that string for this value to request an
490
- # 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.
491
518
  #
492
519
  # @option params [Array<Types::TagFilter>] :tag_filters
493
- # A list of TagFilters (keys and values). Each TagFilter specified must
494
- # contain a key with values as optional. A request can include up to 50
495
- # keys, and each key can include up to 20 values.
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.
496
525
  #
497
526
  # Note the following when deciding how to use TagFilters:
498
527
  #
499
- # * If you *do* specify a TagFilter, the response returns only those
500
- # resources that are currently associated with the specified tag.
501
- #
502
- # * If you *don't* specify a TagFilter, the response includes all
503
- # resources that were ever associated with tags. Resources that
504
- # currently don't have associated tags are shown with an empty tag
505
- # 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": []`.
506
532
  #
507
533
  # * If you specify more than one filter in a single request, the
508
- # response returns only those resources that satisfy all specified
509
- # filters.
534
+ # response returns only those resources that satisfy all filters.
510
535
  #
511
536
  # * If you specify a filter that contains more than one value for a key,
512
537
  # the response returns resources that match any of the specified
513
538
  # values for that key.
514
539
  #
515
540
  # * If you don't specify any values for a key, the response returns
516
- # resources that are tagged with that key irrespective of the value.
541
+ # resources that are tagged with that key and any or no value.
517
542
  #
518
- # For example, for filters: filter1 = \\\{key1, \\\{value1\\}\\},
519
- # filter2 = \\\{key2, \\\{value2,value3,value4\\}\\} , filter3 =
520
- # \\\{key3\\}:
543
+ # For example, for the following filters: `filter1=
544
+ # \{keyA,\{value1\}\}`, `filter2=\{keyB,\{value2,value3,value4\}\}`,
545
+ # `filter3= \{keyC\}`\:
521
546
  #
522
- # * GetResources( \\\{filter1\\} ) returns resources tagged with
523
- # key1=value1
547
+ # * `GetResources(\{filter1\})` returns resources tagged with
548
+ # `key1=value1`
524
549
  #
525
- # * GetResources( \\\{filter2\\} ) returns resources tagged with
526
- # key2=value2 or key2=value3 or key2=value4
550
+ # * `GetResources(\{filter2\})` returns resources tagged with
551
+ # `key2=value2` or `key2=value3` or `key2=value4`
527
552
  #
528
- # * GetResources( \\\{filter3\\} ) returns resources tagged with any
529
- # tag containing key3 as its tag key, irrespective of its value
553
+ # * `GetResources(\{filter3\})` returns resources tagged with any tag
554
+ # with the key `key3`, and with any or no value
530
555
  #
531
- # * GetResources( \\\{filter1,filter2,filter3\\} ) returns resources
532
- # tagged with ( key1=value1) and ( key2=value2 or key2=value3 or
533
- # key2=value4) and (key3, irrespective of the value)
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)`
534
559
  #
535
560
  # @option params [Integer] :resources_per_page
536
- # A limit that restricts the number of resources returned by
537
- # GetResources in paginated output. You can set ResourcesPerPage to a
538
- # minimum of 1 item and the maximum of 100 items.
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.
539
566
  #
540
567
  # @option params [Integer] :tags_per_page
541
568
  # AWS recommends using `ResourcesPerPage` instead of this parameter.
542
569
  #
543
570
  # A limit that restricts the number of tags (key and value pairs)
544
- # returned by GetResources in paginated output. A resource with no tags
545
- # 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).
546
573
  #
547
574
  # `GetResources` does not split a resource and its associated tags
548
575
  # across pages. If the specified `TagsPerPage` would cause such a break,
@@ -555,26 +582,22 @@ module Aws::ResourceGroupsTaggingAPI
555
582
  # second page displays the next 10 resources, each with its 10 tags. The
556
583
  # third page displays the remaining 2 resources, each with its 10 tags.
557
584
  #
558
- # You can set `TagsPerPage` to a minimum of 100 items and the maximum of
585
+ # You can set `TagsPerPage` to a minimum of 100 items up to a maximum of
559
586
  # 500 items.
560
587
  #
561
588
  # @option params [Array<String>] :resource_type_filters
562
- # The constraints on the resources that you want returned. The format of
563
- # each resource type is `service[:resourceType]`. For example,
564
- # specifying a resource type of `ec2` returns all Amazon EC2 resources
565
- # (which includes EC2 instances). Specifying a resource type of
566
- # `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.
567
594
  #
568
595
  # The string for each service name and resource type is the same as that
569
596
  # embedded in a resource's Amazon Resource Name (ARN). Consult the *AWS
570
597
  # General Reference* for the following:
571
598
  #
572
- # * For a list of service name strings, see [AWS Service Namespaces][1].
573
- #
574
- # * For resource type strings, see [Example ARNs][2].
575
- #
576
- # * For more information about ARNs, see [Amazon Resource Names (ARNs)
577
- # and AWS Service Namespaces][3].
599
+ # For more information about ARNs, see [Amazon Resource Names (ARNs) and
600
+ # AWS Service Namespaces][1].
578
601
  #
579
602
  # You can specify multiple resource types by using an array. The array
580
603
  # can include up to 100 items. Note that the length constraint
@@ -582,9 +605,7 @@ module Aws::ResourceGroupsTaggingAPI
582
605
  #
583
606
  #
584
607
  #
585
- # [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces
586
- # [2]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax
587
- # [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
588
609
  #
589
610
  # @option params [Boolean] :include_compliance_details
590
611
  # Specifies whether to include details regarding the compliance with the
@@ -599,6 +620,24 @@ module Aws::ResourceGroupsTaggingAPI
599
620
  # You can use this parameter only if the `IncludeComplianceDetails`
600
621
  # parameter is also set to `true`.
601
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
+ #
602
641
  # @return [Types::GetResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
603
642
  #
604
643
  # * {Types::GetResourcesOutput#pagination_token #pagination_token} => String
@@ -621,6 +660,7 @@ module Aws::ResourceGroupsTaggingAPI
621
660
  # resource_type_filters: ["AmazonResourceType"],
622
661
  # include_compliance_details: false,
623
662
  # exclude_compliant_resources: false,
663
+ # resource_arn_list: ["ResourceARN"],
624
664
  # })
625
665
  #
626
666
  # @example Response structure
@@ -646,13 +686,21 @@ module Aws::ResourceGroupsTaggingAPI
646
686
  req.send_request(options)
647
687
  end
648
688
 
649
- # Returns all tag keys in the specified Region for the AWS account.
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.
650
699
  #
651
700
  # @option params [String] :pagination_token
652
- # A string that indicates that additional data is available. Leave this
653
- # value empty for your initial request. If the response includes a
654
- # `PaginationToken`, use that string for this value to request an
655
- # 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.
656
704
  #
657
705
  # @return [Types::GetTagKeysOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
658
706
  #
@@ -682,18 +730,26 @@ module Aws::ResourceGroupsTaggingAPI
682
730
  req.send_request(options)
683
731
  end
684
732
 
685
- # Returns all tag values for the specified key in the specified Region
686
- # 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.
687
743
  #
688
744
  # @option params [String] :pagination_token
689
- # A string that indicates that additional data is available. Leave this
690
- # value empty for your initial request. If the response includes a
691
- # `PaginationToken`, use that string for this value to request an
692
- # 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.
693
748
  #
694
749
  # @option params [required, String] :key
695
- # The key for which you want to list all existing values in the
696
- # specified Region for the AWS account.
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.
697
753
  #
698
754
  # @return [Types::GetTagValuesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
699
755
  #
@@ -724,15 +780,16 @@ module Aws::ResourceGroupsTaggingAPI
724
780
  req.send_request(options)
725
781
  end
726
782
 
727
- # Generates a report that lists all tagged resources in accounts across
728
- # your organization and tells whether each resource is compliant with
729
- # 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.
730
787
  #
731
788
  # The generated report is saved to the following location:
732
789
  #
733
790
  # `s3://example-bucket/AwsTagPolicies/o-exampleorgid/YYYY-MM-ddTHH:mm:ssZ/report.csv`
734
791
  #
735
- # You can call this operation only from the organization's master
792
+ # You can call this operation only from the organization's management
736
793
  # account and from the us-east-1 Region.
737
794
  #
738
795
  # @option params [required, String] :s3_bucket
@@ -764,18 +821,20 @@ module Aws::ResourceGroupsTaggingAPI
764
821
  # Applies one or more tags to the specified resources. Note the
765
822
  # following:
766
823
  #
767
- # * Not all resources can have tags. For a list of services that support
768
- # tagging, see [this list][1].
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].
769
827
  #
770
828
  # * Each resource can have up to 50 tags. For other limits, see [Tag
771
829
  # Naming and Usage Conventions][2] in the *AWS General Reference.*
772
830
  #
773
- # * You can only tag resources that are located in the specified Region
774
- # for the AWS account.
831
+ # * You can only tag resources that are located in the specified AWS
832
+ # Region for the AWS account.
775
833
  #
776
834
  # * To add tags to a resource, you need the necessary permissions for
777
835
  # the service that the resource belongs to as well as permissions for
778
- # adding tags. For more information, see [this list][1].
836
+ # adding tags. For more information, see the documentation for each
837
+ # service.
779
838
  #
780
839
  # Do not store personally identifiable information (PII) or other
781
840
  # confidential or sensitive information in tags. We use tags to provide
@@ -784,21 +843,24 @@ module Aws::ResourceGroupsTaggingAPI
784
843
  #
785
844
  #
786
845
  #
787
- # [1]: http://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html
788
- # [2]: http://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions
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
789
848
  #
790
849
  # @option params [required, Array<String>] :resource_arn_list
791
- # A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a
792
- # resource. For more information, see [Amazon Resource Names (ARNs) and
793
- # AWS Service Namespaces][1] in the *AWS General Reference*.
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*.
794
856
  #
795
857
  #
796
858
  #
797
859
  # [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
798
860
  #
799
861
  # @option params [required, Hash<String,String>] :tags
800
- # The tags that you want to add to the specified resources. A tag
801
- # 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.
802
864
  #
803
865
  # @return [Types::TagResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
804
866
  #
@@ -836,27 +898,27 @@ module Aws::ResourceGroupsTaggingAPI
836
898
  #
837
899
  # * To remove tags from a resource, you need the necessary permissions
838
900
  # for the service that the resource belongs to as well as permissions
839
- # for removing tags. For more information, see [this list][1].
901
+ # for removing tags. For more information, see the documentation for
902
+ # the service whose resource you want to untag.
840
903
  #
841
- # * You can only tag resources that are located in the specified Region
842
- # for the AWS account.
843
- #
844
- #
845
- #
846
- # [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.
847
906
  #
848
907
  # @option params [required, Array<String>] :resource_arn_list
849
- # A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a
850
- # resource. For more information, see [Amazon Resource Names (ARNs) and
851
- # AWS Service Namespaces][1] in the *AWS General Reference*.
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*.
852
914
  #
853
915
  #
854
916
  #
855
917
  # [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
856
918
  #
857
919
  # @option params [required, Array<String>] :tag_keys
858
- # A list of the tag keys that you want to remove from the specified
859
- # resources.
920
+ # Specifies a list of tag keys that you want to remove from the
921
+ # specified resources.
860
922
  #
861
923
  # @return [Types::UntagResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
862
924
  #
@@ -898,7 +960,7 @@ module Aws::ResourceGroupsTaggingAPI
898
960
  params: params,
899
961
  config: config)
900
962
  context[:gem_name] = 'aws-sdk-resourcegroupstaggingapi'
901
- context[:gem_version] = '1.30.0'
963
+ context[:gem_version] = '1.35.0'
902
964
  Seahorse::Client::Request.new(handlers, context)
903
965
  end
904
966
 
@@ -47,7 +47,8 @@ module Aws::ResourceGroupsTaggingAPI
47
47
  Region = Shapes::StringShape.new(name: 'Region')
48
48
  RegionFilterList = Shapes::ListShape.new(name: 'RegionFilterList')
49
49
  ResourceARN = Shapes::StringShape.new(name: 'ResourceARN')
50
- ResourceARNList = Shapes::ListShape.new(name: 'ResourceARNList')
50
+ ResourceARNListForGet = Shapes::ListShape.new(name: 'ResourceARNListForGet')
51
+ ResourceARNListForTagUntag = Shapes::ListShape.new(name: 'ResourceARNListForTagUntag')
51
52
  ResourceTagMapping = Shapes::StructureShape.new(name: 'ResourceTagMapping')
52
53
  ResourceTagMappingList = Shapes::ListShape.new(name: 'ResourceTagMappingList')
53
54
  ResourceTypeFilterList = Shapes::ListShape.new(name: 'ResourceTypeFilterList')
@@ -128,6 +129,7 @@ module Aws::ResourceGroupsTaggingAPI
128
129
  GetResourcesInput.add_member(:resource_type_filters, Shapes::ShapeRef.new(shape: ResourceTypeFilterList, location_name: "ResourceTypeFilters"))
129
130
  GetResourcesInput.add_member(:include_compliance_details, Shapes::ShapeRef.new(shape: IncludeComplianceDetails, location_name: "IncludeComplianceDetails"))
130
131
  GetResourcesInput.add_member(:exclude_compliant_resources, Shapes::ShapeRef.new(shape: ExcludeCompliantResources, location_name: "ExcludeCompliantResources"))
132
+ GetResourcesInput.add_member(:resource_arn_list, Shapes::ShapeRef.new(shape: ResourceARNListForGet, location_name: "ResourceARNList"))
131
133
  GetResourcesInput.struct_class = Types::GetResourcesInput
132
134
 
133
135
  GetResourcesOutput.add_member(:pagination_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "PaginationToken"))
@@ -162,7 +164,9 @@ module Aws::ResourceGroupsTaggingAPI
162
164
 
163
165
  RegionFilterList.member = Shapes::ShapeRef.new(shape: Region)
164
166
 
165
- ResourceARNList.member = Shapes::ShapeRef.new(shape: ResourceARN)
167
+ ResourceARNListForGet.member = Shapes::ShapeRef.new(shape: ResourceARN)
168
+
169
+ ResourceARNListForTagUntag.member = Shapes::ShapeRef.new(shape: ResourceARN)
166
170
 
167
171
  ResourceTagMapping.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceARN, location_name: "ResourceARN"))
168
172
  ResourceTagMapping.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
@@ -209,7 +213,7 @@ module Aws::ResourceGroupsTaggingAPI
209
213
  TagMap.key = Shapes::ShapeRef.new(shape: TagKey)
210
214
  TagMap.value = Shapes::ShapeRef.new(shape: TagValue)
211
215
 
212
- TagResourcesInput.add_member(:resource_arn_list, Shapes::ShapeRef.new(shape: ResourceARNList, required: true, location_name: "ResourceARNList"))
216
+ TagResourcesInput.add_member(:resource_arn_list, Shapes::ShapeRef.new(shape: ResourceARNListForTagUntag, required: true, location_name: "ResourceARNList"))
213
217
  TagResourcesInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, required: true, location_name: "Tags"))
214
218
  TagResourcesInput.struct_class = Types::TagResourcesInput
215
219
 
@@ -225,7 +229,7 @@ module Aws::ResourceGroupsTaggingAPI
225
229
  ThrottledException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionMessage, location_name: "Message"))
226
230
  ThrottledException.struct_class = Types::ThrottledException
227
231
 
228
- UntagResourcesInput.add_member(:resource_arn_list, Shapes::ShapeRef.new(shape: ResourceARNList, required: true, location_name: "ResourceARNList"))
232
+ UntagResourcesInput.add_member(:resource_arn_list, Shapes::ShapeRef.new(shape: ResourceARNListForTagUntag, required: true, location_name: "ResourceARNList"))
229
233
  UntagResourcesInput.add_member(:tag_keys, Shapes::ShapeRef.new(shape: TagKeyListForUntag, required: true, location_name: "TagKeys"))
230
234
  UntagResourcesInput.struct_class = Types::UntagResourcesInput
231
235
 
@@ -198,24 +198,25 @@ module Aws::ResourceGroupsTaggingAPI
198
198
  # }
199
199
  #
200
200
  # @!attribute [rw] target_id_filters
201
- # The target identifiers (usually, specific account IDs) to limit the
202
- # output by. If you use this parameter, the count of returned
203
- # noncompliant resources includes only resources with the specified
204
- # target IDs.
201
+ # Specifies target identifiers (usually, specific account IDs) to
202
+ # limit the output by. If you use this parameter, the count of
203
+ # returned noncompliant resources includes only resources with the
204
+ # specified target IDs.
205
205
  # @return [Array<String>]
206
206
  #
207
207
  # @!attribute [rw] region_filters
208
- # A list of Regions to limit the output by. If you use this parameter,
209
- # the count of returned noncompliant resources includes only resources
210
- # in the specified Regions.
208
+ # Specifies a list of AWS Regions to limit the output by. If you use
209
+ # this parameter, the count of returned noncompliant resources
210
+ # includes only resources in the specified Regions.
211
211
  # @return [Array<String>]
212
212
  #
213
213
  # @!attribute [rw] resource_type_filters
214
- # The constraints on the resources that you want returned. The format
215
- # of each resource type is `service[:resourceType]`. For example,
216
- # specifying a resource type of `ec2` returns all Amazon EC2 resources
217
- # (which includes EC2 instances). Specifying a resource type of
218
- # `ec2:instance` returns only EC2 instances.
214
+ # Specifies that you want the response to include information for only
215
+ # resources of the specified types. The format of each resource type
216
+ # is `service[:resourceType]`. For example, specifying a resource type
217
+ # of `ec2` returns all Amazon EC2 resources (which includes EC2
218
+ # instances). Specifying a resource type of `ec2:instance` returns
219
+ # only EC2 instances.
219
220
  #
220
221
  # The string for each service name and resource type is the same as
221
222
  # that embedded in a resource's Amazon Resource Name (ARN). Consult
@@ -229,38 +230,42 @@ module Aws::ResourceGroupsTaggingAPI
229
230
  # * For more information about ARNs, see [Amazon Resource Names (ARNs)
230
231
  # and AWS Service Namespaces][3].
231
232
  #
232
- # You can specify multiple resource types by using an array. The array
233
- # can include up to 100 items. Note that the length constraint
234
- # requirement applies to each resource type filter.
233
+ # You can specify multiple resource types by using a comma separated
234
+ # array. The array can include up to 100 items. Note that the length
235
+ # constraint requirement applies to each resource type filter.
235
236
  #
236
237
  #
237
238
  #
238
- # [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces
239
- # [2]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax
240
- # [3]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
239
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces
240
+ # [2]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax
241
+ # [3]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
241
242
  # @return [Array<String>]
242
243
  #
243
244
  # @!attribute [rw] tag_key_filters
244
- # A list of tag keys to limit the output by. If you use this
245
- # parameter, the count of returned noncompliant resources includes
246
- # only resources that have the specified tag keys.
245
+ # Specifies that you want the response to include information for only
246
+ # resources that have tags with the specified tag keys. If you use
247
+ # this parameter, the count of returned noncompliant resources
248
+ # includes only resources that have the specified tag keys.
247
249
  # @return [Array<String>]
248
250
  #
249
251
  # @!attribute [rw] group_by
250
- # A list of attributes to group the counts of noncompliant resources
251
- # by. If supplied, the counts are sorted by those attributes.
252
+ # Specifies a list of attributes to group the counts of noncompliant
253
+ # resources by. If supplied, the counts are sorted by those
254
+ # attributes.
252
255
  # @return [Array<String>]
253
256
  #
254
257
  # @!attribute [rw] max_results
255
- # A limit that restricts the number of results that are returned per
256
- # page.
258
+ # Specifies the maximum number of results to be returned in each page.
259
+ # A query can return fewer than this maximum, even if there are more
260
+ # results still to return. You should always check the
261
+ # `PaginationToken` response value to see if there are more results.
262
+ # You can specify a minimum of 1 and a maximum value of 100.
257
263
  # @return [Integer]
258
264
  #
259
265
  # @!attribute [rw] pagination_token
260
- # A string that indicates that additional data is available. Leave
261
- # this value empty for your initial request. If the response includes
262
- # a `PaginationToken`, use that string for this value to request an
263
- # additional page of data.
266
+ # Specifies a `PaginationToken` response value from a previous request
267
+ # to indicate that you want the next page of results. Leave this
268
+ # parameter empty in your initial request.
264
269
  # @return [String]
265
270
  #
266
271
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/GetComplianceSummaryInput AWS API Documentation
@@ -282,10 +287,10 @@ module Aws::ResourceGroupsTaggingAPI
282
287
  # @return [Array<Types::Summary>]
283
288
  #
284
289
  # @!attribute [rw] pagination_token
285
- # A string that indicates that the response contains more data than
286
- # can be returned in a single response. To receive additional data,
287
- # specify this string for the `PaginationToken` value in a subsequent
288
- # request.
290
+ # A string that indicates that there is more data available than this
291
+ # response contains. To receive the next part of the response, specify
292
+ # this response value as the `PaginationToken` value in the request
293
+ # for the next page.
289
294
  # @return [String]
290
295
  #
291
296
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/GetComplianceSummaryOutput AWS API Documentation
@@ -313,70 +318,70 @@ module Aws::ResourceGroupsTaggingAPI
313
318
  # resource_type_filters: ["AmazonResourceType"],
314
319
  # include_compliance_details: false,
315
320
  # exclude_compliant_resources: false,
321
+ # resource_arn_list: ["ResourceARN"],
316
322
  # }
317
323
  #
318
324
  # @!attribute [rw] pagination_token
319
- # A string that indicates that additional data is available. Leave
320
- # this value empty for your initial request. If the response includes
321
- # a `PaginationToken`, use that string for this value to request an
322
- # additional page of data.
325
+ # Specifies a `PaginationToken` response value from a previous request
326
+ # to indicate that you want the next page of results. Leave this
327
+ # parameter empty in your initial request.
323
328
  # @return [String]
324
329
  #
325
330
  # @!attribute [rw] tag_filters
326
- # A list of TagFilters (keys and values). Each TagFilter specified
327
- # must contain a key with values as optional. A request can include up
328
- # to 50 keys, and each key can include up to 20 values.
331
+ # Specifies a list of TagFilters (keys and values) to restrict the
332
+ # output to only those resources that have the specified tag and, if
333
+ # included, the specified value. Each `TagFilter` must contain a key
334
+ # with values optional. A request can include up to 50 keys, and each
335
+ # key can include up to 20 values.
329
336
  #
330
337
  # Note the following when deciding how to use TagFilters:
331
338
  #
332
- # * If you *do* specify a TagFilter, the response returns only those
333
- # resources that are currently associated with the specified tag.
334
- #
335
- # * If you *don't* specify a TagFilter, the response includes all
336
- # resources that were ever associated with tags. Resources that
337
- # currently don't have associated tags are shown with an empty tag
338
- # set, like this: `"Tags": []`.
339
+ # * If you *don't* specify a `TagFilter`, the response includes all
340
+ # resources that are currently tagged or ever had a tag. Resources
341
+ # that currently don't have tags are shown with an empty tag set,
342
+ # like this: `"Tags": []`.
339
343
  #
340
344
  # * If you specify more than one filter in a single request, the
341
- # response returns only those resources that satisfy all specified
342
- # filters.
345
+ # response returns only those resources that satisfy all filters.
343
346
  #
344
347
  # * If you specify a filter that contains more than one value for a
345
348
  # key, the response returns resources that match any of the
346
349
  # specified values for that key.
347
350
  #
348
351
  # * If you don't specify any values for a key, the response returns
349
- # resources that are tagged with that key irrespective of the value.
352
+ # resources that are tagged with that key and any or no value.
350
353
  #
351
- # For example, for filters: filter1 = \\\{key1, \\\{value1\\}\\},
352
- # filter2 = \\\{key2, \\\{value2,value3,value4\\}\\} , filter3 =
353
- # \\\{key3\\}:
354
+ # For example, for the following filters: `filter1=
355
+ # \{keyA,\{value1\}\}`, `filter2=\{keyB,\{value2,value3,value4\}\}`,
356
+ # `filter3= \{keyC\}`\:
354
357
  #
355
- # * GetResources( \\\{filter1\\} ) returns resources tagged with
356
- # key1=value1
358
+ # * `GetResources(\{filter1\})` returns resources tagged with
359
+ # `key1=value1`
357
360
  #
358
- # * GetResources( \\\{filter2\\} ) returns resources tagged with
359
- # key2=value2 or key2=value3 or key2=value4
361
+ # * `GetResources(\{filter2\})` returns resources tagged with
362
+ # `key2=value2` or `key2=value3` or `key2=value4`
360
363
  #
361
- # * GetResources( \\\{filter3\\} ) returns resources tagged with any
362
- # tag containing key3 as its tag key, irrespective of its value
364
+ # * `GetResources(\{filter3\})` returns resources tagged with any
365
+ # tag with the key `key3`, and with any or no value
363
366
  #
364
- # * GetResources( \\\{filter1,filter2,filter3\\} ) returns resources
365
- # tagged with ( key1=value1) and ( key2=value2 or key2=value3 or
366
- # key2=value4) and (key3, irrespective of the value)
367
+ # * `GetResources(\{filter1,filter2,filter3\})` returns resources
368
+ # tagged with `(key1=value1) and (key2=value2 or key2=value3 or
369
+ # key2=value4) and (key3, any or no value)`
367
370
  # @return [Array<Types::TagFilter>]
368
371
  #
369
372
  # @!attribute [rw] resources_per_page
370
- # A limit that restricts the number of resources returned by
371
- # GetResources in paginated output. You can set ResourcesPerPage to a
372
- # minimum of 1 item and the maximum of 100 items.
373
+ # Specifies the maximum number of results to be returned in each page.
374
+ # A query can return fewer than this maximum, even if there are more
375
+ # results still to return. You should always check the
376
+ # `PaginationToken` response value to see if there are more results.
377
+ # You can specify a minimum of 1 and a maximum value of 100.
373
378
  # @return [Integer]
374
379
  #
375
380
  # @!attribute [rw] tags_per_page
376
381
  # AWS recommends using `ResourcesPerPage` instead of this parameter.
377
382
  #
378
383
  # A limit that restricts the number of tags (key and value pairs)
379
- # returned by GetResources in paginated output. A resource with no
384
+ # returned by `GetResources` in paginated output. A resource with no
380
385
  # tags is counted as having one tag (one key and value pair).
381
386
  #
382
387
  # `GetResources` does not split a resource and its associated tags
@@ -391,28 +396,23 @@ module Aws::ResourceGroupsTaggingAPI
391
396
  # each with its 10 tags. The third page displays the remaining 2
392
397
  # resources, each with its 10 tags.
393
398
  #
394
- # You can set `TagsPerPage` to a minimum of 100 items and the maximum
399
+ # You can set `TagsPerPage` to a minimum of 100 items up to a maximum
395
400
  # of 500 items.
396
401
  # @return [Integer]
397
402
  #
398
403
  # @!attribute [rw] resource_type_filters
399
- # The constraints on the resources that you want returned. The format
400
- # of each resource type is `service[:resourceType]`. For example,
401
- # specifying a resource type of `ec2` returns all Amazon EC2 resources
402
- # (which includes EC2 instances). Specifying a resource type of
403
- # `ec2:instance` returns only EC2 instances.
404
+ # Specifies the resource types that you want included in the response.
405
+ # The format of each resource type is `service[:resourceType]`. For
406
+ # example, specifying a resource type of `ec2` returns all Amazon EC2
407
+ # resources (which includes EC2 instances). Specifying a resource type
408
+ # of `ec2:instance` returns only EC2 instances.
404
409
  #
405
410
  # The string for each service name and resource type is the same as
406
411
  # that embedded in a resource's Amazon Resource Name (ARN). Consult
407
412
  # the *AWS General Reference* for the following:
408
413
  #
409
- # * For a list of service name strings, see [AWS Service
410
- # Namespaces][1].
411
- #
412
- # * For resource type strings, see [Example ARNs][2].
413
- #
414
- # * For more information about ARNs, see [Amazon Resource Names (ARNs)
415
- # and AWS Service Namespaces][3].
414
+ # For more information about ARNs, see [Amazon Resource Names (ARNs)
415
+ # and AWS Service Namespaces][1].
416
416
  #
417
417
  # You can specify multiple resource types by using an array. The array
418
418
  # can include up to 100 items. Note that the length constraint
@@ -420,9 +420,7 @@ module Aws::ResourceGroupsTaggingAPI
420
420
  #
421
421
  #
422
422
  #
423
- # [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces
424
- # [2]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax
425
- # [3]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
423
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
426
424
  # @return [Array<String>]
427
425
  #
428
426
  # @!attribute [rw] include_compliance_details
@@ -440,6 +438,26 @@ module Aws::ResourceGroupsTaggingAPI
440
438
  # parameter is also set to `true`.
441
439
  # @return [Boolean]
442
440
  #
441
+ # @!attribute [rw] resource_arn_list
442
+ # Specifies a list of ARNs of resources for which you want to retrieve
443
+ # tag data. You can't specify both this parameter and any of the
444
+ # pagination parameters (`ResourcesPerPage`, `TagsPerPage`,
445
+ # `PaginationToken`) in the same request. If you specify both, you get
446
+ # an `Invalid Parameter` exception.
447
+ #
448
+ # If a resource specified by this parameter doesn't exist, it
449
+ # doesn't generate an error; it simply isn't included in the
450
+ # response.
451
+ #
452
+ # An ARN (Amazon Resource Name) uniquely identifies a resource. For
453
+ # more information, see [Amazon Resource Names (ARNs) and AWS Service
454
+ # Namespaces][1] in the *AWS General Reference*.
455
+ #
456
+ #
457
+ #
458
+ # [1]: http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
459
+ # @return [Array<String>]
460
+ #
443
461
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/GetResourcesInput AWS API Documentation
444
462
  #
445
463
  class GetResourcesInput < Struct.new(
@@ -449,21 +467,22 @@ module Aws::ResourceGroupsTaggingAPI
449
467
  :tags_per_page,
450
468
  :resource_type_filters,
451
469
  :include_compliance_details,
452
- :exclude_compliant_resources)
470
+ :exclude_compliant_resources,
471
+ :resource_arn_list)
453
472
  SENSITIVE = []
454
473
  include Aws::Structure
455
474
  end
456
475
 
457
476
  # @!attribute [rw] pagination_token
458
- # A string that indicates that the response contains more data than
459
- # can be returned in a single response. To receive additional data,
460
- # specify this string for the `PaginationToken` value in a subsequent
461
- # request.
477
+ # A string that indicates that there is more data available than this
478
+ # response contains. To receive the next part of the response, specify
479
+ # this response value as the `PaginationToken` value in the request
480
+ # for the next page.
462
481
  # @return [String]
463
482
  #
464
483
  # @!attribute [rw] resource_tag_mapping_list
465
484
  # A list of resource ARNs and the tags (keys and values) associated
466
- # with each.
485
+ # with those ARNs.
467
486
  # @return [Array<Types::ResourceTagMapping>]
468
487
  #
469
488
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/GetResourcesOutput AWS API Documentation
@@ -483,10 +502,9 @@ module Aws::ResourceGroupsTaggingAPI
483
502
  # }
484
503
  #
485
504
  # @!attribute [rw] pagination_token
486
- # A string that indicates that additional data is available. Leave
487
- # this value empty for your initial request. If the response includes
488
- # a `PaginationToken`, use that string for this value to request an
489
- # additional page of data.
505
+ # Specifies a `PaginationToken` response value from a previous request
506
+ # to indicate that you want the next page of results. Leave this
507
+ # parameter empty in your initial request.
490
508
  # @return [String]
491
509
  #
492
510
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/GetTagKeysInput AWS API Documentation
@@ -498,10 +516,10 @@ module Aws::ResourceGroupsTaggingAPI
498
516
  end
499
517
 
500
518
  # @!attribute [rw] pagination_token
501
- # A string that indicates that the response contains more data than
502
- # can be returned in a single response. To receive additional data,
503
- # specify this string for the `PaginationToken` value in a subsequent
504
- # request.
519
+ # A string that indicates that there is more data available than this
520
+ # response contains. To receive the next part of the response, specify
521
+ # this response value as the `PaginationToken` value in the request
522
+ # for the next page.
505
523
  # @return [String]
506
524
  #
507
525
  # @!attribute [rw] tag_keys
@@ -526,15 +544,15 @@ module Aws::ResourceGroupsTaggingAPI
526
544
  # }
527
545
  #
528
546
  # @!attribute [rw] pagination_token
529
- # A string that indicates that additional data is available. Leave
530
- # this value empty for your initial request. If the response includes
531
- # a `PaginationToken`, use that string for this value to request an
532
- # additional page of data.
547
+ # Specifies a `PaginationToken` response value from a previous request
548
+ # to indicate that you want the next page of results. Leave this
549
+ # parameter empty in your initial request.
533
550
  # @return [String]
534
551
  #
535
552
  # @!attribute [rw] key
536
- # The key for which you want to list all existing values in the
537
- # specified Region for the AWS account.
553
+ # Specifies the tag key for which you want to list all existing values
554
+ # that are currently used in the specified AWS Region for the calling
555
+ # AWS account.
538
556
  # @return [String]
539
557
  #
540
558
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/GetTagValuesInput AWS API Documentation
@@ -547,14 +565,15 @@ module Aws::ResourceGroupsTaggingAPI
547
565
  end
548
566
 
549
567
  # @!attribute [rw] pagination_token
550
- # A string that indicates that the response contains more data than
551
- # can be returned in a single response. To receive additional data,
552
- # specify this string for the `PaginationToken` value in a subsequent
553
- # request.
568
+ # A string that indicates that there is more data available than this
569
+ # response contains. To receive the next part of the response, specify
570
+ # this response value as the `PaginationToken` value in the request
571
+ # for the next page.
554
572
  # @return [String]
555
573
  #
556
574
  # @!attribute [rw] tag_values
557
- # A list of all tag values for the specified key in the AWS account.
575
+ # A list of all tag values for the specified key currently used in the
576
+ # specified AWS Region for the calling AWS account.
558
577
  # @return [Array<String>]
559
578
  #
560
579
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/GetTagValuesOutput AWS API Documentation
@@ -796,9 +815,12 @@ module Aws::ResourceGroupsTaggingAPI
796
815
  # }
797
816
  #
798
817
  # @!attribute [rw] resource_arn_list
799
- # A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a
800
- # resource. For more information, see [Amazon Resource Names (ARNs)
801
- # and AWS Service Namespaces][1] in the *AWS General Reference*.
818
+ # Specifies the list of ARNs of the resources that you want to apply
819
+ # tags to.
820
+ #
821
+ # An ARN (Amazon Resource Name) uniquely identifies a resource. For
822
+ # more information, see [Amazon Resource Names (ARNs) and AWS Service
823
+ # Namespaces][1] in the *AWS General Reference*.
802
824
  #
803
825
  #
804
826
  #
@@ -806,8 +828,8 @@ module Aws::ResourceGroupsTaggingAPI
806
828
  # @return [Array<String>]
807
829
  #
808
830
  # @!attribute [rw] tags
809
- # The tags that you want to add to the specified resources. A tag
810
- # consists of a key and a value that you define.
831
+ # Specifies a list of tags that you want to add to the specified
832
+ # resources. A tag consists of a key and a value that you define.
811
833
  # @return [Hash<String,String>]
812
834
  #
813
835
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/TagResourcesInput AWS API Documentation
@@ -857,9 +879,12 @@ module Aws::ResourceGroupsTaggingAPI
857
879
  # }
858
880
  #
859
881
  # @!attribute [rw] resource_arn_list
860
- # A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a
861
- # resource. For more information, see [Amazon Resource Names (ARNs)
862
- # and AWS Service Namespaces][1] in the *AWS General Reference*.
882
+ # Specifies a list of ARNs of the resources that you want to remove
883
+ # tags from.
884
+ #
885
+ # An ARN (Amazon Resource Name) uniquely identifies a resource. For
886
+ # more information, see [Amazon Resource Names (ARNs) and AWS Service
887
+ # Namespaces][1] in the *AWS General Reference*.
863
888
  #
864
889
  #
865
890
  #
@@ -867,8 +892,8 @@ module Aws::ResourceGroupsTaggingAPI
867
892
  # @return [Array<String>]
868
893
  #
869
894
  # @!attribute [rw] tag_keys
870
- # A list of the tag keys that you want to remove from the specified
871
- # resources.
895
+ # Specifies a list of tag keys that you want to remove from the
896
+ # specified resources.
872
897
  # @return [Array<String>]
873
898
  #
874
899
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/UntagResourcesInput AWS API Documentation
@@ -881,8 +906,11 @@ module Aws::ResourceGroupsTaggingAPI
881
906
  end
882
907
 
883
908
  # @!attribute [rw] failed_resources_map
884
- # Details of resources that could not be untagged. An error code,
885
- # status code, and error message are returned for each failed item.
909
+ # A map containing a key-value pair for each failed item that
910
+ # couldn't be untagged. The key is the ARN of the failed resource.
911
+ # The value is a `FailureInfo` object that contains an error code, a
912
+ # status code, and an error message. If there are no errors, the
913
+ # `FailedResourcesMap` is empty.
886
914
  # @return [Hash<String,Types::FailureInfo>]
887
915
  #
888
916
  # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/UntagResourcesOutput AWS API Documentation
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-resourcegroupstaggingapi
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.30.0
4
+ version: 1.35.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: 2020-08-05 00:00:00.000000000 Z
11
+ date: 2021-01-21 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.99.0
22
+ version: 3.109.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.99.0
32
+ version: 3.109.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement