TagFilter

A tag filter that specifies a tag key and optional tag values for filtering log groups by tags.

key

The tag key to filter on.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Pattern: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$

Required: Yes

values

An optional list of tag values to filter on.

If you specify a filter that contains more than one value for a key, the response returns log groups that match any of the specified values for that key.
If you don't specify values, the response returns all log groups that are tagged with that key, with any or no value.
Use * for wildcard matching. For example, prod* matches values that start with prod.
Use ! as a prefix for negation. For example, !prod matches values that are not prod.
Exact matching and negation are case-sensitive. Wildcard matching is case-insensitive.

Type: Array of strings

Array Members: Minimum number of 0 items. Maximum number of 5 items.

Length Constraints: Minimum length of 0. Maximum length of 259.

Pattern: ^!?\*?([\p{L}\p{Z}\p{N}_.:/=+\-@]*)\*?$

Required: No

Contents