Adds one or more domain names to Dynamic Route for CDN (DCDN).
Prerequisites:
- The DCDN service is activated.
- Internet Content Provider (ICP) filing is complete for the accelerated domain names.
- If the content of the origin server is not stored on Alibaba Cloud, the content must be reviewed. After you submit the request, the review is complete by the end of the following business day.
- The maximum number of domain names configured at a time is 50.
- The maximum number of times that each user can call this operation per second is 30.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | BatchAddDcdnDomain |
The operation that you want to perform. Set the value to BatchAddDcdnDomain. |
DomainName | String | Yes | example.com |
You can add up to 50 domain names to DCDN for each of your Alibaba Cloud account. Separate multiple domain names with commas (,). |
Sources | String | Yes | [{"content":"10.10.10.10","type":"ipaddr","priority":"20","port":80,"weight":"15"}] |
The information about the addresses of origin servers. |
ResourceGroupId | String | No | testID |
The ID of the resource group. If you do not specify a value for this parameter, the system automatically assigns the ID of the default resource group. |
CheckUrl | String | No | www.example.com/test.html |
The URL that is used to check whether the origin server can be accessed. |
Scope | String | No | domestic |
The accelerated region. Default value: domestic. Valid values:
|
TopLevelDomain | String | No | example.com |
The top-level domain name. |
The following table describes the fields in the Sources parameter.
Field |
Type |
Required |
Description |
---|---|---|---|
type |
String |
Yes |
The type of the origin server. Valid values: ipaddr: the IP address domain: the domain name oss: the endpoint of an Object Storage Service (OSS) bucket fc_domain: the domain name of Function Compute |
content |
String |
Yes |
The address of the origin server. You can specify an IP address or a domain name. |
port |
Integer |
No |
The port. Valid values: 80: the default port 443: the HTTPS port A custom port |
priority |
String |
No |
The priority of the origin server if multiple origin servers are specified. Default value: 20. Valid values: 20: the primary origin server 30: the secondary origin server |
weight |
String |
No |
The weight of the origin server if multiple origin servers are specified. Valid values: 0 to 100. Default value: 10. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 15C66C7B-671A-4297-9187-2C4477247A74 |
The ID of the request. |
Examples
Sample requests
http://dcdn.aliyuncs.com/?Action=BatchAddDcdnDomain
&DomainName=example.com
&Sources=[{"content":"10.10.10.10","type":"ipaddr","priority":"20","port":80}]
&<Common request parameters>
Sample success responses
XML
format
<BatchAddDcdnDomainResponse>
<RequestId>15C66C7B-671A-4297-9187-2C4477247A74</RequestId>
</BatchAddDcdnDomainResponse>
JSON
format
{
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | InvalidDomainName.Malformed | The specified DomainName is invalid. | The error message returned because the format of the domain name is invalid. |
400 | InvalidSources.Malformed | The specified Sources is invalid. | The error message returned because the format of the value specified for the Sources parameter is invalid. You can specify up to 20 IP addresses or one domain name for the Sources parameter. Separate multiple IP addresses with commas (,). You cannot specify IP addresses and domain names in the same request. |
400 | InvalidScope.Malformed | The specified Scope is invalid. | The error message returned because the value specified for the Scope parameter is invalid. Specify a valid value and try again. |
400 | InvalidSource.Priority.Malformed | The specified Source Priority is invalid. | The error message returned because the value specified for the priority field in the Sources parameter is invalid. Specify a value in the correct format. |
400 | SourceIp.Exceed | The maximum number of back-to-origin IP addresses is exceeded. | The error message returned because the maximum number of origin IP addresses has been reached. |
400 | InvalidCertificate | The specified certificate format is invalid. | The error message returned because the format of the specified certificate is invalid. Specify a valid certificate and try again. |
400 | InvalidCertificate.TooLong | The maximum length of the certificate is exceeded. | The error message returned because the maximum length of the specified certificate content has been reached. |
400 | CheckSourceHealthFailed | Error checking the security. Provide the valid origin site information. | The error message returned because security check failed due to invalid origin information. Specify valid origin information and try again. |
400 | ExtensiveAndAllBothExist | A wildcard domain name and a domain name with an all. prefix cannot be both specified. | The error message returned because wildcard domain names and domain names that start with the string all. cannot exist at the same time. |
400 | CdnTypeNotSupportExtensiveDomain | Wildcard domain names are not supported. | The error message returned because wildcard domain names are not supported. |
400 | ExtensiveAndSpecificDomainConflict | The wildcard domain name overlaps a domain name at the same level. | The error message returned because the specified domain name is an exact match of an existing wildcard domain name at the same level. Specify another domain name. |
400 | InvalidResourceGroupId.Malformed | The specified ResourceGroupId is invalid. | The error message returned because the value specified for the ResourceGroupId parameter is invalid. Specify a valid value and try again. |
400 | DomainReserved | The root domain of your domain is reserved by another account. Submit a ticket to contact customer support. | The error message returned because the root domain of the specified domain name is used by another Alibaba Cloud account. If you want to add the domain name, submit a ticket. |
400 | InvalidDomainNameLevel | The alicdn.com domain supports a maximum of three levels of domain. | The error message returned because the specified domain name is not supported. DCDN supports only top-level, second-level, and third-level domain names. |
400 | TopLevelDomain.NotFound | The specified TopLevelDomain does not exist. | The error message returned because the specified top-level domain name does not exist. |
400 | EntityNotExists.ResourceGroup | The resource group does not exist. | The error message returned because the specified resource group does not exist. |
400 | EntityNotExist.ResourceGroup | The resource group does not exist. | The error message returned because the specified resource group does not exist. |
400 | InvalidStatus.ResourceGroup | The current status of the resource group does not support this operation. | The error message returned because the operation is not allowed when the resource group is in the current state. |
400 | NotInternationRealIdentity | Real-name registration is required for services offered in Mainland China. | The error message returned because real-name verification that is required to purchase or use Internet content services in mainland China is not complete. |
400 | RecordCheckNotAvailable | The ICP filing interface is unavailable. Please try again later. | The error message returned because the operation for ICP filing is unavailable. Try again later. |
400 | IcpBlack | The domain is on the ICP blacklist. | The error message returned because the domain name is included in the ICP filing blacklist of the Ministry of Industry and Information Technology (MIIT). |
400 | IspBlack | The domain is on the ISP blacklist. | The error message returned because the domain name is included in the blacklist of Alibaba Cloud. |
400 | DomainOwnerVerifyFail | Owner verification of the root domain failed. | The error message returned because the ownership of the domain name is not verified. The first time you add a domain name to DCDN, you must add a DNS record or upload a verification file to verify the ownership of the domain name. |
400 | TopLevelDomain.Mismatch | The specified TopLevelDomain does not match webSiteType. | The error message returned because the specified top-level domain name does not match the type of the domain name. |
For a list of error codes, visit the API Error Center.