Creates a resource group with the specified name and description¶

Description¶

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

Usage¶

resourcegroups_create_group(Name, Description, ResourceQuery, Tags,
  Configuration, Criticality, Owner, DisplayName)

Arguments¶

• Name

  [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 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.

• Description

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

• ResourceQuery

  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.

• Tags

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

• Configuration

  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.

• Criticality

  The critical rank of the application group on a scale of 1 to 10, with a rank of 1 being the most critical, and a rank of 10 being least critical.

• Owner

  A name, email address or other identifier for the person or group who is considered as the owner of this application group within your organization.

• DisplayName

  The name of the application group, which you can change at any time.

Value¶

A list with the following syntax:

list(
  Group = list(
    GroupArn = "string",
    Name = "string",
    Description = "string",
    Criticality = 123,
    Owner = "string",
    DisplayName = "string",
    ApplicationTag = list(
      "string"
    )
  ),
  ResourceQuery = list(
    Type = "TAG_FILTERS_1_0"|"CLOUDFORMATION_STACK_1_0",
    Query = "string"
  ),
  Tags = list(
    "string"
  ),
  GroupConfiguration = list(
    Configuration = list(
      list(
        Type = "string",
        Parameters = list(
          list(
            Name = "string",
            Values = list(
              "string"
            )
          )
        )
      )
    ),
    ProposedConfiguration = list(
      list(
        Type = "string",
        Parameters = list(
          list(
            Name = "string",
            Values = list(
              "string"
            )
          )
        )
      )
    ),
    Status = "UPDATING"|"UPDATE_COMPLETE"|"UPDATE_FAILED",
    FailureReason = "string"
  )
)

Request syntax¶

svc$create_group(
  Name = "string",
  Description = "string",
  ResourceQuery = list(
    Type = "TAG_FILTERS_1_0"|"CLOUDFORMATION_STACK_1_0",
    Query = "string"
  ),
  Tags = list(
    "string"
  ),
  Configuration = list(
    list(
      Type = "string",
      Parameters = list(
        list(
          Name = "string",
          Values = list(
            "string"
          )
        )
      )
    )
  ),
  Criticality = 123,
  Owner = "string",
  DisplayName = "string"
)