ListCert
Retrieves a list of certificates.
Operation description
This operation queries a list of certificates. If you need to query certificates issued by a specific intermediate CA but do not have the unique identifier of the CA certificate, you can first call DescribeCACertificateList to query the identifier and pass the returned Identifier as ParentIdentifier.
QPS limits
The QPS limit per user is 10 calls per second. If the limit is exceeded, API calls are throttled, which may affect your services. Make API calls at a reasonable rate.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
yundun-cert:ListCert |
list |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceUuid |
string |
No |
The UUID of the instance. |
1ef79512-569b-6a4e-9105-9b91473562f7 |
| BeforeDate |
string |
No |
The modification time of the certificate (YYYY-MM-DD). |
2025-09-04 |
| AfterDate |
string |
No |
The host record bound to the certificate (YYYY-MM-DD). |
2024-05-13 |
| Status |
string |
No |
The status of the certificate. Valid values:
|
ISSUE |
| Type |
string |
No |
The type of the certificate. Valid values:
|
CLIENT |
| CurrentPage |
integer |
No |
The page number of the current page. |
1 |
| ShowSize |
integer |
No |
The total size of the certificate. Unit: bytes. |
50 |
| MaxResults |
integer |
No |
The maximum number of entries to return in this request. |
20 |
| NextToken |
string |
No |
The token used to start the next query. If NextToken is empty, no more results are available. |
1d2db86sca4384811e0b5e8707e68181f |
| ParentIdentifier |
string |
No |
The identifier of the intermediate CA that issued the certificate. You can call DescribeCACertificateList to query the unique identifier of the CA certificate. This parameter is actually required. If it is not provided, the API returns MissingParameter.CaIdentifier (400), where CaIdentifier corresponds to ParentIdentifier. You must first call DescribeCACertificateList to obtain the CA identifier and pass it as ParentIdentifier. |
273ae6bb538d538c70c01f81jh2**** |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
OpenApiResponse<PagedResultData |
||
| TotalCount |
integer |
The total number of certificates. |
10 |
| PageCount |
integer |
The total number of pages. |
1 |
| CurrentPage |
integer |
The current page number. |
1 |
| ShowSize |
integer |
The total size of the certificate. Unit: bytes. |
50 |
| List |
array<object> |
The ID of the data source to which the certificate belongs. |
|
|
object |
The certificate information. |
||
| Status |
string |
The status of the certificate. Valid values:
|
complete |
| AfterDate |
string |
The expiration time of the certificate (UTC/GMT). |
Mon Nov 05 16:33:52 CST 2035 |
| Organization |
string |
The organization of the certificate. |
test |
| KeyExportable |
boolean |
Specifies whether the certificate can be used. Valid values:
|
true |
| SubjectDn |
string |
The ID of the subscription relationship. |
SubjectDn |
| Algorithm |
string |
The algorithm type. |
RSA |
| CertificateType |
string |
The type of the certificate. Valid values:
|
Server |
| Identifier |
string |
The certificate identifier. |
1ef539a8-1e1f-6b88-8c11-21cf01a203e9 |
| SerialNumber |
string |
The certificate serial number. |
3a3ee3c3597d675e |
| Extra |
string |
The extended field. |
{"appId":"APP_PFHMIGUHKDUW6S3N7ZL2"} |
| OrganizationUnit |
string |
The name of the company or organization to which the user who purchased the certificate belongs. |
IT |
| BeforeTime |
integer |
The issuance time of the client certificate. The value is a timestamp. Default value: the time when you call this operation. Unit: milliseconds. Note
BeforeTime and AfterTime must be both empty or both specified. |
1728921600000 |
| AliasName |
string |
The name set for the issued certificate. |
test |
| AfterTime |
integer |
The service expiration time of the client certificate. The value is a timestamp. Unit: milliseconds. Note
BeforeTime and AfterTime must be both empty or both specified. |
1728921600000 |
| Id |
integer |
The ID of the data source to which the certificate order belongs. |
1806958 |
| Tags |
array |
The certificate tags. |
|
|
string |
The certificate tags. |
{"app-57074":"test"} |
|
| CommonName |
string |
The primary domain name bound to the certificate. |
www.kfsjn.xyz |
| BeforeDate |
string |
The issuance time of the certificate (UTC/GMT). |
Wed Nov 05 16:33:52 CST 2025 |
| CustomIdentifier |
string |
The custom identifier of the user, which is a unique key. |
***b86sca4384811e0b5e8707e68*** |
| RequestId |
string |
The request ID. |
15C66C7B-671A-4297-9187-2C4477247A74 |
| NextToken |
string |
The token used to start the next query. If NextToken is empty, no more results are available. |
1d2db86sca4384811e0b5e8707e68181f |
| MaxResults |
integer |
The maximum number of entries to return in this request. |
20 |
Examples
Success response
JSON format
{
"TotalCount": 10,
"PageCount": 1,
"CurrentPage": 1,
"ShowSize": 50,
"List": [
{
"Status": "complete",
"AfterDate": "Mon Nov 05 16:33:52 CST 2035",
"Organization": "test",
"KeyExportable": true,
"SubjectDn": "SubjectDn",
"Algorithm": "RSA",
"CertificateType": "Server",
"Identifier": "1ef539a8-1e1f-6b88-8c11-21cf01a203e9",
"SerialNumber": "3a3ee3c3597d675e",
"Extra": "{\"appId\":\"APP_PFHMIGUHKDUW6S3N7ZL2\"}",
"OrganizationUnit": "IT",
"BeforeTime": 1728921600000,
"AliasName": "test",
"AfterTime": 1728921600000,
"Id": 1806958,
"Tags": [
"{\"app-57074\":\"test\"}"
],
"CommonName": "www.kfsjn.xyz",
"BeforeDate": "Wed Nov 05 16:33:52 CST 2025",
"CustomIdentifier": "***b86sca4384811e0b5e8707e68***"
}
],
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
"NextToken": "1d2db86sca4384811e0b5e8707e68181f",
"MaxResults": 20
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.