Reference > PyDo > Library Reference > registry > list_repository_manifests()

Was this page helpful?

Give Feedback

pydo.registry.list_repository_manifests()

Generated on 25 November 2024 from pydo version v0.6.0

Description

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

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

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_manifests(registry_name="example", repository_name="repo01")

Responses

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

200
401
404
429
500
default

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

Click to expand an example response.

{
  "manifests": [
    {
      "digest": "sha256:cb8a924afdf0229ef7515d9e5b3024e23b3eb03ddbba287f4a19c6ac90b8d221",
      "registry_name": "example",
      "repository": "repo-1",
      "compressed_size_bytes": 1972332,
      "size_bytes": 2816445,
      "updated_at": "2021-04-09T23:54:25Z",
      "tags": [
        "v1",
        "v2"
      ],
      "blobs": [
        {
          "digest": "sha256:14119a10abf4669e8cdbdff324a9f9605d99697215a0d21c360fe8dfa8471bab",
          "compressed_size_bytes": 1471
        },
        {
          "digest": "sha256:a0d0a0d46f8b52473982a3c466318f479767577551a53ffc9074c9fa7035982e",
          "compressed_size_byte": 2814446
        },
        {
          "digest": "sha256:69704ef328d05a9f806b6b8502915e6a0a4faa4d72018dc42343f511490daf8a",
          "compressed_size_bytes": 528
        }
      ]
    }
  ],
  "meta": {
    "total": 3
  },
  "links": {
    "pages": {
      "first": "https://api.digitalocean.com/v2/registry/example/repositories/repo-1/digests?page=1&per_page=1",
      "prev": "https://api.digitalocean.com/v2/registry/example/repositories/repo-1/digests?page=1&per_page=1",
      "next": "https://api.digitalocean.com/v2/registry/example/repositories/repo-1/digests?page=3&per_page=1",
      "last": "https://api.digitalocean.com/v2/registry/example/repositories/repo-1/digests?page=3&per_page=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"
}