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

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

调试

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

请求参数

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

系统规定参数。取值：SetDomainServerCertificate。

DomainName String 是 example.com

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

仅支持单个域名查询。
ServerCertificateStatus String 是 on

HTTPS证书是否启用。取值：

  • on：启用。
  • off（默认）：不启用。
CertName String 否 myCert1

证书名称，仅支持传单个名称。
CertType String 否 cas

证书类型。取值：

  • upload：上传证书。
  • cas：云盾证书。
  • free：免费证书。
说明 当证书类型为cas时，PrivateKey无需传参。
ServerCertificate String 否 ----BEGIN CERTIFICATE----- MIIFz****-----END CERTIFICATE-----

安全证书内容，不启用证书则无需输入，配置证书请输入证书内容。
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
&CertType=cas
&CertName=myCert1
&ServerCertificateStatus=on
&ServerCertificate=----BEGIN CERTIFICATE----- MIIFz****-----END CERTIFICATE-----
&<公共请求参数>

正常返回示例

XML格式 

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

JSON格式 

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

错误码

HttpCode 错误码 错误信息 描述
400 Certificate.FormatError The format of the certificate is invalid. 证书格式错误
400 Certificate.NotFind Not find the certificate info. 证书不存在。
400 Certificate.MissMatch The certificate is not match the private key. 证书与私钥不匹配。

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