Count images matching criteria

post

https://{full_url}/public/consec/api/v1/images/search/count

Retrieves the total count of images that match the specified search filter criteria.

Requires the permConSecViewApp Container Security permission. See Roles and Permissions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The search request parameters for querying container images. Use filters to narrow results by specific criteria, specify which fields to return for optimal performance, control result pagination with limit and next tokens, and sort results by desired properties.

fields

array of objects

An array of field names to include in the search results. Limiting fields to only those you need improves query performance and reduces response size. If omitted, all available fields are returned.

fields

filter

Specifies filter criteria to narrow the search results to images matching specific conditions.

limit

number

The maximum number of results to return in a single response. Use this to control page size for pagination. Typical values range from 50 to 500 depending on your performance requirements.

string | null

The pagination continuation token returned from a previous search response. Include this token to retrieve the next page of results. Omit this field or set to null for the first page.

sort

array of objects

An array of sorting criteria to order the results. Results are sorted by the first criterion, then by subsequent criteria as tiebreakers. Each sort specifies a field and whether to sort ascending or descending.

sort

Responses

400

Returned if the parameters in your request were invalid.

403

Returned if you do not have permission to perform this operation.

429

Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

200Returned if the count of images was retrieved successfully.