• 热门
  • 基础
  • 数据库
  • 安全
  • 大数据
  • 人工智能
  • 混合云
  • 开发与运维
  • 企业应用

应用服务

行业引擎

全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

获取用户证书列表信息接口

最近更新时间:2024-08-02 11:37:08

GetCertificates

描述

本接口用于获取用户的证书列表信息。

请求语法

本接口请求需要包含指定目录/2016-09-01/cert/GetCertificates、公共请求header和该接口所特有的请求参数:

请求参数

参数名

必选

类型及范围

说明

示例值

PageSize

Long

分页大小,默认20;

最大100,取值1~100间整数

20

PageNum

Long

取第几页,默认为1;

取值1~10000

1

DomainName

String

加速域名,仅支持单个查询。

不带此参数,获取用户的所有证书列表信息

test.com

CertificateName

String

证书名称,仅支持单个查询。

不带此参数,获取用户的所有证书列表信息

test

CertificateId

String

证书唯一性ID,仅支持单个查询。不带此参数,获取用户的所有证书列表信息

8265

MatchRule

String

匹配方式,仅支持以下两个参数:

  • exact,表示精准匹配。选择此参数时,DomainName、CertificateName如果有值,则精准匹配筛选

  • fuzzy,表示模糊匹配。选择此参数时,DomainName、CertificateName如果有值,则模糊匹配筛选。

    模糊匹配的规则为匹配包含传参字符串的内容,例如输入123,则匹配结果为.*123.*

不带此参数,默认精准匹配。

注意:

  • 此参数仅支持DomainName和CertificateName

  • CertificateId仅支持精准匹配

exact

注意:如果传入了多个筛选参数,则查询结果取交集

返回参数

参数名

类型及范围

说明

示例值

Certificates

Certificate[ ]

证书列表

见下方详细说明

PageNum

Long

页码

2

PageSize

Long

单页大小

10

TotalCount

Long

总条数

3

Certificate

参数名

类型及范围

说明

示例值

CertificateName

String

证书名称

test

CertificateId

String

证书唯一性ID

2312

Enable

String

证书状态

启用:on,未启用:off

on

IssueDomain

String

CA颁发时证书绑定的域名

test.com

IssueTime

String

证书颁发时间

1533547545

ExpirationTime

String

证书过期时间

1536139545

CertificateContent

String

证书内容,PEM格式

-----BEGIN CERTIFICATE-----\nMIID8zCCA7H2\nzYKParXOYgJFVAQ4W/OAxoFLNE2WiiaADku7o5go9Rg==\n-----END CERTIFICATE-----

CertificateType

String

证书类型,分别是EV\DV\OV

DV

ConfigDomainNames

String

证书已绑定域名

域名之间用半角英文逗号“,”相隔

test.com

示例

请求示例

POST方式:

POST /2016-09-01/cert/GetCertificates 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetCertificates 
x-version: 2016-09-01
Content-Type: application/json

{
    "PageSize": 2,
    "PageNum": 1,
    "CertificateName":"test"
}

返回示例:

{
    "Certificates": [
        {
            "CertificateName": "test",
            "CertificateId": "969",
            "Enable": "on",
            "IssueDomain": "test.com",
            "IssueTime": "1533547545",
            "ExpirationTime": "1536139545",
            "CertificateContent": "-----BEGIN CERTIFICATE-----\nMIID8zCCAtugAwIBAgIJAIziJNVI9HdSMA0GCSqGSIb3DQEBBQUAMIGPMQswCQYD\nVQQGEwJISDEQMA4GA1UECAwHYmVpamluZzEQMA4GA1UEBwwHYmVpa3Lmh1YWXQOBgNVBAcMB2JlaWppbmcxDTALBgNVBAoMBGh1eWExDTAL\nBgNVBAsMBGh1eWExGzAZBgNVBAMMEnd3dy5odWFuZm91Lm5ldC5jbjEhMB8GCSqG\nSIb3DQEJARYSd3d3Lmh1YW5mb3UubmV0LmNuMIIBIjANBgkqhkiG9w0BAQEFAAOC\nAQ8AMIIBCgKCAQEA2bH1j/bjoh0B7CUn3ovUG6q5cLh6fyowJPWzGDDVEkbA17H2\nzYKParXOYgJFVAQ4W/OAxoFLNE2glba5eObDaGHLiu6syEEYLE4v8zczL9TIMqVs\nuqzGL61Y2zKS3JBviPy7atFy3w/QXcH48YFDAwkCKDE3ehW4SruFEimQfOrMS/WZ\ndYeWr3Iuv+a5c7Emo7t5AoY+yAp6D1AG6XyWuwtMi9rfdJ6j461FM4XCYk9Gi1AQ\nvyvPnXd0rfrlNEbQV8ucNftn8RT4z1i1yFJ+3FAZl+TZ1V2cn6JG+LeQMqgLvp47\nTSXzqhYyshQeBY12Y6m9jXdqC+VUDZ9Olp+92wIDAQABo1AwTjAdBgNVHQ4EFgQU\nghJiOk6aMGYw7WSsEDNwWEavOTIwHwYDVR0jBBgwFoAUghJiOk6aMGYw7WSsEDNw\nWEavOTIwDAYDVR0TBAUwAwEB/zANBgkqhkiG9w0BAQUFAAOCAQEAwz3Tx5Xv3yzJ\nLGlQtuBESGKsRXd20Hx8YZ2JVQs1g82L9CKfI84mFJ+QiqCEmIdY/ERB7zt6vqbD\nGfBoIX6Z+9hxiZZwIm5ziLLbYAcX/lg1bqNb8mdP29LEhYn3A6TmLR3XJAF7EXwB\ntNN3VPry1sIwJAPLQ3BvQcXk+3InF3+lgrUX+1/wNNEl2xiKxbpEt/OTAzh3jkYK\npE0CCnmfGoIVCwGJLUqr8uSf8fJud1nQh63P52hOKzWiiaADku7og2wLAT7d2QoC\nLb0yAr3X0MP+TiCCg8ZLMGe7p7tJjTX6Hmc+ayJgNuq9cOWozSvaIH60C7N0iAJk\nS2J45go9Rg==\n-----END CERTIFICATE-----",
            "CertificateType": "DV",
            "ConfigDomainNames": "test.com"
        }
    ],
    "TotalCount": 1,
    "PageSize": 2,
    "PageNum": 1
}

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈

聆听反馈