pydo.registry.list_repository_tags()

Description

To list all tags in your container registry repository, send a GET request to /v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/tags.

Note that if your repository name contains / characters, it must be URL-encoded in the request URL. For example, to list tags for registry.digitalocean.com/example/my/repo, the path would be /v2/registry/example/repositories/my%2Frepo/tags.

Parameters

Name Type Required Description Default Value
per_page integer False Number of items returned per page 20
page integer False Which ‘page’ of paginated results to return. 1
registry_name string True The name of a container registry.
repository_name string True The name of a container registry repository. If the name contains / characters, they must be URL-encoded, e.g. %2F.

Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

resp = client.registry.list_repository_tags(registry_name="example", repository_name="repo01")

Responses

See the API spec for this endpoint to view additional detail on responses, headers, parameters, and more.

The response body will be a JSON object with a key of tags. This will be set to an array containing objects each representing a tag.

Click to expand an example response.
{
  "tags": [
    {
      "registry_name": "example",
      "repository": "repo-1",
      "tag": "latest",
      "manifest_digest": "sha256:cb8a924afdf0229ef7515d9e5b3024e23b3eb03ddbba287f4a19c6ac90b8d221",
      "compressed_size_bytes": 2803255,
      "size_bytes": 5861888,
      "updated_at": "2020-04-09T23:54:25Z"
    }
  ],
  "meta": {
    "total": 1
  }
}

Unauthorized

Click to expand an example response.
{
  "id": "unauthorized",
  "message": "Unable to authenticate you."
}

The resource was not found.

Click to expand an example response.
{
  "id": "not_found",
  "message": "The resource you requested could not be found."
}

API Rate limit exceeded

Click to expand an example response.
{
  "id": "too_many_requests",
  "message": "API Rate limit exceeded."
}

Server error.

Click to expand an example response.
{
  "id": "server_error",
  "message": "Unexpected server-side error"
}

Unexpected error

Click to expand an example response.
{
  "id": "example_error",
  "message": "some error message"
}