[][src]Module bollard::service

Service API: manage and inspect docker services within a swarm

Structs

Address

Address represents an IPv4 or IPv6 IP address.

AuthConfig
Body

Describes a permission accepted by the user upon installing the plugin.

Body1
Body2
Body3
BuildCache
BuildInfo
BuildPruneResponse
ClusterInfo

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

Commit

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.

Config
ConfigSpec
Container
Container1
ContainerChangeResponseItem

change item in response to ContainerChanges operation

ContainerConfig

Configuration for a container that is portable between hosts

ContainerCreateResponse

OK response to ContainerCreate operation

ContainerInspectResponse
ContainerPruneResponse
ContainerState

ContainerState stores container's running state. It's part of ContainerJSONBase and will be returned by the "inspect" command.

ContainerSummaryInner
ContainerSummaryInnerHostConfig
ContainerSummaryInnerNetworkSettings

A summary of the container's network settings

ContainerTopResponse

OK response to ContainerTop operation

ContainerUpdateResponse

OK response to ContainerUpdate operation

ContainerWaitResponse

OK response to ContainerWait operation

ContainerWaitResponseError

container waiting error, if any

CreateImageInfo
DeviceMapping

A device mapping between the host and container

DeviceRequest

A request for devices to be sent to device drivers

DistributionInspectResponse
DistributionInspectResponseDescriptor

A descriptor struct containing digest, media type, and size.

DistributionInspectResponsePlatforms
Driver

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

EndpointIpamConfig

EndpointIPAMConfig represents an endpoint's IPAM configuration.

EndpointPortConfig
EndpointSettings

Configuration for a network endpoint.

EndpointSpec

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

EngineDescription

EngineDescription provides information about an engine.

EngineDescriptionPlugins
ErrorDetail
ErrorResponse

Represents an error.

ExecConfig
ExecInspectResponse
ExecStartConfig
GenericResourcesInner
GenericResourcesInnerDiscreteResourceSpec
GenericResourcesInnerNamedResourceSpec
GraphDriverData

Information about a container's graph driver.

Health

Health stores information about the container's healthcheck results.

HealthConfig

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

HealthcheckResult

HealthcheckResult stores information about a single run of a healthcheck probe

HistoryResponseItem

individual image layer information in response to ImageHistory operation

HostConfig

Container configuration that depends on the host we are running on

HostConfigLogConfig

The logging configuration for this container

IdResponse

Response to an API call that returns just an Id

Image
ImageDeleteResponseItem
ImageId

Image ID or Digest

ImageMetadata
ImagePruneResponse
ImageRootFs
ImageSearchResponseItem
ImageSummary
IndexInfo

IndexInfo contains information about a registry.

InlineResponse400
InspectServiceOptions

Parameters used in the Inspect Service API

Ipam
JoinTokens

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

ListServicesOptions

Parameters used in the List Service API

ManagerStatus

ManagerStatus represents the status of a manager. It provides the current status of a node's manager component, if the node is a manager.

Mount
MountBindOptions

Optional configuration for the bind type.

MountPoint

A mount point inside a container

MountTmpfsOptions

Optional configuration for the tmpfs type.

MountVolumeOptions

Optional configuration for the volume type.

MountVolumeOptionsDriverConfig

Map of driver specific options

Network
NetworkAttachmentConfig

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

NetworkConfig
NetworkContainer
NetworkCreateResponse
NetworkPruneResponse
NetworkSettings

NetworkSettings exposes the network settings in the API

NetworkingConfig

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.

Node
NodeDescription

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

NodeSpec
NodeStatus

NodeStatus represents the status of a node. It provides the current status of the node, as seen by the manager.

ObjectVersion

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. This approach ensures safe concurrency and determinism in that the change on the object may not be applied if the version number has changed from the last read. In other words, if two update requests specify the same base version, only one of the requests can succeed. As a result, two separate update requests that happen at the same time will not unintentionally overwrite each other.

PeerNode

Represents a peer-node in the swarm

Platform

Platform represents the platform (Arch/OS).

Plugin

A plugin for the Engine API

PluginConfig

The config of a plugin.

PluginConfigArgs
PluginConfigInterface

The interface between Docker and the plugin

PluginConfigLinux
PluginConfigNetwork
PluginConfigRootfs
PluginConfigUser
PluginDevice
PluginEnv
PluginInterfaceType
PluginMount
PluginPrivilegeItem

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

PluginSettings

Settings that can be modified by users.

PluginsInfo

Available plugins per type.


> Note: Only unmanaged (V1) plugins are included in this list. > V1 plugins are "lazily" loaded, and are not returned in this list > if there is no resource using the plugin.

Port

An open port on a container

PortBinding

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

ProcessConfig
ProgressDetail
PushImageInfo
RegistryServiceConfig

RegistryServiceConfig stores daemon registry services configuration.

ResourceObject

An object describing the resources which can be advertised by a node and requested by a task.

Resources

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

ResourcesBlkioWeightDevice
ResourcesUlimits
RestartPolicy

The behavior to apply when the container exits. The default is not to restart. An ever increasing delay (double the previous delay, starting at 100ms) is added before each restart to prevent flooding the server.

Runtime

Runtime describes an OCI compliant runtime. The runtime is invoked by the daemon via the containerd daemon. OCI runtimes act as an interface to the Linux kernel namespaces, cgroups, and SELinux.

