NAME
API::Docker::Type::ImageInspect - Information about an image in the local image cache
VERSION
version 0.004
DESCRIPTION
Generated from the ImageInspect definition of spec/v1.51.yaml.
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.
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.
manifests
Manifests is a list of image 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.
Only available if the daemon provides a multi-platform image store and the manifests option is set in the inspect request.
WARNING: This is experimental and may change at any time without any backward compatibility. See API::Docker::Type::ImageManifestSummary.
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.
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.
parent
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.
> Deprecated: This field is only set when using the deprecated > legacy builder. It is included in API responses for informational > purposes, but should not be depended on as it will be omitted > once the legacy builder is removed.
comment
Optional message that was set when committing or importing the image.
created
Date and time at which the image was created, formatted in RFC 3339 format with nano-seconds.
This information is only available if present in the image, and omitted otherwise.
docker_version
The version of Docker that was used to build the image.
Depending on how the image was created, this field may be empty.
> Deprecated: This field is only set when using the deprecated > legacy builder. It is included in API responses for informational > purposes, but should not be depended on as it will be omitted > once the legacy builder is removed.
author
Name of the author that was specified when committing the image, or as specified through MAINTAINER (deprecated) in the Dockerfile.
config
Configuration of the image. See API::Docker::Type::ImageConfig.
architecture
Hardware CPU architecture that the image runs on.
variant
CPU architecture variant (presently ARM-only).
os
Operating System the image is built to run on.
os_version
Operating System version the image is built to run on (especially for Windows).
size
Total size of the image including all layers it is composed of.
graph_driver
Information about the storage driver used to store the container's and image's filesystem. See API::Docker::Type::DriverData.
root_fs
Information about the image's RootFS, including the layer IDs. See API::Docker::Type::ImageInspect::RootFS. Serialised as RootFS -- spelled out, because deriving it from the Perl name would produce RootFs.
metadata
Additional metadata of the image in the local cache. This information is local to the daemon, and not part of the image itself. See API::Docker::Type::ImageInspect::Metadata.
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.