查看证书列表--慢直播-火山引擎

文档中心

立即注册

导航

查看证书列表

最近更新时间：2022.08.19 18:13:33首次发布时间：2022.08.19 18:13:33

查询证书列表。

请求方式

使用 GET 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，参考「公共参数」。

字段	位置	类型	必填	说明	值
Action	Query	String	是	公共参数，OpenAPI 接口名称	ListCertificates
Version	Query	String	是	公共参数，OpenAPI 接口版本	2021-01-01

返回结果

返回参数说明

通用返回参数，请参考 ResponseMetadata 结构体说明。

Result 字段包含以下参数：

字段	类型	说明
Certs	Array of objects	查询到的证书列表，参考以下 `List<Certs>` 数据结构说明

List<Certs> 数据结构说明

字段	类型	说明
ChainID	String	证书 ID
CertName	String	证书名称
Status	String	证书当前状态： normal（正常） expired（过期）
Domain	String	证书已绑定的域名
CreateAt	Timestamp	证书创建时间
UpdateAt	Timestamp	证书更新时间

示例

请求示例

GET https://open.volcengineapi.com?Action=ListCertificates
&Version=2021-01-01
&<公共请求参数>

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20220819113455010225243125060475F3",
        "Action": "ListCertificates",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "PageNumber": 1,
        "PageSize": 20,
        "TotalCount": 2,
        "Certs": [
            {
                "ChainID": "d96e7f513b9a41dd93090884dcxxxxxx",
                "CertName": "cert1",
                "Status": "normal",
                "Domain": "",
                "CreateAt": 1633984854,
                "UpdateAt": 1655282322
            },
            {
                "ChainID": "cd74146cdef74a29afe4359250xxxxxx",
                "CertName": "cert2",
                "Status": "normal",
                "Domain": "",
                "CreateAt": 1638241249,
                "UpdateAt": 1658826482
            }
        ]
    }
}