获取集群SSL证书详情
接口说明
获取集群 SSL 证书详情
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /webapi/starrocks/listSSLDetails HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
实例 ID。 |
c-b25e21e24388**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| HttpStatusCode |
integer |
HTTP 请求状态码。 |
200 |
| RequestId |
string |
请求 ID。 |
32A44F0D-BFF6-5664-999A-218BBDE74XXX |
| Success |
boolean |
请求是否成功。 |
false |
| ErrCode |
string |
错误码。 |
InvalidParams |
| ErrMessage |
string |
错误信息。 |
Invalid params: [instance not exists]. |
| Data |
object |
返回数据。 |
|
| IsValid |
boolean |
是否有效 |
true |
| EnableSSL |
boolean |
是否开启 SSL。 |
true |
| NotBefore |
integer |
证书有效期的开始时间。 |
1751000702000 |
| NotAfter |
integer |
证书有效期的截止时间。 |
1751010702000 |
| Aliases |
string |
证书的别名。 |
starrocks-ssl |
| SubjectDN |
string |
CA 证书的 DN（Distinguished Name）属性，表示证书的使用者，具体包含以下信息：
|
CN=fe-{clusterId}-internal.starrocks.aliyuncs.com, OU=Aliyun Big Data Platform EMR StarRocks, O=Aliyun, L=BJ, ST=CN, C=CN |
| IssuerDN |
string |
系统自签名证书时，因为是自签名，IssuerDN 和 SubjectDN 内容相同（自己签自己）。用户自定义证书时，取 x509Cert.getIssuerDN().getName()，指向实际签发该证书的 CA 机构 |
CN=fe-sr-cn-xxx123-internal.starrocks.aliyuncs.com, OU=Aliyun Big Data Platform EMR StarRocks, O=Aliyun, L=BJ, ST=CN, C=CN |
| SslCertificateText |
string |
存储的是证书文件的 Base64 编码内容（PKCS#12 格式的 .p12 文件）。系统证书是生成的 P12 文件 Base64 后的字符串；自定义证书则是用户上传时传入的 customSSLCertificate 原始值 |
MIIJkAIBAzCCCVYGCSqGSIb3DQEHAaCCCUcEgglDMIIJPzCCA+8GCSqGSIb3DQEHBqCCA+AwggPc AgEAMIID1QYJKoZIhvcNAQcBMBwGCiqGSIb3DQEMAQYwDgQI3e4V2eXgGFMCAggAgIIDqJ/L8sA ...... AB3eKpMa7rQc== |
| CustomCert |
boolean |
系统自动生成的证书固定为 false；用户上传自定义证书时固定为 true。 |
true |
| Status |
string |
状态列表。
|
valid |
示例
正常返回示例
JSON格式
{
"HttpStatusCode": 200,
"RequestId": "32A44F0D-BFF6-5664-999A-218BBDE74XXX\n",
"Success": false,
"ErrCode": "InvalidParams",
"ErrMessage": "Invalid params: [instance not exists].",
"Data": {
"IsValid": true,
"EnableSSL": true,
"NotBefore": 1751000702000,
"NotAfter": 1751010702000,
"Aliases": "starrocks-ssl",
"SubjectDN": "CN=fe-{clusterId}-internal.starrocks.aliyuncs.com, OU=Aliyun Big Data Platform EMR StarRocks, O=Aliyun, L=BJ, ST=CN, C=CN",
"IssuerDN": "CN=fe-sr-cn-xxx123-internal.starrocks.aliyuncs.com, OU=Aliyun Big Data Platform EMR StarRocks, O=Aliyun, L=BJ, ST=CN, C=CN",
"SslCertificateText": "MIIJkAIBAzCCCVYGCSqGSIb3DQEHAaCCCUcEgglDMIIJPzCCA+8GCSqGSIb3DQEHBqCCA+AwggPc\nAgEAMIID1QYJKoZIhvcNAQcBMBwGCiqGSIb3DQEMAQYwDgQI3e4V2eXgGFMCAggAgIIDqJ/L8sA\n......\nAB3eKpMa7rQc==",
"CustomCert": true,
"Status": "valid"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。