CfnGroupProps

class aws_cdk.aws_resourcegroups.CfnGroupProps(*, name, configuration=None, description=None, resource_query=None, resources=None, tags=None)

Bases: object

Properties for defining a CfnGroup.

Parameters:

name (str) – The name of a resource group. The name must be unique within the AWS Region in which you create the resource. To create multiple resource groups based on the same CloudFormation stack, you must generate unique names for each.
configuration (Union[IResolvable, Sequence[Union[IResolvable, ConfigurationItemProperty, Dict[str, Any]]], None]) – The service configuration currently associated with the resource group and in effect for the members of the resource group. A Configuration consists of one or more ConfigurationItem entries. For information about service configurations for resource groups and how to construct them, see Service configurations for resource groups in the AWS Resource Groups User Guide . .. epigraph:: You can include either a Configuration or a ResourceQuery , but not both.
description (Optional[str]) – The description of the resource group.
resource_query (Union[IResolvable, ResourceQueryProperty, Dict[str, Any], None]) – The resource query structure that is used to dynamically determine which AWS resources are members of the associated resource group. For more information about queries and how to construct them, see Build queries and groups in AWS Resource Groups in the AWS Resource Groups User Guide .. epigraph:: - You can include either a ResourceQuery or a Configuration , but not both. - You can specify the group’s membership either by using a ResourceQuery or by using a list of Resources , but not both.
resources (Optional[Sequence[str]]) – A list of the Amazon Resource Names (ARNs) of AWS resources that you want to add to the specified group. .. epigraph:: - You can specify the group membership either by using a list of Resources or by using a ResourceQuery , but not both. - You can include a Resources property only if you also specify a Configuration property.
tags (Optional[Sequence[Union[CfnTag, Dict[str, Any]]]]) – The tag key and value pairs that are attached to the resource group.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourcegroups-group.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_resourcegroups as resourcegroups

cfn_group_props = resourcegroups.CfnGroupProps(
    name="name",

    # the properties below are optional
    configuration=[resourcegroups.CfnGroup.ConfigurationItemProperty(
        parameters=[resourcegroups.CfnGroup.ConfigurationParameterProperty(
            name="name",
            values=["values"]
        )],
        type="type"
    )],
    description="description",
    resource_query=resourcegroups.CfnGroup.ResourceQueryProperty(
        query=resourcegroups.CfnGroup.QueryProperty(
            resource_type_filters=["resourceTypeFilters"],
            stack_identifier="stackIdentifier",
            tag_filters=[resourcegroups.CfnGroup.TagFilterProperty(
                key="key",
                values=["values"]
            )]
        ),
        type="type"
    ),
    resources=["resources"],
    tags=[CfnTag(
        key="key",
        value="value"
    )]
)

Attributes

configuration

The service configuration currently associated with the resource group and in effect for the members of the resource group.

A Configuration consists of one or more ConfigurationItem entries. For information about service configurations for resource groups and how to construct them, see Service configurations for resource groups in the AWS Resource Groups User Guide . .. epigraph:

You can include either a ``Configuration`` or a ``ResourceQuery`` , but not both.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourcegroups-group.html#cfn-resourcegroups-group-configuration

description

The description of the resource group.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourcegroups-group.html#cfn-resourcegroups-group-description

name

The name of a resource group.

The name must be unique within the AWS Region in which you create the resource. To create multiple resource groups based on the same CloudFormation stack, you must generate unique names for each.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourcegroups-group.html#cfn-resourcegroups-group-name

resource_query

The resource query structure that is used to dynamically determine which AWS resources are members of the associated resource group.

For more information about queries and how to construct them, see Build queries and groups in AWS Resource Groups in the AWS Resource Groups User Guide .. epigraph:

- You can include either a ``ResourceQuery`` or a ``Configuration`` , but not both.
- You can specify the group's membership either by using a ``ResourceQuery`` or by using a list of ``Resources`` , but not both.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourcegroups-group.html#cfn-resourcegroups-group-resourcequery

resources

A list of the Amazon Resource Names (ARNs) of AWS resources that you want to add to the specified group.

You can specify the group membership either by using a list of Resources or by using a ResourceQuery , but not both.

You can include a Resources property only if you also specify a Configuration property.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourcegroups-group.html#cfn-resourcegroups-group-resources

tags

The tag key and value pairs that are attached to the resource group.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourcegroups-group.html#cfn-resourcegroups-group-tags