Each listener is associated with an endpoint group. You can associate a listener with an endpoint group by specifying the region to which you want to distribute network traffic. After you associate a listener with an endpoint group, the system distributes network traffic to the endpoint in the endpoint group based on the routing type of the listener. This topic describes how to create and manage endpoint groups of custom routing listeners.
Prerequisites
A standard Global Accelerator instance is created. For more information, see Create and manage standard GA instances.
A basic bandwidth plan is purchased and associated with the GA instance whose bandwidth metering method is pay-by-bandwidth.
An application that serves as the endpoint of a standard Global Accelerator (GA) instance is deployed. The application is used to receive requests that are forwarded from the GA instance. You can specify only vSwitches as endpoints for custom routing listeners. For more information, see the "Endpoints" section of the Overview topic.
You are granted the permissions to use custom routing listeners. Custom routing listeners are in invitational preview. To use custom routing listeners, submit a request to your account manager. After your request is approved, you can use custom routing listeners.
Background information
After you create a custom routing listener for a GA instance, the GA instance generates a mapping table based on the relationship between the listener port range and the destination endpoint group port that you configured and the subnet information of the endpoint. This way, the GA instance can forward traffic to all IP addresses or specific IP addresses and ports in the vSwitch that you specify.
Custom routing listeners support only TCP and UDP. By default, you can create only two endpoint groups for a custom routing listener. If you want to create additional endpoint groups, go to the Quota Management page and increase the quota named gaplus_quota_epgs_per_listener. For more information, see Manage GA quotas.
Create an endpoint group
Log on to the GA console.
On the Instances page, find the GA instance that you want to manage and click Configure Listeners in the Actions column.
On the Listeners tab, click Add Listener.
NoteIf this is the first time that you add a listener or if no listener is created for the specified Global Accelerator instance, skip this step.
On the Configure Listener & Protocol wizard page, select Custom Routing as the routing type, configure the listener port, and then click Next.
For more information, see Add and manage custom routing listeners.
On the Configure Endpoint Group wizard page, configure the endpoint group and endpoint.
Endpoint groups define the mappings between listener port ranges, backend service port ranges, and protocols. Endpoints determine the backend destination CIDR blocks and access policies of subnet traffic.
Configure an endpoint group.
On the Configure Endpoint Group wizard page, configure the parameters for the endpoint group. The following table describes the parameters.
Parameter
Example
Endpoint Group Name
Enter a name for the endpoint group.
Region
Select the region where you want to deploy the endpoint group.
Port Mapping Range and Protocol
Select Batch Mode and enter the port ranges and protocols of backend services in the endpoint group. The port ranges and protocols of backend services are mapped to the port range of the listener that is associated with the endpoint group.
List Mode: enter a Port Range and select a Protocol. You can select Protocol or UDP from the Protocol drop-down list. You can select TCP and UDP at the same time.
You can click Add to add additional entries.
In this mode, you can add up to 20 entries at the same time.
Batch Mode: enter port ranges and protocols based on the instructions. You can also download a template, enter port ranges and protocols, and then upload the template.
In this mode, you can add up to 100 entries at the same time.
NoteThe sum of all ports in the endpoint groups that are associated with a custom routing listener and the IP addresses of all vSwitches in the endpoints must be less than or equal to the number of listener ports. This means that
the number of ports in the endpoint groups times the number of IP addresses of all vSwitches in the endpoints must be less than or equal to the number of listener ports
.Configure endpoints.
In the Endpoint section, click Add Endpoint. In the Add Endpoint dialog box, configure the parameters and click OK. The following table describes the parameters.
Parameter
Example
Backend Service Type
Set the value to vSwitch.
Backend Service
Select the vSwitch to which you want to forward traffic.
Subnet Traffic
Select an access policy for subnet traffic.
Allow All Traffic: GA forwards all traffic to the specified backend service.
Deny All Traffic: GA does not forward traffic to the specified backend service. This is the default value.
Allow Traffic from Specific vSwitch IP Address and Port: specifies the access policy that can receive client requests, which is the IP address and port of an Elastic Compute Service (ECS) instance.
Optional. Click + Add Endpoint Group to add multiple endpoint groups by repeating the operations in the preceding step.
NoteBy default, you can create two endpoint groups for each TCP and UDP listener. If you want to create additional endpoint groups, go to the Quota Management page and increase the quota named gaplus_quota_epgs_per_listener. For more information, see Manage GA quotas.
In the Cross-border Acceleration Settings section, read Compliance Commitments Regarding Cross-border Data Transfers and select Agree to the Preceding Compliance Agreement.
This parameter takes effect only when cross-border acceleration is disabled for your GA instance and the selected endpoint group and existing acceleration regions are deployed across borders. For example, the endpoint group resides in a region in the Chinese mainland and the acceleration regions are located outside the Chinese mainland, such as the China (Hong Kong), China (Macao), and China (Taiwan) regions.
After the configuration is complete, the Transmission Network Type parameter of the GA instance is automatically set to BGP (Multi-ISP) Pro. For more information, see Pay-by-data-transfer.
Click Next.
Confirm the configurations.
In the Confirm step, confirm the configurations of the listener and endpoints, and then click Submit.
If you want to modify settings, click Modify in the corresponding section. Then, you are redirected to the configuration page.
NoteIf this is the first time you add a listener, the listener takes effect after 3 minutes. If you modify the configurations of a listener, the new configurations take effect after 1 minute.
More operations
Operation | Description |
Modify an endpoint group |
|
Add an endpoint |
|
Modify an endpoint |
|
Delete an endpoint |
|
Delete an endpoint group |
|
References
CreateCustomRoutingEndpointGroups: creates multiple endpoint groups of a custom routing listener at the same time.
UpdateCustomRoutingEndpointGroupAttribute: modifies the name and description of an endpoint group that is associated with a custom routing listener.
DeleteCustomRoutingEndpointGroups: deletes multiple endpoint groups of a custom routing listener at the same time.
CreateCustomRoutingEndpointGroupDestinations: creates port mappings of an endpoint group that is associated with a custom routing listener.
UpdateCustomRoutingEndpointGroupDestinations: modifies port mappings of an endpoint group that is associated with a custom routing listener.
DeleteCustomRoutingEndpointGroupDestinations: deletes port mappings of an endpoint group that is associated with a custom routing listener.
CreateCustomRoutingEndpoints: creates endpoints for a custom routing listener.
UpdateCustomRoutingEndpoints: modifies the endpoints of a custom routing listener.
DeleteCustomRoutingEndpoints: deletes the endpoints of a custom routing listener.
CreateCustomRoutingEndpointTrafficPolicies: creates traffic policies for endpoints of a custom routing listener.
UpdateCustomRoutingEndpointTrafficPolicies: modifies the traffic policies for endpoints of a custom routing listener.
DeleteCustomRoutingEndpointTrafficPolicies: deletes the traffic policies for endpoints of a custom routing listener.
ListCustomRoutingPortMappings: queries the port mappings of a custom routing listener.
ListCustomRoutingPortMappingsByDestination: queries the port mappings of a specific backend instance that is associated with a custom routing listener.