SetVsDomainCertificate - 设置域名证书信息

设置某域名下证书功能是否启用。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vs:SetVsDomainCertificateupdate
  • 全部资源
    *

请求参数

名称类型必填描述示例值
DomainNamestring

指定证书所属加速域名。

说明 域名需要属于 HTTPS 加速类型。
example.aliyundoc.com
SSLProtocolstring

HTTPS 证书是否启用。取值:

  • on:启用。
  • off(默认值):不启用。
on
CertNamestring

证书名称。

Cert-77****7
CertTypestring

证书类型。

  • upload(上传证书)
  • cas(云盾证书)
  • free(个人测试证书(免费版))
free
SSLPubstring

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

328uiuii28****82dsada81
SSLPristring

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

xxxxxxx
Regionstring

地域。

cn-qingdao
ForceSetstring

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

1

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

119F7639-4646-51A4-B6C1-300D391C0104

示例

正常返回示例

JSON格式

{
  "RequestId": "119F7639-4646-51A4-B6C1-300D391C0104"
}

错误码

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

特殊错误码

ErrorCode 错误码Message 错误信息HTTP 状态语义
InvalidDomain.NotFoundThe domain provided does not belong to you.404域名不存在或不属于当前用户。
IllegalOperationIllegal domain operate is not permitted.403没有权限执行当前操作。
ServiceBusyThe specified Domain is configuring, please retry later.403域名正在配置中,请稍后再试。
InvalidDomain.OfflineThe domain provided is offline.400域名已下线。
OperationDeniedYour CDN service is suspended.403该账号已经欠费,请充值。
InvalidSSLProtocol.ValueNotSupportedThe specified value of parameter Enable is not supported.400SSLProtocol 的值不合法。
SSLPub.MissingParameterAn input parameter SSLPub that is mandatory for processing the request is not supplied.400SSLPub 参数缺失。
SSLPri.MissingParameterAn input parameter SSLPri that is mandatory for processing the request is not supplied.400SSLPri 参数缺失。
InvalidCertificateThe Certificate you provided is malformed!400证书内容不合法。
InvalidSSLPriThe SSLPri you provided is malformed!400私钥内容不合法。
Certificate.MissMatchThe SSLPri does not math the specified Certificate!400证书和私钥不匹配。
InvalidCertificate.TooLongThe Certificate you provided is over the max length!400证书内容超过长度限制。
InvalidCertName.TooLongThe Certificate name you provided is over the max length 128!400证书名称不能超过 128 个字符。
SetDomainSSLPub.ParameterErrorParameters have error.400参数错误。
Certificate.StatusErrorCertificate is not exist or its status is error.400证书不存在或证书状态错误。
DeleteFailedDelete certificate is failed.400删除证书失败。
Certificate.NotFindNot find the certificate info.400没有查到相应证书。
Certificate.DuplicatedThe certificate name is duplicated.400证书名称重复。
Certificate.FormatErrorThe certificate format is error.400证书格式错误。
Certificate.StatusErrorThe certificate status is error.400证书状态错误。
Certificate.KeyNullThe SSLPri is not null.400私钥不能为空。
SSLPri.MalformedThe SSLPri format is error.400私钥格式错误。
Certificate.NotPermittedOffTurn off certificate will change domain scheduling, please contact customer service.400关闭证书会影响该域名调度,请联系客户调整。
Certificate.SettedNotEffectCertificate was successfully setted but does’t take effect for protecting current service, please contact customer service.400证书已经设置成功,但为保护当前服务还未生效,请联系客服处理。