/ 
API-Docker-0.004
/ API::Docker::Type::ImageHistoryResponseItem

NAME

API::Docker::Type::ImageHistoryResponseItem - individual image layer information in response to ImageHistory operation

VERSION

version 0.004

DESCRIPTION

Generated from the ImageHistoryResponseItem definition of spec/v1.51.yaml. The swagger describes none of the six fields, but the example response it gives for GET /images/{name}/history shows all six across three layers. That example is not the last word: measured against Podman 5.8.4 (API 1.44), a locally built image answers ten entries that contradict it on three of the six, so "id", "tags" and "comment" each say what the spec shows and what the engine sent.

id

Undocumented upstream. The swagger's example response spells this as a bare hex digest with no sha256: prefix. The engine does not. Measured against Podman 5.8.4 (API 1.44), a locally built image answers ten entries of which exactly one -- the image's own top layer -- carries a real sha256:... digest; the other nine carry the literal string sha256:<missing>, which is a marker and not an ID. Handing that to GET /images/{id}/json looks up nothing, so test for it before treating this field as a reference to anything. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.

created

Undocumented upstream. A Unix timestamp in seconds -- 1398108230 in the swagger's example response, the same form the spec spells out for "created" in API::Docker::Type::ImageSummary, and the form measured against Podman 5.8.4 (API 1.44), which answers 1787794246 for the top layer of a locally built image. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.

created_by

Undocumented upstream. What created the layer, "/bin/sh -c #(nop) ADD file:eb15... in /" in the swagger's example response. Measured against Podman 5.8.4 (API 1.44), one response mixes two forms: that "/bin/sh -c ..." shell wrapping on the older layers, and bare Dockerfile instructions on the ones a BuildKit build produced -- CMD ["perl5.40.5" "-de0"], WORKDIR /usr/src/app, COPY *.patch /usr/src/perl/ # buildkit. Do not parse it expecting either one. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.

tags

Undocumented upstream. The image names pointing at this layer, ["ubuntu:lucid", "ubuntu:10.04"] in the swagger's example response, which writes [] for a layer that has none. The engine writes null there instead: measured against Podman 5.8.4 (API 1.44), all ten entries of an untagged image answer null. An empty list is not what an absent tag looks like on the wire. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.

size

Undocumented upstream. The layer's size in bytes: 182964289 for the one that adds the root filesystem in the swagger's example response, 0 for the two that only carry metadata. Measured against Podman 5.8.4 (API 1.44), the ten entries of one locally built image run from 0 to 410969600, and 0 is not reserved for metadata layers -- a #(nop) COPY among them reports 4262912. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.

comment

Undocumented upstream. The message set when the layer was committed or imported, which is what "comment" in API::Docker::Type::ImageInspect describes for a whole image. The swagger's example response leaves it empty on two layers and gives "Imported from -" on the third. Measured against Podman 5.8.4 (API 1.44) it is always present, never absent, and where the layer has a provenance it carries that: on one locally built image, "buildkit.dockerfile.v0" on five entries, "debuerreotype 0.17" on the base layer, "FROM docker.io/library/perl:5.40-slim" on one more, and the empty string on the remaining three. The swagger lists this field as required; nothing here enforces that, see "since is documentation" in API::Docker::Type.

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.