Query

List of images containing given package

Filterable query interface to search for images containing specified package

get/query/images/by_package

Query parameters

namestring required

Name of package to search for (e.g. sed)

package_typestring

Type of package to filter on (e.g. dpkg)

versionstring

Version of named package to filter on (e.g. 4.4-1)

pagestring

The page of results to fetch. Pages start at 1

limitinteger

Limit the number of records for the requested page. If omitted or set to 0, return all results in a single page

Headers

x-anchore-accountstring

An account name to change the resource scope of the request to that account, if permissions allow (admin only)

Response

Image listing

pagestring

The page number returned (should match the requested page query string param)

next_pagestring

True if additional pages exist (page + 1) or False if this is the last page

returned_countinteger

The number of items sent in this response

Example response

{
  "images": [
    {
      "image": {
        "tag_history": [
          {
            "registry": "registry",
            "detected_at": "2000-01-23T04:56:07.000+00:00",
            "pullstring": "pullstring",
            "tag": "tag",
            "repository": "repository"
          }
        ]
      }
    }
  ]
}

Changes

Changed in 3 of the 5 revisions of this API.17

Jul 17, 202638e5705e0b2112See the full diff
- ▲
  the allOf[PaginatedImageList_allOf]/ response's property type/format changed from / to object/ for status 200
  response-property-type-changed
- ○
  api tag Query added
  api-tag-added
- ○
  added the optional property allOf[PaginatedImageList_allOf]/images/items/packages/items/will_not_fix to the response with the 200 status
  response-optional-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Oct 4, 2019f0235c7ed0d52See the full diff
- ○
  added PaginatedImageList_allOf to the response body allOf list for the response status 200
  response-body-all-of-added
- ○
  removed subschema #2 from the response body allOf list for the response status 200
  response-body-all-of-removed
Oct 2, 201975f483ab10a03See the full diff
- ○
  api tag Query removed
  api-tag-removed
- ○
  added subschema #2 to the response body allOf list for the response status 200
  response-body-all-of-added
- ○
  removed PaginatedImageList_allOf from the response body allOf list for the response status 200
  response-body-all-of-removed
This revision also has 75 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history