Modifies a specified accelerated domain.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpdateDcdnIpaDomain

The operation that you want to perform. Set the value to UpdateDcdnIpaDomain.

DomainName String Yes example.com

The name of the accelerated domain to be modified. You can specify only one domain name at a time.

Sources String No [{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80,"weight":"15"}]

The origin information.

ResourceGroupId String No 123

The ID of the resource group.

TopLevelDomain String No yourDomain.com

The top-level domain name.

The following table describes the fields in the Sources parameter.

Parameter

Type

Required

Description

type

String

Yes

The type of the origin. Valid values: ipaddr and domain. A value of ipaddr indicates the IP address of the origin server. A value of domain indicates the domain name of the origin server. A value of oss is not supported.

content

String

Yes

The address of the origin. You can specify an IP address or a domain name.

port

Integer

No

The port number. Valid values: 0 to 65535.

priority

String

No

The priority of the origin server if multiple origin servers are specified. Valid values: 20 and 30. Default value: 20. A value of 20 specifies that the origin is a primary origin. A value of 30 specifies that the origin is a secondary origin.

weight

String

No

The weight of the origin if multiple origins are specified. You must specify a value less than 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=UpdateDcdnIpaDomain
&domainname=example.com
&SourceType=domain
&Sources=[{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]
&<Common request parameters>

Sample success responses

XML format

<UpdateDcdnIpaDomainResponse>
	  <RequestId>15C66C7B-671A-4297-9187-2C4477247A74</RequestId>
</UpdateDcdnIpaDomainResponse>

JSON format

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

Error codes

HttpCode Error code Error message Description
400 MissingDomainName The domainName parameter is required. The error message returned because the DomainName parameter must be specified.
400 InvalidDomainName.Malformed The specified DomainName is invalid. The error message returned because the specified DomainName parameter is invalid.
400 InvalidSource.Content.Malformed The specified Source Content is invalid. The error message returned because the specified Sources parameter is invalid.
400 InvalidTypeContent.Mismatch The specified source type does not match the specified source content. The error message returned because the type and content fields specified in the Sources parameter do not match.
400 MissingSource.Content The Source Content must be specified. The error message returned because the content field in the Sources parameter must be specified.
400 MissingSource.Type The Source Type must be specified. The error message returned because the type field in the Sources parameter must be specified.
400 InvalidSource.Type.Malformed The specified Source Type is invalid. The error message returned because the type field specified in the Sources parameter is invalid.
400 InvalidSource.Priority.Malformed The specified Source Priority is invalid. The error message returned because the priority field specified in the Sources parameter is invalid.
400 InvalidResourceGroupId.Malformed The specified ResourceGroupId is invalid. The error message returned because the specified ResourceGroupId parameter is invalid.
400 EntityNotExists.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.
403 DomainInProtectedMode The domain is in protection mode. To request permission, contact Customer Service. The error message returned because the specified domain is being protected. To call this operation, contact Customer Service.
400 TopLevelDomain.NotFound The specified TopLevelDomain does not exist. The error message returned because the specified top-level domain name does not exist.
400 InvalidSource.Port.Malformed The source port is empty, or it is outside the range 0-65535. The error message returned because the port number of the origin is not specified or the specified port number of the origin is invalid. Valid port numbers are from 0 to 65535.
403 DcdnIpaServiceNotFound The DCDN IPA service has not been activated. The error message returned because the IPA service is not activated.

For a list of error codes, visit the API Error Center.