v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Container Registry

List Garbage Collections

To get information about past garbage collections for a registry, send a GET request to /v2/registry/$REGISTRY_NAME/garbage-collections.

get/v2/registry/{registry_name}/garbage-collections

Path parameters

registry_namestring required

The name of a container registry.

Query parameters

per_pageinteger

Number of items returned per page

pageinteger

Which 'page' of paginated results to return.

Response

The response will be a JSON object with a key of garbage_collections. This will be set to an array containing objects representing each past garbage collection. Each will contain the standard Garbage Collection attributes.

Example response

{
  "garbage_collections": [
    {
      "uuid": "eff0feee-49c7-4e8f-ba5c-a320c109c8a8",
      "registry_name": "example",
      "status": "requested",
      "created_at": "2020-10-30T21:03:24Z",
      "updated_at": "2020-10-30T21:03:44Z",
      "blobs_deleted": 42,
      "freed_bytes": 667
    }
  ]
}