全部产品
阿里云办公

设置证书接口

更新时间:2018-11-29 16:03:22

概述

该接口用于设置某域名下证书功能是否启用,以及修改证书信息。

请求参数

名称 类型 是否必需 描述
Action String 操作接口名。系统规定参数。取值:SetDcdnDomainCertificate
DomainName String 指定证书所属加速域名。需属于HTTPS加速类型。
SSLProtocol String HTTPS证书是否启用。取值范围:
  • on:启用
  • off:不启用
默认值:off
SSLPub String 安全证书内容。不启用证书则无需输入,配置证书请输入证书内容。
SSLPri String 私钥内容。不启用证书则无需输入,配置证书请输入私钥内容。
CertName String 证书名称。
CertType String 证书类型。取值范围:
  • upload:上传证书
  • cas:证书中心证书
  • free:免费证书
ForceSet String 设置为1时,忽略证书名称重复的校验,覆盖原有同名证书信息。

返回参数

名称 类型 描述
RequestID String 公共返回参数

示例

请求示例

  1. http://dcdn.aliyuncs.com?Action=SetDcdnDomainCertificate&DomainName=example.com&SSLProtocol=on&SSLPub=xxx&SSLPri=yyy&<公共请求参数>

返回示例

JSON格式:

  1. {
  2. "RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9"
  3. }

错误码

错误代码 错误信息 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 私钥格式错误