All Products
Search

This Product

    CDN:BatchAddCdnDomain

    Document Center

    CDN:BatchAddCdnDomain

    Last Updated:Apr 13, 2026

    Use the BatchAddCdnDomain operation to add up to 50 accelerated domain names in a single request.

    Operation description

    • You must enable the CDN service before adding an accelerated domain name. For details, see Enable CDN service.

    • If you select Chinese mainland or Global as the acceleration region, the accelerated domain name must have an ICP filing.

    • You can query up to 50 domain names per call. To query multiple domain names, separate them with a comma (,).

    • Each user can call this operation up to 100 times per hour.

    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

    cdn:BatchAddCdnDomain

    create

    *Domain

    acs:cdn:*:{#accountId}:domain/*

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    CdnType

    string

    Yes

    The service type of the accelerated domain. Valid values:

    • web: small files and images.

    • download: large file downloads.

    • video: VOD acceleration.

    web
    DomainName

    string

    Yes

    The domain names to add to CDN. Separate multiple domains with a comma.

    example.com,aliyundoc.com
    ResourceGroupId

    string

    No

    The ID of the resource group. If you omit this parameter, the system automatically uses the ID of the default resource group.

    rg-acfmyuji4b6r4**
    Sources

    string

    Yes

    A list of origins.

    [ { "content": "192.0.2.0", "type": "ipaddr", "priority": "20", "port": 80, "weight": "15" } ]
    CheckUrl

    string

    No

    The health check URL.

    url
    Scope

    string

    No

    The service area. Valid values:

    • domestic: Chinese mainland only.

    • overseas: Global (excluding Chinese mainland).

    • global: Global.

    domestic
    TopLevelDomain

    string

    No

    The root domain name, such as example.com.

    example.com

    The following table describes the fields in Sources.

    ParameterTypeRequiredDescription
    typeStringYesThe type of the origin. Valid values:
    ipaddr: an IP origin.
    domain: a domain name origin.
    oss: an OSS Bucket origin.
    fc_domain: a Function Compute origin.



    contentStringYesThe IP address or domain name of the origin.
    portIntegerNoThe port of the origin. Options include 443 for HTTPS origin-pull, 80 (default), or a custom port number.
    priorityStringNoThe origin priority. Use 20 for a primary origin (default) and 30 for a backup origin.
    weightStringNoThe origin weight. Value range: 1 to 100. Default value: 10.

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The unique request ID.

    15C66C7B-671A-4297-9187-2C4477247A74

    Examples

    Success response

    JSON format

    {
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidDomainName.Malformed Specified DomainName is malformed. The specified DomainName parameter is invalid or wildcard domain names cannot be batch added.
    400 MissingParameter The input parameter cdnType that is mandatory for processing this request is not supplied. You must specify the cdnType parameter.
    400 InvalidCdnType.Malformed Specified CdnType is malformed. The CdnType parameter is set to an invalid value. Valid values: web: distributes images and small files. download: accelerates large file downloads. video: accelerates distribution of on-demand audio and video content.
    400 InvalidSources.Malformed Specified Sources is malformed. The specified origin address is invalid.
    400 InvalidSourceType.Malformed Specified CdnType is malformed. The specified CdnType parameter is invalid.
    400 InvalidSource.Priority.Malformed The specified Source Priority is invalid.
    400 InvalidTypeAndContent.MissMatch InvalidTypeAndContent.MissMatch
    400 InvalidScope.Malformed Specified Scope is malformed. The specified Scope parameter is invalid.
    400 SourceIp.Exceed The Certificate you provided is malformed The specified certificate format is invalid.
    400 InvalidCertificate The Certificate you provided is malformed The specified certificate format is invalid.
    400 InvalidCertificate.TooLong The Certificate you provided is over the max length Certificate and private key length exceeds the limit
    400 InnerAddDomainDenied Your account has not bind aoneId, can not add domain. Your account is not bound to aoneId and cannot add a domain name.
    400 CheckSourceHealthFailed sources ip or source domain check health failed,please input right source. The origin IP address or domain name is invalid. Specify a valid value and try again.
    400 ExtensiveAndAllBothExist Extensive domain and the domain begins with all. can not exist at the same time. Wildcard domain names and domain names that start with "all." cannot both exist.
    400 CdnTypeNotSupportExtensiveDomain Extensive domain not supported for this cdn type. The specified CdnType parameter is not supported for wildcard domain names. Valid values: web: distributes images and small files. download: accelerates large file downloads. video: accelerates distribution of on-demand audio and video content.
    400 ExtensiveAndSpecificDomainConflict The number of wildcard domain names exceeds the limit.
    400 InvalidResourceGroupId.Malformed Specified ResourceGroupId is malformed. Format of parameter ResourceGroupId is incorrect.
    400 DomainReserved The root domain of your domain is reserved by another account. Submit a ticket to contact customer support.
    400 InvalidDomainNameLevel Domain name suffixed with alicdn.com only support third level. alicdn.com supports up to three domain levels for wildcard domain names.
    400 InvalidTopLevelDomain.Malformed Specified TopLevelDomain is malformed. The specified TopLevelDomain parameter is invalid.
    400 TopLevelDomain.NotFound TopLevelDomain is not exist. The specified TopLevelDomain parameter does not exist.
    400 EntityNotExists.ResourceGroup The resource group does not exist. The specified ResourceGroup parameter does not exist.
    400 EntityNotExist.ResourceGroup The resource group does not exist. The specified resource group does not exist.
    400 InvalidStatus.ResourceGroup It is not allowed to do this operation because of the current status of resource-group. This operation is not supported while the resource group is in the current state.
    400 NotInternationRealIdentity You need to do real name authentication when you use Chinese mainland resources. You have not passed real-name verification. According to the regulations issued by MIIT, you must pass real-name verification if you want to purchase IT services in the Chinese mainland.
    400 RecordCheckNotAvailable The ICP filing interface is unavailable. Please try again later.
    400 IcpBlack The domain is on the ICP blacklist.
    400 IspBlack The domain is on the ISP blacklist.
    400 DomainOwnerVerifyFail Owner verification of the root domain failed. The first time a domain name is added to Alibaba Cloud CDN, you must prove the ownership of the domain name. You must add a DNS record or a verification file for the domain name before it can be added to Alibaba Cloud CDN.
    400 TopLevelDomain.Mismatch The specified TopLevelDomain does not match webSiteType. The top-level domain name does not match the domain name type.
    400 DomainOverLimit The maximum number of domains is exceeded. The number of domain names exceeds the limit.
    400 DomainInRiskList The domain you added may be at risk. If you have any questions, please submit a ticket. The domain name you added may be at risk. If you have any questions, please submit a work order.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.