全部产品
Search
文档中心

:查询证书匹配的域名列表

更新时间:Oct 13, 2023

调用DescribeLiveDomainByCertificate根据证书信息获取加速域名。

使用说明

调用本接口可根据证书信息查询匹配的加速域名。

QPS限制

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

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String DescribeLiveDomainByCertificate

系统规定参数。取值:DescribeLiveDomainByCertificate

SSLPub String ******

证书公钥,需要base64编码后再进行encodeURIComponent。支持pem格式。

SSLStatus Boolean true

表示返回的域名列表只包含开启或关闭HTTPS的域名。

  • true:开启。
  • false:关闭。

返回数据

名称

类型

示例值

描述

RequestId String ASAF2FDS-12SADSA-DDSAE3D-DSADCD4C-CDADS2D

请求ID。

CertInfos Array of CertInfo

证书信息列表。

CertInfo
CertExpireTime String Nov 29 00:00:00 2016 GMT

证书过期时间。

CertStartTime String Nov 29 23:59:59 2017 GMT

证书开始时间。

CertType String RSA

证书类型,取值:RSADSAECDSA

CertSubjectCommonName String owner

证书所有者名称。

CertCaIsLegacy String yes

证书CA废弃状态。取值:

  • yes:已废弃。
  • no:正常,未废弃。
DomainNames String *.example.com,aliyundoc.com

证书匹配的域名(DNS字段),多个用半角逗号(,)分隔。

CertExpired String yes

证书过期状态。 取值:

  • yes:已过期。
  • no:未过期。
Issuer String C=US, O=Symantec Corporation, OU=Symantec Trust Network, OU=Domain Validated SSL, CN=Symantec Basic DV SSL CA - G1

证书颁发机构。

DomainList String example.com,aliyundoc.com

如果该返回值不为空,则将该列表与证书做匹配,多个用半角逗号(,)分隔。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainByCertificate
&SSLPub=******
&SSLStatus=true
&公共请求参数

正常返回示例

XML格式

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

<DescribeLiveDomainByCertificateResponse>
    <RequestId>ASAF2FDS-12SADSA-DDSAE3D-DSADCD4C-CDADS2D</RequestId>
    <CertInfos>
        <CertExpireTime>Nov 29 00:00:00 2016 GMT</CertExpireTime>
        <CertStartTime>Nov 29 23:59:59 2017 GMT</CertStartTime>
        <CertType>RSA</CertType>
        <CertSubjectCommonName>owner</CertSubjectCommonName>
        <CertCaIsLegacy>yes</CertCaIsLegacy>
        <DomainNames>*.example.com,aliyundoc.com</DomainNames>
        <CertExpired>yes</CertExpired>
        <Issuer>C=US, O=Symantec Corporation, OU=Symantec Trust Network, OU=Domain Validated SSL, CN=Symantec Basic DV SSL CA - G1</Issuer>
        <DomainList>example.com,aliyundoc.com</DomainList>
    </CertInfos>
</DescribeLiveDomainByCertificateResponse>

JSON格式

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

{
  "RequestId" : "ASAF2FDS-12SADSA-DDSAE3D-DSADCD4C-CDADS2D",
  "CertInfos" : [ {
    "CertExpireTime" : "Nov 29 00:00:00 2016 GMT",
    "CertStartTime" : "Nov 29 23:59:59 2017 GMT",
    "CertType" : "RSA",
    "CertSubjectCommonName" : "owner",
    "CertCaIsLegacy" : "yes",
    "DomainNames" : "*.example.com,aliyundoc.com",
    "CertExpired" : "yes",
    "Issuer" : "C=US, O=Symantec Corporation, OU=Symantec Trust Network, OU=Domain Validated SSL, CN=Symantec Basic DV SSL CA - G1",
    "DomainList" : "example.com,aliyundoc.com"
  } ]
}

错误码

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