Menu
AWS Management Console
Getting Started Guide (Version 1.0)

Creating a Resource Group

Note

This content describes legacy Resource Groups. For information about the new AWS Resource Groups service, see the AWS Resource Groups User Guide.

To create a resource group, you start by tagging your resources (if you have not already done so). Next, you create a view of resources that have common tags or common strings in those tags. You can create your own custom tags or use tags created by others in your same account. You also can use the tags that AWS automatically creates, such as the stack name in AWS CloudFormation. To use Tag Editor to add, remove, and manage tags, see Working with Tag Editor. For a list of ways to tag resources within their respective services, see Applying Tags.

Every tag consists of a key and a value. In search engine terms, adding values is like searching for them with the OR operator (all items found are included). But adding keys is like searching for them with AND (only items with all keys are included). As a result, adding more values to each tag key that you specify can increase the size of your resource group, but adding more keys might reduce the group size.

For example, suppose that you have an account with only two resources, a pair of Amazon EC2 instances. To each instance you assign a tag with the key name Stack. One of the stack keys has the value Production and the other has the value Test. One of the instances also has a tag with the key name Owner and the value Jan.


                Adding values finds more resources, adding keys finds fewer

If you create a resource group with the Stack key and both Production and Test values, your group has two members. If you then add the Owner key to your group definition, your group shrinks to one because only one instance has that key.

You can also create groups based on a portion of a tag value. For example, if you have alpha, beta, and release versions of a project, you might have a naming scheme for each resource's name key that includes multiple points of information. For example, you might have several Amazon S3 buckets whose Name keys have values like John Alpha Bucket, John Beta Bucket, Mary Alpha Bucket, and so on. To create a resource group for your alpha version, you would specify only tags whose value includes Alpha. Or you could create a group of all buckets by specifying that the tag value include Bucket.

Not every AWS resource can be included in a resource group. For a list of currently supported resources, see Supported Resources.

To create a resource group, you begin by searching for tags or tag strings that your group has in common. You perform this search either on the Create a resource group page or with Tag Editor.

To create a resource group

  1. Sign in to the AWS Management Console. On the navigation bar, choose Resource Groups, and then choose Create a Resource Group.

  2. On the Create a resource group page, for Group name, type a name for your group.

  3. For Tags, choose the name of a tag key in the first box. You can type in the box to search for a key based on characters it contains.

  4. (Optional) Choose the box next to that and do any of the following:

    • Leave the box empty to find tags with the specified key and any value.

       

    • Select Empty value to find tags with the specified key but no value.

       

    • Type one or more characters to find the values that you are looking for. Select a value from the list to find an exact match or select the Contains: option to find values that contain the characters that you typed.

      If you don’t see any values listed, you might not have permissions to view available tags. In that case, you can simply type in a complete value and press Enter to start searching.

       

    • Choose the x next to an item that you added to remove it from the search criteria.

    You can repeat any of the preceding steps to search for multiple values for each tag key. Resources whose values have any of the criteria for that particular key are included in the resource group. The searches are case sensitive.

    For more information about tag keys and values, see What Is a Tag?

    Note

    Before a key and its values appear in the autocomplete list, they must have been applied to at least one resource in the current account. If you don’t see a tag that you just applied to a resource, try refreshing your browser window.

    If the autocomplete list still doesn't work, you might need to contact your administrator to get the necessary permissions. For more information, see Obtaining Permissions for Resource Groups and Tag Editor.

  5. (Optional) To further refine your group, use another row of Tags boxes to specify more tag keys and values. The group now contains only those resources that have all the specified tags, so the more tags that you specify, the fewer resources your group contains. If you change your mind, choose Remove next to any row.

  6. (Optional) For Regions, choose the regions that you want to include in your group. Repeat for as many regions as you want. To remove a region, choose the x by its name. Leave the box empty to include all regions.

  7. (Optional) For Resource types, choose the kind of resources that you want to include in your group. Repeat for as many resource types as you want. To remove a resource type, choose the x by its name. Leave the box empty to include all resource types.

  8. (Optional) When you have your preferred settings, choose Preview to see which resources are included based on your current settings. You can change any of the previous settings, and then choose Preview again.

  9. When you are satisfied with your group, choose Save.

If you need to change the settings later, see Modifying What Resources Are in a Group.

To create a resource group from Tag Editor search results

  1. In Tag Editor, search for the resources that you want in your group. You must include at least one tag key in your search.

  2. When the search is complete, choose View as resource group.

  3. In the space provided, type a name for your resource group.

  4. (Optional) Modify the settings for the resource group as explained in the preceding procedure. To see your changes, choose Preview.

  5. When you are satisfied with your group, choose Save.