调用ListRevokeCertificate查询所有已被吊销的客户端证书和服务端证书的详细信息。

使用说明

本接口用于分页查询所有已被吊销的客户端证书和服务端证书的详细信息,例如,证书的唯一识别码、序列号、吊销日期等。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用将会被限流,这可能影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListRevokeCertificate

要执行的操作。取值:ListRevokeCertificate

CurrentPage Integer 1

分页查询时,设置当前页面的页码。默认值为1

ShowSize Integer 20

分页查询时,设置每页包含已被吊销证书的数量。默认值为20

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
CurrentPage Integer 1

当前页面的页码。

RequestId String 15C66C7B-671A-4297-9187-2C4477247A74

本次请求的ID。

TotalCount Integer 1

已被吊销的客户端证书和服务端证书的总数。

PageCount Integer 1

总页数。

ShowSize Integer 20

每页包含已被吊销证书的数量。

CertificateList Array of Certificate

已被吊销的客户端证书或服务端证书的详细信息。

SerialNumber String 168b12c42e62339f8d2340ff530f9365****

证书的序列号。

Algorithm String RSA

证书的加密算法类型。取值:

  • RSA:表示RSA算法。
  • ECC:表示ECC算法。
  • SM2:表示SM2(国密)算法。
State String Zhejiang

签发该证书的子CA证书关联的组织机构所在省份、直辖市或自治区的名称。

Organization String 阿里云计算有限公司

签发该证书的子CA证书关联的组织机构的名称。

Locality String Hangzhou

签发该证书的子CA证书关联的组织机构所在城市的名称。

RevokeDate String 2021-09-01T00:00Z

证书被吊销的日期。格式为yyyy-MM-ddT00:00Z,例如,2021-09-01T00:00Z表示2021年09月01日。

Identifier String 05e148d8d3ecc9976d9ecd2b2f25****

证书的唯一识别码。

Sans String [ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ]

证书的SAN(Subject Alternative Name)扩展属性。

该参数使用JSON数组转化的字符串表示。JSON数组中的每个元素是一个结构体,对应一个SAN扩展。每个SAN扩展结构体包含以下参数:

  • Type:Integer类型,表示扩展的类型。取值:
    • 1:表示邮箱地址。
    • 2:表示域名。
    • 6:表示统一资源标识符URI(Uniform Resource Identifier)。
    • 7:表示IP地址。
  • Value:String类型,表示扩展的内容。
KeySize Integer 4096

证书的密钥长度。

SubjectDN String C=CN,O=阿里云计算有限公司,OU=Security,L=ZheJiang,ST=HangZhou,CN=aliyundoc.com

证书的DN(Distinguished Name)属性,表示证书的使用者,具体包含以下信息:

  • C:国家。
  • O:组织机构。
  • OU:部门。
  • L:城市。

  • ST:省份、直辖市或自治区。

  • CN:公用名。
SignAlgorithm String SHA256WITHRSA

证书的签名算法。

OrganizationUnit String Security

签发该证书的子CA证书关联的组织机构下部门的名称。

AfterDate String 2021-12-31T00:00Z

证书的到期日期。格式为yyyy-MM-ddT00:00Z,例如,2021-12-31T00:00Z表示2021年12月31日。

Sha2 String b60eff7e04323ff662f9ab5e6986f849f626a9c7bf2c59dcc752fa23779a****

证书的SHA256数字指纹。

CommonName String aliyundoc.com

证书的公用名。

Md5 String 05e148d8d3ecc9976d9ecd2b2f25****

证书的MD5数字指纹。

CountryCode String CN

签发该证书的子CA证书关联的组织机构所在国家的代码。

关于不同国家代码的含义,请参见管理公司信息中的国际代号章节。

BeforeDate String 2021-01-01T00:00Z

证书的签发日期。格式为yyyy-MM-ddT00:00Z,例如,2021-01-01T00:00Z表示2021年01月01日。

示例

请求示例

http(s)://[Endpoint]/?Action=ListRevokeCertificate
&CurrentPage=1
&ShowSize=20
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListRevokeCertificateResponse>
    <CurrentPage>1</CurrentPage>
    <RequestId>15C66C7B-671A-4297-9187-2C4477247A74</RequestId>
    <TotalCount>1</TotalCount>
    <PageCount>1</PageCount>
    <ShowSize>20</ShowSize>
    <CertificateList>
        <SerialNumber>168b12c42e62339f8d2340ff530f9365****</SerialNumber>
        <Algorithm>RSA</Algorithm>
        <State>Zhejiang</State>
        <Organization>阿里云计算有限公司</Organization>
        <Locality>Hangzhou</Locality>
        <RevokeDate>2021-09-01T00:00Z</RevokeDate>
        <Identifier>05e148d8d3ecc9976d9ecd2b2f25****</Identifier>
        <Sans>[ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ]</Sans>
        <KeySize>4096</KeySize>
        <SubjectDN>C=CN,O=阿里云计算有限公司,OU=Security,L=ZheJiang,ST=HangZhou,CN=aliyundoc.com</SubjectDN>
        <SignAlgorithm>SHA256WITHRSA</SignAlgorithm>
        <OrganizationUnit>Security</OrganizationUnit>
        <AfterDate>2021-12-31T00:00Z</AfterDate>
        <Sha2>b60eff7e04323ff662f9ab5e6986f849f626a9c7bf2c59dcc752fa23779a****</Sha2>
        <CommonName>aliyundoc.com</CommonName>
        <Md5>05e148d8d3ecc9976d9ecd2b2f25****</Md5>
        <CountryCode>CN</CountryCode>
        <BeforeDate>2021-01-01T00:00Z</BeforeDate>
    </CertificateList>
</ListRevokeCertificateResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "CurrentPage" : 1,
  "RequestId" : "15C66C7B-671A-4297-9187-2C4477247A74",
  "TotalCount" : 1,
  "PageCount" : 1,
  "ShowSize" : 20,
  "CertificateList" : [ {
    "SerialNumber" : "168b12c42e62339f8d2340ff530f9365****",
    "Algorithm" : "RSA",
    "State" : "Zhejiang",
    "Organization" : "阿里云计算有限公司",
    "Locality" : "Hangzhou",
    "RevokeDate" : "2021-09-01T00:00Z",
    "Identifier" : "05e148d8d3ecc9976d9ecd2b2f25****",
    "Sans" : "[ {\"Type\": 7, \"Value\": \"192.0.XX.XX\"}, {\"Type\": 2, \"Value\": \"www.aliyundoc.com\"}, ]",
    "KeySize" : 4096,
    "SubjectDN" : "C=CN,O=阿里云计算有限公司,OU=Security,L=ZheJiang,ST=HangZhou,CN=aliyundoc.com",
    "SignAlgorithm" : "SHA256WITHRSA",
    "OrganizationUnit" : "Security",
    "AfterDate" : "2021-12-31T00:00Z",
    "Sha2" : "b60eff7e04323ff662f9ab5e6986f849f626a9c7bf2c59dcc752fa23779a****",
    "CommonName" : "aliyundoc.com",
    "Md5" : "05e148d8d3ecc9976d9ecd2b2f25****",
    "CountryCode" : "CN",
    "BeforeDate" : "2021-01-01T00:00Z"
  } ]
}

错误码

访问错误中心查看更多错误码。