AWS Global Accelerator
Developer Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Accelerators in AWS Global Accelerator

An accelerator in AWS Global Accelerator directs traffic to optimal endpoints over the AWS global network to improve the availability and performance of your internet applications that have a global audience. Each accelerator includes one or more listeners. A listener processes inbound connections from clients to Global Accelerator, based on the protocol and port (or port range) that you configure.

This section explains how to create, edit, or delete an accelerator on the Global Accelerator console. After you create your accelerator, you can edit it to change the name that you provided, or you can delete it when you no longer need it.

If you want to use API operations with Global Accelerator, see the AWS Global Accelerator API Reference.

Creating, Editing, or Deleting an Accelerator

This section explains how to work with accelerators on the console. To work with Global Accelerator programmatically, see the AWS Global Accelerator API Reference.

Important

Make sure that you’re in the US-West-2 (Oregon) Region. You must be in this Region to create or update accelerators.

To create an accelerator

  1. Open the Global Accelerator console at https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#Global Accelerator:.

  2. Choose Create accelerator.

  3. Provide a name for your accelerator.

  4. Choose Next to add listeners, endpoint groups, and endpoints.

To edit an accelerator

  1. Open the Global Accelerator console at https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#Global Accelerator:.

  2. In the list of accelerators, choose one, and then choose Edit.

  3. On the Edit accelerator page, make any changes that you like. For example, you can disable the accelerator so that you can delete it.

  4. Choose Save.

If you created an accelerator as a test or if you're no longer using an accelerator, you can delete it. On the console, disable the accelerator, and then you can delete it. You don't have to remove listeners and endpoint groups from the accelerator.

To delete an accelerator by using an API operation instead of the console, you must first remove all listeners and endpoint groups that are associated with the accelerator, and then disable it. For more information, see the DeleteAccelerator operation in the AWS Global Accelerator API Reference.

To disable an accelerator

  1. Open the Global Accelerator console at https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#Global Accelerator:.

  2. In the list, choose an accelerator that you want to disable.

  3. Choose Edit.

  4. Choose Disable accelerator, and then choose Save.

To delete an accelerator

  1. Open the Global Accelerator console at https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#Global Accelerator:.

  2. In the list, choose an accelerator that you want to delete.

  3. Choose Delete.

    Note

    If you haven't disabled the accelerator, Delete is unavailable.

  4. In the confirmation dialog box, choose Delete.

Viewing Your Accelerators

You can view information about your accelerators on the console. To see descriptions of your accelerators programmatically, see ListAccelerators and DescribeAccelerator in the AWS Global Accelerator API Reference.

To view information about your accelerator

  1. Open the Global Accelerator console at https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#Global Accelerator:.

  2. To see details about an accelerator, in the list, choose an accelerator, and then choose View.

Support for DNS Addressing in Global Accelerator

When you create an accelerator, Global Accelerator provisions two static IP addresses for you. It also assigns a default Domain Name System (DNS) name to your accelerator, similar to a1234567890abcdef.awsglobalaccelerator.com, that points to the static IP addresses. The static IP addresses are advertised globally using anycast from the AWS edge network to your endpoints such as Elastic IP addresses, Network Load Balancers, or Application Load Balancers. You can use your accelerator's static IP addresses or DNS name to route traffic to your accelerator. DNS servers and DNS resolvers use a round robin to resolve the DNS name for an accelerator, so the name resolves to the static IP addresses for the accelerator, returned by Route 53 in random order. Clients typically use the first IP address that is returned.

Note

Global Accelerator creates two Pointer (PTR) records that map an accelerator’s static IP addresses to the corresponding DNS name generated by Global Accelerator, to support reverse DNS lookup. This is also known as a reverse hosted zone. Be aware that the DNS name that Global Accelerator generates for you isn't configurable, and you can't create PTR records that point to your custom domain name.

Route Custom Domain Traffic to Your Accelerator

In most scenarios, you can configure DNS to use your custom domain name (such as www.example.com) with your accelerator, instead of using the assigned static IP addresses or the default DNS name. First, using Amazon Route 53 or another DNS provider, create a domain name, and then add or update DNS records with your Global Accelerator IP addresses. Alternatively, you can associate your custom domain name with the DNS name for your accelerator. Complete the DNS configuration and wait for the changes propagate over the internet. Now when a client makes a request using your custom domain name, the DNS server resolves it to the IP addresses, in random order, or to the DNS name for your accelerator.

To use your custom domain name with Global Accelerator when you use Route 53 as your DNS service, you create an alias record that points your custom domain name to the DNS name assigned to your accelerator. An alias record is a Route 53 extension to DNS. It's similar to a CNAME record, but you can create an alias record both for the root domain, such as example.com, and for subdomains, such as www.example.com. For more information, see Choosing Between Alias and Non-Alias Records in the Amazon Route 53 Developer Guide.

Setting up Route 53 with an alias record for an accelerator is similar to setting up Route 53 with an AWS load balancer. Follow the same basic steps that are included in the procedure To create a hosted zone and an alias record set for your domain using Route 53 in the following topic: Configure a Custom Domain Name for Your Classic Load Balancer in the User Guide for Classic Load Balancers. Note that the Hosted Zone ID for Global Accelerator is Z2BJ6XQ5FK7U4H.