# Generated by default/object.tt package Paws::Route53::AliasTarget; use Moose; has DNSName => (is => 'ro', isa => 'Str', required => 1); has EvaluateTargetHealth => (is => 'ro', isa => 'Bool', required => 1); has HostedZoneId => (is => 'ro', isa => 'Str', required => 1); 1; ### main pod documentation begin ### =head1 NAME Paws::Route53::AliasTarget =head1 USAGE This class represents one of two things: =head3 Arguments in a call to a service Use the attributes of this class as arguments to methods. You shouldn't make instances of this class. Each attribute should be used as a named argument in the calls that expect this type of object. As an example, if Att1 is expected to be a Paws::Route53::AliasTarget object: $service_obj->Method(Att1 => { DNSName => $value, ..., HostedZoneId => $value }); =head3 Results returned from an API call Use accessors for each attribute. If Att1 is expected to be an Paws::Route53::AliasTarget object: $result = $service_obj->Method(...); $result->Att1->DNSName =head1 DESCRIPTION I Information about the AWS resource, such as a CloudFront distribution or an Amazon S3 bucket, that you want to route traffic to. When creating resource record sets for a private hosted zone, note the following: =over =item * Creating geolocation alias resource record sets or latency alias resource record sets in a private hosted zone is unsupported. =item * For information about creating failover resource record sets in a private hosted zone, see Configuring Failover in a Private Hosted Zone (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html). =back =head1 ATTRIBUTES =head2 B DNSName => Str I The value that you specify depends on where you want to route queries: =over =item Amazon API Gateway custom regional APIs and edge-optimized APIs Specify the applicable domain name for your API. You can get the applicable value using the AWS CLI command get-domain-names (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html): =over =item * For regional APIs, specify the value of C. =item * For edge-optimized APIs, specify the value of C. This is the name of the associated CloudFront distribution, such as C. =back The name of the record that you're creating must match a custom domain name for your API, such as C. =item Amazon Virtual Private Cloud interface VPC endpoint Enter the API endpoint for the interface endpoint, such as C. For edge-optimized APIs, this is the domain name for the corresponding CloudFront distribution. You can get the value of C using the AWS CLI command describe-vpc-endpoints (https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html). =item CloudFront distribution Specify the domain name that CloudFront assigned when you created your distribution. Your CloudFront distribution must include an alternate domain name that matches the name of the resource record set. For example, if the name of the resource record set is I, your CloudFront distribution must include I as one of the alternate domain names. For more information, see Using Alternate Domain Names (CNAMEs) (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/CNAMEs.html) in the I. You can't create a resource record set in a private hosted zone to route traffic to a CloudFront distribution. For failover alias records, you can't specify a CloudFront distribution for both the primary and secondary records. A distribution must include an alternate domain name that matches the name of the record. However, the primary and secondary records have the same name, and you can't include the same alternate domain name in more than one distribution. =item Elastic Beanstalk environment If the domain name for your Elastic Beanstalk environment includes the region that you deployed the environment in, you can create an alias record that routes traffic to the environment. For example, the domain name C.elasticbeanstalk.com> is a regionalized domain name. For environments that were created before early 2016, the domain name doesn't include the region. To route traffic to these environments, you must create a CNAME record instead of an alias record. Note that you can't create a CNAME record for the root domain name. For example, if your domain name is example.com, you can create a record that routes traffic for acme.example.com to your Elastic Beanstalk environment, but you can't create a record that routes traffic for example.com to your Elastic Beanstalk environment. For Elastic Beanstalk environments that have regionalized subdomains, specify the C attribute for the environment. You can use the following methods to get the value of the CNAME attribute: =over =item * I: For information about how to get the value by using the console, see Using Custom Domains with AWS Elastic Beanstalk (https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/customdomains.html) in the I. =item * I: Use the C action to get the value of the C attribute. For more information, see DescribeEnvironments (https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_DescribeEnvironments.html) in the I. =item * I: Use the C command to get the value of the C attribute. For more information, see describe-environments (https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/describe-environments.html) in the I. =back =item ELB load balancer Specify the DNS name that is associated with the load balancer. Get the DNS name by using the AWS Management Console, the ELB API, or the AWS CLI. =over =item * B: Go to the EC2 page, choose B in the navigation pane, choose the load balancer, choose the B tab, and get the value of the B field. If you're routing traffic to a Classic Load Balancer, get the value that begins with B. If you're routing traffic to another type of load balancer, get the value that applies to the record type, A or AAAA. =item * B: Use C to get the value of C. For more information, see the applicable guide: =over =item * Classic Load Balancers: DescribeLoadBalancers (https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html) =item * Application and Network Load Balancers: DescribeLoadBalancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html) =back =item * B: Use C to get the value of C. For more information, see the applicable guide: =over =item * Classic Load Balancers: describe-load-balancers (http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html) =item * Application and Network Load Balancers: describe-load-balancers (http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html) =back =back =item AWS Global Accelerator accelerator Specify the DNS name for your accelerator: =over =item * B To get the DNS name, use DescribeAccelerator (https://docs.aws.amazon.com/global-accelerator/latest/api/API_DescribeAccelerator.html). =item * B To get the DNS name, use describe-accelerator (https://docs.aws.amazon.com/cli/latest/reference/globalaccelerator/describe-accelerator.html). =back =item Amazon S3 bucket that is configured as a static website Specify the domain name of the Amazon S3 website endpoint that you created the bucket in, for example, C. For more information about valid values, see the table Amazon S3 Website Endpoints (https://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpoints) in the I. For more information about using S3 buckets for websites, see Getting Started with Amazon Route 53 (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/getting-started.html) in the I =item Another Route 53 resource record set Specify the value of the C element for a resource record set in the current hosted zone. If you're creating an alias record that has the same name as the hosted zone (known as the zone apex), you can't specify the domain name for a record for which the value of C is C. This is because the alias record must have the same type as the record that you're routing traffic to, and creating a CNAME record for the zone apex isn't supported even for an alias record. =back =head2 B EvaluateTargetHealth => Bool I When C is C, an alias resource record set inherits the health of the referenced AWS resource, such as an ELB load balancer or another resource record set in the hosted zone. Note the following: =over =item CloudFront distributions You can't set C to C when the alias target is a CloudFront distribution. =item Elastic Beanstalk environments that have regionalized subdomains If you specify an Elastic Beanstalk environment in C and the environment contains an ELB load balancer, Elastic Load Balancing routes queries only to the healthy Amazon EC2 instances that are registered with the load balancer. (An environment automatically contains an ELB load balancer if it includes more than one Amazon EC2 instance.) If you set C to C and either no Amazon EC2 instances are healthy or the load balancer itself is unhealthy, Route 53 routes queries to other available resources that are healthy, if any. If the environment contains a single Amazon EC2 instance, there are no special requirements. =item ELB load balancers Health checking behavior depends on the type of load balancer: =over =item * B: If you specify an ELB Classic Load Balancer in C, Elastic Load Balancing routes queries only to the healthy Amazon EC2 instances that are registered with the load balancer. If you set C to C and either no EC2 instances are healthy or the load balancer itself is unhealthy, Route 53 routes queries to other resources. =item * B: If you specify an ELB Application or Network Load Balancer and you set C to C, Route 53 routes queries to the load balancer based on the health of the target groups that are associated with the load balancer: =over =item * For an Application or Network Load Balancer to be considered healthy, every target group that contains targets must contain at least one healthy target. If any target group contains only unhealthy targets, the load balancer is considered unhealthy, and Route 53 routes queries to other resources. =item * A target group that has no registered targets is considered unhealthy. =back =back When you create a load balancer, you configure settings for Elastic Load Balancing health checks; they're not Route 53 health checks, but they perform a similar function. Do not create Route 53 health checks for the EC2 instances that you register with an ELB load balancer. =item S3 buckets There are no special requirements for setting C to C when the alias target is an S3 bucket. =item Other records in the same hosted zone If the AWS resource that you specify in C is a record or a group of records (for example, a group of weighted records) but is not another alias record, we recommend that you associate a health check with all of the records in the alias target. For more information, see What Happens When You Omit Health Checks? (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-complex-configs.html#dns-failover-complex-configs-hc-omitting) in the I. =back For more information and examples, see Amazon Route 53 Health Checks and DNS Failover (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html) in the I. =head2 B HostedZoneId => Str I: The value used depends on where you want to route traffic: =over =item Amazon API Gateway custom regional APIs and edge-optimized APIs Specify the hosted zone ID for your API. You can get the applicable value using the AWS CLI command get-domain-names (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html): =over =item * For regional APIs, specify the value of C. =item * For edge-optimized APIs, specify the value of C. =back =item Amazon Virtual Private Cloud interface VPC endpoint Specify the hosted zone ID for your interface endpoint. You can get the value of C using the AWS CLI command describe-vpc-endpoints (https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html). =item CloudFront distribution Specify C. Alias resource record sets for CloudFront can't be created in a private zone. =item Elastic Beanstalk environment Specify the hosted zone ID for the region that you created the environment in. The environment must have a regionalized subdomain. For a list of regions and the corresponding hosted zone IDs, see AWS Elastic Beanstalk endpoints and quotas (https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) in the the I. =item ELB load balancer Specify the value of the hosted zone ID for the load balancer. Use the following methods to get the hosted zone ID: =over =item * Elastic Load Balancing endpoints and quotas (https://docs.aws.amazon.com/general/latest/gr/elb.html) topic in the I: Use the value that corresponds with the region that you created your load balancer in. Note that there are separate columns for Application and Classic Load Balancers and for Network Load Balancers. =item * B: Go to the Amazon EC2 page, choose B in the navigation pane, select the load balancer, and get the value of the B field on the B tab. =item * B: Use C to get the applicable value. For more information, see the applicable guide: =over =item * Classic Load Balancers: Use DescribeLoadBalancers (https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html) to get the value of C. =item * Application and Network Load Balancers: Use DescribeLoadBalancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html) to get the value of C. =back =item * B: Use C to get the applicable value. For more information, see the applicable guide: =over =item * Classic Load Balancers: Use describe-load-balancers (http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html) to get the value of C. =item * Application and Network Load Balancers: Use describe-load-balancers (http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html) to get the value of C. =back =back =item AWS Global Accelerator accelerator Specify C. =item An Amazon S3 bucket configured as a static website Specify the hosted zone ID for the region that you created the bucket in. For more information about valid values, see the table Amazon S3 Website Endpoints (https://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpoints) in the I. =item Another Route 53 resource record set in your hosted zone Specify the hosted zone ID of your hosted zone. (An alias resource record set can't reference a resource record set in a different hosted zone.) =back =head1 SEE ALSO This class forms part of L, describing an object used in L =head1 BUGS and CONTRIBUTIONS The source code is located here: L Please report bugs to: L =cut