aws-sdk-resourcegroupstaggingapi 1.87.0 → 1.88.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d17ccd40a36bb34c5cb229431f62995303a70d1dd14567c4cb5a5ee521461c3f
-  data.tar.gz: 3526b3c654fbb4fd8e06a23e54f5ef6227ab17f753de063bfbdc27f9c13c8dc9
+  metadata.gz: 9d3fe5e0513f2256dceda63d4540c4a307cea463809285038481ef73d0342d5e
+  data.tar.gz: 25373adf324768419a313dc36ad6c8f484602af33057da5ed26ec5b2c80d2ba9
 SHA512:
-  metadata.gz: 83e1a997a8f0aa102d6da7bd8a2bd8ca1a86f1da1569015e064835a82fbae9dcac3a445c1b3b9724ad7fbef2573f4646e4ca4a16af7c0ff8b9335d2ea063fcaf
-  data.tar.gz: 101b5e48ad376a2370675ab97a9c3c576ce0dd627ada33f7c6e67cede7d5f63d526dbca764e89ed90840f93503c72409298168bb4f90bee8abfebd3def05ed7e
+  metadata.gz: 8e665a128acb3052fc2667594f40c65a651121f8115bac176b6ab7c078583a509b843251e550439fe9991a88c7e506b64964c111d020274722fd0158284437c1
+  data.tar.gz: 97db04b722aa92d22fdbc0e350e73085ef2e81bb9c60b52221d990382d9a457d8c41bf5cf4cbe73ece531302b1668ca2b9281035d64d2e0f0bf31c4b235e9149

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.88.0 (2025-11-18)
+------------------
+
+* Feature - Add support for new ListRequiredTags API used to retrieve the required tags specified in a customer's effective tag policy.
+
 1.87.0 (2025-10-31)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.87.0
+1.88.0

data/lib/aws-sdk-resourcegroupstaggingapi/client.rb

@@ -562,6 +562,17 @@ module Aws::ResourceGroupsTaggingAPI
     #   * For more information about ARNs, see [Amazon Resource Names (ARNs)
     #     and Amazon Web Services Service Namespaces][3].
     #
+    #   <note markdown="1"> For the list of services whose resources you can tag using the
+    #   Resource Groups Tagging API, see [Services that support the Resource
+    #   Groups Tagging API][4]. If an Amazon Web Services service isn't
+    #   listed on that page, you might still be able to tag that service's
+    #   resources by using that service's native tagging operations instead
+    #   of using Resource Groups Tagging API operations. All tagged resources,
+    #   whether the tagging used the Resource Groups Tagging API or not, are
+    #   returned by the `Get*` operation.
+    #
+    #    </note>
+    #
     #   You can specify multiple resource types by using a comma separated
     #   array. The array can include up to 100 items. Note that the length
     #   constraint requirement applies to each resource type filter.
@@ -571,6 +582,7 @@ module Aws::ResourceGroupsTaggingAPI
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces
     #   [2]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax
     #   [3]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
+    #   [4]: https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/supported-services.html
     #
     # @option params [Array<String>] :tag_key_filters
     #   Specifies that you want the response to include information for only
@@ -655,9 +667,19 @@ module Aws::ResourceGroupsTaggingAPI
     # `null` value. A null value for `PaginationToken` indicates that there
     # are no more results waiting to be returned.
     #
+    # <note markdown="1"> `GetResources` does not return untagged resources.
+    #
+    #  To find untagged resources in your account, use Amazon Web Services
+    # Resource Explorer with a query that uses `tag:none`. For more
+    # information, see [ Search query syntax reference for Resource
+    # Explorer][2].
+    #
+    #  </note>
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html
+    # [2]: https://docs.aws.amazon.com/resource-explorer/latest/userguide/using-search-query-syntax.html
     #
     # @option params [String] :pagination_token
     #   Specifies a `PaginationToken` response value from a previous request
@@ -671,12 +693,16 @@ module Aws::ResourceGroupsTaggingAPI
     #   a key with values optional. A request can include up to 50 keys, and
     #   each key can include up to 20 values.
     #
+    #   You can't specify both this parameter and the `ResourceArnList`
+    #   parameter in the same request. If you do, you get an `Invalid
+    #   Parameter` exception.
+    #
     #   Note the following when deciding how to use TagFilters:
     #
     #   * If you *don't* specify a `TagFilter`, the response includes all
     #     resources that are currently tagged or ever had a tag. Resources
