List images
GET {{baseUrl}}/images?offset=0&limit=50&name=ea ex pariatur velit tempor&repo=ea ex pariatur velit tempor&tag=ea ex pariatur velit tempor&hasMalware=false&score=54689830&scoreOperator=LT&os=ea ex pariatur velit tempor
Returns a paginated list of images. Use URL query parameters to filter the list.
Requires BASIC [16] user permissions. See Permissions.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
offset | number | The number of skipped records in the returned result set. Must be in the int32 format. | |
limit | number | The number of records to include in the result set. Must be in the int32 format. Default is 50. The maximum limit is 1,000. | |
name | string | The image name to filter on. Tenable.io returns only the images with names that exactly match the parameter value. The value is case-sensitive. | |
repo | string | The repository name to filter on. Tenable.io returns only the images from repositories that exactly match the parameter value. The value is case-sensitive. | |
tag | string | The tag to filter on. Tenable.io returns only the images with tags that exactly match the parameter value. The value is case-sensitive. | |
hasMalware | boolean | Specifies whether to return only the images with associated malware (images with the numberOfMalware attribute greater than 0). | |
score | number | The score to filter on. Tenable.io limits results based on the parameter value and the comparison operator specified by the scoreOperator parameter. For more information about the risk score metric, see Tenable.io Vulnerability Management User Guide. | |
scoreOperator | string | The comparison operator for the value specified by the score parameter. Operators include: |
- EQ—equals
- GT—greater than
- EQ—less than |
|
os
| string | | The operating system to filter on. Tenable.io returns only the images with an operating system that exactly matches the parameter value. |
RESPONSES
status: OK
{"items":[{"repoId":"2491620318530539587","repoName":"dmjb","name":"jboss","tag":"latest","digest":"sha256:f75748b2bbd5a386c8d876770ff09a65c42335fb1f538025b928c794ffa8123f","hasReport":false,"hasInventory":false,"status":"scan_failed","lastJobStatus":"failed","pullCount":"0","pushCount":"1","source":"pushed","createdAt":"2019-10-31T11:31:11.283Z","updatedAt":"2019-11-31T12:33:29.903Z","finishedAt":"2019-12-31T12:33:29.903Z","imageHash":"859c02589af7","size":"4471","layers":[{"size":133212385,"digest":"sha256:01e684a89bbea67a11fcc96caed8e8b3320c44e29c2ab2a85016f48a69870bc8"},{"size":32,"digest":"sha256:4f4fb700ef54461cfa02571ae0db9a0dc1e0cdb5577484a6d75e68dc38e8acc1"},{"size":32,"digest":"sha256:4f4fb700ef54461cfa02571ae0db9a0dc1e0cdb5577484a6d75e68dc38e8acc1"},{"size":32,"digest":"sha256:4f4fb700ef54461cfa02571ae0db9a0dc1e0cdb5577484a6d75e68dc38e8acc1"},{"size":32,"digest":"sha256:4f4fb700ef54461cfa02571ae0db9a0dc1e0cdb5577484a6d75e68dc38e8acc1"},{"size":3338,"digest":"sha256:ebdaef68b4f08d23189ae32fd90bd68261385549f46360d9c3d163b988d91a45"},{"size":250,"digest":"sha256:cc7ec6c68bd72324ab932dc00474d0713044542c2adf6bff6f4e4d1cacc70737"},{"size":510,"digest":"sha256:01bb3ac59edc6a05e14a5151cdc39eae261ff37a933118063d1f91bb14aaceb4"},{"size":7863072,"digest":"sha256:a248b0871c3cac9ce2b2a956e118ce03e49027d5d4c4da74df00ae399fff17c3"},{"size":681,"digest":"sha256:c9f371853f28eb40b76f309e27f671b57bffb8d80df4ca8e7970885ae532e172"},{"size":86733990,"digest":"sha256:2fe0df338fc0cc7d9ec4428ba7538f165f901f3a7760c7fecbdda11a435c5eee"},{"size":71511,"digest":"sha256:aa2f8df214335759614f9aceea51f570354944f59c36cc8399415bbfab91839e"},{"size":67494686,"digest":"sha256:23efb549476f5f10a40b3784758a807c0194d87a0b18c9a5a3436e67611e971b"},{"size":421,"digest":"sha256:1049dfc2ba444c2f74f3eb77a07d0fd5fe304d79ea7178d5a0885788696d63aa"},{"size":374,"digest":"sha256:ef072d3c9b418ba3ce624ce456d311bb81c9ae5d4d5bc682da5edadde408fce7"}],"os":"Unknown","osVersion":"Unknown"},{"repoId":"7185635748924628551","repoName":"elastic","name":"elasticsearch","tag":"5","digest":"sha256:0278ed727ad6dd0bef0be279b3112755a110980c31f07e7f4a54e19b9ca2e24a","hasReport":true,"hasInventory":false,"status":"scanned","lastJobStatus":"completed","score":10,"numberOfVulns":54,"numberOfMalware":0,"pullCount":"0","pushCount":"1","source":"on_prem_import","createdAt":"2018-12-31T17:51:03.295Z","updatedAt":"2019-11-31T10:48:02.857Z","finishedAt":"2019-12-31T10:48:02.857Z","imageHash":"5e9d896dc62c","size":"3460","layers":[],"os":"Debian","osVersion":"9.5"},{"repoId":"7185635748924628551","repoName":"postgres_db","name":"postgres","tag":"latest","digest":"sha256:0dec082064d1203a3ead704057de56823d2c8ae11818da0fd3065dee9ec1b92e","hasReport":true,"hasInventory":false,"status":"scanned","lastJobStatus":"completed","score":10,"numberOfVulns":46,"numberOfMalware":0,"pullCount":"0","pushCount":"1","source":"on_prem_import","createdAt":"2018-12-31T17:51:43.861Z","updatedAt":"2019-11-31T16:46:10.739Z","finishedAt":"2019-12-31T16:46:10.739Z","imageHash":"c230b2f564da","size":"3244","layers":[],"os":"Debian","osVersion":"9.6"}],"pagination":{"offset":0,"limit":1000,"total":138,"sort":[]}}