All Products
Search
Document Center

Global Accelerator:API overview

Last Updated:Jan 06, 2026

API standard and pre-built SDKs in multi-language

The OpenAPI specification of this product (Ga/2019-11-20) follows the RPC standard. Alibaba Cloud provides pre-built SDKs for popular programming languages to abstract low-level complexities such as request signing. This enables developers to call APIs using language-specific syntax without dealing with HTTP details directly.

Custom signature

If your specific needs, such as a customized signature, are not supported by the SDK, manually sign requests using the signature mechanism. Note that manual signing requires significant effort (usually about 5 business days). For support, join our DingTalk group (ID: 147535001692).

Before you begin

An Alibaba Cloud account has full administrative privileges. A compromised AccessKey pair exposes all associated resources to unauthorized access, posing a significant security risk. To call APIs securely, create a Resource Access Management (RAM) user with API access only, configure its AccessKey pairs, and implement the principle of least privilege (PoLP) through RAM policies. Use the Alibaba Cloud account only when its permissions are explicitly required for specific scenarios.

Bandwidth plans

API

Title

Description

UpdateBandwidthPackage UpdateBandwidthPackage You can call the UpdateBandwidthPackage operation to modify the configuration of a bandwidth plan.
ListBandwidthackages ListBandwidthackages Queries a list of bandwidth plans.

GA instances

API

Title

Description

CreateAccelerator CreateAccelerator Alibaba Cloud Global Accelerator (GA) is a network acceleration service that provides services to users across the globe. It uses the high-quality Border Gateway Protocol (BGP) bandwidth and global transmission network of Alibaba Cloud to provide low-latency access to the global network. GA reduces the impact of network issues, such as latency, jitter, and packet loss, on service quality and provides a high-availability and high-performance network acceleration service. You can call the CreateAccelerator operation to create a Global Accelerator instance.
DescribeAccelerator DescribeAccelerator Queries the details of a specified Global Accelerator instance.
UpdateAccelerator UpdateAccelerator Call the UpdateAccelerator operation to modify a Global Accelerator instance.
AttachDdosToAccelerator AttachDdosToAccelerator Call AttachDdosToAccelerator to attach an Anti-DDoS Pro or Anti-DDoS Premium instance to a Global Accelerator instance. This protects your Global Accelerator applications from large-scale DDoS attacks and ensures service stability and availability.
DetachDdosFromAccelerator DetachDdosFromAccelerator Call the DetachDdosFromAccelerator operation to detach an Anti-DDoS Pro or Anti-DDoS Premium instance from a Global Accelerator instance.
UpdateAcceleratorAutoRenewAttribute UpdateAcceleratorAutoRenewAttribute You can call the UpdateAcceleratorAutoRenewAttribute operation to modify the auto-renewal property of a Global Accelerator instance.

Acceleration regions

API

Title

Description

ListAvailableAccelerateAreas ListAvailableAccelerateAreas You can call the ListAvailableAccelerateAreas operation to query available acceleration areas.

Listeners

API

Title

Description

ListListeners ListListeners Retrieves a list of listeners.

Endpoint groups (intelligent routing listeners)

API

Title

Description

ListEndpointGroups ListEndpointGroups This operation queries a list of endpoint groups.

Endpoint groups (custom routing listeners)

API

Title

Description

CreateCustomRoutingEndpointGroups CreateCustomRoutingEndpointGroups You can call the CreateCustomRoutingEndpointGroups operation to create endpoint groups for a custom routing listener.
UpdateCustomRoutingEndpointGroupAttribute UpdateCustomRoutingEndpointGroupAttribute You can call the UpdateCustomRoutingEndpointGroupAttribute operation to modify the name and description of an endpoint group associated with a custom routing listener.

Endpoint group mapping configurations (custom routing listeners)

API

Title

Description

CreateCustomRoutingEndpointGroupDestinations CreateCustomRoutingEndpointGroupDestinations You can call the CreateCustomRoutingEndpointGroupDestinations operation to create mappings for an endpoint group that is associated with a custom routing listener.

Port mappings (custom routing listeners)

API

Title

Description

ListCustomRoutingPortMappings ListCustomRoutingPortMappings This operation queries the port mapping table of a custom routing listener.
ListCustomRoutingPortMappingsByDestination ListCustomRoutingPortMappingsByDestination Call the ListCustomRoutingPortMappingsByDestination operation to query the port mappings of a specified backend instance for a custom route listener.

Others

API

Title

Description

