/certificates-by-ca/{caCertificateId}

List the device certificates signed by the specified CA certificate.

Requires permission to access the ListCertificatesByCA action.

Request

Path Params

caCertificateId

string

required

The ID of the CA certificate. This operation will list all registered device certificate that were signed by this CA certificate.

Query Params

pageSize

integer

optional

The result page size.

marker

string

optional

The marker for the next set of results.

isAscendingOrder

string

optional

Specifies the order for results. If True, the results are returned in ascending order, based on the creation date.

Responses

🟢200Success

application/json

Body

The output of the ListCertificatesByCA operation.

certificates

array[object (Certificate) {5}]

optional

The device certificates signed by the specified CA certificate.

certificateArn

string

optional

The ARN of the certificate.

certificateId

string

optional

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

>= 64 characters<= 64 characters

Match pattern:

(0x)?[a-fA-F0-9]+

status

enum<string>

optional

The status of the certificate.

The status value REGISTER_INACTIVE is deprecated and should not be used.

Allowed values:

ACTIVEINACTIVEREVOKEDPENDING_TRANSFERREGISTER_INACTIVEPENDING_ACTIVATION

certificateMode

enum<string>

optional

The mode of the certificate.

Allowed values:

DEFAULTSNI_ONLY

creationDate

string <date-time>

optional

The date and time the certificate was created.

nextMarker

string

optional

The marker for the next set of results, or null if there are no additional results.

<= 1024 characters

Match pattern:

[A-Za-z0-9+/]+={0,2}

🟠480InvalidRequestException

🟠481ThrottlingException

🟠482UnauthorizedException

🟠483ServiceUnavailableException

🟠484InternalFailureException