-    #     that currently don't have tags are shown with an empty tag set,
-    #     like this: `"Tags": []`.
+    #     that were previously tagged, *but do not currently* have tags, are
+    #     shown with an empty tag set, like this: `"Tags": []`.
     #
     #   * If you specify more than one filter in a single request, the
     #     response returns only those resources that satisfy all filters.
@@ -688,8 +714,8 @@ module Aws::ResourceGroupsTaggingAPI
     #   * If you don't specify a value for a key, the response returns all
     #     resources that are tagged with that key, with any or no value.
     #
-    #     For example, for the following filters: `filter1= {keyA,{value1}}`,
-    #     `filter2={keyB,{value2,value3,value4}}`, `filter3= {keyC}`:
+    #     For example, for the following filters: `filter1= {key1,{value1}}`,
+    #     `filter2={key2,{value2,value3,value4}}`, `filter3= {key3}`:
     #
     #     * `GetResources({filter1})` returns resources tagged with
     #       `key1=value1`
@@ -736,14 +762,27 @@ module Aws::ResourceGroupsTaggingAPI
     # @option params [Array<String>] :resource_type_filters
     #   Specifies the resource types that you want included in the response.
     #   The format of each resource type is `service[:resourceType]`. For
-    #   example, specifying a resource type of `ec2` returns all Amazon EC2
+    #   example, specifying a service of `ec2` returns all Amazon EC2
     #   resources (which includes EC2 instances). Specifying a resource type
     #   of `ec2:instance` returns only EC2 instances.
     #
+    #   You can't specify both this parameter and the `ResourceArnList`
+    #   parameter in the same request. If you do, you get an `Invalid
+    #   Parameter` exception.
+    #
     #   The string for each service name and resource type is the same as that
-    #   embedded in a resource's Amazon Resource Name (ARN). For the list of
-    #   services whose resources you can use in this parameter, see [Services
-    #   that support the Resource Groups Tagging API][1].
+    #   embedded in a resource's Amazon Resource Name (ARN).
+    #
+    #   <note markdown="1"> For the list of services whose resources you can tag using the
+    #   Resource Groups Tagging API, see [Services that support the Resource
+    #   Groups Tagging API][1]. If an Amazon Web Services service isn't
+    #   listed on that page, you might still be able to tag that service's
+    #   resources by using that service's native tagging operations instead
+    #   of using Resource Groups Tagging API operations. All tagged resources,
+    #   whether the tagging used the Resource Groups Tagging API or not, are
+    #   returned by the `Get*` operation.
+    #
+    #    </note>
     #
     #   You can specify multiple resource types by using an array. The array
     #   can include up to 100 items. Note that the length constraint
@@ -772,10 +811,19 @@ module Aws::ResourceGroupsTaggingAPI
     #
     # @option params [Array<String>] :resource_arn_list
     #   Specifies a list of ARNs of resources for which you want to retrieve
-    #   tag data. You can't specify both this parameter and any of the
-    #   pagination parameters (`ResourcesPerPage`, `TagsPerPage`,
-    #   `PaginationToken`) in the same request. If you specify both, you get
-    #   an `Invalid Parameter` exception.
+    #   tag data.
+    #
+    #   You can't specify both this parameter and the `ResourceTypeFilters`
+    #   parameter in the same request. If you do, you get an `Invalid
+    #   Parameter` exception.
+    #
+    #   You can't specify both this parameter and the `TagFilters` parameter
+    #   in the same request. If you do, you get an `Invalid Parameter`
+    #   exception.
+    #
+    #   You can't specify both this parameter and any of the pagination
+    #   parameters (`ResourcesPerPage`, `TagsPerPage`, `PaginationToken`) in
+    #   the same request. If you do, you get an `Invalid Parameter` exception.
     #
     #   If a resource specified by this parameter doesn't exist, it doesn't
     #   generate an error; it simply isn't included in the response.
@@ -930,6 +978,52 @@ module Aws::ResourceGroupsTaggingAPI
       req.send_request(options)
     end
 
