All Products
Search

This Product

    Edge Security Acceleration:BatchDeleteDcdnDomainConfigs

    Document Center

    Edge Security Acceleration:BatchDeleteDcdnDomainConfigs

    Last Updated:Sep 16, 2025

    Deletes configurations for multiple domain names in a batch.

    Operation description

    Note

    • You can specify a maximum of 50 domain names in a single request.

    • The throttling limit for a single user is 30 calls 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 for which you want to delete configurations. Separate multiple domain names with commas (,). Note the following limits:

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

    • The number of domain names multiplied by the number of function names cannot exceed 50.

    example.com
    FunctionNames

    string

    Yes

    The names of the features to delete. Separate multiple feature names with commas (,). You can specify up to 50 feature names in a single request. For more information about feature names, see Parameters for domain name configurations.

    referer_white_list_set,https_force

    The following table lists the features.

    NameParameters
    referer_white_list_set: Referer whitelist for hotlink protectionrefer_domain_allow_list: The whitelist. Separate multiple domain names with commas (,).
    allow_empty: Specifies whether to allow requests with an empty Referer header to access DCDN resources. Valid values: on or off.



    referer_black_list_set: Referer blacklist for hotlink protectionrefer_domain_deny_list: The blacklist. Separate multiple domain names with commas (,).
    allow_empty: Specifies whether to allow requests with an empty Referer header to access DCDN resources. Valid values: on or off.



    filetype_based_ttl_set: Sets the cache expiration time for specific file typesttl: The time-to-live (TTL). Unit: seconds.
    file_type: The file type. Separate multiple file types with commas (,), for example, TXT,JPG.
    weight: The weight.










    path_based_ttl_set: Sets the cache expiration time for specific directoriesttl: The TTL. Unit: seconds.
    path: The directory. The path must start with a forward slash (/).
    weight: The weight.










    oss_auth: OSS authentication for bucketsoss_bucket_id: The URL of your bucket.
    ip_black_list_set: IP address blacklistip_list: The list of IP addresses. Separate multiple IP addresses with commas (,).
    ip_allow_list_set: IP address whitelistip_list: The list of IP addresses. Separate multiple IP addresses with commas (,).
    error_page: Error page redirectionerror_code: The error code.
    rewrite_page: The redirection page.



    set_req_host_header: Modifies the custom back-to-origin request headerdomain_name: The content of the back-to-origin HOST header.
    set_hashkey_args: Ignores URL parametershashkey_args: The list of parameters to retain. Separate multiple parameters with commas (,). You can specify up to 10 parameters.
    disable: Set to on to ignore all parameters, or off to not ignore them. Ignoring all parameters for the cache hash key has a lower priority than retaining specific cache parameters.
    keep_oss_args: Set to on to retain all parameters for origin fetch requests, or off to use the same parameters as the cache hash key.










    aliauth: Alibaba Cloud authenticationauth_type: The authentication type. no_auth: no authentication. type_a: authentication method A. type_b: authentication method B. type_c: authentication method C.
    auth_key1: Authentication key 1. auth_key2: Authentication key 2.
    ali_auth_delta: The custom authentication cache time.










    set_resp_header: Sets HTTP response headers. These headers are visible on the browser.key (Required): The response header.
    value (Required): The content of the response header. To delete the header, set this to null.
    header_operation_type: The operation on the request header. Valid values: add, delete, modify, and rewrite.
    duplicate: Specifies whether to allow duplicates. Valid values: on or off.
    header_source: The header to find.
    header_destination: The header to replace with.
    match_all: Specifies whether to match all. Valid values: on or off.






































    https_force: Forces HTTPS redirectionenable: The switch for the feature. Valid values: on or off.
    http_force: Forces HTTP redirectionenable: The switch for the feature. Valid values: on or off.
    https_option: Basic HTTPS parametershttp2: The switch for HTTP/2. Valid values: on or off.
    ocsp_stapling: The switch for the Online Certificate Status Protocol (OCSP) feature. Valid values: on or off.



    forward_scheme: Follows the protocol of the origin server for static contentenable: The switch. Valid values: on or off.
    scheme_origin: The protocol for origin fetch. Valid values: http, https, and follow.



    dynamic: Configurations related to whole site accelerationenable (Required): The switch. Valid values: on or off.
    static_route_type: The file extensions for static acceleration.
    static_route_url: The URI for static acceleration.
    static_route_path: The path for static acceleration.
    dynamic_route_origin: The scheme for the back-to-origin route. Valid values: http, https, follow, and follow-port.
    dynamic_route_round_robin: The switch for Server Load Balancer. Valid values: on or off.
    dynamic_route_adapt_cache: The switch for adaptive caching. Valid values: on or off.






































    set_req_header: Sets custom back-to-origin HTTP headerskey: The back-to-origin header.
    value: The content of the back-to-origin header.



    l2_oss_key: Enables back-to-origin requests to a private OSS bucketprivate_oss_auth: The switch for back-to-origin to a private bucket. Valid values: on or off.
    range: Enables range-based origin fetchenable: The switch. Valid values: on or off.
    video_seek: Enables video seekingenable (Required): The switch. Valid values: on or off.
    flv_seek_by_time: Enables seeking by time for FLV files. Valid values: on or off.
    mp4_seek_start: The custom start parameter for MP4 seeking.
    mp4_seek_end: The custom end parameter for MP4 seeking.
    flv_seek_start: The custom start parameter for FLV seeking.
    flv_seek_end: The custom end parameter for FLV seeking.































    websocket: WebSocketenabled (Required): Specifies whether to enable WebSocket. Valid values: on or off.
    origin_scheme: The scheme for origin fetch. Valid values: http, https, and follow.
    heartbeat: The heartbeat timeout. Default value: 60 seconds. Valid values: 1 to 300 seconds.










    ali_remove_args: Ignores specified URL parametersali_remove_args (Required): The parameters to delete. Separate multiple parameters with spaces. The remaining parameters are used as the args part of the URL in the hash key.
    keep_oss_args: Retain parameters for origin fetch. Valid values: on (retain all parameters) or off (use the same parameters as the cache hash key).



    https_tls_version: TLS protocol versionstls10: Enables TLSv1.0. Default: on. Valid values: on or off.
    tls11: Enables TLSv1.1. Default: on. Valid values: on or off.
    tls12: Enables TLSv1.2. Default: on. Valid values: on or off.
    tls13: Enables TLSv1.3. Default: off. Valid values: on or off.

















    HSTS: HTTP Strict Transport Security (HSTS)enabled (Required): The switch. Default: off. Valid values: on or off.
    https_hsts_max_age (Required): The expiration time. Unit: ms. We recommend that you set this to 5184000000 ms (60 days).
    https_hsts_include_subdomains: Specifies whether to include the includeSubDomains parameter in the HSTS header. Valid values: on or off. Enable this feature with caution. Before you enable it, make sure that HTTPS is enabled for all subdomains of the accelerated domain name. Otherwise, the subdomains become inaccessible after automatic redirection to HTTPS.










    filetype_force_ttl_code: Sets the expiration time for specific status codes of certain file typesfile_type (Required): The file type. Separate multiple file types with commas (,), for example, TXT,JPG.
    code_string (Required): The status code. Separate multiple status codes with commas (,). For example: 302=0,301=0,4xx=2.



    path_force_ttl_code: Sets the expiration time for specific status codes of certain pathspath (Required): The path must start with a forward slash (/), for example, /image.
    code_string (Required): The status code. Separate multiple status codes with commas (,). For example: 302=0,301=0,4xx=2.



    gzip: Intelligent compressionenable (Required): The switch for the feature. Valid values: on or off.
    tesla: HTML optimizationenable (Required): The switch for the feature. Valid values: on or off.
    trim_js: Valid values: on or off. If you enable this feature, the embedded JavaScript code in the HTML is optimized.
    trim_css: Valid values: on or off. If you enable this feature, the embedded CSS code in the HTML is optimized.










    https_origin_sni: Origin Server Name Indication (SNI)enabled: The switch for the feature. Valid values: on or off.
    https_origin_sni (Required): The origin SNI.



    protogw: IP application accelerationrealip (Required): The method to pass through the real IP address of the client. Valid values: off, toa, and pp.
    port (Required): The service port.
    patten: The pattern string.










    host_redirect: Rewrite featureregex: The URL to rewrite. For example: ^/$.
    replacement: The destination URL. For example: /go/act/sale/tbzlsy.php.
    flag: Only redirect and break are supported.










    forward_timeout: Timeout period for back-to-origin requestsforward_timeout: Unit: seconds. We recommend that you do not set this to a value greater than 100 seconds.
    ipv6: IPv6 configurationswitch (Required): The switch. Valid values: on (enable) or off (disable).
    region: The region where IPv6 is enabled. The asterisk (*) is supported.



    edge_function: Edge Routine
    rule (Required): The DSL rule.
    pri (Required): The priority.
    enable (Required): Specifies whether the rule is effective. Valid values: on or off.
    name: The rule name.
    pos: The position where the rule is executed. For whole site acceleration domain names, only head is supported. foot is not supported.
    brk: If this rule is hit, the remaining rules at the current execution position are skipped.
    option: Option control.
    grammar: Grammar control. Valid values: empty, es2, and js.
    jsmode: JS domain name whitelist control. Valid values: redirect and bypass.



























































    brotli: Brotli compressionenable (Required): The switch for the feature. Valid values: on or off.
    brotli_level: The compression level. Valid values: 1 to 11.



    ali_ua: User-Agent blacklist/whitelistua: The User-Agent.
    type: The 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.