View a markdown version of this page

AZAffinity - Amazon Route 53

AZAffinity

Specifies the location that an AZ-affinity resource record set answers DNS queries from. For the location types, from most to least specific, see LocationType. A query matches a location when Route 53 VPC Resolver reports that the query came from an Availability Zone (AZ) in that location. If Route 53 doesn't know which AZ a query came from, the query matches only the record for the Global location type. AZ-affinity routing chooses which record to return. It doesn't restrict which clients can get a record. You must specify both LocationType and LocationId.

To have Route 53 fall back to a less specific location when a resource is unhealthy, associate a health check with each record, or set EvaluateTargetHealth to true for alias records. If every record that matches a query is unhealthy, Route 53 responds with the most specific one.

Contents

LocationId

The ID of the location. You can specify only generally available Availability Zones and Zone Groups. Zone Group, Region, and partition IDs must belong to a partition that you can use. Specify the ID in lowercase, in the format that corresponds to LocationType:

  • For AvailabilityZone, the Availability Zone ID (not the Availability Zone name or a Local Zone ID), such as use1-az1.

  • For AvailabilityZoneGroup, the Zone Group that an Availability Zone belongs to (not a Local Zone group), such as us-east-1-zg-1.

  • For Region, the Region code, such as us-east-1.

  • For Partition, the partition name, such as aws.

  • For Global, the value global.

Type: String

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

Required: No

LocationType

The level of the location that LocationId identifies. Valid values, from most to least specific:

  • AvailabilityZone: A single Availability Zone.

  • AvailabilityZoneGroup: A Zone Group, which is a group of Availability Zones in an AWS Region.

  • Region: An entire AWS Region.

  • Partition: An entire AWS partition.

  • Global: All locations.

We recommend that you create a record for the Global location type so that every query gets an answer. Route 53 responds with it when a query matches no more specific record, or when it's the only healthy record that matches. Without a Global record, Route 53 returns a "no answer" response to queries that don't match any other record.

Type: String

Valid Values: AvailabilityZone | AvailabilityZoneGroup | Region | Partition | Global

Required: No

See Also

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