This page describes how to view and list Artifact Registry repositories.
Before you begin
- (Optional) Configure defaults for gcloud 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 permissions section:
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 Repositories page in the Google Cloud console.
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 these 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 a regional or multi-regional location. Use this 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.