# AWS Resource Groups Resource Groups API Reference

> AWS Resource Groups lets you organize AWS resources such as Amazon Elastic Compute Cloud instances, Amazon Relational Database Service databases, and Amazon Simple Storage Service buckets into groups using criteria that you define as tags. A resource group is a collection of resources that match the resource types specified in a query, and share one or more tags or portions of tags. You can create a group of resources based on their roles in your cloud infrastructure, lifecycle stages, regions, application layers, or virtually any criteria. Resource Groups enable you to automate management tasks, such as those in AWS Systems Manager Automation documents, on tag-related resources in AWS Systems Manager. Groups of tagged resources also let you quickly view a custom console in AWS Systems Manager that shows AWS Config compliance and other monitoring data about member resources.

- [Welcome](https://docs.aws.amazon.com/ARG/latest/APIReference/Welcome.md)
- [Common Parameters](https://docs.aws.amazon.com/ARG/latest/APIReference/CommonParameters.md)
- [Common Error Types](https://docs.aws.amazon.com/ARG/latest/APIReference/CommonErrors.md)

## [Actions](https://docs.aws.amazon.com/ARG/latest/APIReference/API_Operations.md)

- [CancelTagSyncTask](https://docs.aws.amazon.com/ARG/latest/APIReference/API_CancelTagSyncTask.md): Cancels the specified tag-sync task.
- [CreateGroup](https://docs.aws.amazon.com/ARG/latest/APIReference/API_CreateGroup.md): Creates a resource group with the specified name and description.
- [DeleteGroup](https://docs.aws.amazon.com/ARG/latest/APIReference/API_DeleteGroup.md): Deletes the specified resource group.
- [GetAccountSettings](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GetAccountSettings.md): Retrieves the current status of optional features in Resource Groups.
- [GetGroup](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GetGroup.md): Returns information about a specified resource group.
- [GetGroupConfiguration](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GetGroupConfiguration.md): Retrieves the service configuration associated with the specified resource group.
- [GetGroupQuery](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GetGroupQuery.md): Retrieves the resource query associated with the specified resource group.
- [GetTags](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GetTags.md): Returns a list of tags that are associated with a resource group, specified by an Amazon resource name (ARN).
- [GetTagSyncTask](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GetTagSyncTask.md): Returns information about a specified tag-sync task.
- [GroupResources](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GroupResources.md): Adds the specified resources to the specified group.
- [ListGroupingStatuses](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ListGroupingStatuses.md): Returns the status of the last grouping or ungrouping action for each resource in the specified application group.
- [ListGroupResources](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ListGroupResources.md): Returns a list of Amazon resource names (ARNs) of the resources that are members of a specified resource group.
- [ListGroups](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ListGroups.md): Returns a list of existing Resource Groups in your account.
- [ListTagSyncTasks](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ListTagSyncTasks.md): Returns a list of tag-sync tasks.
- [PutGroupConfiguration](https://docs.aws.amazon.com/ARG/latest/APIReference/API_PutGroupConfiguration.md): Attaches a service configuration to the specified group.
- [SearchResources](https://docs.aws.amazon.com/ARG/latest/APIReference/API_SearchResources.md): Returns a list of AWS resource identifiers that matches the specified query.
- [StartTagSyncTask](https://docs.aws.amazon.com/ARG/latest/APIReference/API_StartTagSyncTask.md): Creates a new tag-sync task to onboard and sync resources tagged with a specific tag key-value pair to an application.
- [Tag](https://docs.aws.amazon.com/ARG/latest/APIReference/API_Tag.md): Adds tags to a resource group with the specified Amazon resource name (ARN).
- [UngroupResources](https://docs.aws.amazon.com/ARG/latest/APIReference/API_UngroupResources.md): Removes the specified resources from the specified group.
- [Untag](https://docs.aws.amazon.com/ARG/latest/APIReference/API_Untag.md): Deletes tags from a specified resource group.
- [UpdateAccountSettings](https://docs.aws.amazon.com/ARG/latest/APIReference/API_UpdateAccountSettings.md)
- [UpdateGroup](https://docs.aws.amazon.com/ARG/latest/APIReference/API_UpdateGroup.md): Updates the description for an existing group.
- [UpdateGroupQuery](https://docs.aws.amazon.com/ARG/latest/APIReference/API_UpdateGroupQuery.md): Updates the resource query of a group.


## [Data Types](https://docs.aws.amazon.com/ARG/latest/APIReference/API_Types.md)

- [AccountSettings](https://docs.aws.amazon.com/ARG/latest/APIReference/API_AccountSettings.md): The Resource Groups settings for this AWS account.
- [FailedResource](https://docs.aws.amazon.com/ARG/latest/APIReference/API_FailedResource.md): A resource that failed to be added to or removed from a group.
- [Group](https://docs.aws.amazon.com/ARG/latest/APIReference/API_Group.md): A resource group that contains AWS resources.
- [GroupConfiguration](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GroupConfiguration.md): A service configuration associated with a resource group.
- [GroupConfigurationItem](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GroupConfigurationItem.md): An item in a group configuration.
- [GroupConfigurationParameter](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GroupConfigurationParameter.md): A parameter for a group configuration item.
- [GroupFilter](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GroupFilter.md): A filter collection that you can use to restrict the results from a List operation to only those you want to include.
- [GroupIdentifier](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GroupIdentifier.md): The unique identifiers for a resource group.
- [GroupingStatusesItem](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GroupingStatusesItem.md): The information about a grouping or ungrouping resource action.
- [GroupQuery](https://docs.aws.amazon.com/ARG/latest/APIReference/API_GroupQuery.md): A mapping of a query attached to a resource group that determines the AWS resources that are members of the group.
- [ListGroupingStatusesFilter](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ListGroupingStatusesFilter.md): A filter name and value pair that is used to obtain more specific results from the list of grouping statuses.
- [ListGroupResourcesItem](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ListGroupResourcesItem.md): A structure returned by the ListGroupResources operation that contains identity and group membership status information for one of the resources in the group.
- [ListTagSyncTasksFilter](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ListTagSyncTasksFilter.md): Returns tag-sync tasks filtered by the Amazon resource name (ARN) or name of a specified application group.
- [PendingResource](https://docs.aws.amazon.com/ARG/latest/APIReference/API_PendingResource.md): A structure that identifies a resource that is currently pending addition to the group as a member.
- [QueryError](https://docs.aws.amazon.com/ARG/latest/APIReference/API_QueryError.md): A two-part error structure that can occur in ListGroupResources or SearchResources.
- [ResourceFilter](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ResourceFilter.md): A filter name and value pair that is used to obtain more specific results from a list of resources.
- [ResourceIdentifier](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ResourceIdentifier.md): A structure that contains the ARN of a resource and its resource type.
- [ResourceQuery](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ResourceQuery.md): The query you can use to define a resource group or a search for resources.
- [ResourceStatus](https://docs.aws.amazon.com/ARG/latest/APIReference/API_ResourceStatus.md): A structure that identifies the current group membership status for a resource.
- [TagSyncTaskItem](https://docs.aws.amazon.com/ARG/latest/APIReference/API_TagSyncTaskItem.md): The Amazon resource name (ARN) of the tag-sync task.


## Full content

The entire guide is also available as a single markdown file, useful for feeding the full guide to an LLM in one pass:

- [Complete guide (single file)](https://docs.aws.amazon.com/ARG/latest/APIReference/full.md)