Export several images Run in API Explorer

GET /images/get

Get a tarball containing all images and metadata for several image repositories.

For each value of the names parameter: if it is a specific name and tag (e.g. ubuntu:latest), then only that image (and its parents) are returned; if it is an image ID, similarly only that image (and its parents) are returned and there would be no names referenced in the 'repositories' file for this image ID.

For details on the format, see the export image endpoint.

Query parameters

  • names array[string]

    Image names to filter by

  • platform string

    JSON encoded OCI platform describing a platform which will be used to select a platform-specific image to be saved if the image is multi-platform. If not provided, the full multi-platform image will be saved.

    Example: {"os": "linux", "architecture": "arm", "variant": "v5"}

Responses

  • 200 application/x-tar

    no error
  • 500 application/x-tar

    server error

    Hide response attribute Show response attribute object
    • message string Required

      The error message.
GET /images/get 
curl \
 --request GET 'http://api.example.com/v1.49/images/get'
Response examples (500) 
{
  "message": "Something went wrong."
}