更新时间:2022-02-22 GMT+08:00

获取证书列表

功能介绍

获取某个用户的证书列表。

URI

  • URI格式

    GET /v1/{project_id}/waf/certificate?offset={offset}&limit={limit}

  • 参数说明
    表1 Path参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    用户操作的项目ID。

    offset

    Long

    指定返回的页数,取值范围为:[0, 65535],默认值为0。

    limit

    Long

    指定查询返回每页记录的最大条数,取值范围为:(0, 50],默认值为10。当limit=-1时,将返回offset=0,limit=65535的数据。

请求消息

请求参数

响应消息

响应参数
表2 响应参数说明

名称

参数类型

说明

total

Integer

获得证书的总数。

items

表3

证书对象列表。

表3 items

名称

参数类型

说明

id

String

证书的ID。

name

String

证书名称。

expireTime

Long

证书的到期时间

timestamp

Long

创建证书的时间。

示例

如下以获取证书列表,返回记录条数为“2”为例。

响应样例
{
   "total": 2,
    "items": [
        {
          "id": "388a7789d55b41d1918b3088a8f1e7f3",
          "name": "cert_a",
          "timestamp": 1544756441859,
          "expireTime": 1545978662373
        }, {
          "id": "388a7789d55b41d1918b3088a8f1e7f4",
          "name": "cert_b",
          "timestamp": 1544756441859,
          "expireTime": 1545978662356
        }]
}

状态码

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

状态码

编码

状态说明

200

OK

客户端请求已处理成功。

异常状态码,请参见状态码