All Products
Search
Document Center

CDN:BatchUpdateCdnDomain

Last Updated:Jul 04, 2024

Updates the configurations of multiple accelerated domain names at a time.

Operation description

  • You can call this operation up to 30 times per second per account.
  • You can specify up to 50 domain names in each request. Separate multiple domain names with commas (,).

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DomainNamestringYes

The accelerated domain names. You can specify one or more accelerated domain names. Separate domain names with commas (,).

example.com,example.org
SourcesstringNo

The information about the addresses of origin servers.

Note Do not set Sources and TopLevelDomain at the same time. If you set Sources and TopLevelDomain at the same time, TopLevelDomain does not take effect.
[{"content":"10.10.10.10","type":"ipaddr","priority":"20","port":80,"weight":"15"}]
ResourceGroupIdstringNo

The ID of the resource group.

rg-acfmyuji4b6r4**
TopLevelDomainstringNo

The root domain.

Note Do not set Sources and TopLevelDomain at the same time. If you set Sources and TopLevelDomain at the same time, TopLevelDomain does not take effect.
example.com

The following table describes the fields in the Sources parameter.

FieldTypeRequiredDescription
typeStringYesThe type of the origin server.ipaddr: an IP addressdomain: a domain nameoss: the domain name of an Object Storage Service (OSS) bucketfc_domain: a Function Compute domain name
contentStringYesThe address of the origin server. You can specify an IP address or a domain name.
portIntegerNoThe port. You can specify port 80, port 443, or a custom port. Default value: 80. If you specify port 443, Alibaba Cloud CDN communicates with the origin server over HTTPS.
priorityStringNoThe 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.
weightStringNoThe weight of the origin server if multiple origin servers are specified. You must specify a value that is less than 100. Default value: 10.

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

15C66C7B-671A-4297-9187-2C4477247A74

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status codeError codeError messageDescription
400MissingDomainNameThe domainName parameter is required.-
400InvalidDomainName.MalformedThe specified DomainName is invalid.The specified domain name is invalid.
400InvalidSource.Content.MalformedThe specified Source Content is invalid.The specified origin address is invalid.
400InvalidTypeContent.MismatchThe specified source type does not match the specified source content.-
400MissingSource.ContentThe Source Content must be specified.You must specify the origin information.
400MissingSource.TypeThe Source Type must be specified.-
400InvalidSources.MalformedSpecified Sources is malformed.The specified origin address is invalid.
400InvalidSource.Type.MalformedThe specified Source Type is invalid.-
400InvalidSource.Priority.MalformedThe specified Source Priority is invalid.-
400InvalidResourceGroupId.MalformedThe specified ResourceGroupId is invalid.-
400EntityNotExists.ResourceGroupThe resource group does not exist.The specified ResourceGroup parameter does not exist.
400EntityNotExist.ResourceGroupThe resource group does not exist.The specified resource group does not exist.
400InvalidStatus.ResourceGroupIt is not allowed to do this operation because of the current status of resource-group.This operation is not supported while the resource group is in the current state.
403DomainInProtectedModeThe domain is in protection mode. To request permission, contact Customer Service.-

For a list of error codes, visit the Service error codes.