全部产品
Search
文档中心

视频点播:SetVodDomainCertificate - 设置域名证书启用及修改信息

更新时间:Dec 16, 2024

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

接口说明

说明 目前服务地址仅支持:华东 2(上海)

调试

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

授权信息

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

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

请求参数

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

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

example.com
CertNamestring

证书名称。

cert_name
SSLProtocolstring

HTTPS 证书是否启用。取值:

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

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

****
SSLPristring

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

****

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

04F0F334-1335-436C-****-6C044FE73368

示例

正常返回示例

JSON格式

{
  "RequestId": "04F0F334-1335-436C-****-6C044FE73368"
}

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史

接口错误码

下表列举了本接口特有的错误码。

错误代码错误信息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 set but doesn't take effect for protecting current service, please contact customer service.400证书已经设置成功,但为保护当前服务还未生效,请联系客服处理。