Moby Files

The first release of a Go module github.com/moby/moby/api dedicated for the Moby API making the old github.com/docker/docker/api package obsolete.

This release continues the 1.x line of API compatibility with the 52nd minor release of the 1.x API.

Changelog

• api/pkg/progress and api/pkg/streamformatter have been removed. [#51153]
• api/types/registry: EncodeAuthConfig: use empty string for zero value. [#50426]
• api/types/versions has moved to the client and daemon. [#51284]
• client/pkg/jsonmessage: remove deprecated ProgressMessage, ErrorMessage, DisplayJSONMessagesToStream and Stream interface. [#49264]
• events API now reports content-type as application/x-ndjson for newline-delimited JSON event stream. [#50953]
• GET /containers/json now includes a Health field describing container healthcheck status. [#50281]
• GET /events no longer includes the deprecated status, id, and from fields. These fields were removed in API v1.22, but still included in the response. These fields are now omitted when using API v1.52 or higher. [#50832]
• GET /images/{name}/get and POST /images/load now accept multiple platform query parameters, allowing export and load of images for multiple platforms. [#50166]
• GET /images/{name}/json now omits the following fields if their value is empty: Parent, Comment, DockerVersion, Author. [#51072]
• GET /images/{name}/json: omit empty Config fields when not set. [#50915]
• POST /images/{name:}/push: remove compatibility with API v1.4 auth-config in body. [#50371]
• Add progress aux emitter to build backend. [#50278]
• Add support for memory swappiness in Swarm services. [#51114]
• GET /services now returns SwapBytes and MemorySwappiness fields as part of the Resource requirements
• GET /services/{id} now returns SwapBytes and MemorySwappiness fields as part of the Resource requirements
• POST /services/create now accepts SwapBytes and MemorySwappiness fields as part of the Resource requirements
• POST /services/{id}/update now accepts SwapBytes and MemorySwappiness fields as part of the Resource requirements
• GET /tasks now returns SwapBytes and MemorySwappiness fields as part of the Resource requirements
• GET /tasks/{id} now returns SwapBytes and MemorySwappiness fields as part of the Resource requirements
• api/docs: add v1.52 swagger. [#50626]
• api/docs: fix events example response. [#50949]
• api/docs: remove links to docs.docker.com from changelog. [#51457]
• api/docs: sync swagger and update changelog. [#50980]
• api/docs: sync v1.52 docs with latest. [#50911]
• api/docs: sync v1.52 swagger with current version. [#50643]
• api/docs: update v1.52 docs with current swagger. [#50899]
• api/pkg/stdcopy: move stdWriter to daemon/internal. [#51157]
• api/templates: align with go-swagger v1.32.3. [#51168]
• api/types/build: move CachePruneOptions type to client.BuildCachePruneOptions. [#50772]
• api/types/build: move build options to client and backend. [#50907]
• api/types/build: remove deprecated BuildCache.Parent field. [#51185]
• api/types/checkpoint: move checkpoint options to client module. [#50905]
• api/types/container: OnBuild will now be omitted if its value is empty or zero. [#51154]
• api/types/container: add aliases for go-connections/nat types. [#50573]
• api/types/container: add missing type for exec-inspect response. [#50482]
• api/types/container: make ContainerState, HealthStatus concrete types. [#51439]
• api/types/container: make the container config MacAddress obsolete for v1.52 and onwards. Use network endpoint settings instead. [#51189]
• api/types/container: merge InspectResponse and ContainerJSONBase. [#50809]
• api/types/container: move ResizeOptions type to ContainerResizeOptions in the client. [#50773]
• api/types/container: move StatsResponseReader to client package. [#50521]
• api/types/container: move container options to client. [#50897]
• api/types/container: move ExecInspect type to client. [#50991]
• api/types/container: move StateStatus, NewStateStatus internal again. [#50495]
• api/types/container: remove deprecated ContainerTopOKBody alias. [#50400]
• api/types/container: remove deprecated ContainerUpdateOKBody alias. [#50400]
• api/types/container: remove deprecated Stats type. [#50492]
• api/types/container: remove deprecated Config.MacAddress. [#51194]
• api/types/container: remove deprecated ExecOptions.Detach. [#50959]
• api/types/container: rename Port to PortSummary. [#50711]
• api/types/container: StatsResponse: add OSType field. [#51305]
• api/types/container: StatsResponse: cleanup fields and GoDoc. [#51299]
• api/types/events: move ListOptions type to the client EventsListOptions. [#50774]
• api/types/filters: remove deprecated ToParamWithVersion. [#50561]
• api/types/image: InspectResponse: remove deprecated VirtualSize, Container, ContainerConfig, Parent, and DockerVersion fields. [#51103]
• api/types/image: move image options out to the client. [#50776]
• api/types/image: move LoadResponse to client. [#50909]
• api/types/image: remove deprecated Summary.VirtualSize field. [#51190]
• api/types/network: CreateRequest: remove deprecated CheckDuplicate field. [#50998]
• api/types/network: define ConnectRequest and DisconnectRequest. [#51324]
• api/types/network: EndpointSettings: make MacAddress "operational data". [#51203]
• api/types/network: modernize EndpointIPAMConfig.Copy, EndpointSettings.Copy. [#50690]
• api/types/network: move CreateOptions, ConnectOptions and DisconnectOptions to the client module. [#50817]
• api/types/network: move the ListOptions and InspectOptions types to the client. [#50786]
• api/types/plugin: change ListResponse to a non-pointer slice. [#51440]
• api/types/plugin: deprecate Config.DockerVersion field. [#51109]
• api/types/plugin: remove deprecated Config.DockerVersion. [#51458]
• api/types/registry: add some tests for encoding/decoding authconfig. [#50392]
• api/types/registry: DecodeAuthConfig: add early returns and improve errors. [#50425]
• api/types/registry: move SearchOptions to ImageSearchOptions in the client. [#50787]
• api/types/registry: moved ServiceConfig legacy field marshaling support into daemon backend. [#50826]
• api/types/registry: moved encode/decode auth config functions into reference utility package. [#50785]
• api/types/registry: remove deprecated ServiceConfig.AllowNondistributableArtifactsCIDRs and ServiceConfig.AllowNondistributableArtifactsHostnames fields. [#50375]
• api/types/registry: remove deprecated AuthConfig.Email field. [#51059]
• api/types/registry: rename AuthenticateOKBody to AuthResponse. [#51334]
• api/types/storage: add Storage type and integrate in container inspect. [#50857]
• api/types/strslice: deprecate StrSlice in favor of using a regular []string. [#50292]
• api/types/strslice: use slices.Equal. [#50608]
• api/types/swarm: add documentation to clarify virtual IP address type. [#51155]
• api/types/swarm: create types for enum-consts. [#51399]
• api/types/swarm: deprecated and dropped support for PortConfigProtocol; use network.IPProtocol instead. [#51094]
• api/types/swarm: move option types to the client module. [#50794]
• api/types/swarm: move the SecretListOptions type to the client module. [#50816]
• api/types/swarm: remove deprecated ServiceSpec.Networks field. [#51184]
• api/types/system: deprecated top level DiskUsage fields for type specific fields. [#51235]
• api/types/system: move DiskUsageOptions to the client. [#50788]
• api/types/system: move SecurityOpt and DecodeSecurityOptions to client module. [#50825]
• api/types/sytem: remove deprecated DiskUsage.BuilderSize. [#51180]
• api/types/volume: change ListResponse.Volumes to a non-pointer slice. [#51454]
• api/types/volume: move CreateOptions to client.VolumeCreateOptions. [#51211]
• api/types/volume: move the ListOptions type to the client module. [#50789]
• api/types/volume: moved UpdateOptions into client module. [#51205]
• api/types: daemon: move the disk usage structs to the backend server. [#50764]
• api/types: fix godoc. [#51261]
• api/types: fix Plugin.Config.Interface.Types Swagger definition. [#50519]
• api/types: move backend types to daemon/server. [#50534]
• api/types: move client.go contents into moby/moby/client. [#50510]
• api/types: move disk usage structs to per type packages. [#51406]
• api/types: move ErrorResponse to common/ErrorResponse. [#50632]
• api/types: move Ping and swarm.Status to client. [#51258]
• api/types: move plugin types to api/types/plugin. [#48114]
• api/types: move Version to api/types/system. [#51359]
• api/types: remove deprecated aliases. [#50452]
• api/types: remove PushResult type, and move internal. [#51357]
• api/types: use regular slices for disk usage types. [#51412]
• api: bump github.com/google/go-cmp v0.7.0. [#50723]
• api: deprecate NoBaseImageSpecifier const. This const is no longer used and will be removed in the next release. [#50437]
• API: Deprecation: the Engine was automatically backfilling empty PortBindings lists with a PortBinding with an empty HostIP and HostPort when starting a container. This behavior is deprecated for API 1.52, and will be dropped in API 1.53. [#50874]
• api: docs: sync v1.52 yaml. [#51095]
• api: docs: update v1.52 swagger with latest changes. [#50796]
• api: fix swarm network field from addr to prefix. [#51150]
• api: make GraphDriver field in image.InspectResponse optional. This field will continue to be emitted when using the legacy graph drivers and will be omitted when using the containerd image backend. [#50893]
• api: move "DiskUsage" related types to the right location. [#50518]
• api: move docs to api module. [#50491]
• api: redefine container network port types. [#50710]
• api: remove / internalize LegacyDiskUsage. [#51437]
• api: remove NoBaseImageSpecifier. [#50574]
• api: remove image inspect Parent, DockerVersion from swagger docs. [#51196]
• api: remove references to old module name. [#50474]
• api: remove unused DefaultVersion, MinSupportedAPIVersion consts. [#50587]
• api: update "interface{}" to "any". [#50609]
• apk/pkg/stdcopy: remove use of iota, improve docs, and add example. [#50612]
• cli/ is not in moby repo (anymore). [#50537]
• client, api: update go.mod to go1.24. [#51460]
• client: move ExecStartOptions, ExecAttachOptions, ExecOptions to client. [#50978]
• client: PluginListResult: change Items field to a non-pointer slice. [#51440]
• client: remove client.ContainerStatsResult.OSType field. [#51305]
• client: remove legacy CBC cipher suites from client config. [#50126]
• Copy the api/types/time package to internal client/daemon packages. [#50722]
• Create github.com/moby/moby/api and github.com/moby/moby/client module. [#50280]
• daemon: filter networks before converting to API types. [#50860]
• deprecate pkg/stdcopy, which was moved to api/stdcopy. [#50462]
• Deprecate field NetworkSettingsBase.Bridge, struct NetworkSettingsBase, all the fields of DefaultNetworkSettings, and struct DefaultNetworkSettings. [#50848]
• Dockerfile: update to go-swagger v0.33.1 (for go1.25). [#51167]
• docs: api: improve the docs of the outputs parameter. [#50338]
• fix: easiest revive rules. [#50262]
• GO SDK: api/types/system: remove deprecated Commit.Expected field. [#51127]
• Inspecting networks with API v1.52 and newer provides statistics about IPAM allocations for the subnets assigned to the network. [#50917]
• IP addresses and subnets are now of type netip.Addr and netip.Prefix, respectively. [#50956]
• MAC address fields are represented as byte slices compatible with the standard library net.HardwareAddr type instead of strings. [#51355]
• Move api server packages to daemon. [#50004]
• Move jsonmessage, streamformatter, and progress. [#50565]
• Prefer explicit device driver name over GPU capabilities when selecting the device driver with docker run --gpus. [#50717]
• Prepare release notes for api/v1.52.0-beta.0. [#50904]
• Prepare release notes for v1.52.0-alpha.0. [#50625]
• README: update, add badges. [#50665]
• remove deprecated types/plugins/logdriver and types/swarm/runtime packages; plugin-runtime spec is now exposed as types/swarm.RuntimeSpec and types/swarm.RuntimePrivilege. [#50554]
• Remove structs NetworkSettingsBase and DefaultNetworkSettings. Fields in NetworkSettingsBase that were not deprecated are now directly in NetworkSettings. [#50846]
• Remove support for deprecated kernel memory limit. [#50989]
• Rename disk usage API fields. [#51428]
• Revert "api/types/registry: EncodeAuthConfig: use empty string for zero value". [#50583]
• Swagger definitions for NetworkSummary and NetworkInspect have been added to the Swagger spec describing the Engine API. [#50855]
• the client now uses its own client.Filters type for filtering API requests, with a more ergonomic interface. Users of the github.com/docker/docker/api/types/filters package will need to refactor when they upgrade to the v29 client. [#51115]
• Types "github.com/moby/moby/api/types/network".Summary and "github.com/moby/moby/api/types/network".Inspect are no longer aliases, and most of their fields have been moved into an embedded struct. Engine API clients may require some source-level changes when migrating to the new github.com/moby/moby/api module. [#50878]
• Update API version to 1.52. [#50418]
• update github and pkg.go.dev links. [#50590]