Queries certificates.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeUserCertificateList

The operation that you want to perform. Set the value to DescribeUserCertificateList.

ShowSize Integer Yes 1

The number of entries to return on each page. Default value: 50.

CurrentPage Integer Yes 1

The number of the page to return. Default value: 1.

SourceIp String No 47.100.XX.XX

The source IP address of the request.

Lang String No zh

The language of the content within the request and response. Valid values:

  • zh: Chinese
  • en: English

All Alibaba Cloud API operations must include common request parameters. For more information about common request parameters, see Common parameters.

For more information about sample requests, see the "Examples" section of this topic.

Response parameters

Parameter Type Example Description
CurrentPage Integer 1

The page number of the returned page.

RequestId String 0068247C-A454-5FC9-93BF-C41CBB5CD19E

The ID of the request, which is used to locate and troubleshoot issues.

TotalCount Integer 343

The total number of returned entries.

ShowSize Integer 1

The number of entries returned per page.

CertificateList Array of Certificate

An array that consists of the details about the certificate.

startDate String 2020-05-15

The issuance date of the certificate.

province String Zhejiang

The province of the company or organization to which the certificate purchaser belongs.

sans String www.aliyundoc.com,aliyundoc.com

All domain names that are bound to the certificate.

common String www.aliyundoc.com

The primary domain name that is bound to the certificate.

id Long 3920982

The ID of the certificate.

country String CN

The country or region of the company or organization to which the certificate purchaser belongs.

issuer String DigiCert Inc

The certificate authority (CA) that issued the certificate.

buyInAliyun Boolean true

Indicates whether the certificate was purchased from Alibaba Cloud. Valid values:

  • true: The certificate was purchased from Alibaba Cloud.
  • false: The certificate was not purchased from Alibaba Cloud.
expired Boolean true

Indicates whether the certificate has expired. Valid values:

  • true: The certificate has expired.
  • false: The certificate has not expired.
endDate String 2021-05-15

The expiration date of the certificate.

name String cert-370****

The name of the certificate.

fingerprint String 5998B127E231A46EBE48D947F79CAE820CF7588D

The fingerprint of the certificate.

city String Hangzhou

The city of the company or organization to which the certificate purchaser belongs.

orgName String Alibaba

The name of the company or organization to which the certificate purchaser belongs.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeUserCertificateList
&CurrentPage=1
&ShowSize=1
&<Common request parameters>

Sample success responses

XML format 

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

<DescribeUserCertificateListResponse>
    <TotalCount>343</TotalCount>
    <RequestId>0068247C-A454-5FC9-93BF-C41CBB5CD19E</RequestId>
    <CurrentPage>1</CurrentPage>
    <CertificateList>
        <country>CN</country>
        <orgName>Alibaba</orgName>
        <endDate>2021-05-15</endDate>
        <city>Hangzhou</city>
        <sans>www.aliyundoc.com,aliyundoc.com</sans>
        <issuer>DigiCert Inc</issuer>
        <expired>true</expired>
        <province>Zhejiang</province>
        <common>www.aliyundoc.com</common>
        <buyInAliyun>true</buyInAliyun>
        <name>cert-370****</name>
        <fingerprint>5998B127E231A46EBE48D947F79CAE820CF7588D</fingerprint>
        <id>3920982</id>
        <startDate>2020-05-15</startDate>
    </CertificateList>
    <ShowSize>1</ShowSize>
</DescribeUserCertificateListResponse>

JSON format 

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

{
  "TotalCount" : 343,
  "RequestId" : "0068247C-A454-5FC9-93BF-C41CBB5CD19E",
  "CurrentPage" : 1,
  "CertificateList" : [ {
    "country" : "CN",
    "orgName" : "Alibaba",
    "endDate" : "2021-05-15",
    "city" : "Hangzhou",
    "sans" : "www.aliyundoc.com,aliyundoc.com",
    "issuer" : "DigiCert Inc",
    "expired" : true,
    "province" : "Zhejiang",
    "common" : "www.aliyundoc.com",
    "buyInAliyun" : true,
    "name" : "cert-370****",
    "fingerprint" : "5998B127E231A46EBE48D947F79CAE820CF7588D",
    "id" : 3920982,
    "startDate" : "2020-05-15"
  } ],
  "ShowSize" : 1
}

Error codes

For a list of error codes, visit the API Error Center.