How to Retrieve Repository Details from Vultr Container Registry

Updated on March 20, 2025

A repository in the Vultr Container Registry stores container images pushed via OCI-compliant container engines like Docker or Podman. Each repository acts as a logical storage unit, organizing images under unique names for streamlined management and deployment. Retrieving repository details exposes metadata such as the repository name, description, and pull count, providing visibility into usage patterns and storage utilization.

Follow this guide to retrieve repository details from your container registry on your Vultr account using the Vultr Customer Portal, API or CLI.

  • Vultr Customer Portal
  • Vultr API
  • Vultr CLI
  1. Navigate to Products and click Container Registry.

  2. Click your target registry to open its management page.

  3. Click Repositories to view all the available repositories.

  4. Locate the target repository and retrieve its details, including the description, pull count, and artifact count.

  1. Send a GET request to the List Container Registries endpoint and note the target registry's ID.

    console
    $ curl "https://api.vultr.com/v2/registries" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    
  2. Send a GET request to the List Repositories endpoint to list all the available repositories and note the target repository image.

    console
    $ curl "https://api.vultr.com/v2/registry/{registry-id}/repositories" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    
  3. Send a GET request to the Read Repository endpoint to retrieve details of the target repository.

    console
    $ curl "https://api.vultr.com/v2/registry/{registry-id}/repository/{repository-image}" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    
  1. List all the available registries in your Vultr account and note the target registry's ID.

    console
    $ vultr-cli container-registry list
    
  2. List all the available repositories in your registry and note the target repository image.

    console
    $ vultr-cli container-registry repository list <registry-id>
    
  3. Retrieve details of the target repository.

    console
    $ vultr-cli container-registry get <registry-id> --image-name "<repository-image>"
    

Comments

No comments yet.