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

  • 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:

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

The domain name that requests access to CDN. Supports generic domain name,  and starts with ".", such as

Checkurl String No

Health check of the source site.

LiveType String No liveEdge

Live edge streaming.

OwnerAccount String No your 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 a higher level.
SourcePort String No 80

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

443 port performs https source. OSS does not support 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

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 No www.yourTopLevelDomain

Top-level scheduling domain.

Response parameters

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



Request example

1.<Public request parameter>
Normal return example
  • JSON format

Exception return example
  • JSON format

         "Message":"The request processing has failed due to some unknown error.",