Configures the SSL certificate and modifies the certificate information for multiple accelerated domain names at a time.
Operation description
Note
You can call this operation up to 10 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 for which you want to configure the HTTPS certificate. The accelerated domain must have HTTPS acceleration enabled. You can specify multiple domain names and separate them with commas (,). Note
You can configure up to 10 domain names in each request.
| **example**.com |
| CertName | string | No | The name of the certificate. | cert-te**.com |
| CertType | string | No | The type of the certificate. Valid values:
| cas |
| SSLProtocol | string | Yes | Specifies whether to enable the HTTPS certificate. Valid values:
This is the default value. | on |
| SSLPub | string | No | The content of the certificate. This parameter is required only if you enable the certificate. | x**** |
| SSLPri | string | No | The private key. This parameter is required only if you enable the certificate. | y**** |
| Region | string | No | The ID of the region. | cn-hangzhou |
Response parameters
Examples
Sample success responses
JSONformat
{
"RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9"
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 400 | InvalidSSLProtocol.ValueNotSupported | The specified SSLProtocol is invalid. | The specified SSL certificate parameter is invalid. Set the value to on or off. |
| 400 | SSLPub.MissingParameter | The SSLPub parameter is required. | The SSLPub parameter is not specified. |
| 400 | SSLPri.MissingParameter | The SSLPri parameter is required. | The SSLPri parameter is not specified. |
| 400 | InvalidSSLPub | The specified SSLPub is invalid. | The value specified for the SSLPub parameter is invalid. |
| 400 | InvalidSSLPri | The specified SSLPri is invalid. | The value specified for the SSLPri parameter is invalid. |
| 400 | Certificate.MissMatch | The SSLPri does not match the certificate. | The certificate and private key do not match. |
| 400 | InvalidCertificate.TooLong | The maximum length of the certificate is exceeded. | The maximum length of the specified certificate content has been reached. |
| 400 | InvalidCertName.TooLong | The length of the certificate name cannot exceed 128 characters. | The certificate name cannot contain more than 128 characters. |
| 400 | IllegalOperationDomain | You are not authorized to operate the domain. | You are not authorized to manage the domain name. |
| 400 | AuthenticationFailed | Error performing verification. | Identity authentication failed. |
| 400 | SetDomainCertificate.ParameterError | The specified parameters are invalid. | The specified parameter values are invalid. |
| 400 | Certificate.StatusError | The status of the certificate is invalid. | The specified certificate status is invalid. |
| 400 | DeleteFailed | Error deleting the certificate. | Failed to delete the certificate. |
| 400 | Certificate.NotFind | The certificate does not exist. | The specified certificate does not exist. |
| 400 | Certificate.Duplicated | The certificate name already exists. | The certificate is duplicated. |
| 400 | Certificate.FormatError | The format of the certificate is invalid. | The specified certificate format is invalid. |
| 400 | Certificate.StatusError | The certificate does not exist, or the status of the certificate is invalid. | The specified certificate does not exist or the certificate status is invalid. |
| 400 | Certificate.KeyNull | The private key is required. | The private key is not specified. |
| 400 | Key.Malformed | The specified Key format is invalid. | The Key parameter is set in an invalid format. |
| 400 | CertStorage.failed | Error saving the certificate. | Failed to store the certificate. |
| 400 | CertificateContent.Duplicated | The certificate has been uploaded; do not upload again. | The specified certificate has been uploaded. Do not upload the certificate again. |
| 400 | Certificate.Expired | The certificate has expired. | The certificate has expired. |
| 400 | InvalidDomain.notOnline | The domain is offline. Check the status of the domain and try again later. | The specified domain name status is invalid. Check whether the domain name is online and try again later. |
| 400 | Decode.Error | Error decoding the SSLPub or SSLPri certificate. | The system has failed to decode the public key or the private key of the SSL certificate. |
| 400 | sslPub.Error | Error encoding SSLPub. | Failed to encode sslPub. |
| 400 | sslPri.Error | Error encoding SSLPri. | Failed to encode SSLPri. |
| 400 | DomainInSafeMode | The domain is in safe mode. To request permission, contact Customer Service. | The specified domain name is in the protected mode. If you must perform this operation, submit a ticket. |
| 400 | InvalidDomainNumber.TooLong | The maximum number of DomainNumber is 50. | The number of domain names cannot exceed 50. |
| 403 | DomainInProtectedMode | The domain is in protection mode. To request permission, contact Customer Service. | The specified domain name is in the protected mode. If you must perform this operation, contact customer service. |
| 404 | CertName.MissingParameter | You must specify CertName. | Enter the certificate name. |
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation |
|---|---|---|
| 2024-05-07 | The Error code has changed | View Change Details |