diff options
author | Matej Marusak <mmarusak@redhat.com> | 2020-02-17 18:54:50 +0100 |
---|---|---|
committer | Matej Marusak <mmarusak@redhat.com> | 2020-02-17 18:54:50 +0100 |
commit | b6e0692466ef118bc1804729107fc6e0ddb2027a (patch) | |
tree | c8a9f4b8198745a77e0eb63b141ebde190b7653e | |
parent | d08e0c728f8c2bf2185265b35d8e7b6acfd221f0 (diff) | |
download | podman-b6e0692466ef118bc1804729107fc6e0ddb2027a.tar.gz podman-b6e0692466ef118bc1804729107fc6e0ddb2027a.tar.bz2 podman-b6e0692466ef118bc1804729107fc6e0ddb2027a.zip |
apiv2: Fixup /containers/json filters documentation
Mention what is the input format plus put literals into quotation marks
for better readability (plus it seems that some tags were not rendered).
Signed-off-by: Matej Marusak <mmarusak@redhat.com>
-rw-r--r-- | pkg/api/server/register_containers.go | 30 |
1 files changed, 15 insertions, 15 deletions
diff --git a/pkg/api/server/register_containers.go b/pkg/api/server/register_containers.go index b1facc27c..f014f5ddb 100644 --- a/pkg/api/server/register_containers.go +++ b/pkg/api/server/register_containers.go @@ -591,21 +591,21 @@ func (s *APIServer) RegisterContainersHandlers(r *mux.Router) error { // name: filters // type: string // description: | - // Returns a list of containers. - // - ancestor=(<image-name>[:<tag>], <image id>, or <image@digest>) - // - before=(<container id> or <container name>) - // - expose=(<port>[/<proto>]|<startport-endport>/[<proto>]) - // - exited=<int> containers with exit code of <int> - // - health=(starting|healthy|unhealthy|none) - // - id=<ID> a container's ID - // - is-task=(true|false) - // - label=key or label="key=value" of a container label - // - name=<name> a container's name - // - network=(<network id> or <network name>) - // - publish=(<port>[/<proto>]|<startport-endport>/[<proto>]) - // - since=(<container id> or <container name>) - // - status=(created|restarting|running|removing|paused|exited|dead) - // - volume=(<volume name> or <mount point destination>) + // A JSON encoded value of the filters (a `map[string][]string`) to process on the containers list. Available filters: + // - `ancestor`=(`<image-name>[:<tag>]`, `<image id>`, or `<image@digest>`) + // - `before`=(`<container id>` or `<container name>`) + // - `expose`=(`<port>[/<proto>]` or `<startport-endport>/[<proto>]`) + // - `exited=<int>` containers with exit code of `<int>` + // - `health`=(`starting`, `healthy`, `unhealthy` or `none`) + // - `id=<ID>` a container's ID + // - `is-task`=(`true` or `false`) + // - `label`=(`key` or `"key=value"`) of an container label + // - `name=<name>` a container's name + // - `network`=(`<network id>` or `<network name>`) + // - `publish`=(`<port>[/<proto>]` or `<startport-endport>/[<proto>]`) + // - `since`=(`<container id>` or `<container name>`) + // - `status`=(`created`, `restarting`, `running`, `removing`, `paused`, `exited` or `dead`) + // - `volume`=(`<volume name>` or `<mount point destination>`) // produces: // - application/json // responses: |