设置域名证书

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

使用说明

先获取直播域名,再调用本接口设置域名下证书是否启用和修改证书信息。

QPS限制

本接口的单用户QPS限制为30次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String SetLiveDomainCertificate

系统规定参数。取值:SetLiveDomainCertificate

DomainName String developer.aliyundoc.com

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

CertName String Cert-****

证书名称。

CertType String free

证书类型。取值:

  • upload:上传证书。
  • cas:证书中心证书。
  • free:个人测试证书(免费版)。
SSLProtocol String off

HTTPS证书是否启用。取值:

  • on:启用。如果取值为on,则必须同时设置请求参数SSLPub和SSLPri。
  • off(默认值):不启用。
SSLPub String ****

公钥内容。

说明 当SSLProtocol取值为on时,本参数才必填。
SSLPri String ****

私钥内容。

说明 当SSLProtocol取值为on时,本参数才必填。
ForceSet String 1

忽略证书名称重复的校验,覆盖原有同名证书信息。固定取值:1

返回数据

名称

类型

示例值

描述

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=SetLiveDomainCertificate
&DomainName=developer.aliyundoc.com
&SSLProtocol=off
&<公共请求参数>

正常返回示例

XML格式

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

<?xml version="1.0" encoding="UTF-8" ?>
<SetLiveDomainCertificateResponse>
	<RequestId>0AEDAF20-4DDF-4165-8750-47FF9C1929C9</RequestId>
</SetLiveDomainCertificateResponse>

JSON格式

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

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

错误码

HttpCode

错误码

错误信息

描述

403 IllegalOperation Illegal domain operate is not permitted. 接口权限不足,请您联系管理员,配置访问权限。

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