AddEntriesToAcl AddEntriesToAcl Adds IP addresses or CIDR blocks to an access control list (ACL). You can add IP addresses or CIDR blocks to an ACL and configure a whitelist or blacklist to allow or deny requests from clients.
AssociateAclsWithListener AssociateAclsWithListener Associates access control lists (ACLs) with a listener.
AssociateAdditionalCertificatesWithListener AssociateAdditionalCertificatesWithListener Associates additional certificates with an HTTPS listener. You can associate multiple certificates with an HTTPS listener and configure virtual endpoint groups and forwarding rules to accelerate access to multiple HTTPS-capable domain names.
AttachLogStoreToEndpointGroup AttachLogStoreToEndpointGroup Associates a Log Service Logstore with an endpoint group.
BandwidthPackageAddAccelerator BandwidthPackageAddAccelerator Associates a bandwidth plan with a Global Accelerator (GA) instance.
BandwidthPackageRemoveAccelerator BandwidthPackageRemoveAccelerator Disassociates a bandwidth plan from a Global Accelerator (GA) instance.
ChangeResourceGroup ChangeResourceGroup Changes the resource group to which a Global Accelerator (GA) resource belongs.
ConfigEndpointProbe ConfigEndpointProbe Configures latency monitoring for an endpoint.
CreateAcl CreateAcl Creates an access control list (ACL).
CreateApplicationMonitor CreateApplicationMonitor Creates an origin probing task.
CreateBandwidthPackage CreateBandwidthPackage Creates a bandwidth plan.
CreateBasicAccelerateIp CreateBasicAccelerateIp Creates an accelerated IP address for a basic Global Accelerator (GA) instance.
CreateBasicAccelerateIpEndpointRelation CreateBasicAccelerateIpEndpointRelation Creates a mapping between an accelerated IP address and an endpoint for a basic Global Accelerator (GA) instance.
CreateBasicAccelerateIpEndpointRelations CreateBasicAccelerateIpEndpointRelations Creates mappings between accelerated IP addresses and endpoints for a basic Global Accelerator (GA) instance.
CreateBasicAccelerator CreateBasicAccelerator Basic Global Accelerator (GA) instances leverage the immense bandwidth of the high-quality global network of Alibaba Cloud to provide end-to-end acceleration services. You can use basic GA instances to accelerate content delivery at Layer 3 (IP). You can call the CreateBasicAccelerator operation to create a basic GA instance.
CreateBasicEndpoint CreateBasicEndpoint Creates an endpoint for a basic Global Accelerator (GA) instance.
CreateBasicEndpointGroup CreateBasicEndpointGroup Creates an endpoint group for a basic Global Accelerator (GA) instance.
CreateBasicEndpoints CreateBasicEndpoints Creates multiple endpoints for a basic Global Accelerator (GA) instance.
CreateBasicIpSet CreateBasicIpSet Creates an acceleration region for a basic Global Accelerator (GA) instance.
CreateCustomRoutingEndpointTrafficPolicies CreateCustomRoutingEndpointTrafficPolicies Creates traffic destinations for an endpoint that is associated with a custom routing listener.
CreateCustomRoutingEndpoints CreateCustomRoutingEndpoints Creates endpoints for a custom routing listener.
CreateDomain CreateDomain Creates a domain name and associates the domain name with Global Accelerator (GA) instances.
CreateEndpointGroup CreateEndpointGroup Creates an endpoint group.
CreateEndpointGroups CreateEndpointGroups Creates endpoint groups.
CreateForwardingRules CreateForwardingRules If you want to distribute and process traffic based on request attributes, such as domain names and paths, or information in requests, such as HTTP headers and cookies, you can create custom forwarding rules for a listener. The listener forwards requests based on the forwarding rules. You can call the CreateForwardingRules operation to create forwarding rules.
CreateIpSets CreateIpSets Creates acceleration regions.
CreateListener CreateListener Creates a listener for a Global Accelerator (GA) instance.
CreateSpareIps CreateSpareIps Creates secondary IP addresses for a CNAME that is assigned to a Global Accelerator (GA) instance. If an acceleration area of the GA instance becomes unavailable, access traffic is redirected to the secondary IP addresses.
DeleteAccelerator DeleteAccelerator Deletes a Global Accelerator (GA) instance.
DeleteAcl DeleteAcl Deletes a access control list (ACL) of a Global Accelerator (GA) instance.
DeleteApplicationMonitor DeleteApplicationMonitor Deletes an origin probing task.
DeleteBandwidthPackage DeleteBandwidthPackage Deletes a bandwidth plan.
DeleteBasicAccelerateIp DeleteBasicAccelerateIp Deletes an accelerated IP address of a basic Global Accelerator (GA) instance.
DeleteBasicAccelerateIpEndpointRelation DeleteBasicAccelerateIpEndpointRelation Deletes a mapping between an accelerated IP address and an endpoint for a basic Global Accelerator (GA) instance.
DeleteBasicAccelerator DeleteBasicAccelerator Deletes a basic Global Accelerator (GA) instance.
DeleteBasicEndpoint DeleteBasicEndpoint Deletes an endpoint that is associated with a basic Global Accelerator (GA) instance.
DeleteBasicEndpointGroup DeleteBasicEndpointGroup Deletes an endpoint group that is associated with a basic Global Accelerator (GA) instance.
DeleteBasicIpSet DeleteBasicIpSet Deletes the acceleration region of a basic Global Accelerator (GA) instance.
DeleteCustomRoutingEndpointGroupDestinations DeleteCustomRoutingEndpointGroupDestinations Deletes mappings from an endpoint group that is associated with a custom routing listener.
DeleteCustomRoutingEndpointGroups DeleteCustomRoutingEndpointGroups Deletes multiple endpoint groups that are associated with a custom routing listener.
DeleteCustomRoutingEndpointTrafficPolicies DeleteCustomRoutingEndpointTrafficPolicies Deletes traffic destinations from an endpoint.
DeleteCustomRoutingEndpoints DeleteCustomRoutingEndpoints Deletes endpoints from a custom routing listener.
DeleteDomainAcceleratorRelation DeleteDomainAcceleratorRelation Disassociates a domain name from Global Accelerator (GA) instances.
DeleteEndpointGroup DeleteEndpointGroup Deletes an endpoint group.
DeleteEndpointGroups DeleteEndpointGroups Deletes endpoint groups.
DeleteForwardingRules DeleteForwardingRules Deletes forwarding rules.
DeleteIpSet DeleteIpSet Deletes an acceleration region.
DeleteIpSets DeleteIpSets Deletes acceleration regions.
DeleteListener DeleteListener Deletes a listener.
DeleteSpareIps DeleteSpareIps Deletes the secondary IP addresses that are associated with a CNAME.
DescribeAcceleratorAutoRenewAttribute DescribeAcceleratorAutoRenewAttribute Queries the auto-renewal status of a Global Accelerator (GA) instance.
DescribeAcceleratorServiceStatus DescribeAcceleratorServiceStatus Queries the status of a pay-as-you-go Global Accelerator (GA) instance.
DescribeApplicationMonitor DescribeApplicationMonitor Queries the detailed information about an origin probing task.
DescribeBandwidthPackage DescribeBandwidthPackage Queries information about a bandwidth plan.
DescribeBandwidthPackageAutoRenewAttribute DescribeBandwidthPackageAutoRenewAttribute Queries the auto-renewal status of a bandwidth plan.
DescribeCommodity DescribeCommodity Queries information about commodities.
DescribeCommodityPrice DescribeCommodityPrice Queries the prices of commodities.
DescribeCustomRoutingEndPointTrafficPolicy DescribeCustomRoutingEndPointTrafficPolicy Queries a traffic destination of an endpoint.
DescribeCustomRoutingEndpoint DescribeCustomRoutingEndpoint Queries a specified endpoint that is associated with a custom routing listener.
DescribeCustomRoutingEndpointGroup DescribeCustomRoutingEndpointGroup Queries the information about a specific endpoint group that is associated with a custom routing listener.
DescribeCustomRoutingEndpointGroupDestinations DescribeCustomRoutingEndpointGroupDestinations Queries the mapping configuration of a specified endpoint group that is associated with a custom routing listener.
DescribeEndpointGroup DescribeEndpointGroup Returns the details of a specified endpoint group.
DescribeIpSet DescribeIpSet Queries information about an acceleration region.
DescribeListener DescribeListener Queries configuration information about a listener of a Global Accelerator (GA) instance.
DescribeLogStoreOfEndpointGroup DescribeLogStoreOfEndpointGroup Queries the Simple Log Service project and Logstore associated with an endpoint group.
DescribeRegions DescribeRegions Queries the regions where Global Accelerator (GA) instances are deployed.
DetachLogStoreFromEndpointGroup DetachLogStoreFromEndpointGroup Disassociates a Log Service Logstore from an endpoint group.
DetectApplicationMonitor DetectApplicationMonitor Enables the diagnostic feature for an origin probing task.
DisableApplicationMonitor DisableApplicationMonitor Disables an origin probing task.
DissociateAclsFromListener DissociateAclsFromListener Disassociates access control lists (ACLs) from a listener.
DissociateAdditionalCertificatesFromListener DissociateAdditionalCertificatesFromListener Disassociates an additional certificate from an HTTPS listener.
EnableApplicationMonitor EnableApplicationMonitor Enables an origin probing task.
GetAcl GetAcl Queries an access control list (ACL).
GetBasicAccelerateIp GetBasicAccelerateIp Queries the status of an accelerated IP address of a basic Global Accelerator (GA) instance.
GetBasicAccelerateIpEndpointRelation GetBasicAccelerateIpEndpointRelation Queries whether the accelerated IP address of a basic Global Accelerator (GA) instance is associated with an endpoint.
GetBasicAccelerateIpIdleCount GetBasicAccelerateIpIdleCount Queries the number of idle accelerated IP addresses of a Global Accelerator (GA) instance.
GetBasicAccelerator GetBasicAccelerator Queries the information about a basic Global Accelerator (GA) instance.
GetBasicEndpoint GetBasicEndpoint Queries detailed information about an endpoint that is associated with a basic Global Accelerator (GA) instance.
GetBasicEndpointGroup GetBasicEndpointGroup Queries the information about the endpoint group of a basic GA instance.
GetBasicIpSet GetBasicIpSet Queries the information about the acceleration region of a basic Global Accelerator (GA) instance.
GetHealthStatus GetHealthStatus Queries the health status of the endpoints and endpoint groups of a listener.
GetInvalidDomainCount GetInvalidDomainCount Queries the number of invalid domain names.
GetIpsetsBandwidthLimit GetIpsetsBandwidthLimit Queries the maximum bandwidth of an acceleration area.
GetSpareIp GetSpareIp Queries the status of a secondary IP address that is associated with a CNAME.
ListAccelerateAreas ListAccelerateAreas Queries available acceleration areas and regions.
ListAccelerators ListAccelerators Queries a list of Global Accelerator instances.
ListAcls ListAcls Queries a list of access control lists (ACLs).
ListApplicationMonitor ListApplicationMonitor Queries origin probing tasks.
ListApplicationMonitorDetectResult ListApplicationMonitorDetectResult Queries the diagnostic results of origin probing tasks.
ListAvailableBusiRegions ListAvailableBusiRegions Queries the available acceleration regions of a Global Accelerator (GA) instance.
ListBandwidthPackages ListBandwidthPackages Queries bandwidth plans.
ListBasicAccelerateIpEndpointRelations ListBasicAccelerateIpEndpointRelations Queries whether the accelerated IP address of a basic Global Accelerator (GA) instance is associated with an endpoint.
ListBasicAccelerateIps ListBasicAccelerateIps Queries the accelerated IP addresses in the acceleration region of a basic Global Accelerator (GA) instance.
ListBasicAccelerators ListBasicAccelerators Queries basic Global Accelerator (GA) instances.
ListBasicEndpoints ListBasicEndpoints Queries the endpoints that are associated with a basic Global Accelerator (GA) instance.
ListBusiRegions ListBusiRegions Queries the acceleration regions that are supported by Global Accelerator (GA).
ListCommonAreas ListCommonAreas Queries available acceleration areas and regions.
ListCustomRoutingEndpointGroupDestinations ListCustomRoutingEndpointGroupDestinations Queries endpoint group mapping configurations of a custom routing listener of a Global Accelerator (GA) instance.
ListCustomRoutingEndpointGroups ListCustomRoutingEndpointGroups Queries the endpoint groups that are associated with a custom routing listener.
ListCustomRoutingEndpointTrafficPolicies ListCustomRoutingEndpointTrafficPolicies Queries the traffic policies of an endpoint that belongs to a custom routing listener.
ListCustomRoutingEndpoints ListCustomRoutingEndpoints Queries the configurations of an endpoint.
ListDomains ListDomains Queries accelerated domain names.
ListEndpointGroupIpAddressCidrBlocks ListEndpointGroupIpAddressCidrBlocks Queries the public CIDR blocks to which the endpoint group IP addresses belong. The CIDR blocks can be used to configure ACLs in terminals.
ListForwardingRules ListForwardingRules Queries forwarding rules.
ListIpSets ListIpSets Queries acceleration regions.
ListIspTypes ListIspTypes Queries the line types of elastic IP addresses (EIPs) that are supported in an acceleration region.
ListListenerCertificates ListListenerCertificates Queries the certificates associated with a listener.
ListSpareIps ListSpareIps Queries the information about the secondary IP addresses that are associated with a CNAME.
ListSystemSecurityPolicies ListSystemSecurityPolicies Queries the TLS security policies that are supported by HTTPS listeners.
ListTagResources ListTagResources Queries the tags that are added to Global Accelerator (GA) resources.
OpenAcceleratorService OpenAcceleratorService Activates the pay-as-you-go Global Accelerator (GA) service. If you want to use pay-as-you-go GA instances, you must activate the pay-as-you-go GA service first.
QueryCrossBorderApprovalStatus QueryCrossBorderApprovalStatus Queries the approval status of cross-border permissions for an Alibaba Cloud account (main account).
RemoveEntriesFromAcl RemoveEntriesFromAcl Deletes IP entries from an access control list (ACL).
ReplaceBandwidthPackage ReplaceBandwidthPackage Replaces the bandwidth plans of Global Accelerator (GA) instances.
TagResources TagResources Adds tags to Global Accelerator (GA) resources.
UntagResources UntagResources Removes tags from Global Accelerator (GA) resources.
UpdateAcceleratorConfirm UpdateAcceleratorConfirm Confirms the updated specification of a Global Accelerator (GA) instance.
UpdateAcceleratorCrossBorderMode UpdateAcceleratorCrossBorderMode Changes the type of transmission network for a Global Accelerator (GA) instance.
UpdateAcceleratorCrossBorderStatus UpdateAcceleratorCrossBorderStatus Enables cross-border data transmission for a Global Accelerator (GA) instance.
UpdateAclAttribute UpdateAclAttribute Modifies the attributes of an access control list (ACL) of a Global Accelerator (GA) instance.
UpdateAdditionalCertificateWithListener UpdateAdditionalCertificateWithListener Replaces an expired additional certificate for an HTTPS listener.
UpdateApplicationMonitor UpdateApplicationMonitor Modifies an origin probing task.
UpdateBandwidthPackagaAutoRenewAttribute UpdateBandwidthPackagaAutoRenewAttribute Changes the auto-renewal status of a bandwidth plan.
UpdateBasicAccelerator UpdateBasicAccelerator Modifies the name and description of a basic Global Accelerator (GA) instance.
UpdateBasicEndpoint UpdateBasicEndpoint Modifies the name of an endpoint that is associated with a basic Global Accelerator (GA) instance.
UpdateBasicEndpointGroup UpdateBasicEndpointGroup Modifies the configurations of an endpoint group that is associated with a basic Global Accelerator (GA) instance.
UpdateBasicIpSet UpdateBasicIpSet Modifies the bandwidth of an acceleration region of a basic Global Accelerator (GA) instance.
UpdateCustomRoutingEndpointGroupDestinations UpdateCustomRoutingEndpointGroupDestinations Modifies the mapping configurations of an endpoint group that is associated with a custom routing listener.
UpdateCustomRoutingEndpointTrafficPolicies UpdateCustomRoutingEndpointTrafficPolicies Modifies the traffic policies for an endpoint that is associated with a custom routing listener.
UpdateCustomRoutingEndpoints UpdateCustomRoutingEndpoints Modifies the endpoints of a custom routing listener.
UpdateDomain UpdateDomain Modifies an accelerated domain name.
UpdateDomainState UpdateDomainState Updates the ICP filing status of an accelerated domain name.
UpdateEndpointGroup UpdateEndpointGroup Modifies the configurations of an endpoint group.
UpdateEndpointGroupAttribute UpdateEndpointGroupAttribute Modifies the name and description of an endpoint group.
UpdateEndpointGroups UpdateEndpointGroups Modifies endpoint groups for a listener in a batch.
UpdateForwardingRules UpdateForwardingRules Updates a forwarding rule.
UpdateIpSet UpdateIpSet Modifies the attributes of an acceleration region in an acceleration area for a Global Accelerator (GA) instance.
UpdateIpSets UpdateIpSets Modifies the attributes of acceleration regions in an acceleration area for a Global Accelerator (GA) instance.
UpdateListener UpdateListener Modifies the configurations of a listener for a Global Accelerator (GA) instance.
UpdateServiceManagedControl UpdateServiceManagedControl Changes the control mode of a resource from managed mode to unmanaged mode.