For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

deprecated

Usage

client.registry.list_repository_tags(
    per_page=20,
    page=1,
    registry_name="example",
    repository_name="repo-1",
)

Description

Note: This endpoint is deprecated. Please use the /v2/registries endpoint instead.

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

per_page integer optional

Number of items returned per page

Min: 1

Max: 200

Default: 20

page integer optional

Which 'page' of paginated results to return.

Min: 1

Default: 1

registry_name string required

The name of a container registry.

repository_name string required

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")

Pagination

This method returns paginated results. The response includes a links.pages object with URLs for navigating between pages. To retrieve the next page, parse the next URL and pass the page parameter:

from urllib.parse import urlparse, parse_qs

resp = client.registry.list_repository_tags(registry_name="example", repository_name="repo-1", )
pages = resp.get("links", {}).get("pages", {})

while "next" in pages:
    parsed = urlparse(pages["next"])
    page = int(parse_qs(parsed.query)["page"][0])
    resp = client.registry.list_repository_tags(registry_name="example", repository_name="repo-1", page=page)
    pages = resp.get("links", {}).get("pages", {})

Response Example

{
  "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
  }
}

More Information

See /v2/registry/{registry_name}/repositories/{repository_name}/tags in the API reference for additional detail on responses, headers, parameters, and more.