diff --git a/api/swagger.yaml b/api/swagger.yaml index edc774aa5d..bfefac25a4 100644 --- a/api/swagger.yaml +++ b/api/swagger.yaml @@ -2453,22 +2453,21 @@ paths: - name: "filters" in: "query" description: | - Filters to process on the container list, encoded as JSON (a `map[string][]string`). For example, `{"status": ["paused"]}` will only return paused containers. + Filters to process on the container list, encoded as JSON (a `map[string][]string`). For example, `{"status": ["paused"]}` will only return paused containers. Available filters: - Available filters: - - `exited=` containers with exit code of `` - - `status=`(`created`|`restarting`|`running`|`removing`|`paused`|`exited`|`dead`) - - `label=key` or `label="key=value"` of a container label - - `isolation=`(`default`|`process`|`hyperv`) (Windows daemon only) - - `id=` a container's ID - - `name=` a container's name - - `is-task=`(`true`|`false`) - `ancestor`=(`[:]`, ``, or ``) - `before`=(`` or ``) - - `since`=(`` or ``) - - `volume`=(`` or ``) - - `network`=(`` or ``) + - `exited=` containers with exit code of `` - `health`=(`starting`|`healthy`|`unhealthy`|`none`) + - `id=` a container's ID + - `isolation=`(`default`|`process`|`hyperv`) (Windows daemon only) + - `is-task=`(`true`|`false`) + - `label=key` or `label="key=value"` of a container label + - `name=` a container's name + - `network`=(`` or ``) + - `since`=(`` or ``) + - `status=`(`created`|`restarting`|`running`|`removing`|`paused`|`exited`|`dead`) + - `volume`=(`` or ``) type: "string" responses: 200: @@ -4272,14 +4271,13 @@ paths: - name: "filters" in: "query" description: | - A JSON encoded value of the filters (a `map[string][]string`) to process on the images list. + A JSON encoded value of the filters (a `map[string][]string`) to process on the images list. Available filters: - Available filters: + - `before`=(`[:]`, `` or ``) - `dangling=true` - `label=key` or `label="key=value"` of an image label - - `before`=(`[:]`, `` or ``) - - `since`=(`[:]`, `` or ``) - `reference`=(`[:]`) + - `since`=(`[:]`, `` or ``) type: "string" - name: "digests" in: "query" @@ -4853,9 +4851,9 @@ paths: description: | A JSON encoded value of the filters (a `map[string][]string`) to process on the images list. Available filters: - - `stars=` - `is-automated=(true|false)` - `is-official=(true|false)` + - `stars=` Matches images that has at least 'number' stars. type: "string" tags: ["Image"] /images/prune: @@ -4868,9 +4866,8 @@ paths: - name: "filters" in: "query" description: | - Filters to process on the prune list, encoded as JSON (a `map[string][]string`). + Filters to process on the prune list, encoded as JSON (a `map[string][]string`). Available filters: - Available filters: - `dangling=` When set to `true` (or `1`), prune only unused *and* untagged images. When set to `false` (or `0`), all unused images are pruned. @@ -5355,13 +5352,14 @@ paths: A JSON encoded value of filters (a `map[string][]string`) to process on the event list. Available filters: - `container=` container name or ID + - `daemon=` daemon name or ID - `event=` event type - `image=` image name or ID - `label=` image or container label + - `network=` network name or ID + - `plugin`= plugin name or ID - `type=` object to filter by, one of `container`, `image`, `volume`, `network`, or `daemon` - `volume=` volume name or ID - - `network=` network name or ID - - `daemon=` daemon name or ID type: "string" tags: ["System"] /system/df: @@ -5835,13 +5833,14 @@ paths: JSON encoded value of the filters (a `map[string][]string`) to process on the volumes list. Available filters: - - `name=` Matches all or part of a volume name. - `dangling=` When set to `true` (or `1`), returns all volumes that are not in use by a container. When set to `false` (or `0`), only volumes that are in use by one or more containers are returned. - - `driver=` Matches all or part of a volume - driver name. + - `driver=` Matches volumes based on their driver. + - `label=` or `label=:` Matches volumes based on + the presence of a `label` alone or a `label` and a value. + - `name=` Matches all or part of a volume name. type: "string" format: "json" tags: ["Volume"] @@ -7200,8 +7199,8 @@ paths: A JSON encoded value of the filters (a `map[string][]string`) to process on the services list. Available filters: - `id=` - - `name=` - `label=` + - `name=` tags: ["Service"] /services/create: post: @@ -7664,12 +7663,12 @@ paths: description: | A JSON encoded value of the filters (a `map[string][]string`) to process on the tasks list. Available filters: - - `id=` - - `name=` - - `service=` - - `node=` - - `label=key` or `label="key=value"` - `desired-state=(running | shutdown | accepted)` + - `id=` + - `label=key` or `label="key=value"` + - `name=` + - `node=` + - `service=` tags: ["Task"] /tasks/{id}: get: diff --git a/docs/reference/commandline/events.md b/docs/reference/commandline/events.md index b670d81fe2..71f07fc124 100644 --- a/docs/reference/commandline/events.md +++ b/docs/reference/commandline/events.md @@ -82,14 +82,14 @@ container container 588a23dac085 *AND* the event type is *start* The currently supported filters are: * container (`container=`) +* daemon (`daemon=`) * event (`event=`) * image (`image=`) -* plugin (experimental) (`plugin=`) * label (`label=` or `label==`) +* network (`network=`) +* plugin (`plugin=`) * type (`type=`) * volume (`volume=`) -* network (`network=`) -* daemon (`daemon=`) ## Format diff --git a/docs/reference/commandline/ps.md b/docs/reference/commandline/ps.md index 1d5f31da88..164e36433c 100644 --- a/docs/reference/commandline/ps.md +++ b/docs/reference/commandline/ps.md @@ -23,17 +23,20 @@ List containers Options: -a, --all Show all containers (default shows just running) -f, --filter value Filter output based on conditions provided (default []) - - exited= an exit code of - - label= or label== - - status=(created|restarting|removing|running|paused|exited) - - name= a container's name - - id= a container's ID - - before=(|) - - since=(|) - ancestor=([:tag]||) containers created from an image or a descendant. - - is-task=(true|false) + - before=(|) + - exited= an exit code of - health=(starting|healthy|unhealthy|none) + - id= a container's ID + - isolation=(`default`|`process`|`hyperv`) (Windows daemon only) + - is-task=(true|false) + - label= or label== + - name= a container's name + - network=(|) + - since=(|) + - status=(created|restarting|removing|running|paused|exited) + - volume=(|) --format string Pretty-print containers using a Go template --help Print usage -n, --last int Show n last created containers (includes all states) (default -1)