Modifies the configuration of an accelerated domain name.
Operation description
Note
You can call this operation up to 30 times per second per account.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
DomainName | string | Yes | The accelerated domain name. You can specify only one domain name in each request. | example.com |
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":"1.1.1.1","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. To add a root domain name, you must be added to the whitelist specified by the CDN_TOP_LEVEL_DOMAIN_GREY_USER_LIST parameter. 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.
| aliyundoc.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 number. You can specify port 80, port 443, or a custom port. Default value: 80. If you specify port 443, 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
JSON
format
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | Abs.Sources.Malformed | The specified Sources is invalid. | The specified origin is invalid. |
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 | 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. |
400 | TopLevelDomain.NotFound | TopLevelDomain is not exist. | The specified TopLevelDomain parameter does not exist. |
400 | InvalidTopLevelDomain.Malformed | Specified TopLevelDomain is malformed. | The specified TopLevelDomain parameter is invalid. |
400 | TopLevelDomain.Mismatch | The specified TopLevelDomain does not match webSiteType. | The top-level domain name does not match the domain name type. |
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.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2023-06-08 | The Error code has changed | View Change Details |