Menu
Amazon Route 53
Developer Guide (API Version 2013-04-01)

Naming and Tagging Health Checks

You can add tags to Amazon Route 53 health checks, which lets you give each health check a name that is more comprehensible than the health check ID. These are the same tags that AWS Billing and Cost Management provides for organizing your AWS bill to reflect your own cost structure. For more information about using tags for cost allocation, see Use Cost Allocation Tags for Custom Billing Reports in the AWS Billing and Cost Management User Guide.

Each tag consists of a key (the name of the tag) and a value, both of which you define. When you add tags to a health check, we recommend that you add one tag for which the key is Name and the value is the name that you want to give to the health check. The value of the Name tag appears in the list of health checks in the Amazon Route 53 console, which lets you readily distinguish health checks from one another. You can view other tags in the console, but you need to select a health check to see tags other than the Name tag.

For more information about tags, see the following topics:

Tag Restrictions

The following basic restrictions apply to tags:

  • Maximum number of tags per resource – 10

  • Maximum Key length – 128 Unicode characters

  • Maximum Value length – 256 Unicode characters

  • Valid values for Key and Value – uppercase and lowercase letters in the UTF-8 character set, numbers, space, and the following characters: _ . : / = + - and @

  • Tag keys and values are case sensitive

  • Don't use the aws: prefix for either keys or values; it's reserved for AWS use

Adding, Editing, and Deleting Tags for Health Checks

The following procedures show you how to use tags for your health checks in the Amazon Route 53 console.

To add tags to health checks

  1. Sign in to the AWS Management Console and open the Amazon Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the navigation pane, choose Health Checks.

  3. Select a health check, or select multiple health checks if you want to add the same tag to more than one health check.

  4. In the bottom pane, choose the Tags tab, and then choose Add/Edit Tags.

  5. In the Add/Edit Tags dialog box, enter a name for the tag in the Key field, and enter a value in the Value field.

  6. Choose Apply changes.

To edit tags for health checks

  1. Sign in to the AWS Management Console and open the Amazon Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the navigation pane, choose Health Checks.

  3. Select a health check.

    If you select multiple health checks that share the same tag, you cannot edit the value for all the tags simultaneously. Note, however, that you can edit the value of a tag that appears in multiple health checks if you select health checks that have the tag and at least one than doesn't.

    For example, suppose you select multiple health checks that have a Cost Center tag and one that doesn't. You choose the option to add a tag, and you specify Cost Center for the key and 777 for the value. For the selected health checks that already have a Cost Center tag, Amazon Route 53 changes the value to 777. For the one health check that doesn't have a Cost Center tag, Amazon Route 53 adds one and sets the value to 777.

  4. In the bottom pane, choose the Tags tab, and then choose Add/Edit Tags.

  5. In the Add/Edit Tags dialog box, edit the value.

  6. Choose Save.

To delete tags for health checks

  1. Sign in to the AWS Management Console and open the Amazon Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the navigation pane, choose Health Checks.

  3. Select a health check, or select multiple health checks if you want to delete the same tag from more than one health check.

  4. In the bottom pane, choose the Tags tab, and then choose Add/Edit Tags.

  5. In the Add/Edit Tags dialog box, choose the X next to the tag that you want to delete.

  6. Choose Save.