NAME

       skopeo-list-tags - List tags in the transport-specific image repository.

SYNOPSIS

       skopeo list-tags [options] repository-name

       Return a list of tags from repository-name in a registry.

       repository-name name of repository to retrieve tag listing from

OPTIONS

       --authfile path

       Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/containers/auth.json, which
       is set using skopeo login.
         If the authorization state is not found  there,  $HOME/.docker/config.json  is  checked,
       which is set using docker login.

       --creds username[:password] for accessing the registry.

       --cert-dir path

       Use certificates at path (*.crt, *.cert, *.key) to connect to the registry.

       --help, -h

       Print usage statement

       --no-creds bool-value

       Access the registry anonymously.

       --registry-token Bearer token

       Bearer token for accessing the registry.

       --retry-times

       The number of times to retry. Retry wait time will be exponentially increased based on the
       number of failed attempts.

       --tls-verify=bool

       Require HTTPS and verify certificates when talking to the  container  registry  or  daemon
       (defaults to true)

REPOSITORY NAMES

       Repository  names  are  transport-specific  references  as each transport may have its own
       concept of a "repository" and "tags". Currently, only the Docker transport is supported.

       This commands refers to repositories  using  a  transport:details  format.  The  following
       formats are supported:

       docker://docker-repository-reference
         A  repository  in a registry implementing the "Docker Registry HTTP API V2". By default,
       uses the authorization state in either $XDG_RUNTIME_DIR/containers/auth.json, which is set
       using    (skopeo    login).   If   the   authorization   state   is   not   found   there,
       $HOME/.docker/config.json is checked, which is set using (docker login).
         A docker-repository-reference is of the form: registryhost:port/repositoryname which  is
       similar to an image-reference but with no tag or digest allowed as the last component (e.g
       no :latest or @sha256:xyz)

                Examples of valid docker-repository-references:
                  "docker.io/myuser/myrepo"
                  "docker.io/nginx"
                  "docker.io/library/fedora"
                  "localhost:5000/myrepository"

                Examples of invalid references:
                  "docker.io/nginx:latest"
                  "docker.io/myuser/myimage:v1.0"
                  "docker.io/myuser/myimage@sha256:f48c4cc192f4c3c6a069cb5cca6d0a9e34d6076ba7c214fd0cc3ca60e0af76bb"

EXAMPLES

   Docker Transport
       To get the list of tags in the  "fedora"  repository  from  the  docker.io  registry  (the
       repository name expands to "library/fedora" per docker transport canonical form):

              $ skopeo list-tags docker://docker.io/fedora
              {
                  "Repository": "docker.io/library/fedora",
                  "Tags": [
                      "20",
                      "21",
                      "22",
                      "23",
                      "24",
                      "25",
                      "26-modular",
                      "26",
                      "27",
                      "28",
                      "29",
                      "30",
                      "31",
                      "32",
                      "branched",
                      "heisenbug",
                      "latest",
                      "modular",
                      "rawhide"
                  ]
              }

       To  list  the tags in a local host docker/distribution registry on port 5000, in this case
       for the "fedora" repository:

              $ skopeo list-tags docker://localhost:5000/fedora
              {
                  "Repository": "localhost:5000/fedora",
                  "Tags": [
                      "latest",
                      "30",
                      "31"
                  ]
              }

SEE ALSO

       skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)

AUTHORS

       Zach Hill zach@anchore.com ⟨mailto:zach@anchore.com⟩

                                                                            skopeo-list-tags(1)()