文档

DescribeCerts - 查询适用于当前域名的所有证书列表

更新时间:

查询用户适用于当前域名的所有证书信息,而非当前使用的证书。

接口说明

该接口为查询配置高防域名适用所有证书,会出现一个域名对应多个证书。例如:通过精准域名查询到精准域名证书或泛域名证书。

说明 如果您需要查询当前域名正在生效使用的证书您可以调用 DescribeWebRules 查询获取 CertName 和 CertRegion,然后调用证书中心的接口 ListUserCertificateOrder 使用返回的 CertName 关联查询到对应的证书 ID 或其他详情。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

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

DDoS 高防实例在资源管理产品中所属的资源组 ID。默认为空,即属于默认资源组。

default
Domainstring

网站业务的域名。

说明 域名必须已配置网站业务转发规则。您可以调用 DescribeDomains 查询所有域名。
www.aliyun.com

返回参数

名称类型描述示例值
object
RequestIdstring

本次请求的 ID。

0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc
Certsarray<object>

网站业务的证书信息。

object
EndDatestring

证书到期日期。字符串格式。

2021-09-12
DomainRelatedboolean

证书是否关联域名。取值:

  • true:已关联
  • false:未关联
true
StartDatestring

证书签发日期。字符串格式。

2019-09-12
Issuerstring

证书颁发机构。

Symantec
Namestring

证书名称。

testcert
Commonstring

证书关联的域名。

www.aliyun.com
Idinteger

证书 ID。

81
CertIdentifierstring

全局证书 ID,证书 ID+"-cn-hangzhou"。如果证书 ID=123,则 CertIdentifier=“123-cn-hangzhou”。

126345-ap-southeast-1

示例

正常返回示例

JSON格式

{
  "RequestId": "0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc",
  "Certs": [
    {
      "EndDate": "2021-09-12",
      "DomainRelated": true,
      "StartDate": "2019-09-12",
      "Issuer": "Symantec",
      "Name": "testcert",
      "Common": "www.aliyun.com",
      "Id": 81,
      "CertIdentifier": "126345-ap-southeast-1"
    }
  ]
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-07-18OpenAPI 返回结构发生变更查看变更详情