调用SetDomainServerCertificate设置指定域名下证书信息及证书功能是否启用。

说明
  • 单用户调用频率:10次/秒。
  • 调用方式:POST。

调试

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

请求参数

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

系统规定参数。取值:SetDomainServerCertificate

DomainName String example.com

指定证书所属加速域名,需属于HTTPS加速类型。

仅支持单个域名查询。

CertName String myCert1

证书名称,仅支持传单个名称。

CertType String cas

证书类型。取值:

  • upload:上传证书。
  • cas:云盾证书。
说明 当证书类型为cas时,PrivateKey无需传参。
ServerCertificateStatus String on

HTTPS证书是否启用。取值:

  • on:启用。
  • off(默认):不启用。
ServerCertificate String ----BEGIN CERTIFICATE----- MIIFz****-----END CERTIFICATE-----

安全证书内容,不启用证书则无需输入,配置证书请输入证书内容。可通过以下两种方法获取安全证书内容:

  • 方法一:调用DescribeDomainCertificateInfo查询加速域名对应的证书信息,取返回数据中的ServerCertificate证书公钥的值。
  • 方法二:先调用DescribeCdnCertificateList查询加速域名对应的证书列表,取返回数据中的CertName证书名称的值;然后以CertName证书名称为请求参数,通过调用DescribeCdnCertificateDetail来获取证书详细信,取返回数据中的Cert证书公钥值。
PrivateKey String ----BEGIN RSA PRIVATE KEY-----QswCQ****----END RSA PRIVATE KEY-----

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

ForceSet String 1

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

返回数据

名称 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http(s)://cdn.aliyuncs.com/?Action=SetDomainServerCertificate
&DomainName=example.com
&CertName=myCert1
&CertType=cas
&ServerCertificateStatus=on
&ServerCertificate=----BEGIN CERTIFICATE----- MIIFz****-----END CERTIFICATE-----
&PrivateKey=----BEGIN RSA PRIVATE KEY-----QswCQ****----END RSA PRIVATE KEY-----
&ForceSet=1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SetDomainServerCertificateResponse>
	<RequestId>0AEDAF20-4DDF-4165-8750-47FF9C1929C9</RequestId>
</SetDomainServerCertificateResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0AEDAF20-4DDF-4165-8750-47FF9C1929C9"
}

错误码

HttpCode 错误码 错误信息 描述
400 SSLPub.MissingParameter The SSLPub parameter is required. SSLPub参数缺失。
400 SSLPri.MissingParameter The SSLPri parameter is required. SSLPri参数缺失。
400 InvalidCertificate.TooLong The Certificate you provided is over the max length 证书和私钥长度超出限制。
400 SetDomainCertificate.ParameterError The specified parameters are invalid. 指定的参数无效。
400 Certificate.FormatError The format of the certificate is invalid. 证书格式错误
400 Certificate.NotFind Not find the certificate info. 证书不存在。
400 InvalidSSLPub The SSLPub you provided is malformed. 证书内容不合法。
400 InvalidSSLPri The SSLPri you provided is malformed. 证书私钥内容不合法。
400 Certificate.MissMatch The certificate is not match the private key. 证书与私钥不匹配。
404 CertName.MissingParameter The CertName parameter is required. CertName参数缺失。

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