aws-sdk-resourcegroups 1.22.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aab58ae69703affd666aa56b2b099c6c8604000d270ad3e8529e43b4294376cc
-  data.tar.gz: 43849e71ffbb5a549593f427b7dbc39755a2409b39386b0ec6df42d539757431
+  metadata.gz: d11deac8aab073e36e5c1f6ed18e872b6e532cddbede52d9a6eea6e6e39d24f1
+  data.tar.gz: c846995796d93f43edf31e8a61b0b152f6a6fa2b44fb785b576151586fa7fb02
 SHA512:
-  metadata.gz: c98435be4656c23770591fde0c574c9e8094b9b6592b0550644a87a0b989aa7a69d7da92ff4781d56ce8b09f8d0a8917c3285bdf9938681fc4fd453b33510525
-  data.tar.gz: fc1ceeaeed4feb5bdbb284fc4268e72725a3d6515ae515f3c25413229a080d15260ca92f2c4b9ce9d8e47fd144f4fe533f98c288c3bb255504afe9c08c97a2ec
+  metadata.gz: 57b6f38164521ee6695549f76e12e8880ec4dedf4c8fc4564f8cd4ff291cca6b9129858a527dc8ab2432508c971ba209ac665b8cc6f8ace3c4e57ea4716f80ab
+  data.tar.gz: bf6d5bc545861c81229f61123123bc7b74f242c72d4ada99248c02153e5a26963283ac5e924818a6d3523cdb56ec0e6eeb4fc40c90eda783015f16ecf7d784cd

data/lib/aws-sdk-resourcegroups.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -45,6 +47,6 @@ require_relative 'aws-sdk-resourcegroups/customizations'
 # @service
 module Aws::ResourceGroups
 
-  GEM_VERSION = '1.22.0'
+  GEM_VERSION = '1.27.0'
 
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
+require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -69,6 +72,7 @@ module Aws::ResourceGroups
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::RestJson)
 
@@ -105,7 +109,7 @@ module Aws::ResourceGroups
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -161,7 +165,7 @@ module Aws::ResourceGroups
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -176,7 +180,7 @@ module Aws::ResourceGroups
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -269,8 +273,7 @@ module Aws::ResourceGroups
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yielded by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
     #     seconds a connection is allowed to sit idle before it is
@@ -282,7 +285,7 @@ module Aws::ResourceGroups
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yielded by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -309,50 +312,73 @@ module Aws::ResourceGroups
 
     # @!group API Operations
 
-    # Creates a group with a specified name, description, and resource
-    # query.
+    # Creates a resource group with the specified name and description. You
+    # can optionally include a resource query, or a service configuration.
     #
     # @option params [required, String] :name
     #   The name of the group, which is the identifier of the group in other
-    #   operations. A resource group name cannot be updated after it is
-    #   created. A resource group name can have a maximum of 128 characters,
-    #   including letters, numbers, hyphens, dots, and underscores. The name
-    #   cannot start with `AWS` or `aws`; these are reserved. A resource group
-    #   name must be unique within your account.
+    #   operations. You can't change the name of a resource group after you
+    #   create it. A resource group name can consist of letters, numbers,
+    #   hyphens, periods, and underscores. The name cannot start with `AWS` or
+    #   `aws`; these are reserved. A resource group name must be unique within
+    #   each AWS Region in your AWS account.
     #
     # @option params [String] :description
-    #   The description of the resource group. Descriptions can have a maximum
-    #   of 511 characters, including letters, numbers, hyphens, underscores,
-    #   punctuation, and spaces.
+    #   The description of the resource group. Descriptions can consist of
+    #   letters, numbers, hyphens, underscores, periods, and spaces.
     #
-    # @option params [required, Types::ResourceQuery] :resource_query
+    # @option params [Types::ResourceQuery] :resource_query
     #   The resource query that determines which AWS resources are members of
     #   this group.
     #
+    #   <note markdown="1"> You can specify either a `ResourceQuery` or a `Configuration`, but not
+    #   both.
+    #
+    #    </note>
+    #
     # @option params [Hash<String,String>] :tags