+    # Lists the required tags for supported resource types in an Amazon Web
+    # Services account.
+    #
+    # @option params [String] :next_token
+    #   A token for requesting another page of required tags if the
+    #   `NextToken` response element indicates that more required tags are
+    #   available. Use the value of the returned `NextToken` element in your
+    #   request until the token comes back as null. Pass null if this is the
+    #   first call.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of required tags.
+    #
+    # @return [Types::ListRequiredTagsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListRequiredTagsOutput#required_tags #required_tags} => Array&lt;Types::RequiredTag&gt;
+    #   * {Types::ListRequiredTagsOutput#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_required_tags({
+    #     next_token: "PaginationToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.required_tags #=> Array
+    #   resp.required_tags[0].resource_type #=> String
+    #   resp.required_tags[0].cloud_formation_resource_types #=> Array
+    #   resp.required_tags[0].cloud_formation_resource_types[0] #=> String
+    #   resp.required_tags[0].reporting_tag_keys #=> Array
+    #   resp.required_tags[0].reporting_tag_keys[0] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/ListRequiredTags AWS API Documentation
+    #
+    # @overload list_required_tags(params = {})
+    # @param [Hash] params ({})
+    def list_required_tags(params = {}, options = {})
+      req = build_request(:list_required_tags, params)
+      req.send_request(options)
+    end
+
     # Generates a report that lists all tagged resources in the accounts
     # across your organization and tells whether each resource is compliant
     # with the effective tag policy. Compliance data is refreshed daily. The
@@ -937,19 +1031,36 @@ module Aws::ResourceGroupsTaggingAPI
     #
     # The generated report is saved to the following location:
     #
-    # `s3://example-bucket/AwsTagPolicies/o-exampleorgid/YYYY-MM-ddTHH:mm:ssZ/report.csv`
+    # `s3://amzn-s3-demo-bucket/AwsTagPolicies/o-exampleorgid/YYYY-MM-ddTHH:mm:ssZ/report.csv`
+    #
+    # For more information about evaluating resource compliance with tag
+    # policies, including the required permissions, review [Permissions for
+    # evaluating organization-wide compliance][1] in the *Tagging Amazon Web
+    # Services Resources and Tag Editor* user guide.
     #
     # You can call this operation only from the organization's management
     # account and from the us-east-1 Region.
     #
+    # If the account associated with the identity used to call
+    # `StartReportCreation` is different from the account that owns the
+    # Amazon S3 bucket, there must be a bucket policy attached to the bucket
+    # to provide access. For more information, review [Amazon S3 bucket
+    # policy for report storage][2] in the *Tagging Amazon Web Services
+    # Resources and Tag Editor* user guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/tag-policies-orgs.html#tag-policies-permissions-org
+    # [2]: https://docs.aws.amazon.com/tag-editor/latest/userguide/tag-policies-orgs.html#bucket-policy
+    #
     # @option params [required, String] :s3_bucket
     #   The name of the Amazon S3 bucket where the report will be stored; for
     #   example:
     #
-    #   `awsexamplebucket`
+    #   `amzn-s3-demo-bucket`
     #
     #   For more information on S3 bucket requirements, including an example
-    #   bucket policy, see the example S3 bucket policy on this page.
+    #   bucket policy, see the example Amazon S3 bucket policy on this page.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -990,6 +1101,15 @@ module Aws::ResourceGroupsTaggingAPI
     #   adding tags. For more information, see the documentation for each
     #   service.
     #
+    # * When you use the [Amazon Web Services Resource Groups Tagging
+    #   API][3] to update tags for Amazon Web Services CloudFormation stack
+    #   sets, Amazon Web Services calls the [Amazon Web Services
+    #   CloudFormation `UpdateStack` ][4] operation. This operation may
+    #   initiate additional resource property updates in addition to the
+    #   desired tag updates. To avoid unexpected resource updates, Amazon
+    #   Web Services recommends that you only apply or update tags to your
+    #   CloudFormation stack sets using Amazon Web Services CloudFormation.
+    #
     # Do not store personally identifiable information (PII) or other
     # confidential or sensitive information in tags. We use tags to provide
     # you with billing and administration services. Tags are not intended to
@@ -1003,14 +1123,24 @@ module Aws::ResourceGroupsTaggingAPI
     # instance using the `TagResources` operation, you must have both of the
     # following permissions:
     #
-    # * `tag:TagResource`
+    # * `tag:TagResources`
     #
     # * `ec2:CreateTags`
     #
