All Products
Search
Document Center

Server Load Balancer:API overview

Last Updated:Dec 22, 2025

API standard and pre-built SDKs in multi-language

The OpenAPI specification of this product (Nlb/2022-04-30) 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. Create a Resource Access Management (RAM) user with API-only access and use RAM policies to apply the principle of least privilege (PoLP). Alibaba Cloud accounts are only used when explicitly required.

To call APIs securely, configure the following:

Monitoring

API

Title

Description

DescribeHdMonitorRegionConfig DescribeHdMonitorRegionConfig Queries the storage configurations of fine-grained monitoring.
SetHdMonitorRegionConfig SetHdMonitorRegionConfig Configures storage for fine-grained monitoring.

Region and zone management

API

Title

Description

DescribeRegions DescribeRegions Queries regions that support Network Load Balancer (NLB) instances.
DescribeZones DescribeZones Queries the zones of a region in which a Network Load Balancer (NLB) instance is deployed.

Network Load Balancer instances

API

Title

Description

CreateLoadBalancer CreateLoadBalancer Creates a Network Load Balancer (NLB) instance in a specified region.
DeleteLoadBalancer DeleteLoadBalancer Deletes a Network Load Balancer (NLB) instance.
UpdateLoadBalancerAddressTypeConfig UpdateLoadBalancerAddressTypeConfig Changes the network type of the IPv4 address for a Network Load Balancer (NLB) instance.
UpdateLoadBalancerAttribute UpdateLoadBalancerAttribute Updates the attributes, including the name, of a Network Load Balancer (NLB) instance.
UpdateLoadBalancerZones UpdateLoadBalancerZones Modifies the zones and zone attributes of a Network Load Balancer (NLB) instance.
EnableLoadBalancerIpv6Internet EnableLoadBalancerIpv6Internet Changes the network type of the IPv6 address of a dual-stack Network Load Balancer (NLB) instance from internal-facing to Internet-facing.
DisableLoadBalancerIpv6Internet DisableLoadBalancerIpv6Internet Changes the public IPv6 address of a dual-stack Network Load Balancer (NLB) instance to a private IPv6 address.
LoadBalancerLeaveSecurityGroup LoadBalancerLeaveSecurityGroup Disassociates a Network Load Balancer (NLB) instance from a security group.
LoadBalancerJoinSecurityGroup LoadBalancerJoinSecurityGroup Associates a security group with a Network Load Balancer (NLB) instance.
UpdateLoadBalancerProtection UpdateLoadBalancerProtection Enables or disables the deletion protection feature.
ListLoadBalancers ListLoadBalancers Queries the basic information about Network Load Balancer (NLB) instances.
GetLoadBalancerAttribute GetLoadBalancerAttribute Queries the details about a Network Load Balancer (NLB) instance.
StartShiftLoadBalancerZones StartShiftLoadBalancerZones Removes the elastic IP address (EIP) or virtual IP address (VIP) used in a zone from the DNS record.
CancelShiftLoadBalancerZones CancelShiftLoadBalancerZones Adds the elastic IP address (EIP) and virtual IP address (VIP) of a zone to the DNS record.

Listeners

API

Title

Description

CreateListener CreateListener Creates a TCP, UDP, or TCP/SSL listener for a Network Load Balancer (NLB) instance.
DeleteListener DeleteListener Deletes a Network Load Balancer (NLB) listener.
StartListener StartListener Enables a Network Load Balancer (NLB) listener.
StopListener StopListener Stops a listener of a Network Load Balancer (NLB) instance.
UpdateListenerAttribute UpdateListenerAttribute Updates the attributes of a listener, such as the name and the idle connection timeout period.
ListListeners ListListeners Queries listeners added to a Network Load Balancer (NLB) instance.
GetListenerAttribute GetListenerAttribute Queries the details of a Network Load Balancer (NLB) listener.
GetListenerHealthStatus GetListenerHealthStatus Queries the health check status of a Network Load Balancer (NLB) listener.

Listener certificates

API

Title

Description

ListListenerCertificates ListListenerCertificates Queries the server certificate of a TCP/SSL listener.
AssociateAdditionalCertificatesWithListener AssociateAdditionalCertificatesWithListener Associates additional certificates with a listener that uses SSL over TCP.
DisassociateAdditionalCertificatesWithListener DisassociateAdditionalCertificatesWithListener Disassociates additional certificates from a listener that uses SSL over TCP.

Server groups

API

Title

Description

CreateServerGroup CreateServerGroup Creates a server group in a specified region.
AddServersToServerGroup AddServersToServerGroup Adds backend servers to a specified server group.
DeleteServerGroup DeleteServerGroup Deletes a Network Load Balancer (NLB) server group.
RemoveServersFromServerGroup RemoveServersFromServerGroup Deletes server groups from a Network Load Balancer (NLB) instance.
UpdateServerGroupAttribute UpdateServerGroupAttribute Updates the configuration of a Network Load Balancer (NLB) server group.
UpdateServerGroupServersAttribute UpdateServerGroupServersAttribute Modifies the weights and descriptions of backend servers in a server group of a Network Load Balancer (NLB) instance.
ListServerGroups ListServerGroups Queries the server groups of a Network Load Balancer (NLB) instance.
ListServerGroupServers ListServerGroupServers Queries servers in a server group of a Network Load Balancer (NLB) instance.

Common bandwidth package

API

Title

Description

DetachCommonBandwidthPackageFromLoadBalancer DetachCommonBandwidthPackageFromLoadBalancer Disassociates a Network Load Balancer (NLB) instance from an Internet Shared Bandwidth instance.
AttachCommonBandwidthPackageToLoadBalancer AttachCommonBandwidthPackageToLoadBalancer Associates an Internet Shared Bandwidth instance with a Network Load Balancer (NLB) instance.

Security policy management

API

Title

Description

CreateSecurityPolicy CreateSecurityPolicy Creates a custom security policy for a TCP/SSL listener.
DeleteSecurityPolicy DeleteSecurityPolicy Deletes a custom TLS security policy from a Network Load Balancer (NLB) instance.
UpdateSecurityPolicyAttribute UpdateSecurityPolicyAttribute Modifies the configurations of a security policy for a Network Load Balancer (NLB) instance.
ListSecurityPolicy ListSecurityPolicy Queries the TLS security policies set for a Network Load Balancer (NLB) instance.
ListSystemSecurityPolicy ListSystemSecurityPolicy Queries the default TLS policy.

Resource groups

API

Title

Description

MoveResourceGroup MoveResourceGroup Modify the group of resource.

Asynchronous tasks

API

Title

Description

GetJobStatus GetJobStatus Queries the result of an asynchronous operation performed on a Network Load Balancer (NLB) instance.
ListAsynJobs ListAsynJobs Queries the results of multiple asynchronous operations performed on a Network Load Balancer (NLB) instance.

Tags

API

Title

Description

TagResources TagResources Adds tags to specified resources.
UntagResources UntagResources Removes tags from resources.
ListTagResources ListTagResources Queries the tags of a resource.