aws-sdk-resourcegroups 1.30.0 → 1.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06bd34fe09571c02bdd7dc72cc1a6781e32a8f45d0ec6dd68beb97a827bdbc16
-  data.tar.gz: 9ca2226dc1fc13dfb274cf0f743b1b2d8d6d9a045933a3b1d59f4671921dd9c9
+  metadata.gz: 3b6e28ce269da1a2204f43b306a04a1226552656d71bf08717fe6572ed7004ea
+  data.tar.gz: 952325578f4c31a9175d30270f6ad9607e587e92c0e3915bbcc500e79a6ec4b1
 SHA512:
-  metadata.gz: f199a00eb06f2c1ba2c58e4a4bbf4aedb82e372e50b63d5f65fe80226c087bdbf01850d49d6e6bd383ee42edf841d07ae926d2d851ec0ef3c743f5973931d2bd
-  data.tar.gz: 92b63537b737db78b7d6f58bcdea389f6d4079616a0f38da95413f12141671e6c557bbaaee36ce497d21baf5e6a924efcfffa0af70e44c7ec203fe00216c7c10
+  metadata.gz: da4aaddc000e9ca8402922276c22b83b206971d5a423732d6fb07024e4098655a293b05dd9db7cd58339f4bf85bb3863d536a498cb010bd57c0b60fb0c365679
+  data.tar.gz: 4b9bb0534939d0d1fc3f3045cbb7972c0422eacbde03c5a42734c70218fe33f36fdd84fb506cc128e22a7a5fe2eddfc78bb7e938d39148e96ae4a60ce223ca07

data/lib/aws-sdk-resourcegroups.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-resourcegroups/customizations'
 # @!group service
 module Aws::ResourceGroups
 
-  GEM_VERSION = '1.30.0'
+  GEM_VERSION = '1.31.0'
 
 end

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

@@ -836,7 +836,7 @@ module Aws::ResourceGroups
       req.send_request(options)
     end
 
-    # Returns a list of AWS resource identifiers that matches tne specified
+    # Returns a list of AWS resource identifiers that matches the specified
     # query. The query uses the same format as a resource query in a
     # CreateGroup or UpdateGroupQuery operation.
     #
@@ -1118,7 +1118,7 @@ module Aws::ResourceGroups
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-resourcegroups'
-      context[:gem_version] = '1.30.0'
+      context[:gem_version] = '1.31.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -976,7 +976,72 @@ module Aws::ResourceGroups
     end
 
     # The query that is used to define a resource group or a search for
-    # resources.
+    # resources. A query specifies both a query type and a query string as a
+    # JSON object. See the examples section for example JSON strings.
+    #
+    # The examples that follow are shown as standard JSON strings. If you
+    # include such a string as a parameter to the AWS CLI or an SDK API, you
+    # might need to 'escape' the string into a single line. For example,
+    # see the [Quoting strings][1] in the *AWS CLI User Guide*.
+    #
+    # **Example 1**
+    #
+    # The following generic example shows a resource query JSON string that
+    # includes only resources that meet the following criteria:
+    #
+    # * The resource type must be either `resource_type1` or
+    #   `resource_type2`.
+    #
+    # * The resource must have a tag `Key1` with a value of either `ValueA`
+    #   or `ValueB`.
+    #
+    # * The resource must have a tag `Key2` with a value of either `ValueC`
+    #   or `ValueD`.
+    #
+    # `\{ "Type": "TAG_FILTERS_1_0", "Query": \{ "ResourceTypeFilters": [
+    # "resource_type1", "resource_type2"], "TagFilters": [ \{ "Key": "Key1",
+    # "Values": ["ValueA","ValueB"] \}, \{ "Key":"Key2",
+    # "Values":["ValueC","ValueD"] \} ] \} \}`
+    #
+    # This has the equivalent "shortcut" syntax of the following:
+    #
+    # `\{ "Type": "TAG_FILTERS_1_0", "Query": \{ "ResourceTypeFilters": [
+    # "resource_type1", "resource_type2"], "TagFilters": [ \{ "Key1":
+    # ["ValueA","ValueB"] \}, \{ "Key2": ["ValueC","ValueD"] \} ] \} \}`
+    #
+    # **Example 2**
+    #
+    # The following example shows a resource query JSON string that includes
+    # only Amazon EC2 instances that are tagged `Stage` with a value of
+    # `Test`.
+    #
+    # `\{ "Type": "TAG_FILTERS_1_0", "Query": "\{ "ResourceTypeFilters":
+    # "AWS::EC2::Instance", "TagFilters": \{ "Stage": "Test" \} \} \}`
+    #
+    # **Example 3**
+    #
+    # The following example shows a resource query JSON string that includes
+    # resource of any supported type as long as it is tagged `Stage` with a
+    # value of `Prod`.
+    #
+    # `\{ "Type": "TAG_FILTERS_1_0", "Query": \{ "ResourceTypeFilters":
+    # "AWS::AllSupported", "TagFilters": \{ "Stage": "Prod" \} \} \}`
+    #
+    # **Example 4**
+    #
+    # The following example shows a resource query JSON string that includes
+    # only Amazon EC2 instances and Amazon S3 buckets that are part of the
+    # specified AWS CloudFormation stack.
+    #
+    # `\{ "Type": "CLOUDFORMATION_STACK_1_0", "Query": \{
+    # "ResourceTypeFilters": [ "AWS::EC2::Instance", "AWS::S3::Bucket" ],
+    # "StackIdentifier":
+    # "arn:aws:cloudformation:us-west-2:123456789012:stack/AWStestuseraccount/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE"
+    # \} \}`
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html
     #
     # @note When making an API call, you may pass ResourceQuery
     #   data as a hash:
