v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1418104117.3 KB

Creates a resource group with the specified name and description. You can optionally include either a resource query or a service configuration. For more information about constructing a resource query, see Build queries and groups in Resource Groups in the Resource Groups User Guide. For more information about service-linked groups and service configurations, see Service configurations for Resource Groups.

Minimum permissions

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

  • resource-groups:CreateGroup
post/groups

Request body

Namestring required

The name of the group, which is the identifier of the group in other 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 <code>AWS</code> or <code>aws</code>; these are reserved. A resource group name must be unique within each Amazon Web Services Region in your Amazon Web Services account.

Descriptionstring

The description of the resource group. Descriptions can consist of letters, numbers, hyphens, underscores, periods, and spaces.

Tagsobject

The tags to add to the group. A tag is key-value pair string.

Response

Success

Tagsobject

The tags associated with the group.