设置某域名下证书功能是否启用及修改证书信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String SetVsDomainCertificate

操作接口名,系统规定参数。取值:SetVsDomainCertificate

DomainName String example.aliyundoc.com

指定证书所属加速域名 需属于https加速类型

SSLProtocol String on

HTTPS证书是否启用,取值on:启用;off:不启用,默认取值:off:不启用

CertName String Cert-77****7

证书名称

CertType String free

证书类型。

  • upload(上传证书)
  • cas(云盾证书)
  • free(免费证书)
SSLPub String 328uiuii28****82dsada81

安全证书内容,不启用证书则无需输入,配置证书请输入证书内容。

SSLPri String xxxxxxx

私钥内容,不启用证书则无需输入,配置证书请输入私钥内容。

Region String cn-qingdao

地域。

ForceSet String 1

设置为1时,忽略证书名称重复的校验,覆盖原有同名证书信息。

返回数据

名称 类型 示例值 描述
RequestId String 119F7639-4646-51A4-B6C1-300D391C0104

本次任务请求ID

示例

请求示例

http(s)://[Endpoint]/?Action=SetVsDomainCertificate
&DomainName=example.aliyundoc.com
&SSLProtocol=on
&<公共请求参数>

正常返回示例

JSON格式

{
    "RequestId": "119F7639-4646-51A4-B6C1-300D391C0104"
}

错误码

访问错误中心查看更多错误码。

#特殊错误码

ErrorCode 错误码

Message 错误信息

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

证书已经设置成功,但为保护当前服务还未生效,请联系客服处理