@@ -989,15 +1054,16 @@ module Aws::ResourceGroups
     # @!attribute [rw] type
     #   The type of the query. You can use the following values:
     #
-    #   * <i> <code>CLOUDFORMATION_STACK_1_0:</code> </i> A JSON syntax that
-    #     lets you specify a CloudFormation stack ARN.
+    #   * <i> <code>CLOUDFORMATION_STACK_1_0:</code> </i>Specifies that the
+    #     `Query` contains an ARN for a CloudFormation stack.
     #
-    #   * <i> <code>TAG_FILTERS_1_0:</code> </i> A JSON syntax that lets you
-    #     specify a collection of simple tag filters for resource types and
-    #     tags, as supported by the AWS Tagging API [ `ResourceTypeFilters`
-    #     parameter of the `tagging:GetResources` ][1] operation. If you
-    #     specify more than one tag key, only resources that match all tag
-    #     keys, and at least one value of each specified tag key, are
+    #   * <i> <code>TAG_FILTERS_1_0:</code> </i>Specifies that the `Query`
+    #     parameter contains a JSON string that represents a collection of
+    #     simple tag filters for resource types and tags. The JSON string
+    #     uses a syntax similar to the ` GetResources ` operation, but uses
+    #     only the `  ResourceTypeFilters ` and ` TagFilters ` fields. If
+    #     you specify more than one tag key, only resources that match all
+    #     tag keys, and at least one value of each specified tag key, are
     #     returned in your query. If you specify more than one value for a
     #     tag key, a resource matches the filter if it has a tag key value
     #     that matches *any* of the specified values.
@@ -1005,38 +1071,31 @@ module Aws::ResourceGroups
     #     For example, consider the following sample query for resources
     #     that have two tags, `Stage` and `Version`, with two values each:
     #
-    #     `[\{"Key":"Stage","Values":["Test","Deploy"]\},\{"Key":"Version","Values":["1","2"]\}]`
+    #     `[\{"Stage":["Test","Deploy"]\},\{"Version":["1","2"]\}]`
     #
     #     The results of this query could include the following.
     #
     #     * An EC2 instance that has the following two tags:
-    #       `\{"Key":"Stage","Value":"Deploy"\}`, and
-    #       `\{"Key":"Version","Value":"2"\}`
+    #       `\{"Stage":"Deploy"\}`, and `\{"Version":"2"\}`
     #
     #     * An S3 bucket that has the following two tags:
-    #       `\{"Key":"Stage","Value":"Test"\}`, and
-    #       `\{"Key":"Version","Value":"1"\}`
+    #       `\{"Stage":"Test"\}`, and `\{"Version":"1"\}`
     #
     #     The query would not include the following items in the results,
     #     however.
     #
     #     * An EC2 instance that has only the following tag:
-    #       `\{"Key":"Stage","Value":"Deploy"\}`.
+    #       `\{"Stage":"Deploy"\}`.
     #
     #       The instance does not have **all** of the tag keys specified in
     #       the filter, so it is excluded from the results.
     #
     #     * An RDS database that has the following two tags:
-    #       `\{"Key":"Stage","Value":"Archived"\}`, and
-    #       `\{"Key":"Version","Value":"4"\}`
+    #       `\{"Stage":"Archived"\}` and `\{"Version":"4"\}`
     #
     #       The database has all of the tag keys, but none of those keys has
     #       an associated value that matches at least one of the specified
     #       values in the filter.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html#resourcegrouptagging-GetResources-request-ResourceTypeFilters
     #   @return [String]
     #
     # @!attribute [rw] query

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-resourcegroups
 version: !ruby/object:Gem::Version
-  version: 1.30.0
+  version: 1.31.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-15 00:00:00.000000000 Z
+date: 2020-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core