本文导读

展开导读

文档首页/ 云证书管理服务 CCM/ API参考/ 历史API/ SSL证书管理/ 查询证书列表

查询证书列表

更新时间：2023-10-11 GMT+08:00

查看PDF

功能介绍

根据证书名称或绑定域名查询证书列表。

须知：

当前页面API即将废弃，建议您使用查询证书列表。

URI

URI格式
 GET /v2/{project_id}/scm/certlist?order_status=&content=&sort_key=& sort_dir=&limit=&offset=

参数说明

参数	是否必选	参数类型	描述
project_id	是	String	项目ID。

请求消息

请求参数

参数	是否必选	参数类型	描述
order_status	否	String	证书状态，取值如下： PAID：证书已支付；待申请证书。 ISSUED：证书已签发。 CHECKING：证书申请审核中。 CANCELCHECKING：取消证书申请审核中。 UNPASSED：证书申请未通过。 EXPIRED：证书已过期。 REVOKING：证书吊销申请审核中。 REVOKED：证书已吊销。 UPLOAD：证书托管中。 SUPPLEMENTCHECKING：多域名证书新增附加域名审核中。 CANCELSUPPLEMENTING：取消新增附加域名审核中。
content	否	String	搜索关键词。
sort_key	否	String	排序依据参数，取值如下： certExpiredTime：证书到期时间。 certStatus：证书状态。 certUpdateTime：证书更新时间。
sort_dir	否	String	排序方式。根据排序参数sort_key进行排序，取值如下： ASC：升序。 DESC：降序。
limit	否	Integer	每页条目数量，取值如下： 10：每页显示10条证书信息。 20：每页显示20条证书信息。 50：每页显示50条证书信息。
offset	否	Integer	偏移量。取值范围为1~30。

响应消息

响应参数

参数	是否必选	参数类型	描述
total	是	Integer	列表证书数量。
free_remain	是	Integer	免费测试证书剩余配额。
order_list	是	Array of order_list objects	证书列表，详情请参见表1。

表1 order_list
参数	是否必选	参数类型	描述
cert_id	是	String	证书ID。
cert_name	是	String	证书名称。
domain	是	String	绑定域名。
cert_type	是	String	证书类型。
cert_brand	是	String	证书品牌。
domain_type	是	String	域名类型。
purchase_period	是	Integer	有效期。
expired_time	是	String	证书到期时间。
order_status	是	String	证书状态。
domain_num	是	Integer	域名数量。
wildcard_number	是	Integer	泛域名数量。
cert_des	是	String	证书描述。

示例

请求样例
 无。

响应样例

{  
"total": 1, 
"free_remain":"19", 
"order_list": [{ 
"cert_id": "scs1481110651012", 
"cert_name": "scs-0001", 
"domain": "*.example.com", 
"cert_type": "GE00V01", 
"cert_brand":"GLOBALSIGN",  
"domain_type":" SINGLE_DOMAIN ", 
"purchase_period":1, 
"expired_time":"15051501510501", 
"order_state":"completed ", 
"domain_num":10, 
"wildcard_number":2,
"cert_des":"***********" 
}] 
}

或

{ 
   "error_code": "SCM.XXXX",  
   "error_msg": "XXXX"   
 }

状态码

表2描述的是API返回的正常状态码。

表2 状态码
状态码	编码	状态说明
200	OK	请求已成功。

异常状态码，请参见错误码。

父主题： SSL证书管理

上一篇：购买SSL证书

下一篇：查询证书详情

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

查询证书列表

功能介绍

URI

请求消息

响应消息

示例

状态码

意见反馈

文档内容是否对您有帮助？

文档反馈