Changes for version 0.005 - 2026-11-17
- API::Docker::Type::Network has a typed `status` accessor for the runtime IPAM usage the daemon reports on `GET /networks/{id}` (NetworkStatus, IPAMStatus, SubnetStatus). Before, the daemon's `Status` landed in `unknown_fields`. The fixture was captured from Docker 29.8.0 (API 1.56); Podman 5.8.4 (API 1.44) reports no `Status`, so `status` is undef there.
- maint/spec-overlay.yaml grafts named fields of a newer spec onto the v1.51 base model, together with the definitions they need. The generator, the drift checker and t/spec_to_type.t read the grafted model, and a grafted field carries the `since` of its spec. The overlay holds Network.Status from v1.55.
- maint/spec-to-type.pl takes the version it writes into the generated classes from lib/API/Docker.pm, and t/spec_to_type.t runs in a git worktree as well.
- A daemon that answers and closes before reading the request body leaves the calling process running: the request is written with SIGPIPE ignored and every write checked, the response the daemon sent is still read, so a 4xx arrives as `API::Docker::Error::HTTP`, and without a response the call croaks naming the endpoint.
Modules
Perl client for the Docker Engine API
Docker Engine Configs API
Docker Engine Containers API
Docker Engine Distribution API
Docker Engine Exec API
Docker Engine Images API
Docker Engine Networks API
Docker Engine Plugins API
Docker Engine Secrets API
Docker Engine System API
Docker Engine Volumes API
Removed in 0.004 -- replaced by API::Docker::Type::Config
Removed in 0.004 -- replaced by API::Docker::Type::ContainerSummary and ContainerInspectResponse
Error status returned by the Docker Engine on the status line
Failure reported inside a Docker Engine progress stream
Read timeout while waiting for the Docker Engine
The daemon closed before the response it announced was complete
Removed in 0.004 -- replaced by API::Docker::Type::ImageSummary and ImageInspect
Removed in 0.004 -- replaced by API::Docker::Type::Network
Removed in 0.004 -- replaced by API::Docker::Type::Plugin
The client reference an entity delegates through
Config operations, on the generated config type
Container operations, on the generated container types
Image operations, on the generated image types
Network operations, on the generated network type
Plugin operations, on the generated plugin type
Secret operations, on the generated secret type
Volume operations, on the generated volume type
The filters query parameter, normalised into the one shape the engine reads
HTTP transport role for Docker Engine API
coerce known boolean keys of a request body to JSON booleans
AuthConfig encoding shared by the registry-facing endpoints
Instance behaviour of a generated API::Docker::Type class
A resource class clone that bounds a run of calls
Removed in 0.004 -- replaced by API::Docker::Type::Secret
The DSL and attribute registry behind the generated Docker types
An IPv4 or IPv6 IP address
The body of a POST /auth request
Information about a build cache record
One event of the stream a POST /build answers with
Information about the swarm as is returned by the "/info" endpoint
Options and information specific to, and only present on, Swarm CSI cluster volumes
Information about the global status of the volume
One entry of ClusterVolume.PublishStatus
Cluster-specific options used to create the volume
Defines how the volume is used by tasks
Requirements for the accessible topology of the volume
The desired capacity that the volume should be created with
One cluster volume secret entry
Commit holds the Git-commit (SHA1) that a binary was built from, as reported in the version-string of external tools, such as containerd, or runC
One entry of the 200 response to GET /configs
The config-only network source to provide the configuration for this network
The body of a POST /configs/create request
Blkio stats entry
BlkioStats stores all IO service stats for data read and write
CPU related info of the container
All CPU stats aggregated since container inception
Configuration for a container that is portable between hosts
OK response to ContainerCreate operation
The body of the 200 response to GET /containers/{id}/json
Aggregates all memory stats since container inception on Linux
Aggregates the network stats of one container
PidsStats contains Linux-specific stats of a container's process-IDs (PIDs)
Container's running state
Statistics sample for a container
represents the status of a container
StorageStats is the disk I/O stats for read/write on Windows
One entry of the 200 response to GET /containers/json
Summary of host-specific runtime information of the container
Summary of the container's network settings
CPU throttling stats of the container
Container "top" response
Response for a successful container-update
container waiting error, if any
OK response to ContainerWait operation
Information for connecting to the containerd instance that is used by the daemon
The namespaces that the daemon uses for running containers and plugins in containerd
One event of the stream a POST /images/create answers with
A device that can be used by a container
A device mapping between the host and container
A request for devices to be sent to device drivers
Describes the result obtained from contacting the registry to retrieve image metadata
A driver (network, logging, secrets)
Information about the storage driver used to store the container's and image's filesystem
An endpoint's IPAM configuration
One entry of EndpointSpec.Ports
Configuration for a network endpoint
Properties that can be configured to access and load balance a service
EngineDescription provides information about an engine
One entry of EngineDescription.Plugins
The value of BuildInfo.errorDetail
Represents an error
Actor describes something that generates events, like a container, network, or a volume
The information an event contains
Change in the container's filesystem
Information about the daemon's firewalling configuration
User-defined resources can be either Integer resources (e.g, SSD=3) or String resources (e.g, GPU=UUID1)
An integer-valued user-defined resource
A string-valued user-defined resource
Information about the container's healthcheck results
A test to perform to check that the container is healthy
Information about a single run of a healthcheck probe
Container configuration that depends on the host we are running on
The logging configuration for this container
Response to an API call that returns just an Id
The IPAM field of the body of a POST /networks/create request
One entry of IPAM.Config
The value of NetworkStatus.IPAM
Configuration of the image
One entry of the 200 response to DELETE /images/{name}
individual image layer information in response to ImageHistory operation
Image ID or Digest
Information about an image in the local image cache
Additional metadata of the image in the local cache
Information about the image's RootFS, including the layer IDs
A summary of an image manifest
The image data for the attestation manifest
The image data for the image manifest
The unpacked size of an image manifest
The sizes of one manifest of an image
One entry of the 200 response to GET /images/json
Information about a registry
The tokens workers and managers need to join the swarm
An object describing a limit on resources which can be requested by a task
The status of a manager
One entry of a container's Mounts specification
Optional configuration for the bind type
Optional configuration for the image type
Optional configuration for the tmpfs type
Optional configuration for the volume type
The volume driver a mount's volume is to be created with
A mount point configuration inside the container
One entry of the 200 response to GET /networks
Specifies how a service should be attached to a particular network
One value of Network.Containers
OK response to NetworkCreate operation
NetworkSettings exposes the network settings in the API
provides runtime information about the network such as the number of allocated IPs
The container's networking configuration for each of its interfaces
One entry of the 200 response to GET /nodes
NodeDescription encapsulates the properties of the Node as reported by the agent
The body of a POST /nodes/{id}/update request
The status of a node
A descriptor struct containing digest, media type, and size, as defined in the OCI Content Descriptors Specification
Describes the platform which the image in the manifest runs on, as defined in the OCI Image Index Specification
The version number of the object such as node, service, etc
One peer of an overlay network
Represents a peer-node in the swarm
The platform (Arch/OS)
A plugin for the Engine API
The config of a plugin
The command-line arguments a plugin accepts
The interface between Docker and the plugin
The Linux-specific capabilities and devices a plugin needs
The network mode a plugin runs in
The root filesystem of a plugin
The user and group a plugin's process runs as
Settings that can be modified by users
One entry of Plugin.Config.Linux.Devices
One entry of Plugin.Config.Env
One entry of Plugin.Config.Interface.Types
One entry of Plugin.Config.Mounts
Describes a permission the user has to accept upon installing the plugin
Available plugins per type
An open port on a container
A binding between a host IP address and a host port
represents the port status of a task's host ports whose service has published host ports
The ProcessConfig field of the 200 response to GET /exec/{id}/json
The value of BuildInfo.progressDetail
One event of the stream a POST /images/{name}/push answers with
Daemon registry services configuration
An object describing the resources which can be advertised by a node and requested by a task
A container's resources (cgroups config, ulimits, etc)
A per-device block IO weight
One resource limit to set in a container
The behavior to apply when the container exits
An OCI compliant runtime
One entry of the 200 response to GET /secrets
The body of a POST /secrets/create request
One entry of the 200 response to GET /services
The resolved endpoint of a service
One entry of Service.Endpoint.VirtualIPs
The status of the service when it is in one of ReplicatedJob or GlobalJob modes
The status of the service's tasks
The status of a service update
contains the information returned to a client on the creation of a new service
User modifiable configuration for a service
Scheduling mode for the service
The replicated mode of a service, and its replica count
The mode used for services with a finite number of tasks that run to a completed state
Specification for the rollback strategy of the service
Specification for the update strategy of the service
The body of the 200 response to POST /services/{id}/update
One value of IPAMStatus.Subnets
The body of the 200 response to GET /swarm
Represents generic information about swarm
User modifiable swarm configuration
CA configuration
One entry of SwarmSpec.CAConfig.ExternalCAs
Dispatcher configuration
Parameters related to encryption-at-rest
Orchestration configuration
Raft configuration
Defaults for creating tasks in this cluster
The log driver to use for tasks created in the orchestrator if unspecified by a service
The body of the 200 response to GET /info
One entry of SystemInfo.DefaultAddressPools
Response of Engine API: GET "/version"
One entry of SystemVersion.Components
The name of the platform the daemon reports itself as
Information about the issuer of leaf TLS certificates and the trusted root CA certificate
One entry of the 200 response to GET /tasks
User modifiable task configuration
Container spec for the service
One entry of TaskSpec.ContainerSpec.Configs
A specific target that is backed by a file
Specification for DNS related configurations in resolver configuration file (resolv.conf)
Security options for the container
Options for configuring AppArmor on the container
CredentialSpec for managed service account (Windows only)
SELinux labels of the container
Options for configuring seccomp on the container
One entry of TaskSpec.ContainerSpec.Secrets
A specific target that is backed by a file
One entry of TaskSpec.ContainerSpec.Ulimits
Specifies the log driver to use for tasks created from this spec
Read-only spec type for non-swarm containers attached to swarm overlay networks
Where in the swarm a task may be scheduled
One scheduling preference of a task
The node attribute a task is spread over
Plugin spec for the service
Resource requirements which apply to each individual container created as part of the service
Specification for the restart policy which applies to containers created as part of this service
represents the status of a task
A per-device block IO rate limit
A map of topological domains to topological segments
The body of the 200 response to GET /volumes/{name}
Usage details about the volume
Volume configuration
Volume list response
Removed in 0.004 -- replaced by API::Docker::Type::Volume