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

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

接口说明

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

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

调试

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

调试

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
yundun-ddoscoo:DescribeCerts	get	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
ResourceGroupId	string	否	DDoS 高防实例在资源管理产品中所属的资源组 ID。默认为空，即属于默认资源组。	default
Domain	string	否	网站业务的域名。说明域名必须已配置网站业务转发规则。您可以调用 DescribeDomains 查询所有域名。	www.aliyun.com

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次请求的 ID。	0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc
Certs	array<object>	网站业务的证书信息。
CertItem	object
EndDate	string	证书到期日期。字符串格式。	2021-09-12
DomainRelated	boolean	证书是否关联域名。取值： true：已关联 false：未关联	true
StartDate	string	证书签发日期。字符串格式。	2019-09-12
Issuer	string	证书颁发机构。	Symantec
Name	string	证书名称。	testcert
Common	string	证书关联的域名。	www.aliyun.com
Id	integer	证书 ID。	81
CertIdentifier	string	全局证书 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-18	OpenAPI 返回结构发生变更	查看变更详情