TagValues - AWS Billing and Cost Management
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

TagValues

The values that are available for a tag.

In operations that support ABSENT, such as GetCostAndUsage, you can filter on resources with no tags. Set MatchOptions to ABSENT and omit Key and Values. Not all operations support ABSENT. For example, GetReservationCoverage and GetSavingsPlansCoverage don't.

To filter on resources without a given tag key, set MatchOptions to ABSENT, specify the Key, and omit Values.

A Key without Values doesn't apply ABSENT. In Cost Explorer operations such as GetCostAndUsage, unless MatchOptions includes ABSENT, you must specify both Key and Values, or the request fails with a ValidationException.

If MatchOptions includes ABSENT and you also specify Values, the request fails with a ValidationException.

Contents

Key

The key for the tag.

Specify user-defined tag keys without the user: prefix. For example, use team, not user:team. Tag keys that Amazon Web Services generates keep their aws: prefix.

Type: String

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

Pattern: [\S\s]*

Required: No

MatchOptions

The match options that you can use to filter your results. The supported values depend on the operation. Refer to the documentation for each specific API to see what is supported. For example, GetCostAndUsage supports the following values:

  • EQUALS - Matches values exactly.

  • ABSENT - Matches costs that don't have a value for the key.

  • CASE_SENSITIVE - Matches values with case sensitivity.

The default values for MatchOptions are EQUALS and CASE_SENSITIVE.

Type: Array of strings

Valid Values: EQUALS | ABSENT | STARTS_WITH | ENDS_WITH | CONTAINS | CASE_SENSITIVE | CASE_INSENSITIVE | GREATER_THAN_OR_EQUAL

Required: No

Values

The specific value of the tag.

Type: Array of strings

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

Pattern: [\S\s]*

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: