All Products
Search
Document Center

UpdateDcdnDomain

Last Updated: Apr 16, 2019

Description

You can call this operation to modify the DCDN domain name.

Note:Before adding a DCDN domain name, you must activate the DCDN service.

Request parameters

Name Type Required Description
Action String Yes The operation that you want to perform. Set the value to UpdateDcdnDomain.
DomainName String Yes The DCDN domain name that you want to modify.
Sources Json No The list of origin URLs.
ResourceGroupId String No The ID of the resource group.
TopLevelDomain String No The top-level domain, which can only be configured by users on the whitelist.

Sources format

  1. [{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]

Sources fields

Field Type Required Description
type String Yes The type of the origin. Valid values: ipaddr, domain, and oss.
  • ipaddr: The origin is configured using an IP address.
  • domain: The origin is configured using a domain name.
  • oss: The origin is configured using the Internet domain name of an Alibaba Cloud OSS bucket.
content String Yes The URL of the origin, which can be an IP address or a domain name.
port Integer No The port number. Valid values: 443 and 80. Customized ports are supported. Port 443 is used for HTTPS requests.
Default value: 80.
priority String No The priority of the origin when multiple origins exist.
Default value: 20.

Response parameters

Name Type Description
RequestId String The ID of the request.

Examples

Sample requests

  1. http://dcdn.aliyuncs.com?Action=UpdateDcdnDomain&SourceType=domain&Sources=[{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]&<Common request parameters>

Sample responses

JSON format

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

Error codes

Error code Error message HTTP status code Description
InvalidDomainName.Malformed Specified DomainName is malformed. 400 The error message returned when the specified DomainName value is invalid.
InvalidSource.Content.Malformed Specified source content is malformed. 400 The error message returned when the value specified for the content field is invalid.
InvalidSource.Type.Malformed Specified source type is malformed. 400 The error message returned when the value specified for the type field is invalid.
InvalidTypeContent.Mismatch Specified source type does not math the specified source content. 400 The error message returned when the specified origin URL does not match the origin type.
InvalidSource.Priority.Malformed Specified source priority is malformed. 400 The error message returned when the specified Priority value is invalid.
InvalidScope.Malformed Specified Scope is malformed. 400 The error message returned when the specified Scope value is invalid.
IllegalOperation Illegal domain operate is not permitted. 403 The error message returned because you do not have permission to perform the operation.
InvalidDomain.NotFound The domain provided does not belong to you. 404 The error message returned when the domain name does not exist or does not belong to the current user.
Abs.resourceGroupId.Malformed Specified ResourceGroupId is malformed. 400 The error message returned when the resource group ID is incorrect.
EntityNotExists.ResourceGroup The resource group does not exist. 400 The error message returned when the resource group does not exist.
InvalidStatus.ResourceGroup It’s now allowed to do this operation because of the current status of resource-group. 400 The error message returned when the resource group is in an incorrect status.