+    # <note markdown="1"> In addition, some services might have specific requirements for
+    # tagging some types of resources. For example, to tag an Amazon S3
+    # bucket, you must also have the `s3:GetBucketTagging` permission. If
+    # the expected minimum permissions don't work, check the documentation
+    # for that service's tagging APIs for more information.
+    #
+    #  </note>
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/supported-services.html
     # [2]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions
+    # [3]: https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html
+    # [4]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStack.html
     #
     # @option params [required, Array<String>] :resource_arn_list
     #   Specifies the list of ARNs of the resources that you want to apply
@@ -1078,10 +1208,18 @@ module Aws::ResourceGroupsTaggingAPI
     # from an Amazon EC2 instance using the `UntagResources` operation, you
     # must have both of the following permissions:
     #
-    # * `tag:UntagResource`
+    # * `tag:UntagResources`
     #
     # * `ec2:DeleteTags`
     #
+    # <note markdown="1"> In addition, some services might have specific requirements for
+    # untagging some types of resources. For example, to untag Amazon Web
+    # Services Glue Connection, you must also have the `glue:GetConnection`
+    # permission. If the expected minimum permissions don't work, check the
+    # documentation for that service's tagging APIs for more information.
+    #
+    #  </note>
+    #
     # @option params [required, Array<String>] :resource_arn_list
     #   Specifies a list of ARNs of the resources that you want to remove tags
     #   from.
@@ -1143,7 +1281,7 @@ module Aws::ResourceGroupsTaggingAPI
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-resourcegroupstaggingapi'
-      context[:gem_version] = '1.87.0'
+      context[:gem_version] = '1.88.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-resourcegroupstaggingapi/client_api.rb

@@ -15,6 +15,8 @@ module Aws::ResourceGroupsTaggingAPI
     include Seahorse::Model
 
     AmazonResourceType = Shapes::StringShape.new(name: 'AmazonResourceType')
+    CloudFormationResourceType = Shapes::StringShape.new(name: 'CloudFormationResourceType')
+    CloudFormationResourceTypes = Shapes::ListShape.new(name: 'CloudFormationResourceTypes')
     ComplianceDetails = Shapes::StructureShape.new(name: 'ComplianceDetails')
     ComplianceStatus = Shapes::BooleanShape.new(name: 'ComplianceStatus')
     ConcurrentModificationException = Shapes::StructureShape.new(name: 'ConcurrentModificationException')
@@ -41,17 +43,24 @@ module Aws::ResourceGroupsTaggingAPI
     InternalServiceException = Shapes::StructureShape.new(name: 'InternalServiceException')
     InvalidParameterException = Shapes::StructureShape.new(name: 'InvalidParameterException')
     LastUpdated = Shapes::StringShape.new(name: 'LastUpdated')
+    ListRequiredTagsInput = Shapes::StructureShape.new(name: 'ListRequiredTagsInput')
+    ListRequiredTagsOutput = Shapes::StructureShape.new(name: 'ListRequiredTagsOutput')
+    MaxResultsForListRequiredTags = Shapes::IntegerShape.new(name: 'MaxResultsForListRequiredTags')
     MaxResultsGetComplianceSummary = Shapes::IntegerShape.new(name: 'MaxResultsGetComplianceSummary')
     NonCompliantResources = Shapes::IntegerShape.new(name: 'NonCompliantResources')
     PaginationToken = Shapes::StringShape.new(name: 'PaginationToken')
     PaginationTokenExpiredException = Shapes::StructureShape.new(name: 'PaginationTokenExpiredException')
     Region = Shapes::StringShape.new(name: 'Region')
     RegionFilterList = Shapes::ListShape.new(name: 'RegionFilterList')
+    ReportingTagKeys = Shapes::ListShape.new(name: 'ReportingTagKeys')
+    RequiredTag = Shapes::StructureShape.new(name: 'RequiredTag')
+    RequiredTagsForListRequiredTags = Shapes::ListShape.new(name: 'RequiredTagsForListRequiredTags')
     ResourceARN = Shapes::StringShape.new(name: 'ResourceARN')
     ResourceARNListForGet = Shapes::ListShape.new(name: 'ResourceARNListForGet')
     ResourceARNListForTagUntag = Shapes::ListShape.new(name: 'ResourceARNListForTagUntag')
     ResourceTagMapping = Shapes::StructureShape.new(name: 'ResourceTagMapping')
     ResourceTagMappingList = Shapes::ListShape.new(name: 'ResourceTagMappingList')
