interface TagFilterProperty
Language | Type name |
---|---|
.NET | Amazon.CDK.AWS.ResourceGroups.CfnGroup.TagFilterProperty |
Go | github.com/aws/aws-cdk-go/awscdk/v2/awsresourcegroups#CfnGroup_TagFilterProperty |
Java | software.amazon.awscdk.services.resourcegroups.CfnGroup.TagFilterProperty |
Python | aws_cdk.aws_resourcegroups.CfnGroup.TagFilterProperty |
TypeScript | aws-cdk-lib » aws_resourcegroups » CfnGroup » TagFilterProperty |
Specifies a single tag key and optional values that you can use to specify membership in a tag-based group.
An AWS resource that doesn't have a matching tag key and value is rejected as a member of the group.
A TagFilter
object includes two properties: Key
(a string) and Values
(a list of strings). Only resources in the account that are tagged with a matching key-value pair are members of the group. The Values
property of TagFilter
is optional, but specifying it narrows the query results.
As an example, suppose the TagFilters
string is [{"Key": "Stage", "Values": ["Test", "Beta"]}, {"Key": "Storage"}]
. In this case, only resources with all of the following tags are members of the group:
Stage
tag key with a value of eitherTest
orBeta
Storage
tag key with any value
Example
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_resourcegroups as resourcegroups } from 'aws-cdk-lib';
const tagFilterProperty: resourcegroups.CfnGroup.TagFilterProperty = {
key: 'key',
values: ['values'],
};
Properties
Name | Type | Description |
---|---|---|
key? | string | A string that defines a tag key. |
values? | string[] | A list of tag values that can be included in the tag-based resource group. |
key?
Type:
string
(optional)
A string that defines a tag key.
Only resources in the account that are tagged with a specified tag key are members of the tag-based resource group.
This field is required when the ResourceQuery
structure's Type
property is TAG_FILTERS_1_0
. You must specify at least one tag key.
values?
Type:
string[]
(optional)
A list of tag values that can be included in the tag-based resource group.
This is optional. If you don't specify a value or values for a key, then an AWS resource with any value for that key is a member.