Expand description

Generated Docker models

Structs

Address represents an IPv4 or IPv6 IP address.

BuildCache contains information about a build cache record.

ClusterInfo represents information about the swarm as is returned by the “/info” endpoint. Join-tokens are not included.

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.

change item in response to ContainerChanges operation

Configuration for a container that is portable between hosts.

Container created successfully

Configuration for a container that is portable between hosts.

ContainerState stores container’s running state. It’s part of ContainerJSONBase and will be returned by the “inspect” command.

A summary of the container’s network settings

The container has been updated.

A container’s resources (cgroups config, ulimits, etc)

container waiting error, if any

OK response to ContainerWait operation

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.

Driver represents a driver (network, logging, secrets).

EndpointIPAMConfig represents an endpoint’s IPAM configuration.

Configuration for a network endpoint.

Properties that can be configured to access and load balance a service.

EngineDescription provides information about an engine.

Represents an error.

Actor describes something that generates events, like a container, network, or a volume.

EventMessage represents the information an event contains.

Information about the storage driver used to store the container’s and image’s filesystem.

Health stores information about the container’s healthcheck results.

A test to perform to check that the container is healthy.

HealthcheckResult stores information about a single run of a healthcheck probe

individual image layer information in response to ImageHistory operation

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

Image ID or Digest

Information about an image in the local image cache.

Additional metadata of the image in the local cache. This information is local to the daemon, and not part of the image itself.

Information about the image’s RootFS, including the layer IDs.

IndexInfo contains information about a registry.

JoinTokens contains the tokens workers and managers need to join the swarm.

An object describing a limit on resources which can be requested by a task.

ManagerStatus represents the status of a manager.

Optional configuration for the bind type.

MountPoint represents a mount point configuration inside the container. This is used for reporting the mountpoints in use by a container.

Optional configuration for the tmpfs type.

Optional configuration for the volume type.

Specifies how a service should be attached to a particular network.

NetworkSettings exposes the network settings in the API

NetworkingConfig represents the container’s networking configuration for each of its interfaces. It is used for the networking configs specified in the docker create and docker network connect commands.

NodeDescription encapsulates the properties of the Node as reported by the agent.

NodeStatus represents the status of a node.

The version number of the object such as node, service, etc. This is needed to avoid conflicting writes. The client must send the version number along with the modified specification when updating these objects.

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.

Represents a peer-node in the swarm

Platform represents the platform (Arch/OS).

A plugin for the Engine API

The config of a plugin.

The interface between Docker and the plugin

Describes a permission the user has to accept upon installing the plugin.

Settings that can be modified by users.

Available plugins per type.

An open port on a container

PortBinding represents a binding between a host IP address and a host port.

RegistryServiceConfig stores 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)

The behavior to apply when the container exits. The default is not to restart.

Runtime describes an OCI compliant runtime.

User modifiable configuration for a service.

Scheduling mode for the service.

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 status of the service when it is in one of ReplicatedJob or GlobalJob modes. Absent on Replicated and Global mode services. The JobIteration is an ObjectVersion, but unlike the Service’s version, does not need to be sent with an update request.

The status of the service’s tasks. Provided only when requested as part of a ServiceList operation.

User modifiable configuration for a service.

Scheduling mode for the service.

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.

User modifiable configuration for a service.

Scheduling mode for the service.

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 status of a service update.

ClusterInfo represents information about the swarm as is returned by the “/info” endpoint. Join-tokens are not included.

Represents generic information about swarm.

User modifiable swarm configuration.

CA configuration.

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.

An identity token was generated successfully.

Response of Engine API: GET “/version”

User modifiable task configuration.

Container spec for the service.

File represents 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

CredentialSpec for managed service account (Windows only)

File represents a specific target that is backed by a file.

Specifies the log driver to use for tasks created from this spec. If not present, the default one for the swarm will be used, finally falling back to the engine default if not specified.

Read-only spec type for non-swarm containers attached to swarm overlay networks.

Plugin spec for the service. (Experimental release only.)

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.

Information about the issuer of leaf TLS certificates and the trusted root CA certificate.

Volume configuration

Summary volume data that matches the query

Usage details about the volume. This information is used by the GET /system/df endpoint, and omitted in other endpoints.

Enums

Cache record type.

String representation of the container state. Can be one of “created”, “running”, “paused”, “restarting”, “removing”, “exited”, or “dead”.

The mode in which port is published.

The mode of resolution to use for internal load balancing between tasks.

The type of object emitting the event

Scope of the event. Engine events are local scope. Cluster (Swarm) events are swarm scope.

Status is one of none, starting, healthy or unhealthy

cgroup namespace mode for the container. Possible values are:

Isolation technology of the container. (Windows only)

Represents a response chunk from Docker api when building, pulling or importing an image.

Current local status of this node.

A propagation mode with the value [r]private, [r]shared, or [r]slave.

The mount type:

The mount type. Available types:

Availability of the node.

Role of the node.

NodeState represents the state of a node.

Protocol to use for clients connecting to the plugin.

Reachability represents the reachability of a node.

  • Empty string means not to restart
  • no Do not automatically restart
  • always Always restart
  • unless-stopped Restart always except when the user has manually stopped the container
  • on-failure Restart only when the container exit code is non-zero
  • Action to take if an rolled back task fails to run, or stops running during the rollback.

    The order of operations when rolling back a task. Either the old task is shut down before the new task is started, or the new task is started before the old task is shut down.

    Action to take if an updated task fails to run, or stops running during the update.

    The order of operations when rolling out an updated task. Either the old task is shut down before the new task is started, or the new task is started before the old task is shut down.

    Action to take if an rolled back task fails to run, or stops running during the rollback.

    The order of operations when rolling back a task. Either the old task is shut down before the new task is started, or the new task is started before the old task is shut down.

    Action to take if an updated task fails to run, or stops running during the update.

    The order of operations when rolling out an updated task. Either the old task is shut down before the new task is started, or the new task is started before the old task is shut down.

    Action to take if an rolled back task fails to run, or stops running during the rollback.

    The order of operations when rolling back a task. Either the old task is shut down before the new task is started, or the new task is started before the old task is shut down.

    Action to take if an updated task fails to run, or stops running during the update.

    The order of operations when rolling out an updated task. Either the old task is shut down before the new task is started, or the new task is started before the old task is shut down.

    Protocol for communication with the external CA (currently only cfssl is supported).

    The driver to use for managing cgroups.

    The version of the cgroup.

    Represents the isolation technology to use as a default for containers. The supported values are platform-specific.

    Isolation technology of the containers running the service. (Windows only)

    The level at which the volume exists. Either global for cluster-wide, or local for machine level.

    Type Definitions

    The list of changes

    logs returned as a stream in response body. For the stream format, see the documentation for the attach endpoint. Note that unlike the attach endpoint, the logs endpoint does not upgrade the connection and does not set Content-Type.

    User-defined resources can be either Integer resources (e.g, SSD=3) or String resources (e.g, GPU=UUID1).

    Configuration for a container that is portable between hosts.

    The image was deleted successfully

    List of image layers

    Summary image data for the images matching the query

    PortMap describes the mapping of container ports to host ports, using the container’s port-number and protocol as key in the format <port>/<protocol>, for example, 80/udp.

    logs returned as a stream in response body

    User modifiable swarm configuration.

    logs returned as a stream in response body

    Volume configuration