Queries the server certificates in a region.

Note To guarantee security, only the fingerprint and name of the certificate are returned, and the contents of the certificate and private key are not returned.

Make the API call

You can use OpenAPI Explorer to make API calls, search for API calls, perform debugging, and generate SDK example code.

Request parameters

Parameter Type Required? Example value Description
Action String Yes DescribeServerCertificates

The name of this action.

Value: DescribeServerCertificates
RegionId String Yes cn-hangzhou

The ID of the region to which the Server Load Balancer (SLB) instance belongs.

To query the region ID, call DescribeRegions.

ResourceGroupId String No rg-atstuj3rtoptyui

The ID of the enterprise resource group.
ServerCertificateId String No 12315790xxxxxxx_166f8204689_1714763408_709981430

The ID of the server certificate.

Response parameters

Parameter Type Example value Description
ServerCertificates

The list of server certificates.
ServerCertificateId String 123157xxxxxxxx_166f8204689_1714763408_709981430-cn-east-hangzhou-02

The ID of the server certificate.
ServerCertificateName String slb

The name of the server certificate.
RegionId String cn-hangzhou

The ID of the region to which the server certificate belongs.
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.
AliCloudCertificateId String 7309xxxxxxxx_15d97e7709a_71445759hr_789289731

The ID of the server certificate from Alibaba Cloud SSL Certificate Service.
AliCloudCertificateName String testcertkey

The name of the server certificate from Alibaba Cloud SSL Certificate Service.
CommonName String www.example.com

The domain name that corresponds to the CommonName field of the certificate.
CreateTime String 2017-08-31T02:49:05Z

The time when the server certificate is uploaded.
CreateTimeStamp Long 1504147745000

The timestamp generated when the server certificate is uploaded.
ExpireTime String 017-08-31T02:49:05Z

The time when the server certificate expires.
ExpireTimeStamp Long 15041477450

The timestamp generated when the server certificate expires.
IsAliCloudCertificate Integer 0

Indicates whether the certificate is from Alibaba Cloud SSL Certificate Service.

  • 1: Yes.
  • 0: No.
ResourceGroupId String rg-atstuj3rtoptyui

The ID of the enterprise resource group.
SubjectAlternativeNames 123

The list of alternate domain names for the certificate. This parameter is returned in array format. It corresponds to the Subject Alternative Name field of the certificate.

RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710

The ID of the request.

Examples

Request example


http(s)://[Endpoint]/? Action=DescribeServerCertificates
&<CommonParameters>

Response example

XML format 

<DescribeServerCertificatesResponse>	
	  <RequestId>9FFF450B-CC09-4FFB-900F-E347EB7AA2CC</RequestId>
	  <ServerCertificates>
		    <ServerCertificate>
			      <CreateTimeStamp>1541761156000</CreateTimeStamp>
			      <CommonName>*.example1.com</CommonName>
			      <RegionIdAlias>cn-hangzhou</RegionIdAlias>
			      <ResourceGroupId>rg-acfmxazb4ph6aiy</ResourceGroupId>
			      <Fingerprint>68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d</Fingerprint>
			      <ServerCertificateId>1231579xxxxxx_166f8204689_1714763408_709981430</ServerCertificateId>
			      <ExpireTimeStamp>1558161264000</ExpireTimeStamp>
			      <AliCloudCertificateId>1501739</AliCloudCertificateId>
			      <ExpireTime>2019-05-18T06:34:24Z</ExpireTime>
			      <RegionId>cn-hangzhou</RegionId>
			      <CreateTime>2018-11-09T10:59:16Z</CreateTime>
			      <ServerCertificateName>*.example1.com</ServerCertificateName>
			      <IsAliCloudCertificate>1</IsAliCloudCertificate>
			      <AliCloudCertificateName>slb</AliCloudCertificateName>
		    </ServerCertificate>
		    <ServerCertificate>
			      <CreateTimeStamp>1481623069000</CreateTimeStamp>
			      <RegionIdAlias>cn-hangzhou</RegionIdAlias>
			      <ResourceGroupId>rg-acfmxazb4ph6aiy</ResourceGroupId>
			      <Fingerprint>cd:90:1b:7b:49:4d:1d:90:f6:01:de:9a:81:7d:31:a7:38:1d:84:8d</Fingerprint>
			      <ServerCertificateId>1231579085xxxx_158f79de306</ServerCertificateId>
			      <ExpireTimeStamp>1732169065000</ExpireTimeStamp>
			      <AliCloudCertificateId>0</AliCloudCertificateId>
			      <ExpireTime>2024-11-21T06:04:25Z</ExpireTime>
			      <RegionId>cn-hangzhou</RegionId>
			      <CreateTime>2016-12-13T09:57:49Z</CreateTime>
			      <ServerCertificateName>test_certificate</ServerCertificateName>
			      <IsAliCloudCertificate>0</IsAliCloudCertificate>
			      <AliCloudCertificateName></AliCloudCertificateName>
		    </ServerCertificate>
	  </ServerCertificates>
</DescribeServerCertificatesResponse>

JSON format 

{
	"RequestId":"9FFF450B-CC09-4FFB-900F-E347EB7AA2CC",
	"ServerCertificates":{
		"ServerCertificate":[
			{
				"CreateTimeStamp":1541761156000,
				"CommonName":"*.example1.com",
				"RegionIdAlias":"cn-hangzhou",
				"ResourceGroupId":"rg-acfmxazb4ph6aiy",
				"Fingerprint":"68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d",
				"ServerCertificateId":"1231579xxxxxxx_166f8204689_1714763408_709981430",
				"ExpireTimeStamp":1558161264000,
				"AliCloudCertificateId":"1501739",
				"ExpireTime":"2019-05-18T06:34:24Z",
				"RegionId":"cn-hangzhou",
				"CreateTime":"2018-11-09T10:59:16Z",
				"ServerCertificateName":"*.example1.com",
				"IsAliCloudCertificate":1,
				"AliCloudCertificateName":"slb"
			},
			{
				"CreateTimeStamp":1481623069000,
				"RegionIdAlias":"cn-hangzhou",
				"ResourceGroupId":"rg-acfmxazb4ph6aiy",
				"Fingerprint":"cd:90:1b:7b:49:4d:1d:90:f6:01:de:9a:81:7d:31:a7:38:1d:84:8d",
				"ServerCertificateId":"1231579085529123_158f79de306",
				"ExpireTimeStamp":1732169065000,
				"AliCloudCertificateId":"0",
				"ExpireTime":"2024-11-21T06:04:25Z",
				"RegionId":"cn-hangzhou",
				"CreateTime":"2016-12-13T09:57:49Z",
				"ServerCertificateName":"test_certificate",
				"IsAliCloudCertificate":0,
				"AliCloudCertificateName":""
			}
		]
	}
}

Errors

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