View and list repositories

This page describes how to view and list Artifact Registry repositories.

Before you begin

Optional: Configure defaults for Google Cloud CLI commands .

Required roles

To get the permissions that you need to view and list repositories, ask your administrator to grant you the following IAM roles:

View and list all repositories in a Google Cloud project: Artifact Registry Reader ( roles/artifactregistry.reader ) on the project
View a specific repository: Artifact Registry Reader ( roles/artifactregistry.reader ) on the repository

For more information about granting roles, see Manage access to projects, folders, and organizations .

These predefined roles contain the permissions required to view and list repositories. To see the exact permissions that are required, expand the Required permissionssection:

Required permissions

The following permissions are required to view and list repositories:

artifactregistry.repositories.get
artifactregistry.repositories.list

You might also be able to get these permissions with custom roles or other predefined roles .

Viewing repositories

You can view repositories within a Google Cloud project.

To view a list of repositories:

Console

Open the Repositoriespage in the Google Cloud console.

Open the Repositories page

The page displays a list of your repositories.

To filter the Artifact Registry repository list:

Above the repository list, click Filter Table.
Choose a filter from the filter list.
Specify the value that you want to use for filtering the list.

gcloud

To list existing repositories, run the following command:

gcloud  
artifacts  
repositories  
list  
 [ 
--project = 
 PROJECT 
 ] 
  
 \ 
 [ 
--location = 
 LOCATION 
 ]

To view the type of encryption configured for a repository, run the following command:

gcloud  
artifacts  
repositories  
describe  
 REPOSITORY 
  
 \ 
 [ 
--project = 
 PROJECT 
 ] 
  
 [ 
--location = 
 LOCATION 
 ]

In the previous commands, replace the following values:

PROJECT is the project ID. If this flag is omitted, the current or default project is used.
REPOSITORY is the name of the repository.
LOCATION is the regional or multi-regional location of the repository. Use the --location flag to view repositories in a specific location. You can also use --location=all to list repositories across all locations.

If you omit this flag, the command uses the default location if a default is configured. Otherwise, omitting this flag lists repositories across all locations.

For more information about the command, run the following command:

   
gcloud  
artifacts  
repositories  
list  
--help

What's next

Configure access to your repositories.
Download individual files within artifacts stored in your repositories.
Learn to restrict artifact downloads with download rules .