+    ResourceType = Shapes::StringShape.new(name: 'ResourceType')
     ResourceTypeFilterList = Shapes::ListShape.new(name: 'ResourceTypeFilterList')
     ResourcesPerPage = Shapes::IntegerShape.new(name: 'ResourcesPerPage')
     S3Bucket = Shapes::StringShape.new(name: 'S3Bucket')
@@ -84,6 +93,8 @@ module Aws::ResourceGroupsTaggingAPI
     UntagResourcesInput = Shapes::StructureShape.new(name: 'UntagResourcesInput')
     UntagResourcesOutput = Shapes::StructureShape.new(name: 'UntagResourcesOutput')
 
+    CloudFormationResourceTypes.member = Shapes::ShapeRef.new(shape: CloudFormationResourceType)
+
     ComplianceDetails.add_member(:noncompliant_keys, Shapes::ShapeRef.new(shape: TagKeyList, location_name: "NoncompliantKeys"))
     ComplianceDetails.add_member(:keys_with_noncompliant_values, Shapes::ShapeRef.new(shape: TagKeyList, location_name: "KeysWithNoncompliantValues"))
     ComplianceDetails.add_member(:compliance_status, Shapes::ShapeRef.new(shape: ComplianceStatus, location_name: "ComplianceStatus"))
@@ -160,11 +171,28 @@ module Aws::ResourceGroupsTaggingAPI
     InvalidParameterException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionMessage, location_name: "Message"))
     InvalidParameterException.struct_class = Types::InvalidParameterException
 
+    ListRequiredTagsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
+    ListRequiredTagsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsForListRequiredTags, location_name: "MaxResults"))
+    ListRequiredTagsInput.struct_class = Types::ListRequiredTagsInput
+
+    ListRequiredTagsOutput.add_member(:required_tags, Shapes::ShapeRef.new(shape: RequiredTagsForListRequiredTags, location_name: "RequiredTags"))
+    ListRequiredTagsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
+    ListRequiredTagsOutput.struct_class = Types::ListRequiredTagsOutput
+
     PaginationTokenExpiredException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionMessage, location_name: "Message"))
     PaginationTokenExpiredException.struct_class = Types::PaginationTokenExpiredException
 
     RegionFilterList.member = Shapes::ShapeRef.new(shape: Region)
 
+    ReportingTagKeys.member = Shapes::ShapeRef.new(shape: TagKey)
+
+    RequiredTag.add_member(:resource_type, Shapes::ShapeRef.new(shape: ResourceType, location_name: "ResourceType"))
+    RequiredTag.add_member(:cloud_formation_resource_types, Shapes::ShapeRef.new(shape: CloudFormationResourceTypes, location_name: "CloudFormationResourceTypes"))
+    RequiredTag.add_member(:reporting_tag_keys, Shapes::ShapeRef.new(shape: ReportingTagKeys, location_name: "ReportingTagKeys"))
+    RequiredTag.struct_class = Types::RequiredTag
+
+    RequiredTagsForListRequiredTags.member = Shapes::ShapeRef.new(shape: RequiredTag)
+
     ResourceARNListForGet.member = Shapes::ShapeRef.new(shape: ResourceARN)
 
     ResourceARNListForTagUntag.member = Shapes::ShapeRef.new(shape: ResourceARN)
@@ -339,6 +367,24 @@ module Aws::ResourceGroupsTaggingAPI
         )
       end)
 
