Queries server certificates in a specified region.

Note For security reasons, only fingerprints and names of the server certificates are returned. The content of the server certificates and private keys is not returned.

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 DescribeServerCertificates

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

RegionId String No cn-hangzhou

The ID of the region where the Classic Load Balancer (CLB) instance is deployed.

You can call the DescribeRegions operation to query the most recent region list.

ServerCertificateId String No 12315790*******_166f8204689_1714763408_709981430

The ID of the server certificate.

ResourceGroupId String No rg-atstuj3rtop****

The ID of the resource group.

Response parameters

Parameter Type Example Description
RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710

The ID of the request.

ServerCertificates Array of ServerCertificate

The list of server certificates.

ServerCertificate
CreateTimeStamp Long 1504147745000

The timestamp generated when the server certificate is uploaded.

AliCloudCertificateName String testcertkey

The name of the server certificate from Alibaba Cloud SSL Certificates Service.

ExpireTime String 2023-01-26T23:59:59Z

The time when the server certificate expires.

CreateTime String 2021-08-31T02:49:05Z

The time when the server certificate is uploaded.

ServerCertificateId String 123157********_166f8204689_1714763408_709981430-cn-east-hangzhou-02

The ID of the server certificate.

ExpireTimeStamp Long 1674777599000

The timestamp generated when the server certificate expires.

RegionId String cn-hangzhou

The ID of the region where the server certificate is created.

ServerCertificateName String slb

The name of the server certificate.

Fingerprint String 68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d

The fingerprint of the server certificate.

CommonName String www.example.com

The domain name of the certificate. The domain name is specified in the CommonName field.

ResourceGroupId String rg-atstuj3rtop****

The ID of the resource group.

IsAliCloudCertificate Integer 0

Indicates whether the server certificate is from Alibaba Cloud SSL Certificates Service. Valid values:

  • 1: yes
  • 0: no
AliCloudCertificateId String 7309********_15d97e7709a_71445759hr_789289731

The ID of the server certificate from Alibaba Cloud SSL Certificates Service.

SubjectAlternativeNames Array of String ["demo.aliyundoc.com","example.aliyundoc.com"]

The list of alternative domain names of the certificate. The alternative domain names are specified in the SubjectAlternativeNames field of the server certificate.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeServerCertificates
&RegionId=cn-hangzhou
&ServerCertificateId=12315790*******_166f8204689_1714763408_709981430
&ResourceGroupId=rg-atstuj3rtop****
&Common request parameters

Sample success responses

XML format

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

<DescribeServerCertificatesResponse>
    <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
    <ServerCertificates>
        <CreateTimeStamp>1504147745000</CreateTimeStamp>
        <AliCloudCertificateName>testcertkey</AliCloudCertificateName>
        <ExpireTime>2023-01-26T23:59:59Z</ExpireTime>
        <CreateTime>2021-08-31T02:49:05Z</CreateTime>
        <ServerCertificateId>123157********_166f8204689_1714763408_709981430-cn-east-hangzhou-02</ServerCertificateId>
        <ExpireTimeStamp>1674777599000</ExpireTimeStamp>
        <RegionId>cn-hangzhou</RegionId>
        <ServerCertificateName>slb</ServerCertificateName>
        <Fingerprint>68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d</Fingerprint>
        <CommonName>www.example.com</CommonName>
        <ResourceGroupId>rg-atstuj3rtop****</ResourceGroupId>
        <IsAliCloudCertificate>0</IsAliCloudCertificate>
        <AliCloudCertificateId>7309********_15d97e7709a_71445759hr_789289731</AliCloudCertificateId>
        <SubjectAlternativeNames>["demo.aliyundoc.com","example.aliyundoc.com"]</SubjectAlternativeNames>
    </ServerCertificates>
</DescribeServerCertificatesResponse>

JSON format

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

{
  "RequestId" : "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "ServerCertificates" : [ {
    "CreateTimeStamp" : 1504147745000,
    "AliCloudCertificateName" : "testcertkey",
    "ExpireTime" : "2023-01-26T23:59:59Z",
    "CreateTime" : "2021-08-31T02:49:05Z",
    "ServerCertificateId" : "123157********_166f8204689_1714763408_709981430-cn-east-hangzhou-02",
    "ExpireTimeStamp" : 1674777599000,
    "RegionId" : "cn-hangzhou",
    "ServerCertificateName" : "slb",
    "Fingerprint" : "68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d",
    "CommonName" : "www.example.com",
    "ResourceGroupId" : "rg-atstuj3rtop****",
    "IsAliCloudCertificate" : 0,
    "AliCloudCertificateId" : "7309********_15d97e7709a_71445759hr_789289731",
    "SubjectAlternativeNames" : [ "[\"demo.aliyundoc.com\",\"example.aliyundoc.com\"]" ]
  } ]
}

Error codes

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