Use resource tags

Use tags to add metadata to Aiven resources to categorize them or run custom logic on them. Tags can be attached to projects and services.

Typical uses include:

• Tagging for governance to deploy services with specific tags only.
• Tagging for internal cost reporting, ownership, allocation and accountability.

A tag is a key/value pair, where:

• key: A case-sensitive string that much match [A-Za-z0-9_-] and start with a letter. The maximum length for a key is 64 characters.
• value: A string value limited to 64 UTF-8 characters.

Within a resource, the tag keys must be unique.

Add tags to resources in Aiven Console

Add tags to projects

Console

1. In the project, click Settings.
2. In the Tags section, click Project or Billing.
   • Billing tags are returned in the invoice API and displayed on PDF invoices for the project.
   • Project tags are returned for resources in the API and displayed in the list of projects.
3. Click Add tags.
4. Enter a key and value for each tag.
5. Click Save changes.

Terraform

To add billing and project tags, use the tag attribute in your aiven_project resource. For billing tags, prefix the key with billing:. For example: key = "billing:PO".

Add tags to services

Console

1. In the service, click Service settings.
2. In the Service status section, click Actions > Add service tags.
3. Enter a key and value for each tag.
4. Click Save changes.

Terraform

Use the tag attribute in your Aiven service resource.

Related pages

• Create a service