调用DescribeServerCertificates接口查询传统型负载均衡指定地域的服务器证书列表。

说明 为了保证安全性，只返回证书的指纹和名称，不返回证书和私钥的内容。

调试

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

请求参数

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

系统规定参数。取值：DescribeServerCertificates。

RegionId String 否 cn-hangzhou

传统型负载均衡实例的地域。

您可以通过调用DescribeRegions接口查询地域ID。

说明 当您所选地域的Enpoint（服务地址）为slb.aliyuncs.com时，RegionId必填。
ServerCertificateId String 否 12315790*******_166f8204689_1714763408_709981430

服务器证书ID。
ResourceGroupId String 否 rg-atstuj3rtop****

资源组ID。

返回数据

名称 类型 示例值 描述
RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710

请求ID。
ServerCertificates Array of ServerCertificate

服务器证书列表。
ServerCertificate
CreateTimeStamp Long 1504147745000

服务器证书上传的时间戳。
AliCloudCertificateName String testcertkey

阿里云证书服务的服务器证书名称。
ExpireTime String 2023-01-26T23:59:59Z

过期时间。
CreateTime String 2021-08-31T02:49:05Z

服务器证书上传的时间。
ServerCertificateId String 123157********_166f8204689_1714763408_709981430-cn-east-hangzhou-02

服务器证书ID。
ExpireTimeStamp Long 15041477450

过期时间戳。
RegionId String cn-hangzhou

服务器证书的地域。
ServerCertificateName String slb

服务器证书名称。
Fingerprint String 68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d

服务器证书的指纹。
CommonName String www.example.com

域名，对应证书的CommonName字段。

ResourceGroupId String rg-atstuj3rtop****

企业资源组ID。
IsAliCloudCertificate Integer 0

是否是阿里云证书服务中的证书：

  • 1：是。
  • 0：不是。
AliCloudCertificateId String 7309********_15d97e7709a_71445759hr_789289731

阿里云证书服务的服务器证书ID。
SubjectAlternativeNames Array of String ["demo.aliyundoc.com","example.aliyundoc.com"]

数组格式，返回证书的备用域名列表，对应证书的Subject Alternative Name字段。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeServerCertificates
&RegionId=cn-hangzhou
&ServerCertificateId=12315790*******_166f8204689_1714763408_709981430
&ResourceGroupId=rg-atstuj3rtop****
&公共请求参数

正常返回示例

XML格式 

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>15041477450</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格式 

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" : 15041477450,
    "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\"]" ]
  } ]
}

错误码

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