调用SetVodDomainCertificate设置某域名下证书功能是否启用及修改证书信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | SetVodDomainCertificate |
系统规定参数。取值：SetVodDomainCertificate。 |
| DomainName | String | 是 | example.com |
指定证书所属加速域名。需属于HTTPS加速类型。 |
| CertName | String | 否 | cert_name |
证书名称。 |
| SSLProtocol | String | 是 | off |
HTTPS证书是否启用。取值：
|
| SSLPub | String | 否 | **** |
安全证书内容。不启用证书则无需输入，配置证书请输入证书内容。 |
| SSLPri | String | 否 | **** |
私钥内容。不启用证书则无需输入，配置证书请输入私钥内容。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 04F0F334-1335-436C-****-6C044FE73368 |
请求ID。 |
示例
请求示例
https://vod.{ApiRegion}.aliyuncs.com/?Action=SetVodDomainCertificate
&DomainName=example.com
&SSLProtocol=off
&<公共请求参数>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SetVodDomainCertificateResponse>
<RequestId>04F0F334-1335-436C-****-6C044FE73368</RequestId>
</SetVodDomainCertificateResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "04F0F334-1335-436C-****-6C044FE73368"
}错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
|
错误代码 |
错误信息 |
HTTP 状态码 |
说明 |
|---|---|---|---|
|
InvalidDomain.NotFound |
The domain provided does not belong to you. |
404 |
域名不存在或不属于当前用户。 |
|
IllegalOperation |
Illegal domain operate is not permitted. |
403 |
没有权限执行当前操作。 |
|
ServiceBusy |
The specified Domain is configuring, please retry later. |
403 |
域名正在配置中, 请稍后再试。 |
|
InvalidDomain.Offline |
The domain provided is offline. |
400 |
域名已下线。 |
|
OperationDenied |
Your CDN service is suspended. |
403 |
该账号已经欠费，请充值。 |
|
InvalidSSLProtocol.ValueNotSupported |
The specified value of parameter Enable is not supported. |
400 |
SSLProtocol的值不合法。 |
|
SSLPub.MissingParameter |
An input parameter SSLPub that is mandatory for processing the request is not supplied. |
400 |
SSLPub参数缺失。 |
|
SSLPri.MissingParameter |
An input parameter SSLPri that is mandatory for processing the request is not supplied. |
400 |
SSLPri参数缺失。 |
|
InvalidCertificate |
The Certificate you provided is malformed! |
400 |
证书内容不合法。 |
|
InvalidSSLPri |
The SSLPri you provided is malformed! |
400 |
私钥内容不合法。 |
|
Certificate.MissMatch |
The SSLPri does not math the specified Certificate! |
400 |
证书和私钥不匹配。 |
|
InvalidCertificate.TooLong |
The Certificate you provided is over the max length! |
400 |
证书内容超过长度限制。 |
|
InvalidCertName.TooLong |
The Certificate name you provided is over the max length 128! |
400 |
证书名称不能超过128个字符。 |
|
SetDomainSSLPub.ParameterError |
Parameters have error. |
400 |
参数错误。 |
|
Certificate.StatusError |
Certificate is not exist or its status is error. |
400 |
证书不存在或证书状态错误。 |
|
DeleteFailed |
Delete certificate is failed. |
400 |
删除证书失败。 |
|
Certificate.NotFind |
Not find the certificate info. |
400 |
没有查到相应证书。 |
|
Certificate.Duplicated |
The certificate name is duplicated. |
400 |
证书名称重复。 |
|
Certificate.FormatError |
The certificate format is error. |
400 |
证书格式错误。 |
|
Certificate.StatusError |
The certificate status is error. |
400 |
证书状态错误。 |
|
Certificate.KeyNull |
The SSLPri is not null. |
400 |
私钥不能为空。 |
|
SSLPri.Malformed |
The SSLPri format is error. |
400 |
私钥格式错误。 |
|
Certificate.NotPermittedOff |
Turn off certificate will change domain scheduling, please contact customer service. |
400 |
关闭证书会影响该域名调度，请联系客户调整。 |
|
Certificate.SettedNotEffect |
Certificate was successfully setted but does’t take effect for protecting current service, please contact customer service. |
400 |
证书已经设置成功，但为保护当前服务还未生效，请联系客服处理。 |