-    #   The tags to add to the group. A tag is a string-to-string map of
-    #   key-value pairs. Tag keys can have a maximum character length of 128
-    #   characters, and tag values can have a maximum length of 256
-    #   characters.
+    #   The tags to add to the group. A tag is key-value pair string.
+    #
+    # @option params [Array<Types::GroupConfigurationItem>] :configuration
+    #   A configuration associates the resource group with an AWS service and
+    #   specifies how the service can interact with the resources in the
+    #   group. A configuration is an array of GroupConfigurationItem elements.
+    #
+    #   <note markdown="1"> You can specify either a `Configuration` or a `ResourceQuery` in a
+    #   group, but not both.
+    #
+    #    </note>
     #
     # @return [Types::CreateGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateGroupOutput#group #group} => Types::Group
     #   * {Types::CreateGroupOutput#resource_query #resource_query} => Types::ResourceQuery
     #   * {Types::CreateGroupOutput#tags #tags} => Hash&lt;String,String&gt;
+    #   * {Types::CreateGroupOutput#group_configuration #group_configuration} => Types::GroupConfiguration
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_group({
     #     name: "GroupName", # required
-    #     description: "GroupDescription",
-    #     resource_query: { # required
+    #     description: "Description",
+    #     resource_query: {
     #       type: "TAG_FILTERS_1_0", # required, accepts TAG_FILTERS_1_0, CLOUDFORMATION_STACK_1_0
     #       query: "Query", # required
     #     },
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
+    #     configuration: [
+    #       {
+    #         type: "GroupConfigurationType", # required
+    #         parameters: [
+    #           {
+    #             name: "GroupConfigurationParameterName", # required
+    #             values: ["GroupConfigurationParameterValue"],
+    #           },
+    #         ],
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -364,6 +390,20 @@ module Aws::ResourceGroups
     #   resp.resource_query.query #=> String
     #   resp.tags #=> Hash
     #   resp.tags["TagKey"] #=> String
+    #   resp.group_configuration.configuration #=> Array
+    #   resp.group_configuration.configuration[0].type #=> String
+    #   resp.group_configuration.configuration[0].parameters #=> Array
+    #   resp.group_configuration.configuration[0].parameters[0].name #=> String
+    #   resp.group_configuration.configuration[0].parameters[0].values #=> Array
+    #   resp.group_configuration.configuration[0].parameters[0].values[0] #=> String
+    #   resp.group_configuration.proposed_configuration #=> Array
+    #   resp.group_configuration.proposed_configuration[0].type #=> String
+    #   resp.group_configuration.proposed_configuration[0].parameters #=> Array
+    #   resp.group_configuration.proposed_configuration[0].parameters[0].name #=> String
+    #   resp.group_configuration.proposed_configuration[0].parameters[0].values #=> Array
+    #   resp.group_configuration.proposed_configuration[0].parameters[0].values[0] #=> String
+    #   resp.group_configuration.status #=> String, one of "UPDATING", "UPDATE_COMPLETE", "UPDATE_FAILED"
+    #   resp.group_configuration.failure_reason #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/CreateGroup AWS API Documentation
     #
@@ -374,12 +414,15 @@ module Aws::ResourceGroups
       req.send_request(options)
     end
 
-    # Deletes a specified resource group. Deleting a resource group does not
-    # delete resources that are members of the group; it only deletes the
-    # group structure.
+    # Deletes the specified resource group. Deleting a resource group does
+    # not delete any resources that are members of the group; it only
+    # deletes the group structure.
+    #
+    # @option params [String] :group_name
+    #   Don't use this parameter. Use `Group` instead.
     #
-    # @option params [required, String] :group_name
-    #   The name of the resource group to delete.
+    # @option params [String] :group
+    #   The name or the ARN of the resource group to delete.
     #
     # @return [Types::DeleteGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -388,7 +431,8 @@ module Aws::ResourceGroups
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_group({
-    #     group_name: "GroupName", # required
+    #     group_name: "GroupName",
+    #     group: "GroupString",
     #   })
     #
     # @example Response structure
@@ -408,8 +452,11 @@ module Aws::ResourceGroups
 
     # Returns information about a specified resource group.
     #
-    # @option params [required, String] :group_name
-    #   The name of the resource group.
+    # @option params [String] :group_name
+    #   Don't use this parameter. Use `Group` instead.
+    #
+    # @option params [String] :group
+    #   The name or the ARN of the resource group to retrieve.
     #
     # @return [Types::GetGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -418,7 +465,8 @@ module Aws::ResourceGroups
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_group({
-    #     group_name: "GroupName", # required
+    #     group_name: "GroupName",
+    #     group: "GroupString",
     #   })
     #
     # @example Response structure
@@ -436,11 +484,67 @@ module Aws::ResourceGroups
       req.send_request(options)
     end
 
-    # Returns the resource query associated with the specified resource
+    # Returns the service configuration associated with the specified
+    # resource group. AWS Resource Groups supports configurations for the
+    # following resource group types:
+    #
+    # * `AWS::EC2::CapacityReservationPool` - Amazon EC2 capacity
+    #   reservation pools. For more information, see [Working with capacity
+    #   reservation groups][1] in the *EC2 Users Guide*.
+    #
+    # ^
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#create-cr-group
+    #
+    # @option params [String] :group
+    #   The name or the ARN of the resource group.
+    #
+    # @return [Types::GetGroupConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetGroupConfigurationOutput#group_configuration #group_configuration} => Types::GroupConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_group_configuration({
+    #     group: "GroupString",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.group_configuration.configuration #=> Array
+    #   resp.group_configuration.configuration[0].type #=> String
+    #   resp.group_configuration.configuration[0].parameters #=> Array
+    #   resp.group_configuration.configuration[0].parameters[0].name #=> String
+    #   resp.group_configuration.configuration[0].parameters[0].values #=> Array
+    #   resp.group_configuration.configuration[0].parameters[0].values[0] #=> String
+    #   resp.group_configuration.proposed_configuration #=> Array
+    #   resp.group_configuration.proposed_configuration[0].type #=> String
+    #   resp.group_configuration.proposed_configuration[0].parameters #=> Array
+    #   resp.group_configuration.proposed_configuration[0].parameters[0].name #=> String
+    #   resp.group_configuration.proposed_configuration[0].parameters[0].values #=> Array
+    #   resp.group_configuration.proposed_configuration[0].parameters[0].values[0] #=> String
+    #   resp.group_configuration.status #=> String, one of "UPDATING", "UPDATE_COMPLETE", "UPDATE_FAILED"
+    #   resp.group_configuration.failure_reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroupConfiguration AWS API Documentation
+    #
+    # @overload get_group_configuration(params = {})
+    # @param [Hash] params ({})
+    def get_group_configuration(params = {}, options = {})
+      req = build_request(:get_group_configuration, params)
+      req.send_request(options)
+    end
+
+    # Retrieves the resource query associated with the specified resource
     # group.
     #
-    # @option params [required, String] :group_name
-    #   The name of the resource group.
+    # @option params [String] :group_name
+    #   Don't use this parameter. Use `Group` instead.
+    #
+    # @option params [String] :group
+    #   The name or the ARN of the resource group to query.
     #
     # @return [Types::GetGroupQueryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -449,7 +553,8 @@ module Aws::ResourceGroups
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_group_query({
-    #     group_name: "GroupName", # required
+    #     group_name: "GroupName",
+    #     group: "GroupString",
     #   })
     #
     # @example Response structure
@@ -471,8 +576,7 @@ module Aws::ResourceGroups
     # specified by an ARN.
     #
     # @option params [required, String] :arn
-    #   The ARN of the resource group for which you want a list of tags. The
-    #   resource must exist within the account you are using.
+    #   The ARN of the resource group whose tags you want to retrieve.
     #
     # @return [Types::GetTagsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -500,31 +604,101 @@ module Aws::ResourceGroups
       req.send_request(options)
     end
 
+    # Adds the specified resources to the specified group.
+    #
+    # @option params [required, String] :group
+    #   The name or the ARN of the resource group to add resources to.
+    #
+    # @option params [required, Array<String>] :resource_arns
+    #   The list of ARNs for resources to be added to the group.
+    #
+    # @return [Types::GroupResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GroupResourcesOutput#succeeded #succeeded} => Array&lt;String&gt;
+    #   * {Types::GroupResourcesOutput#failed #failed} => Array&lt;Types::FailedResource&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.group_resources({
+    #     group: "GroupString", # required
+    #     resource_arns: ["ResourceArn"], # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.succeeded #=> Array
+    #   resp.succeeded[0] #=> String
+    #   resp.failed #=> Array
+    #   resp.failed[0].resource_arn #=> String
+    #   resp.failed[0].error_message #=> String
+    #   resp.failed[0].error_code #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GroupResources AWS API Documentation
+    #
+    # @overload group_resources(params = {})
+    # @param [Hash] params ({})
+    def group_resources(params = {}, options = {})
+      req = build_request(:group_resources, params)
+      req.send_request(options)
+    end
+
     # Returns a list of ARNs of resources that are members of a specified
     # resource group.
     #
-    # @option params [required, String] :group_name
-    #   The name of the resource group.
+    # @option params [String] :group_name
+    #   Don't use this parameter. Use `Group` instead.
+    #
+    # @option params [String] :group
+    #   The name or the ARN of the resource group
     #
     # @option params [Array<Types::ResourceFilter>] :filters
     #   Filters, formatted as ResourceFilter objects, that you want to apply
-    #   to a ListGroupResources operation.
+    #   to a `ListGroupResources` operation. Filters the results to include
+    #   only those of the specified resource types.
     #
     #   * `resource-type` - Filter resources by their type. Specify up to five
-    #     resource types in the format AWS::ServiceCode::ResourceType. For
-    #     example, AWS::EC2::Instance, or AWS::S3::Bucket.
+    #     resource types in the format `AWS::ServiceCode::ResourceType`. For
+    #     example, `AWS::EC2::Instance`, or `AWS::S3::Bucket`.
     #
     #   ^
     #
+    #   When you specify a `resource-type` filter for `ListGroupResources`,
+    #   AWS Resource Groups validates your filter resource types against the
+    #   types that are defined in the query associated with the group. For
+    #   example, if a group contains only S3 buckets because its query
+    #   specifies only that resource type, but your `resource-type` filter
+    #   includes EC2 instances, AWS Resource Groups does not filter for EC2
+    #   instances. In this case, a `ListGroupResources` request returns a
+    #   `BadRequestException` error with a message similar to the following:
+    #
+    #   `The resource types specified as filters in the request are not
+    #   valid.`
+    #
+    #   The error includes a list of resource types that failed the validation
+    #   because they are not part of the query associated with the group. This
+    #   validation doesn't occur when the group query specifies
+    #   `AWS::AllSupported`, because a group based on such a query can contain
+    #   any of the allowed resource types for the query type (tag-based or AWS
+    #   CloudFormation stack-based queries).
+    #
     # @option params [Integer] :max_results
-    #   The maximum number of group member ARNs that are returned in a single
-    #   call by ListGroupResources, in paginated output. By default, this
-    #   number is 50.
+    #   The total number of results that you want included on each page of the
+    #   response. If you do not include this parameter, it defaults to a value
+    #   that is specific to the operation. If additional items exist beyond
+    #   the maximum you specify, the `NextToken` response element is present
+    #   and has a value (is not null). Include that value as the `NextToken`
+    #   request parameter in the next call to the operation to get the next
+    #   part of the results. Note that the service might return fewer results
+    #   than the maximum even when there are more results available. You
+    #   should check `NextToken` after every operation to ensure that you
+    #   receive all of the results.
     #
     # @option params [String] :next_token
-    #   The NextToken value that is returned in a paginated ListGroupResources
-    #   request. To get the next page of results, run the call again, add the
-    #   NextToken parameter, and specify the NextToken value.
+    #   The parameter for receiving additional results if you receive a
+    #   `NextToken` response in a previous request. A `NextToken` response
+    #   indicates that more output is available. Set this parameter to the
+    #   value provided by a previous call's `NextToken` response to indicate
+    #   where the output should continue from.
     #
     # @return [Types::ListGroupResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -532,10 +706,13 @@ module Aws::ResourceGroups
     #   * {Types::ListGroupResourcesOutput#next_token #next_token} => String
     #   * {Types::ListGroupResourcesOutput#query_errors #query_errors} => Array&lt;Types::QueryError&gt;
     #
+    # 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_group_resources({
-    #     group_name: "GroupName", # required
+    #     group_name: "GroupName",
+    #     group: "GroupString",
     #     filters: [
     #       {
     #         name: "resource-type", # required, accepts resource-type
@@ -569,22 +746,39 @@ module Aws::ResourceGroups
     #
     # @option params [Array<Types::GroupFilter>] :filters
     #   Filters, formatted as GroupFilter objects, that you want to apply to a
-    #   ListGroups operation.
+    #   `ListGroups` operation.
     #
-    #   * `resource-type` - Filter groups by resource type. Specify up to five
-    #     resource types in the format AWS::ServiceCode::ResourceType. For
-    #     example, AWS::EC2::Instance, or AWS::S3::Bucket.
+    #   * `resource-type` - Filter the results to include only those of the
+    #     specified resource types. Specify up to five resource types in the
+    #     format `AWS::ServiceCode::ResourceType `. For example,
+    #     `AWS::EC2::Instance`, or `AWS::S3::Bucket`.
     #
-    #   ^
+    #   * `configuration-type` - Filter the results to include only those
+    #     groups that have the specified configuration types attached. The
+    #     current supported values are:
+    #
+    #     * AWS:EC2::CapacityReservationPool
+    #
+    #     ^
     #
     # @option params [Integer] :max_results
-    #   The maximum number of resource group results that are returned by
-    #   ListGroups in paginated output. By default, this number is 50.
+    #   The total number of results that you want included on each page of the
+    #   response. If you do not include this parameter, it defaults to a value
+    #   that is specific to the operation. If additional items exist beyond
+    #   the maximum you specify, the `NextToken` response element is present
+    #   and has a value (is not null). Include that value as the `NextToken`
+    #   request parameter in the next call to the operation to get the next
+    #   part of the results. Note that the service might return fewer results
+    #   than the maximum even when there are more results available. You
+    #   should check `NextToken` after every operation to ensure that you
+    #   receive all of the results.
     #
     # @option params [String] :next_token
-    #   The NextToken value that is returned in a paginated `ListGroups`
-    #   request. To get the next page of results, run the call again, add the
-    #   NextToken parameter, and specify the NextToken value.
+    #   The parameter for receiving additional results if you receive a
+    #   `NextToken` response in a previous request. A `NextToken` response
+    #   indicates that more output is available. Set this parameter to the
+    #   value provided by a previous call's `NextToken` response to indicate
+    #   where the output should continue from.
     #
     # @return [Types::ListGroupsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -592,12 +786,14 @@ module Aws::ResourceGroups
     #   * {Types::ListGroupsOutput#groups #groups} => Array&lt;Types::Group&gt;
     #   * {Types::ListGroupsOutput#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_groups({
     #     filters: [
     #       {
-    #         name: "resource-type", # required, accepts resource-type
+    #         name: "resource-type", # required, accepts resource-type, configuration-type
     #         values: ["GroupFilterValue"], # required
     #       },
     #     ],
@@ -631,16 +827,26 @@ module Aws::ResourceGroups
     #
     # @option params [required, Types::ResourceQuery] :resource_query
     #   The search query, using the same formats that are supported for
-    #   resource group definition.
+    #   resource group definition. For more information, see CreateGroup.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of group member ARNs returned by `SearchResources`
-    #   in paginated output. By default, this number is 50.
+    #   The total number of results that you want included on each page of the
+    #   response. If you do not include this parameter, it defaults to a value
+    #   that is specific to the operation. If additional items exist beyond
+    #   the maximum you specify, the `NextToken` response element is present
+    #   and has a value (is not null). Include that value as the `NextToken`
+    #   request parameter in the next call to the operation to get the next
+    #   part of the results. Note that the service might return fewer results
+    #   than the maximum even when there are more results available. You
+    #   should check `NextToken` after every operation to ensure that you
+    #   receive all of the results.
     #
     # @option params [String] :next_token
-    #   The NextToken value that is returned in a paginated `SearchResources`
-    #   request. To get the next page of results, run the call again, add the
-    #   NextToken parameter, and specify the NextToken value.
+    #   The parameter for receiving additional results if you receive a
+    #   `NextToken` response in a previous request. A `NextToken` response
+    #   indicates that more output is available. Set this parameter to the
+    #   value provided by a previous call's `NextToken` response to indicate
+    #   where the output should continue from.
     #
     # @return [Types::SearchResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -648,6 +854,8 @@ module Aws::ResourceGroups
     #   * {Types::SearchResourcesOutput#next_token #next_token} => String
     #   * {Types::SearchResourcesOutput#query_errors #query_errors} => Array&lt;Types::QueryError&gt;
     #
+    # 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.search_resources({
@@ -682,14 +890,17 @@ module Aws::ResourceGroups
     # a resource group are not changed if they are not specified in the
     # request parameters.
     #
+    # 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
+    # be used for private or sensitive data.
+    #
     # @option params [required, String] :arn
-    #   The ARN of the resource to which to add tags.
+    #   The ARN of the resource group to which to add tags.
     #
     # @option params [required, Hash<String,String>] :tags
-    #   The tags to add to the specified resource. A tag is a string-to-string
-    #   map of key-value pairs. Tag keys can have a maximum character length
-    #   of 128 characters, and tag values can have a maximum length of 256
-    #   characters.
+    #   The tags to add to the specified resource group. A tag is a
+    #   string-to-string map of key-value pairs.
     #
     # @return [Types::TagOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -720,10 +931,51 @@ module Aws::ResourceGroups
       req.send_request(options)
     end
 
-    # Deletes specified tags from a specified resource.
+    # Removes the specified resources from the specified group.
+    #
+    # @option params [required, String] :group
+    #   The name or the ARN of the resource group from which to remove the
+    #   resources.
+    #
+    # @option params [required, Array<String>] :resource_arns
+    #   The ARNs of the resources to be removed from the group.
+    #
+    # @return [Types::UngroupResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UngroupResourcesOutput#succeeded #succeeded} => Array&lt;String&gt;
+    #   * {Types::UngroupResourcesOutput#failed #failed} => Array&lt;Types::FailedResource&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.ungroup_resources({
+    #     group: "GroupString", # required
+    #     resource_arns: ["ResourceArn"], # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.succeeded #=> Array
+    #   resp.succeeded[0] #=> String
+    #   resp.failed #=> Array
+    #   resp.failed[0].resource_arn #=> String
+    #   resp.failed[0].error_message #=> String
+    #   resp.failed[0].error_code #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UngroupResources AWS API Documentation
+    #
+    # @overload ungroup_resources(params = {})
+    # @param [Hash] params ({})
+    def ungroup_resources(params = {}, options = {})
+      req = build_request(:ungroup_resources, params)
+      req.send_request(options)
+    end
+
+    # Deletes tags from a specified resource group.
     #
     # @option params [required, String] :arn
-    #   The ARN of the resource from which to remove tags.
+    #   The ARN of the resource group from which to remove tags. The command
+    #   removed both the specified keys and any values associated with those
+    #   keys.
     #
     # @option params [required, Array<String>] :keys
     #   The keys of the tags to be removed.
@@ -755,17 +1007,19 @@ module Aws::ResourceGroups
       req.send_request(options)
     end
 
-    # Updates an existing group with a new or changed description. You
-    # cannot update the name of a resource group.
+    # Updates the description for an existing group. You cannot update the
+    # name of a resource group.
+    #
+    # @option params [String] :group_name
+    #   Don't use this parameter. Use `Group` instead.
     #
-    # @option params [required, String] :group_name
-    #   The name of the resource group for which you want to update its
-    #   description.
+    # @option params [String] :group
+    #   The name or the ARN of the resource group to modify.
     #
     # @option params [String] :description
-    #   The description of the resource group. Descriptions can have a maximum
-    #   of 511 characters, including letters, numbers, hyphens, underscores,
-    #   punctuation, and spaces.
+    #   The new description that you want to update the resource group with.
+    #   Descriptions can contain letters, numbers, hyphens, underscores,
+    #   periods, and spaces.
     #
     # @return [Types::UpdateGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -774,8 +1028,9 @@ module Aws::ResourceGroups
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_group({
-    #     group_name: "GroupName", # required
-    #     description: "GroupDescription",
+    #     group_name: "GroupName",
+    #     group: "GroupString",
+    #     description: "Description",
     #   })
     #
     # @example Response structure
@@ -795,12 +1050,15 @@ module Aws::ResourceGroups
 
     # Updates the resource query of a group.
     #
-    # @option params [required, String] :group_name
-    #   The name of the resource group for which you want to edit the query.
+    # @option params [String] :group_name
+    #   Don't use this parameter. Use `Group` instead.
+    #
+    # @option params [String] :group
+    #   The name or the ARN of the resource group to query.
     #
     # @option params [required, Types::ResourceQuery] :resource_query
-    #   The resource query that determines which AWS resources are members of
-    #   the resource group.
+    #   The resource query to determine which AWS resources are members of
+    #   this resource group.
     #
     # @return [Types::UpdateGroupQueryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -809,7 +1067,8 @@ module Aws::ResourceGroups
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_group_query({
-    #     group_name: "GroupName", # required
+    #     group_name: "GroupName",
+    #     group: "GroupString",
     #     resource_query: { # required
     #       type: "TAG_FILTERS_1_0", # required, accepts TAG_FILTERS_1_0, CLOUDFORMATION_STACK_1_0
     #       query: "Query", # required
@@ -844,7 +1103,7 @@ module Aws::ResourceGroups
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-resourcegroups'
-      context[:gem_version] = '1.22.0'
+      context[:gem_version] = '1.27.0'
       Seahorse::Client::Request.new(handlers, context)
     end