All Products
Search

This Product

    Edge Security Acceleration:BatchDeleteDcdnDomainConfigs

    Document Center

    Edge Security Acceleration:BatchDeleteDcdnDomainConfigs

    Last Updated:Aug 20, 2026

    Deletes configurations for multiple accelerated domain names at a time.

    Operation description

    Note

    • Request rate limit per user: 30 requests per second.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dcdn:BatchDeleteDcdnDomainConfigs

    update

    *domain

    acs:dcdn:*:{#accountId}:domain/{#domainName}

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    DomainNames

    string

    Yes

    The accelerated domain names whose configurations you want to delete. Separate multiple domain names with commas (,). The following limits apply:

    • You can specify up to 20 domain names in a single request.

    • The product of the number of domain names and the number of function names must be 50 or less.

    example.com
    FunctionNames

    string

    Yes

    The function names whose configurations you want to delete. Separate multiple function names with commas (,). You can specify up to 50 function names in a single request. For more information, see Domain configuration function parameters.

    referer_white_list_set,https_force

    The following table lists all supported functions.

    Name Parameters
    referer_white_list_set: Referer hotlink protection whitelist refer_domain_allow_list: Whitelist entries separated by commas (,).
    allow_empty: Whether to allow access to DCDN resources when the Referer field is empty. Valid values: on or off.
    referer_black_list_set: Referer hotlink protection blacklist refer_domain_deny_list: Blacklist entries separated by commas (,).
    allow_empty: Whether to allow access to DCDN resources when the Referer field is empty. Valid values: on or off.
    filetype_based_ttl_set: File type cache expiration time settings ttl: Cache time in seconds.
    file_type: File types. Separate multiple file types with commas (,), such as TXT, JPG.
    weight: Weight.
    path_based_ttl_set: Path-based cache expiration time settings ttl: Cache time in seconds.
    path: Path. Must start with a forward slash (/).
    weight: Weight.
    oss_auth: OSS authentication bucket oss_bucket_id: Your bucket address.
    ip_black_list_set: IP address blacklist ip_list: IP addresses separated by commas (,).
    ip_allow_list_set: IP address whitelist ip_list: IP addresses separated by commas (,).
    error_page: Error page redirection error_code: Error code.
    rewrite_page: Redirect page.
    set_req_host_header: Modify custom origin request HOST header domain_name: Content of the origin request HOST header.
    set_hashkey_args: Ignore URL parameters hashkey_args: Parameters to retain. Separate multiple parameters with commas (,). You can specify up to 10 parameters.
    disable: Set to on to ignore all parameters. Set to off to not ignore parameters (cache hashkey ignores all parameters, but this setting has lower priority than the parameter retention list).
    keep_oss_args: Set to on to retain all parameters in origin requests. Set to off to use the same parameters as the cache hashkey.
    aliauth: Alibaba Cloud authentication auth_type: Authentication type. Valid values: no_auth (no authentication), type_a, type_b, type_c.
    auth_key1: Authentication key1. auth_key2: Authentication key2.
    ali_auth_delta: Custom authentication buffer time.
    set_resp_header: Set HTTP response headers (visible in browsers) key (required): Response header.
    value (required): Response header value. Set to null to delete.
    header_operation_type: Header operation type. Valid values: add, delete, modify, rewrite.
    duplicate: Whether to allow duplicates. Valid values: on or off.
    header_source: Find.
    header_destination: Replace with.
    match_all: Match all. Valid values: on or off.
    https_force: Force HTTPS redirect enable: Enable or disable the feature. Valid values: on or off.
    http_force: Force HTTP redirect enable: Enable or disable the feature. Valid values: on or off.
    https_option: HTTPS basic parameters http2: HTTP/2 switch. Valid values: on or off.
    ocsp_stapling: OCSP Stapling switch. Valid values: on or off.
    forward_scheme: Static protocol follows origin protocol enable: Switch. Valid values: on or off.
    scheme_origin: Origin protocol type. Valid values: http, https, follow.
    dynamic: DCDN-related configuration enable (required): Switch. Valid values: on or off.
    static_route_type: File extensions for static acceleration.
    static_route_url: URIs for static acceleration.
    static_route_path: Paths for static acceleration.
    dynamic_route_origin: Origin fetch scheme. Valid values: http, https, follow, follow-port.
    dynamic_route_round_robin: Enable Server Load Balancer. Valid values: on or off.
    dynamic_route_adapt_cache: Enable adaptive caching. Valid values: on or off.
    set_req_header: Custom origin request HTTP header key: Origin request header.
    value: Origin request header value.
    l2_oss_key: Private OSS bucket origin fetch on Alibaba Cloud private_oss_auth: Switch for private bucket origin fetch. Valid values: on or off.
    range: Range-based origin fetch enable: Switch. Valid values: on or off.
    video_seek: Video seeking enable (required): Switch. Valid values: on or off.
    flv_seek_by_time: Enable FLV time-based seeking. Valid values: on or off.
    mp4_seek_start: Custom MP4 start parameter.
    mp4_seek_end: Custom MP4 end parameter.
    flv_seek_start: Custom FLV start parameter.
    flv_seek_end: Custom FLV end parameter.
    websocket: WebSocket enabled (required): Whether to enable. Valid values: on or off.
    origin_scheme: Origin fetch scheme. Valid values: http, https, follow.
    heartbeat: Heartbeat interval in seconds. Default: 60. Valid range: 1–300.
    ali_remove_args: Ignore URL parameters (remove) ali_remove_args (required): Parameters to remove. Separate multiple parameters with spaces. Remaining parameters become part of the URL args in the hashkey.
    keep_oss_args: Retain parameters in origin requests. Valid values: on (retain all parameters) or off (use the same parameters as the cache hashkey).
    https_tls_version: TLS protocol version tls10: Enable TLSv1.0. Default: on. Valid values: on or off.
    tls11: Enable TLSv1.1. Default: on. Valid values: on or off.
    tls12: Enable TLSv1.2. Default: on. Valid values: on or off.
    tls13: Enable TLSv1.3. Default: off. Valid values: on or off.
    HSTS: HTTP Strict Transport Security enabled (required): Switch. Default: off. Valid values: on or off.
    https_hsts_max_age (required): Expiration time in milliseconds. We recommend 5184000000 ms (60 days).
    https_hsts_include_subdomains: Include the includeSubDomains directive in the HSTS header. Valid values: on or off. Use caution. Before enabling, ensure all subdomains of the accelerated domain name support HTTPS. Otherwise, subdomains may become inaccessible after automatic HTTPS redirects.
    filetype_force_ttl_code: File status code expiration time settings file_type (required): File types. Separate multiple types with commas (,), such as TXT, JPG.
    code_string (required): Status codes. Separate multiple codes with commas (,). Example: 302=0,301=0,4xx=2.
    path_force_ttl_code: Path status code expiration time settings path (required): Must start with a forward slash (/), such as /image.
    code_string (required): Status codes. Separate multiple codes with commas (,). Example: 302=0,301=0,4xx=2.
    gzip: Intelligent compression enable (required): Switch. Valid values: on or off.
    tesla: HTML optimization enable (required): Switch. Valid values: on or off.
    trim_js: Valid values: on or off. When enabled, optimizes inline JavaScript in HTML.
    trim_css: Valid values: on or off. When enabled, optimizes inline CSS in HTML.
    https_origin_sni: Origin SNI enabled: Switch. Valid values: on or off.
    https_origin_sni (required): Origin SNI value.
    protogw: IP application acceleration realip (required): Origin IP pass-through method. Valid values: off, toa, pp.
    port (required): Service port.
    patten: Pattern string.
    host_redirect: Rewrite function regex: URL to rewrite, such as ^/$.
    replacement: Target URL, such as /go/act/sale/tbzlsy.php.
    flag: Valid values: redirect, break.
    forward_timeout: Origin request timeout forward_timeout: Timeout in seconds. We recommend setting it to no more than 100 seconds.
    ipv6: IPv6 configuration switch (required): Switch. Valid values: on (enable) or off (disable).
    region: Regions where IPv6 is enabled. Supports asterisk (*) for all regions.
    edge_function: Edge function
    rule (required): DSL rule.
    pri (required): Priority.
    enable (required): Whether the rule takes effect. Valid values: on or off.
    name: Rule name.
    pos: Execution position. For DCDN domain names, only head is supported. foot is not supported.
    brk: Skip remaining rules at the current execution position after this rule matches.
    option: Option control.
    grammar: Grammar control. Valid values: empty, es2, js.
    jsmode: JS domain whitelist control. Valid values: redirect, bypass.
    brotli: Brotli compression enable (required): Switch. Valid values: on or off.
    brotli_level: Compression level. Valid range: [1,11].
    ali_ua: User-Agent blacklist/whitelist ua: User-Agent.
    type: List type. Valid values: black or white.

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    04F0F334-1335-436C-A1D7-6C044FE73368

    Examples

    Success response

    JSON format

    {
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 Invalid%s.ValueNotSupported FunctionName [%s] is not supported. The specified configuration is not supported.
    400 DeleteFunctionFailed Batch delete functions failed. Failed to delete the configurations.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.