aws-sdk-resourcegroupstaggingapi 1.30.0 → 1.35.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 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