All Products
Search
Document Center

Alibaba Cloud DNS:Address configuration

Last Updated:Dec 23, 2025

Configure addresses, set up endpoints and health check templates, and dynamically monitor the health status of your endpoints.

Terms

Address: An address represents your actual service endpoint. The health status of an address indicates whether your service is available. Global Traffic Manager (GTM) supports IPv4, IPv6, and domain name address types. An Address Pool can contain multiple addresses, and an address can be used by multiple Address Pool.

Create an address

  1. Go to the Alibaba Cloud DNS - Global Traffic Manager console.

  2. Click Address > Create Address.

  3. On the Create Address page, click the address icon > Basic Configuration.

    image

  4. Configure the parameters and submit the form.

    Form Item

    Description

    Address Name

    Enter a name for the address that is easy to remember and identify. The name can be in Chinese, English, or other languages.

    Type

    The address can be an IP address or a domain name. IP addresses can be IPv4 or IPv6. You can also use a Zone name.

    Note

    IP addresses are commonly used. However, because your service endpoint might be a domain name for services such as CDN, Anti-DDoS Pro and Anti-DDoS Premium, or a firewall, we also support domain names as an address type.

    Service Address

    Enter the Service Address based on the selected address type. If you select IPv4 as the address type, enter the IPv4 address of your application service. If you select Domain Name, enter the domain name of your application service.

    Health Check

    Optional. If you do not configure a health check, the default status of the address is Normal.

    To configure a health check, create a health check template in advance. For more information, see 4. Health check templates.

    • Port: The port number of the service endpoint that the health check probes.

      Note
      • You can configure up to 5 ports.

      • The port number can be an integer in the range of 0 - 65535, including 0 and 65535, where a value of 0 indicates any port.

    • Health Check Template: The health check protocol used to probe the port. It supports a combination of protocols, such as Ping, TCP, and HTTP(S). You can directly associate an existing health check template.

    Health Status Conditions

    The condition to determine if the current address is normal. The threshold is calculated as: Number of normal health check templates / Total number of associated health check templates. The following options are available:

    • At least one probe in all health check templates must be normal

    • Detection results of at least 30% of templates are normal.

    • Detection results of at least 50% of templates are normal.

    • Detection results of at least 70% of templates are normal.

    • Detection results of all detection templates are normal.

    Enabed State

    Set to Enabled by default. If set to Disabled, Address Pool that reference this address will no longer return it.

    Note

    If an address is disabled, health checks still run if a health check template is configured.

    Remarks

    Enter a remark to help you identify the address.

    image

Attach a Health Check Template to an address

If you did not attach a health check template when you created the address, you can follow these steps to attach one and monitor the health status of the address.

  1. Go to the Alibaba Cloud DNS - Global Traffic Manager console.

  2. Click Address, find the target address, and click Configuration to open the configuration details page.

  3. Click the address icon > Basic Configuration to open the configuration panel.

  4. From the drop-down list, select a pre-configured Health Check Template. If the Health Check Template type is Ping, you do not need to enter a port number. If the Health Check Template type is TCP, HTTP, or HTTPS, you must specify a port number.

    Note

    You can set a maximum of five health check ports for a single address.

    You can specify multiple Health Check Template of the same type for each record. The same address can be used in multiple records.

    image

Manage addresses

Unbind Current Address

Impact: The address is removed from the current address pool. GTM no longer routes requests to this address. If a health check template is attached to the address, the health check task continues to run.

  1. On the Access Domain configuration page, click the address icon > Unbind Current Address.

    image

  2. Confirm the operation in the dialog box that appears.

Enable Globally/Disable Globally/Delete Globally

Impact

Change Type

Impact

Enable Globally

Confirm that the address configuration is correct and the Service Availability is Available. Otherwise, enabling the address will include it in DNS resolution, which might cause service unavailability.

Disable Globally, Delete Globally

If an address is referenced by multiple address pools and associated with multiple access domain names, disabling or deleting the address affects all of them. Proceed with caution.

After an address is disabled or deleted, GTM no longer routes new requests to it. However, the address might still be returned in queries because of carrier Local DNS caches. The change takes effect after the Local DNS cache expires.

  1. On the Access Domain configuration page, click the address icon > Enable Globally / Disable Globally / Delete Globally.

    image

  2. Confirm the operation in the dialog box that appears.

Failover Mode

Configure how the health status of an address is determined and whether it is included in DNS resolution if it becomes abnormal.

  1. Go to the Alibaba Cloud DNS - Global Traffic Manager console.

  2. Click Address, find the target IP address, and click Configuration.

  3. Click the address icon > Failover Mode.

    image

  4. In the dialog box, select a Failover Mode.

    • Automatic Failover: This is the default configuration. The system automatically determines whether to use the address for DNS resolution based on health check results. If a health check fails, DNS resolution for the address stops. When the health check passes, DNS resolution for the address resumes.

    • Manual Switchover: You can set the address status to Normal or Abnormal.

      • Normal: The IP address is always considered normal, and DNS resolution always includes this IP address. Health checks continue to monitor the IP address and send alerts, but failover actions are not performed.

      • Abnormal: The IP address is always considered abnormal, and DNS resolution does not include this IP address.

        Important

        If the address is not associated with a GTM instance, alert notifications are not sent.

    image

Address status description

Health Status description

  • Normal: All attached health check templates are normal, or no health check templates are attached.

  • Warning: Some attached health check templates are abnormal, but the number of abnormal templates does not exceed the configured threshold. The address is still included in DNS resolution.

  • Abnormal: The number of abnormal health check templates exceeds the configured threshold. The address is removed from DNS resolution.

Service Availability description

The Service Availability is determined by the address's Enabed State and Service Availability. The logic is described in the following table:

Enabed State

Failover Mode

Manual Switchover Status

Health Status

Service Availability Status

Enabled

Automatic Failover

--

Normal or Warning

Available

Abnormal

Unavailable

Enabled

Manual Switchover

Normal

Normal, Warning, or Abnormal

Available

Abnormal

Normal, Warning, or Abnormal

Unavailable

Disabled

Automatic Failover or Manual Switchover

Normal or Abnormal

Normal, Warning, or Abnormal

Unavailable

Note