NAME
API::Docker::Type::ImageSummary - One entry of the 200 response to GET /images/json
VERSION
version 0.004
DESCRIPTION
Generated from the ImageSummary definition of spec/v1.51.yaml, which the swagger leaves undescribed. paths: says what it is: one entry of the 200 response to GET /images/json and the Images field of the 200 response to GET /system/df.
id
ID is the content-addressable ID of an image.
This identifier is a content-addressable digest calculated from the image's configuration (which includes the digests of layers used by the image).
Note that this digest differs from the RepoDigests below, which holds digests of image manifests that reference the image. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.
parent_id
ID of the parent image.
Depending on how the image was created, this field may be empty and is only set for images that were built/created locally. This field is empty if the image was pulled from an image registry. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.
repo_tags
List of image names/tags in the local image cache that reference this image.
Multiple image tags can refer to the same image, and this list may be empty if no tags reference the image, in which case the image is "untagged", in which case it can still be referenced by its ID. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.
repo_digests
List of content-addressable digests of locally available image manifests that the image is referenced from. Multiple manifests can refer to the same image.
These digests are usually only available if the image was either pulled from a registry, or if the image was pushed to a registry, which is when the manifest is generated and its digest calculated. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.
created
Date and time at which the image was created as a Unix timestamp (number of seconds since EPOCH). The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.
size
Total size of the image including all layers it is composed of. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.
shared_size
Total size of image layers that are shared between this image and other images.
This size is not calculated by default. -1 indicates that the value has not been set / calculated. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.
labels
User-defined key/value metadata. The keys are the caller's data and are never translated. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.
containers
Number of containers using this image. Includes both stopped and running containers.
-1 indicates that the value has not been set / calculated. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.
manifests
Manifests is a list of manifests available in this image. It provides a more detailed view of the platform-specific image manifests or other image-attached data like build attestations.
WARNING: This is experimental and may change at any time without any backward compatibility. See API::Docker::Type::ImageManifestSummary.
descriptor
Descriptor is an OCI descriptor of the image target. In case of a multi-platform image, this descriptor points to the OCI index or a manifest list.
This field is only present if the daemon provides a multi-platform image store.
WARNING: This is experimental and may change at any time without any backward compatibility. See API::Docker::Type::OCIDescriptor.
SUPPORT
Issues
Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-api-docker/issues.
CONTRIBUTING
Contributions are welcome! Please fork the repository and submit a pull request.
AUTHOR
Torsten Raudssus <getty@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.