Queries the status of client certificates and server certificates by certificate serial number.
Operation description
This operation allows you to query the status of client certificates or server certificates in batches by certificate serial number. For example, you can check whether a certificate has been revoked.
QPS limit
The China QPS limit for this operation is 10 calls per second. If this limit is exceeded, throttling is triggered, which may affect your business. Call this operation as needed.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
yundun-cert:DescribeClientCertificateStatusForSerialNumber |
get |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| SerialNumber |
string |
Yes |
Certificate serial number of the client certificate or server certificate to query. Separate multiple serial numbers with commas (,). Note
You can call ListClientCertificate to query certificate serial numbers of all client certificates and server certificates. |
b67e53ebcea9b77d65b0c3236646d715**** |
When you call this operation, you must include the common request parameters of Alibaba Cloud APIs in addition to the request parameters described in this topic.
For the request format, see the request example in the Examples section.
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response object. |
||
| RequestId |
string |
The request ID. |
15C66C7B-671A-4297-9187-2C4477247A74 |
| CertificateStatus |
array<object> |
The certificate status details. |
|
|
object |
The object. |
||
| SerialNumber |
string |
The serial number of the certificate. |
b67e53ebcea9b77d65b0c3236646d715**** |
| Status |
string |
The current status of the certificate. Valid values:
|
good |
| RevokeTime |
integer |
The date when the certificate was revoked. This value is a UNIX timestamp in milliseconds. Note
This parameter is returned only when Status is revoked (indicating that the certificate has been revoked). |
1787539908871 |
Examples
Success response
JSON format
{
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
"CertificateStatus": [
{
"SerialNumber": "b67e53ebcea9b77d65b0c3236646d715****",
"Status": "good",
"RevokeTime": 1787539908871
}
]
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.