PutGroupConfiguration - AWS Resource Groups


Attaches a service configuration to the specified group. This occurs asynchronously, and can take time to complete. You can use GetGroupConfiguration to check the status of the update.

Minimum permissions

To run this command, you must have the following permissions:

  • resource-groups:PutGroupConfiguration

Request Syntax

POST /put-group-configuration HTTP/1.1 Content-type: application/json { "Configuration": [ { "Parameters": [ { "Name": "string", "Values": [ "string" ] } ], "Type": "string" } ], "Group": "string" }

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.


The new configuration to associate with the specified group. 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.

For information about the syntax of a service configuration, see Service configurations for resource groups.


A resource group can contain either a Configuration or a ResourceQuery, but not both.

Type: Array of GroupConfigurationItem objects

Array Members: Maximum number of 2 items.

Required: No


The name or ARN of the resource group with the configuration that you want to update.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: (arn:aws(-[a-z]+)*:resource-groups:[a-z]{2}(-[a-z]+)+-\d{1}:[0-9]{12}:group/)?[a-zA-Z0-9_\.-]{1,128}

Required: No

Response Syntax

HTTP/1.1 202

Response Elements

If the action is successful, the service sends back an HTTP 202 response with an empty HTTP body.


For information about the errors that are common to all actions, see Common Errors.


The request includes one or more parameters that violate validation rules.

HTTP Status Code: 400


The caller isn't authorized to make the request. Check permissions.

HTTP Status Code: 403


An internal error occurred while processing the request. Try again later.

HTTP Status Code: 500


The request uses an HTTP method that isn't allowed for the specified resource.

HTTP Status Code: 405


One or more of the specified resources don't exist.

HTTP Status Code: 404


You've exceeded throttling limits by making too many requests in a period of time.

HTTP Status Code: 429



The following example attaches a configuration that limits the group to containing EC2 capacity reservations.

Sample Request

POST /put-group-configuration HTTP/1.1 Content-type: application/json { "Group": "CRPGroup", "Configuration": [ { "Type": "AWS::EC2::CapacityReservationPool" }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::CapacityReservation" ] } ] } ] }

Sample Response

HTTP/1.1 202 Accepted


The following example attaches a configuration to the resource group that limits the group to containing only EC2 hosts and provides settings that are enforced on any EC2 instances that are launched into this group.

Sample Request

POST /put-group-configuration HTTP/1.1 Content-type: application/json { "Group": "HostManagementGroup", "Configuration": [ { "Type": "AWS::EC2::HostManagement", "Parameters": [ { "Name":"any-host-based-license-configuration", "Values":["true"] }, { "Name":"allowed-host-families", "Values":["c5"] } ] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": ["AWS::EC2::Host"] }, { "Name": "deletion-protection", "Values": ["UNLESS_EMPTY"] } ] } ] }

Sample Response

HTTP/1.1 202 Accepted

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: