All Products
Search
Document Center

Edge Security Acceleration:Site management

Last Updated:Jun 10, 2026

Add a site to connect a root domain and all its subdomains to ESA at once. You can then view, disable, delete, and tag sites for resource classification, cost allocation, and access control.

Before you begin

Ensure the following before you add and manage sites:

  • Permission preparation: Ensure that the current account has site management permissions for ESA. RAM (Resource Access Management) users must be granted one of the following permissions: Full permissions: esa:* Read-only permissions: esa:ListSites, esa:DescribeSite

  • Account status: The Alibaba Cloud account must have completed identity verification. Unverified accounts cannot add or manage sites.

  • Domain preparation: For NS access, prepare to change your domain NS records to the ESA-assigned DNS servers. For CNAME access, prepare the required CNAME records.

Add a site

Use the Add Website feature to connect a site to ESA.

View site details

View a site's access method, region, and traffic data.

  1. Go to Websites in the ESA console.

  2. View the site name, access method, region, and other details on the page.

  3. In the Website column, click a site name to view its data overview, response traffic, and client request traffic.

image

Delete a site

Before deleting a site, ensure that the following prerequisites are met:

  • For sites using NS access: Log on to your domain registrar and delete the NS records assigned by ESA. If the NS records are not removed before you delete the site, the system returns a NameServerNotDelete error and the deletion is blocked.

  • Live service migration: Ensure that your live services have been migrated away from ESA.

After deletion, configuration is permanently removed and monitoring data is retained for 180 days. You can re-add the site to view historical traffic data.

  1. Go to Websites in the ESA console.

  2. On the page, find the target site and click Delete in the Actions column.

  3. Read the prompt, manually enter the site name, and then click OK to confirm deletion.

    image

Disable a site

New sites default to the Active state. Disabling a site stops all DNS resolutions and causes edge nodes to reject requests. Disable a site when you temporarily do not need it to serve traffic.

Note

Alibaba Cloud automatically disables sites with overdue payments, expired plans, or policy violations. Re-enable the site after resolving the issue.

  1. Go to Websites in the ESA console.

  2. On the page, find the target site, click Disable in the Actions column, and then click OK to confirm.

The site enters the Suspended state. Click Enable to restore DNS and proxy acceleration services.

Tag management

Tag overview

Tags are key-value labels that you bind to sites for classification and management.

Each tag consists of a tag key and a tag value, in the format tagKey:tagValue. For example, project:website indicates site resources for the project "website".

Note

Resource tags versus cache tags: resource tags classify sites for billing and access control (configured on the site management page); cache tags refresh cache by tag (configured in cache policies).

Tags are primarily used for:

  • Resource classification and search: Categorize sites by business type, environment, or owner to quickly filter targets.

  • Cost allocation: Split and analyze resource costs by tag for granular cost accounting.

  • Access control: Use tags with RAM to restrict specific users or roles to sites with designated tags.

Note

Each site supports up to 20 tags. Tag keys and values must not exceed 128 characters.

Edit tags for a site

Add, modify, or delete tags for a single site.

  1. Go to Websites in the ESA console and find the target site.

  2. In the Tag column of the target site, click image and click Edit.

  3. After completing the tag configuration, click OK to save the configuration.

Note

Tag changes typically take effect within 5 minutes. Resource filtering or access control based on tags may require a brief wait for synchronization.

Manage tags using Resource Management

You can also manage tags for multiple sites through Resource Management, view tag distribution across all ESA sites under your account, and perform batch operations.

  1. Log on to the Resource Management console.

  2. In the Resource Type drop-down list, select Edge Security Acceleration to view all ESA sites and their tags under the account.

  3. Filter by tag key or value to locate target sites. You can then batch-add or modify tags for selected sites.

Note

Tag operations in Resource Management sync to site configurations in real time.

Use tags for cost allocation

Split and analyze ESA site costs by tag to track resource consumption across business lines, projects, or environments.

Recommended Tag Key

Purpose

Example Tag Value

cost-center

Identifies the responsible cost center

marketing, rd

project

Identifies the project a site belongs to

website, api-gateway

env

Distinguishes production, testing, and development environments

prod, dev

The workflow is as follows:

  1. Bind tags to sites that need cost allocation. Ensure tag keys and values accurately identify the allocation dimension (for example, cost-center:marketing).

  2. Log on to the Expenses and Costs console.

  3. In the left-side navigation pane, choose Cost Analysis > Cost Details.

  4. On the cost details page, select Tag as the statistical dimension and choose the tag key to analyze. The system splits costs by tag value, showing the cost proportion and trend for each dimension.

Important

Tag-based cost allocation data is updated daily. For real-time costs, check the billing details.

Use tags to control resource access

Use RAM tag-based policies to restrict users or roles to operating only on sites with specific tags.

Typical scenarios:

  • Project isolation: Project A operators can only access sites tagged project:project-a.

  • Environment isolation: Development operators can only access sites tagged env:dev, preventing changes to production sites.

Configuration steps:

  1. Create a custom policy in the RAM console. Use the acs:ResourceTag condition key to limit which tagged resources can be operated. Example policy:

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": "esa:*",
          "Resource": "*",
          "Condition": {
            "StringEquals": {
              "acs:ResourceTag/project": "website"
            }
          }
        }
      ]
    }
  2. Attach the policy to the target RAM user or group. The user can then only operate on sites matching the tag conditions.

Common ESA actions used in tag-based access control:

Operation (Action)

Description

esa:*

All ESA operation permissions

esa:ListSites, esa:DescribeSite

Site query permissions

esa:TagResources, esa:UntagResources

Tag binding and unbinding permissions

Warning

Ensure sites have the correct tags before enabling tag-based access control. Without matching tags, authorized users cannot access expected resources.

Related operations

The Websites page provides quick access to the following features:

FAQ

Why does adding a site fail?

Possible causes and solutions:

  • Domain already added: The root domain or subdomain is already added through ESA or another CDN product. Confirm the domain is not used by another product.

  • Insufficient permissions: Confirm the account has esa:* or esa:AddSite permissions. RAM users must be authorized by the Alibaba Cloud account.

  • Domain verification failed: Add the specified TXT record as prompted and retry.

What should I do if DNS does not take effect after adding a site?

DNS propagation time depends on your access method:

  • NS access: Global DNS propagation may take 0–48 hours after modifying NS records, depending on the registrar and local DNS cache.

  • CNAME access: Usually takes effect within minutes to a few hours.

Note

If DNS has not taken effect after 48 hours, verify that your DNS records are correct, or clear the local DNS cache and retry.

Can a site be recovered after deletion?

No. After deletion, all configuration is permanently removed and monitoring data is retained for only 180 days. To use the same domain again, you must re-add the site and reconfigure it from scratch. Back up important configurations (DNS records, cache policies, etc.) before deletion.