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
Authorization information
The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:
- Operation: the value that you can use in the Action element to specify the operation on a resource.
- Access level: the access level of each operation. The levels are read, write, and list.
- Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level,
All Resourcesis used in the Resource type column of the operation.
- Condition Key: the condition key that is defined by the cloud service.
- Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
| Operation | Access level | Resource type | Condition key | Associated operation |
|---|---|---|---|---|
| cdn:BatchUpdateCdnDomain | update | *Domain acs:cdn:*:{#accountId}:domain/{#DomainName} |
| none |
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| DomainName | string | Yes | The accelerated domain names. You can specify one or more accelerated domain names. Separate domain names with commas (,). | example.com,example.org |
| Sources | string | No | 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"}] |
| ResourceGroupId | string | No | The ID of the resource group. | rg-acfmyuji4b6r4** |
| TopLevelDomain | string | No | 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.
| Field | Type | Required | Description |
|---|---|---|---|
| type | String | Yes | The 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 |
| content | String | Yes | The address of the origin server. You can specify an IP address or a domain name. |
| port | Integer | No | The 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. |
| 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 server if multiple origin servers are specified. You must specify a value that is less than 100. Default value: 10. |
Response parameters
Examples
Sample success responses
JSONformat
{
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 400 | MissingDomainName | The domainName parameter is required. | - |
| 400 | InvalidDomainName.Malformed | The specified DomainName is invalid. | The specified domain name is invalid. |
| 400 | InvalidSource.Content.Malformed | The specified Source Content is invalid. | The specified origin address is invalid. |
| 400 | InvalidTypeContent.Mismatch | The specified source type does not match the specified source content. | - |
| 400 | MissingSource.Content | The Source Content must be specified. | You must specify the origin information. |
| 400 | MissingSource.Type | The Source Type must be specified. | - |
| 400 | InvalidSources.Malformed | Specified Sources is malformed. | The specified origin address is invalid. |
| 400 | InvalidSource.Type.Malformed | The specified Source Type is invalid. | - |
| 400 | InvalidSource.Priority.Malformed | The specified Source Priority is invalid. | - |
| 400 | InvalidResourceGroupId.Malformed | The specified ResourceGroupId is invalid. | - |
| 400 | EntityNotExists.ResourceGroup | The resource group does not exist. | The specified ResourceGroup parameter does not exist. |
| 400 | EntityNotExist.ResourceGroup | The resource group does not exist. | The specified resource group does not exist. |
| 400 | InvalidStatus.ResourceGroup | It 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. |
| 403 | DomainInProtectedMode | The domain is in protection mode. To request permission, contact Customer Service. | - |
For a list of error codes, visit the Service error codes.