Add CDN domain names. At one time, you can only submit one domain name. A single user can add up to 20 domain names.

Restrictions:
  • Before creating CDN domain name, CDN service must be activated.
  • The CDN domain name must complete registration process. 
  • If the origin site content is not on the Alibaba Cloud platform, it must be reviewed. The review will be completed before the next workday.

Request parameters

Name  Type Required Example values Description
Action String Yes. AddCdnDomain

The name of this interface.  Value:

AddCdnDomain
CdnType String Yes web
The CDN domain business type.  Scope of value:
  • web: distribution of images and small files. 
  • download: acceleration of large file downloads.
  • video: acceleration of video and audio on demand.
  • liveStream:: acceleration of live streaming media.
DomainName String Yes www.yourdomain.com

The domain name that requests access to CDN.  Supports generic domain name,  and starts with “.”, such as .a.com.

Checkurl String No www.yourdomain.com/test.html

Health check of the source site.
LiveType String No liveEdge

Live edge streaming.
OwnerAccount String No your OwnerAccount

OwnerAccount.
Priorities String No 20

Priorities, separated by comma, and the number is consistent with sources.
Region String No cn-shanghai

Unit information of live domain name.
ResourceGroupId String No your resourceGroupId

ID of the resource group.
Scope String No domestic
Scope of value:
  • domestic
  • overseas
  • global
Default value: domestic.  The setting is effective for international users, domestic users of level 3 or above.
SourcePort String No 80

You can specify Port 443 and 80. Default value: 80.

443 port performs https source.  OSS does not suppport 443 port.
SourceType String No domain
Source type.  Scope of value:
  • ipaddr:IP source site.
  • domain:source site of domain name. 
  • oss:oss is the source site.
Note If you select the business type of live streaming media acceleration, the source site type and information is not required.
Sources String No www.yourdomain.com

Source address,, which can be IP or domain name.

  • Supporting at most 10 IP addresses, separated by commas.
  • You can only enter one domain name, and you cannot enter IP and domain names simultaneously.
  • If the business type is live streaming media acceleration, the source address is not required to enter. If the business type is other type, source address is required (inner user, the type is common source, and type enum value can be entered).
TopLevelDomain String 否 www.yourTopLevelDomain

Top-level scheduling domain.

Response parameters

Name Type Example value Description
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

RequestId

Examples

Request example

1. http://cdn.aliyuncs.com?Action=AddCdnDomain&CdnType=web&SourceType=domain&DomainName=test.com&Sources=test.com&<Public request parameter>
Normal return example

  • JSON format

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

  • JSON format

    { 
    "Code":"InternalError", 
     "HostId":"cdn.aliyuncs.com", 
     "Message":"The request processing has failed due to some unknown error.",
     "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}