文档

ListRevokeCertificate - 查询吊销证书列表

更新时间:

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

接口说明

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

QPS限制

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

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-cert:ListRevokeCertificateList
  • 全部资源
    acs:yundun-cert:*:{#accountId}:*

请求参数

名称类型必填描述示例值
CurrentPageinteger

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

1
ShowSizeinteger

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

20

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

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

返回参数

名称类型描述示例值
object

ListCertificateResponse2

CertificateListobject []

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

RevokeDatestring

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

2021-09-01T00:00Z
Identifierstring

证书的唯一识别码。

05e148d8d3ecc9976d9ecd2b2f25****
SerialNumberstring

证书的序列号。

168b12c42e62339f8d2340ff530f9365****
SubjectDNstring

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

  • C:国家。

  • O:组织机构。

  • OU:部门。

  • L:城市。

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

  • CN:公用名。

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

证书的公用名。

aliyundoc.com
OrganizationUnitstring

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

Security
Organizationstring

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

阿里云计算有限公司
Localitystring

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

Hangzhou
Statestring

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

Zhejiang
CountryCodestring

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

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

CN
Sansstring

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

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

  • Type:Integer类型,表示扩展的类型。取值:
    • 1:表示邮箱地址。
    • 2:表示域名。
    • 6:表示统一资源标识符URI(Uniform Resource Identifier)。
    • 7:表示IP地址。
  • Value:String类型,表示扩展的内容。
[ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ]
Statusstring

状态。

ISSUE
BeforeDatestring

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

2021-01-01T00:00Z
AfterDatestring

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

2021-12-31T00:00Z
Algorithmstring

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

  • RSA:表示RSA算法。
  • ECC:表示ECC算法。
  • SM2:表示SM2(国密)算法。
RSA
KeySizeinteger

证书的密钥长度。

4096
SignAlgorithmstring

证书的签名算法。

SHA256WITHRSA
CertificateTypestring

证书类型。

SERVER
ParentIdentifierstring

父证书标识。

160ae6bb538d538c70c01f81dcf2****
Sha2string

证书的SHA256数字指纹。

b60eff7e04323ff662f9ab5e6986f849f626a9c7bf2c59dcc752fa23779a****
Md5string

证书的MD5数字指纹。

05e148d8d3ecc9976d9ecd2b2f25****
CurrentPageinteger

当前页面的页码。

1
PageCountinteger

总页数。

1
ShowSizeinteger

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

20
TotalCountlong

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

1
RequestIdstring

本次请求的ID。

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

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史
  • 本页导读 (1)
文档反馈