Secret
SecretSpec
Service
ServiceCreateResponse
ServiceEndpoint
ServiceEndpointVirtualIPs
ServiceSpec

User modifiable configuration for a service.

ServiceSpecMode

Scheduling mode for the service.

ServiceSpecModeReplicated
ServiceSpecRollbackConfig

Specification for the rollback strategy of the service.

ServiceSpecUpdateConfig

Specification for the update strategy of the service.

ServiceUpdateResponse
ServiceUpdateStatus

The status of a service update.

Swarm
SwarmInfo

Represents generic information about swarm.

SwarmSpec

User modifiable swarm configuration.

SwarmSpecCaConfig

CA configuration.

SwarmSpecCaConfigExternalCAs
SwarmSpecDispatcher

Dispatcher configuration.

SwarmSpecEncryptionConfig

Parameters related to encryption-at-rest.

SwarmSpecOrchestration

Orchestration configuration.

SwarmSpecRaft

Raft configuration.

SwarmSpecTaskDefaults

Defaults for creating tasks in this cluster.

SwarmSpecTaskDefaultsLogDriver

The log driver to use for tasks created in the orchestrator if unspecified by a service. Updating this value only affects new tasks. Existing tasks continue to use their previously configured log driver until recreated.

SystemAuthResponse
SystemDataUsageResponse
SystemEventsResponse
SystemEventsResponseActor
SystemInfo
SystemVersion

Response of Engine API: GET "/version"

SystemVersionComponents
SystemVersionPlatform
Task
TaskSpec

User modifiable task configuration.

TaskSpecContainerSpec

Container spec for the service.


> Note: ContainerSpec, NetworkAttachmentSpec, and PluginSpec are > mutually exclusive. PluginSpec is only used when the Runtime field > is set to plugin. NetworkAttachmentSpec is used when the Runtime > field is set to attachment.

TaskSpecContainerSpecConfigs
TaskSpecContainerSpecDnsConfig

Specification for DNS related configurations in resolver configuration file (resolv.conf).

TaskSpecContainerSpecFile

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

TaskSpecContainerSpecFile1

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


> Note: Configs.File and Configs.Runtime are mutually exclusive

TaskSpecContainerSpecPrivileges

Security options for the container

TaskSpecContainerSpecPrivilegesCredentialSpec

CredentialSpec for managed service account (Windows only)

TaskSpecContainerSpecPrivilegesSeLinuxContext

SELinux labels of the container

TaskSpecContainerSpecSecrets
TaskSpecLogDriver

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.

TaskSpecNetworkAttachmentSpec

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


> Note: ContainerSpec, NetworkAttachmentSpec, and PluginSpec are > mutually exclusive. PluginSpec is only used when the Runtime field > is set to plugin. NetworkAttachmentSpec is used when the Runtime > field is set to attachment.

TaskSpecPlacement
TaskSpecPlacementPreferences
TaskSpecPlacementSpread
TaskSpecPluginSpec

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


> Note: ContainerSpec, NetworkAttachmentSpec, and PluginSpec are > mutually exclusive. PluginSpec is only used when the Runtime field > is set to plugin. NetworkAttachmentSpec is used when the Runtime > field is set to attachment.

TaskSpecResources

Resource requirements which apply to each individual container created as part of the service.

TaskSpecRestartPolicy

Specification for the restart policy which applies to containers created as part of this service.

TaskStatus
TaskStatusContainerStatus
ThrottleDevice
TlsInfo

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

UnlockKeyResponse
UpdateServiceOptions

Parameters used in the Update Service API

Volume
VolumeConfig

Volume configuration

VolumeListResponse

Volume list response

VolumePruneResponse
VolumeUsageData

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

Enums

ContainerStateStatusEnum
EndpointPortConfigProtocolEnum
EndpointPortConfigPublishModeEnum
EndpointSpecModeEnum
HealthStatusEnum
HostConfigIsolationEnum
HostConfigLogConfigTypeEnum
LocalNodeState

Current local status of this node. Enumeration of values. Since this enum's variants do not hold data, we can easily define them them as #[repr(C)] which helps with FFI.

MountBindOptionsPropagationEnum
MountTypeEnum
NodeSpecAvailabilityEnum
NodeSpecRoleEnum
NodeState

NodeState represents the state of a node. Enumeration of values. Since this enum's variants do not hold data, we can easily define them them as #[repr(C)] which helps with FFI.

PluginConfigInterfaceProtocolSchemeEnum
PortTypeEnum
Reachability

Reachability represents the reachability of a node. Enumeration of values. Since this enum's variants do not hold data, we can easily define them them as #[repr(C)] which helps with FFI.

RestartPolicyNameEnum
ServiceSpecRollbackConfigFailureActionEnum
ServiceSpecRollbackConfigOrderEnum
ServiceSpecUpdateConfigFailureActionEnum
ServiceSpecUpdateConfigOrderEnum
ServiceUpdateStatusStateEnum
SwarmSpecCaConfigExternalCAsProtocolEnum
SystemInfoCgroupDriverEnum
SystemInfoIsolationEnum
TaskSpecContainerSpecIsolationEnum
TaskSpecRestartPolicyConditionEnum
TaskState

Enumeration of values. Since this enum's variants do not hold data, we can easily define them them as #[repr(C)] which helps with FFI.

VolumeScopeEnum

Type Definitions

ContainerSummary
GenericResources

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

PortMap

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. If a container's port is mapped for multiple protocols, separate entries are added to the mapping table.