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 asuse1-az1. -
For
AvailabilityZoneGroup, the Zone Group that an Availability Zone belongs to (not a Local Zone group), such asus-east-1-zg-1. -
For
Region, the Region code, such asus-east-1. -
For
Partition, the partition name, such asaws. -
For
Global, the valueglobal.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 64.
Required: No
-
- LocationType
-
The level of the location that
LocationIdidentifies. 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
Globallocation 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 aGlobalrecord, Route 53 returns a "no answer" response to queries that don't match any other record.Type: String
Valid Values:
AvailabilityZone | AvailabilityZoneGroup | Region | Partition | GlobalRequired: No
-
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: