查询指定直播域名证书信息

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveDomainCertificateInfo	系统规定参数。取值：DescribeLiveDomainCertificateInfo。
DomainName	String	是	www.yourdomain.com	播流域名。
RegionId	String	否	cn-shanghai	域名所属地域。

返回数据


名称	类型	示例值	描述
CertInfos	Array of CertInfo		证书信息。
CertInfo
CertDomainName	String	example.com	证书匹配的播流域名。
CertExpireTime	String	2018-06-03T22:03:39Z	证书过期时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
CertLife	String	3	证书时长。单位：months（月），years（年）。
CertName	String	Cert-****	证书名称。
CertOrg	String	Let's Encrypt	证书组织。
CertType	String	free	证书类型。取值： free：免费证书。 cas：云盾证书。 upload：自定义上传。
DomainName	String	www.yourdomain.com	播流域名
SSLProtocol	String	on	https开启状态。取值： on：已开启。 off：未开启。
SSLPub	String	yourSSLPub	证书公钥。
Status	String	success	证书状态。取值： success：已生效。 checking：检测域名是否在阿里云直播。 cname_error：域名没有切到阿里云直播。 domain_invalid：域名包含非法字符。 unsupport_wildcard：不支持泛域名。 applying：证书申请中。 failed：证书申请失败。
RequestId	String	5C1E43DC-9E51-4771-82C0-7D5ECEB547A1	请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainCertificateInfo
&DomainName=www.yourdomain.com
&<公共请求参数>

正常返回示例

XML 格式

<DescribeLiveDomainCertificateInfoResponse>
  <CertInfos>
        <CertInfo>
              <Status>success</Status>
              <CertLife>3 months</CertLife>
              <SSLProtocol>on</SSLProtocol>
              <CertType>cas</CertType>
              <CertName>cert-example.com</CertName>
              <CertDomainName>example.com</CertDomainName>
              <DomainName>example.com</DomainName>
              <CertOrg>Let's Encrypt</CertOrg>
              <CertExpireTime>2018-06-03T22:03:39Z</CertExpireTime>
        </CertInfo>
  </CertInfos>
  <RequestId>5C1E43DC-9E51-4771-82C0-7D5ECEB547A1</RequestId>
</DescribeLiveDomainCertificateInfoResponse>

JSON 格式

{
  "CertInfos": {
    "CertInfo": [
      {
        "Status": "success",
        "CertLife": "3 months",
        "SSLProtocol": "on",
        "CertType": "cas",
        "CertName": "cert-example.com",
        "CertDomainName": "example.com",
        "DomainName": "example.com",
        "CertOrg": "Let's Encrypt",
        "CertExpireTime": "2018-06-03T22:03:39Z"
      }
    ]
  },
  "RequestId": "5C1E43DC-9E51-4771-82C0-7D5ECEB547A1"
}

错误码

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

特殊错误码


ErrorCode 错误码	Message 错误信息	HTTP 状态	语义
InvalidDomain.NotFound	The domain provided does not belong to you.	404	域名不存在或不属于当前用户。