调用SetLiveDomainCertificate设置某域名下证书是否启用和修改证书信息。

使用说明

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

QPS限制

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

调试

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

请求参数

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

系统规定参数。取值:SetLiveDomainCertificate

DomainName String developer.aliyundoc.com

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

SSLProtocol String off

HTTPS证书是否启用。取值:

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

证书名称。

CertType String free

证书类型。取值:

  • upload:上传证书。
  • cas:证书中心证书。
  • free:免费证书。
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格式

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

JSON格式

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

错误码

HttpCode 错误码 错误信息 描述
403 IllegalOperation Illegal domain operate is not permitted. 接口权限不足,请您联系管理员,配置访问权限。

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