Skip to content

/AWS1/CL_RGR=>CREATEGROUP()

About CreateGroup

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

Method Signature

IMPORTING

Required arguments:

IV_NAME TYPE /AWS1/RGRGROUPNAME /AWS1/RGRGROUPNAME

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 AWS, aws, or any other possible capitalization; these are reserved. A resource group name must be unique within each Amazon Web Services Region in your Amazon Web Services account.

Optional arguments:

IV_DESCRIPTION TYPE /AWS1/RGRDESCRIPTION /AWS1/RGRDESCRIPTION

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

IO_RESOURCEQUERY TYPE REF TO /AWS1/CL_RGRRESOURCEQUERY /AWS1/CL_RGRRESOURCEQUERY

The resource query that determines which Amazon Web Services resources are members of this group. For more information about resource queries, see Create a tag-based group in Resource Groups.

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

IT_TAGS TYPE /AWS1/CL_RGRTAGS_W=>TT_TAGS TT_TAGS

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

IT_CONFIGURATION TYPE /AWS1/CL_RGRGROUPCONFITEM=>TT_GROUPCONFIGURATIONLIST TT_GROUPCONFIGURATIONLIST

A configuration associates the resource group with an Amazon Web Services service and specifies how the service can interact with the resources in the group. A configuration is an array of GroupConfigurationItem elements. For details about the syntax of service configurations, see Service configurations for Resource Groups.

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

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_RGRCREATEGROUPOUTPUT /AWS1/CL_RGRCREATEGROUPOUTPUT