最近更新时间:2024-08-02 11:37:08
本接口用于获取用户的证书列表信息。
本接口请求需要包含指定目录/2016-09-01/cert/GetCertificates、公共请求header和该接口所特有的请求参数:
公共请求header请参考官网说明:https://docs.ksyun.com/documents/191?type=3
特有请求参数请参考下述说明
参数名 | 必选 | 类型及范围 | 说明 | 示例值 |
---|---|---|---|---|
PageSize | 否 | Long | 分页大小,默认20; 最大100,取值1~100间整数 | 20 |
PageNum | 否 | Long | 取第几页,默认为1; 取值1~10000 | 1 |
DomainName | 否 | String | 加速域名,仅支持单个查询。 不带此参数,获取用户的所有证书列表信息 | |
CertificateName | 否 | String | 证书名称,仅支持单个查询。 不带此参数,获取用户的所有证书列表信息 | test |
CertificateId | 否 | String | 证书唯一性ID,仅支持单个查询。不带此参数,获取用户的所有证书列表信息 | 8265 |
MatchRule | 否 | String | 匹配方式,仅支持以下两个参数:
不带此参数,默认精准匹配。 注意:
| exact |
注意:如果传入了多个筛选参数,则查询结果取交集
参数名 | 类型及范围 | 说明 | 示例值 |
Certificates | Certificate[ ] | 证书列表 | 见下方详细说明 |
PageNum | Long | 页码 | 2 |
PageSize | Long | 单页大小 | 10 |
TotalCount | Long | 总条数 | 3 |
参数名 | 类型及范围 | 说明 | 示例值 |
CertificateName | String | 证书名称 | test |
CertificateId | String | 证书唯一性ID | 2312 |
Enable | String | 证书状态 启用:on,未启用:off | on |
IssueDomain | String | CA颁发时证书绑定的域名 | |
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 | 证书已绑定域名 域名之间用半角英文逗号“,”相隔 |
请求示例
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
}
纯净模式