+      api.add_operation(:list_required_tags, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListRequiredTags"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListRequiredTagsInput)
+        o.output = Shapes::ShapeRef.new(shape: ListRequiredTagsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: PaginationTokenExpiredException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottledException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:start_report_creation, Seahorse::Model::Operation.new.tap do |o|
         o.name = "StartReportCreation"
         o.http_method = "POST"

data/lib/aws-sdk-resourcegroupstaggingapi/types.rb

@@ -38,8 +38,8 @@ module Aws::ResourceGroupsTaggingAPI
       include Aws::Structure
     end
 
-    # The target of the operation is currently being modified by a different
-    # request. Try again later.
+    # The request failed because the target of the operation is currently
+    # being modified by a different request. Try again later.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -52,15 +52,15 @@ module Aws::ResourceGroupsTaggingAPI
       include Aws::Structure
     end
 
-    # The request was denied because performing this operation violates a
+    # The request failed because performing the operation would violate a
     # constraint.
     #
     # Some of the reasons in the following list might not apply to this
     # specific operation.
     #
     # * You must meet the prerequisites for using tag policies. For
-    #   information, see [Prerequisites and Permissions for Using Tag
-    #   Policies][1] in the *Organizations User Guide.*
+    #   information, see [Prerequisites and permissions][1] in the *Tagging
+    #   Amazon Web Services resources and Tag Editor* user guide.
     #
     # * You must enable the tag policies service principal
     #   (`tagpolicies.tag.amazonaws.com`) to integrate with Organizations
@@ -71,7 +71,7 @@ module Aws::ResourceGroupsTaggingAPI
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies-prereqs.html
+    # [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/tag-policies-orgs.html#tag-policies-prereqs
     # [2]: https://docs.aws.amazon.com/organizations/latest/APIReference/API_EnableAWSServiceAccess.html
     #
     # @!attribute [rw] message
@@ -219,6 +219,17 @@ module Aws::ResourceGroupsTaggingAPI
     #   * For more information about ARNs, see [Amazon Resource Names (ARNs)
     #     and Amazon Web Services Service Namespaces][3].
     #
+    #   <note markdown="1"> For the list of services whose resources you can tag using the
+    #   Resource Groups Tagging API, see [Services that support the Resource
+    #   Groups Tagging API][4]. If an Amazon Web Services service isn't
+    #   listed on that page, you might still be able to tag that service's
+    #   resources by using that service's native tagging operations instead
+    #   of using Resource Groups Tagging API operations. All tagged
+    #   resources, whether the tagging used the Resource Groups Tagging API
+    #   or not, are returned by the `Get*` operation.
+    #
+    #    </note>
+    #
     #   You can specify multiple resource types by using a comma separated
     #   array. The array can include up to 100 items. Note that the length
     #   constraint requirement applies to each resource type filter.
@@ -228,6 +239,7 @@ module Aws::ResourceGroupsTaggingAPI
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces
     #   [2]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax
     #   [3]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
+    #   [4]: https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/supported-services.html
     #   @return [Array<String>]
     #
     # @!attribute [rw] tag_key_filters
@@ -304,12 +316,16 @@ module Aws::ResourceGroupsTaggingAPI
     #   contain a key with values optional. A request can include up to 50
     #   keys, and each key can include up to 20 values.
     #
+    #   You can't specify both this parameter and the `ResourceArnList`
+    #   parameter in the same request. If you do, you get an `Invalid
+    #   Parameter` exception.
+    #
     #   Note the following when deciding how to use TagFilters:
     #
     #   * If you *don't* specify a `TagFilter`, the response includes all
     #     resources that are currently tagged or ever had a tag. Resources
-    #     that currently don't have tags are shown with an empty tag set,
-    #     like this: `"Tags": []`.
+    #     that were previously tagged, *but do not currently* have tags, are
+    #     shown with an empty tag set, like this: `"Tags": []`.
     #
     #   * If you specify more than one filter in a single request, the
     #     response returns only those resources that satisfy all filters.
@@ -322,8 +338,8 @@ module Aws::ResourceGroupsTaggingAPI
     #     resources that are tagged with that key, with any or no value.
     #
     #     For example, for the following filters: `filter1=
-    #     {keyA,{value1}}`, `filter2={keyB,{value2,value3,value4}}`,
-    #     `filter3= {keyC}`:
+    #     {key1,{value1}}`, `filter2={key2,{value2,value3,value4}}`,
+    #     `filter3= {key3}`:
     #
     #     * `GetResources({filter1})` returns resources tagged with
     #       `key1=value1`
@@ -374,14 +390,27 @@ module Aws::ResourceGroupsTaggingAPI
     # @!attribute [rw] resource_type_filters
     #   Specifies the resource types that you want included in the response.
     #   The format of each resource type is `service[:resourceType]`. For
-    #   example, specifying a resource type of `ec2` returns all Amazon EC2
+    #   example, specifying a service of `ec2` returns all Amazon EC2
     #   resources (which includes EC2 instances). Specifying a resource type
     #   of `ec2:instance` returns only EC2 instances.
     #
+    #   You can't specify both this parameter and the `ResourceArnList`
+    #   parameter in the same request. If you do, you get an `Invalid
+    #   Parameter` exception.
+    #
     #   The string for each service name and resource type is the same as
-    #   that embedded in a resource's Amazon Resource Name (ARN). For the
-    #   list of services whose resources you can use in this parameter, see
-    #   [Services that support the Resource Groups Tagging API][1].
+    #   that embedded in a resource's Amazon Resource Name (ARN).
+    #
+    #   <note markdown="1"> For the list of services whose resources you can tag using the
+    #   Resource Groups Tagging API, see [Services that support the Resource
+    #   Groups Tagging API][1]. If an Amazon Web Services service isn't
+    #   listed on that page, you might still be able to tag that service's
+    #   resources by using that service's native tagging operations instead
+    #   of using Resource Groups Tagging API operations. All tagged
+    #   resources, whether the tagging used the Resource Groups Tagging API
+    #   or not, are returned by the `Get*` operation.
+    #
+    #    </note>
     #
     #   You can specify multiple resource types by using an array. The array
     #   can include up to 100 items. Note that the length constraint
@@ -413,10 +442,20 @@ module Aws::ResourceGroupsTaggingAPI
     #
     # @!attribute [rw] resource_arn_list
     #   Specifies a list of ARNs of resources for which you want to retrieve
-    #   tag data. You can't specify both this parameter and any of the
-    #   pagination parameters (`ResourcesPerPage`, `TagsPerPage`,
-    #   `PaginationToken`) in the same request. If you specify both, you get
-    #   an `Invalid Parameter` exception.
+    #   tag data.
+    #
+    #   You can't specify both this parameter and the `ResourceTypeFilters`
+    #   parameter in the same request. If you do, you get an `Invalid
+    #   Parameter` exception.
+    #
+    #   You can't specify both this parameter and the `TagFilters`
+    #   parameter in the same request. If you do, you get an `Invalid
+    #   Parameter` exception.
+    #
+    #   You can't specify both this parameter and any of the pagination
+    #   parameters (`ResourcesPerPage`, `TagsPerPage`, `PaginationToken`) in
+    #   the same request. If you do, you get an `Invalid Parameter`
+    #   exception.
     #
     #   If a resource specified by this parameter doesn't exist, it
     #   doesn't generate an error; it simply isn't included in the
@@ -558,23 +597,28 @@ module Aws::ResourceGroupsTaggingAPI
       include Aws::Structure
     end
 
-    # This error indicates one of the following:
+    # The request failed because of one of the following reasons:
     #
-    # * A parameter is missing.
+    # * A required parameter is missing.
     #
-    # * A malformed string was supplied for the request parameter.
+    # * A provided string parameter is malformed.
     #
-    # * An out-of-range value was supplied for the request parameter.
+    # * An provided parameter value is out of range.
     #
     # * The target ID is invalid, unsupported, or doesn't exist.
     #
     # * You can't access the Amazon S3 bucket for report storage. For more
-    #   information, see [Additional Requirements for Organization-wide Tag
-    #   Compliance Reports][1] in the *Organizations User Guide.*
+    #   information, see [Amazon S3 bucket policy for report storage][1] in
+    #   the *Tagging Amazon Web Services resources and Tag Editor* user
+    #   guide.
     #
+    # * The partition specified in an ARN parameter in the request doesn't
+    #   match the partition where you invoked the operation. The partition
+    #   is specified by the second field of the ARN.
     #
     #
-    # [1]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies-prereqs.html#bucket-policies-org-report
+    #
+    # [1]: https://docs.aws.amazon.com/tag-editor/latest/userguide/tag-policies-orgs.html#bucket-policy
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -587,8 +631,50 @@ module Aws::ResourceGroupsTaggingAPI
       include Aws::Structure
     end
 
-    # A `PaginationToken` is valid for a maximum of 15 minutes. Your request
-    # was denied because the specified `PaginationToken` has expired.
+    # @!attribute [rw] next_token
+    #   A token for requesting another page of required tags if the
+    #   `NextToken` response element indicates that more required tags are
+    #   available. Use the value of the returned `NextToken` element in your
+    #   request until the token comes back as null. Pass null if this is the
+    #   first call.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of required tags.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/ListRequiredTagsInput AWS API Documentation
+    #
+    class ListRequiredTagsInput < Struct.new(
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] required_tags
+    #   The required tags.
+    #   @return [Array<Types::RequiredTag>]
+    #
+    # @!attribute [rw] next_token
+    #   A token for requesting another page of required tags if the
+    #   `NextToken` response element indicates that more required tags are
+    #   available. Use the value of the returned `NextToken` element in your
+    #   request until the token comes back as null. Pass null if this is the
+    #   first call.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/ListRequiredTagsOutput AWS API Documentation
+    #
+    class ListRequiredTagsOutput < Struct.new(
+      :required_tags,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The request failed because the specified `PaginationToken` has
+    # expired. A `PaginationToken` is valid for a maximum of 15 minutes.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -601,6 +687,33 @@ module Aws::ResourceGroupsTaggingAPI
       include Aws::Structure
     end
 
+    # Information that describes the required tags for a given resource
+    # type.
+    #
+    # @!attribute [rw] resource_type
+    #   Describes the resource type for the required tag keys.
+    #   @return [String]
+    #
+    # @!attribute [rw] cloud_formation_resource_types
+    #   Describes the CloudFormation resource type assigned the required tag
+    #   keys.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] reporting_tag_keys
+    #   These tag keys are marked as `required` in the
+    #   `report_required_tag_for` block of the effective tag policy.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/RequiredTag AWS API Documentation
+    #
+    class RequiredTag < Struct.new(
+      :resource_type,
+      :cloud_formation_resource_types,
+      :reporting_tag_keys)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A list of resource ARNs and the tags (keys and values) that are
     # associated with each.
     #
@@ -633,10 +746,10 @@ module Aws::ResourceGroupsTaggingAPI
     #   The name of the Amazon S3 bucket where the report will be stored;
     #   for example:
     #
-    #   `awsexamplebucket`
+    #   `amzn-s3-demo-bucket`
     #
     #   For more information on S3 bucket requirements, including an example
-    #   bucket policy, see the example S3 bucket policy on this page.
+    #   bucket policy, see the example Amazon S3 bucket policy on this page.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26/StartReportCreationInput AWS API Documentation
@@ -794,7 +907,8 @@ module Aws::ResourceGroupsTaggingAPI
       include Aws::Structure
     end
 
-    # The request was denied to limit the frequency of submitted requests.
+    # The request failed because it exceeded the allowed frequency of
+    # submitted requests.
     #
     # @!attribute [rw] message
     #   @return [String]

data/lib/aws-sdk-resourcegroupstaggingapi.rb

@@ -54,7 +54,7 @@ module Aws::ResourceGroupsTaggingAPI
   autoload :EndpointProvider, 'aws-sdk-resourcegroupstaggingapi/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-resourcegroupstaggingapi/endpoints'
 
-  GEM_VERSION = '1.87.0'
+  GEM_VERSION = '1.88.0'
 
 end
 

data/sig/client.rbs

@@ -153,6 +153,18 @@ module Aws
                           ) -> _GetTagValuesResponseSuccess
                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetTagValuesResponseSuccess
 
+      interface _ListRequiredTagsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListRequiredTagsOutput]
+        def required_tags: () -> ::Array[Types::RequiredTag]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ResourceGroupsTaggingAPI/Client.html#list_required_tags-instance_method
+      def list_required_tags: (
+                                ?next_token: ::String,
+                                ?max_results: ::Integer
+                              ) -> _ListRequiredTagsResponseSuccess
+                            | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListRequiredTagsResponseSuccess
+
       interface _StartReportCreationResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::StartReportCreationOutput]
       end

data/sig/types.rbs

@@ -110,11 +110,30 @@ module Aws::ResourceGroupsTaggingAPI
       SENSITIVE: []
     end
 
+    class ListRequiredTagsInput
+      attr_accessor next_token: ::String
+      attr_accessor max_results: ::Integer
+      SENSITIVE: []
+    end
+
+    class ListRequiredTagsOutput
+      attr_accessor required_tags: ::Array[Types::RequiredTag]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class PaginationTokenExpiredException
       attr_accessor message: ::String
       SENSITIVE: []
     end
 
+    class RequiredTag
+      attr_accessor resource_type: ::String
+      attr_accessor cloud_formation_resource_types: ::Array[::String]
+      attr_accessor reporting_tag_keys: ::Array[::String]
+      SENSITIVE: []
+    end
+
     class ResourceTagMapping
       attr_accessor resource_arn: ::String
       attr_accessor tags: ::Array[Types::Tag]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-resourcegroupstaggingapi
 version: !ruby/object:Gem::Version
-  version: 1.87.0
+  version: 1.88.0
 platform: ruby
 authors:
 - Amazon Web Services