Reference > PyDo > Library Reference > registry > list_repositories_v2()

Was this page helpful?

Give Feedback

pydo.registry.list_repositories_v2()

Generated on 25 November 2024 from pydo version v0.6.0

Description

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

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. Ignored when ‘page_token’ is provided.	1
`page_token`	string	False	Token to retrieve of the next or previous set of results more quickly than using ‘page’.
`registry_name`	string	True	The name of a container registry.

Request Sample

import os
from pydo import Client

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

resp = client.registry.list_repositories_v2(registry_name="example")

Responses

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

200
400
401
404
429
500
default

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

Click to expand an example response.

{
  "repositories": [
    {
      "registry_name": "example",
      "name": "repo-1",
      "tag_count": 57,
      "manifest_count": 82,
      "latest_manifest": {
        "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": 5
  },
  "links": {
    "pages": {
      "next": "https://api.digitalocean.com/v2/registry/example/repositoriesV2?page=2&page_token=JPZmZzZXQiOjB9&per_page=1",
      "last": "https://api.digitalocean.com/v2/registry/example/repositoriesV2?page=5&per_page=1"
    }
  }
}

Bad Request

Click to expand an example response.

{
  "id": "bad_request",
  "message": "error parsing request body",
  "request_id": "4851a473-1621-42ea-b2f9-5071c0ea8414"
}

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