AWS Global Accelerator
Developer Guide

Endpoints in AWS Global Accelerator

Endpoints in AWS Global Accelerator can be Elastic IP addresses, Network Load Balancers, or Application Load Balancers. A static IP address serves as a single point of contact for clients, and Global Accelerator then distributes incoming traffic across healthy endpoints. Global Accelerator directs traffic to endpoints by using the port that you specify for the listener that the endpoint group for the endpoint belongs to. Each endpoint group can have multiple endpoints.

Note

You can add each endpoint to multiple endpoint groups, but the endpoint groups must be associated with different listeners.

You can add or remove endpoints from endpoint groups based on usage.

If demand on your application increases, you can add more endpoints to one or more endpoint groups to handle the increased traffic. Global Accelerator starts routing requests to an endpoint as soon as you add it and the endpoint passes the initial health checks.

You can remove endpoints from your endpoint groups, for example, if you need to service your endpoints. Removing an endpoint takes it out of the endpoint group, but does not affect the endpoint otherwise. Global Accelerator stops directing traffic to an endpoint as soon as you remove it from an endpoint group. The endpoint goes into a state where it waits for all current requests to be completed so there's no interruption for client traffic that is in progress. You can add the endpoint back to the endpoint group when you’re ready for it to resume receiving requests.

Global Accelerator continually monitors the health of all endpoints that are included in an endpoint group. It routes traffic only to the active endpoints that are healthy. If Global Accelerator doesn’t have any healthy endpoints to route traffic to, it routes traffic to all endpoints.

Adding, Editing, or Removing an Endpoint

You add endpoints to endpoint groups so that traffic can be directed to your resources. You can edit an endpoint to change the weight for the endpoint. Or you can remove an endpoint from your accelerator by removing it from an endpoint group. Removing an endpoint doesn't affect the endpoint itself, but Global Accelerator can no longer direct traffic to that resource.

This section explains how to work with endpoints on the AWS Global Accelerator console. If you want to use API operations with AWS Global Accelerator, see the AWS Global Accelerator API Reference.

To add an endpoint

  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 Global Accelerator resources section, choose an accelerator.

  3. In the Listeners section, for Listener ID, choose the ID of a listener.

  4. In the Endpoint groups section, for Endpoint group ID, choose the ID of the endpoint group that you want to add an endpoint to.

  5. In the Endpoints section, choose Add endpoint.

  6. On the Add endpoints page, choose an endpoint from the dropdown list.

  7. Optionally, for Weight, enter a number from 0 to 255 to set a weight for routing traffic to this endpoint. When you add weights to endpoints, you configure Global Accelerator to route traffic based on proportions that you specify. By default, all endpoints have a weight of 128. For more information, see Endpoint Weights.

  8. Choose Add endpoint.

To edit an endpoint

You can edit an endpoint configuration to change the weight. For more information, see Endpoint Weights.

  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 Listeners section, for Listener ID, choose the ID of a listener.

  3. In the Endpoint groups section, for Endpoint group ID, choose the ID of the endpoint group.

  4. Choose Edit endpoint.

  5. On the Edit endpoint page, change the weight for the endpoint resource.

  6. Choose Save.

To remove an endpoint

  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 Listeners section, for Listener ID, choose the ID of a listener.

  3. In the Endpoint groups section, for Endpoint group ID, choose the ID of the endpoint group.

  4. Choose Remove endpoint.

  5. In the confirmation dialog box, choose Remove.

Endpoint Weights

A weight is a value that determines the proportion of traffic that Global Accelerator directs to an endpoint. Global Accelerator calculates the sum of the weights for the endpoints in an endpoint group, and then directs traffic to the endpoints based on the ratio of each endpoint's weight to the total.

Weighted routing lets you choose how much traffic is routed to a resource in an endpoint group. This can be useful in several ways, including load balancing and testing new versions of an application.

To use weights, you assign each endpoint in an endpoint group a relative weight that corresponds with how much traffic that you want to send to it. By default, the weight for an endpoint is 128—that is, half of the maximum value for a weight, 255. Global Accelerator sends traffic to an endpoint based on the weight that you assign to it as a proportion of the total weight for all endpoints in the group:


    How relative weights work for endpoints

For example, if you want to send a tiny portion of your traffic to one endpoint and the rest to another endpoint, you might specify weights of 1 and 255. The endpoint with a weight of 1 gets 1/256 of the traffic (1/1+255), and the other endpoint gets 255/256 (255/1+255). You can gradually change the balance by changing the weights. If you want Global Accelerator to stop sending traffic to an endpoint, you can change the weight for that resource to 0.