Es posible que parte o toda la información de esta página no se aplique a Trusted Cloud by S3NS. Para obtener más información, consulta las
diferencias con Google Cloud.
Ver y enumerar repositorios
En esta página se describe cómo ver y enumerar repositorios de Artifact Registry.
Antes de empezar
Opcional: configura los valores predeterminados de los comandos de Google Cloud CLI.
Roles obligatorios
Para obtener los permisos que necesitas para ver y enumerar repositorios, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:
-
Para ver y enumerar todos los repositorios de un proyecto de Trusted Cloud by S3NS , haz lo siguiente:
Lector de Artifact Registry (
roles/artifactregistry.reader)
en el proyecto
-
Para ver un repositorio específico, sigue estos pasos:
Lector de Artifact Registry (
roles/artifactregistry.reader)
en el repositorio
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para ver y enumerar repositorios. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Se necesitan los siguientes permisos para ver y enumerar repositorios:
-
artifactregistry.repositories.get
-
artifactregistry.repositories.list
También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.
Ver repositorios
Puedes ver los repositorios de un Trusted Cloud proyecto.
Para ver una lista de repositorios, sigue estos pasos:
Consola
Abre la página Repositorios en la consola de Trusted Cloud .
Abre la página Repositorios.
En la página se muestra una lista de tus repositorios.
Para filtrar la lista de repositorios de Artifact Registry, sigue estos pasos:
- Encima de la lista de repositorios, haga clic en Filtrar tabla.
- Elige un filtro de la lista.
- Especifica el valor que quieras usar para filtrar la lista.
gcloud
Para ver una lista de los repositorios, ejecuta el siguiente comando:
gcloud artifacts repositories list [--project=PROJECT] \
[--location=LOCATION]
Para ver el tipo de cifrado configurado en un repositorio, ejecuta el siguiente comando:
gcloud artifacts repositories describe REPOSITORY \
[--project=PROJECT] [--location=LOCATION]
En los comandos anteriores, sustituye los siguientes valores:
PROJECT es el ID del proyecto. Si se omite esta marca, se usará el proyecto actual o predeterminado.REPOSITORY es el nombre del repositorio.
LOCATION es la ubicación regional del
repositorio.
Usa la marca --location para ver los repositorios de una ubicación específica.
También puedes usar --location=all para enumerar los repositorios de todas las ubicaciones.
Si omites esta marca, el comando usará la ubicación predeterminada
si se ha configurado una. De lo contrario, si se omite esta marca, se mostrarán los repositorios de todas las ubicaciones.
Para obtener más información sobre el comando, ejecuta el siguiente comando:
gcloud artifacts repositories list --help
Siguientes pasos
- Configura el acceso a tus repositorios.
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-21 (UTC).
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Me falta la información que necesito","missingTheInformationINeed","thumb-down"],["Es demasiado complicado o hay demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Está obsoleto","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema de muestras o código","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (UTC)."],[[["\u003cp\u003eThis page explains how to view and list Artifact Registry repositories within a Google Cloud project using the console or the gcloud command-line tool.\u003c/p\u003e\n"],["\u003cp\u003eTo view and list repositories, you need the Artifact Registry Reader role (\u003ccode\u003eroles/artifactregistry.reader\u003c/code\u003e) on the project or the specific repository, or equivalent permissions.\u003c/p\u003e\n"],["\u003cp\u003eThe console allows you to filter the repository list using various criteria, and the gcloud command enables listing repositories with optional filtering by project and location, or across all locations.\u003c/p\u003e\n"],["\u003cp\u003eThe gcloud command can also be used to view the encryption type of a specific repository.\u003c/p\u003e\n"],["\u003cp\u003eIt is possible to set a default project and location to be used with the gcloud command.\u003c/p\u003e\n"]]],[],null,["# View and list repositories\n\nThis page describes how to view and list Artifact Registry repositories.\n\nBefore you begin\n----------------\n\nOptional: [Configure defaults for Google Cloud CLI commands](/artifact-registry/docs/repositories/gcloud-defaults).\n\n### Required roles\n\n\nTo get the permissions that\nyou need to view and list repositories,\n\nask your administrator to grant you the\nfollowing IAM roles:\n\n- View and list all repositories in a Google Cloud project: [Artifact Registry Reader](/iam/docs/roles-permissions/artifactregistry#artifactregistry.reader) (`roles/artifactregistry.reader`) on the project\n- View a specific repository: [Artifact Registry Reader](/iam/docs/roles-permissions/artifactregistry#artifactregistry.reader) (`roles/artifactregistry.reader`) on the repository\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nThese predefined roles contain\n\nthe permissions required to view and list repositories. To see the exact permissions that are\nrequired, expand the **Required permissions** section:\n\n\n#### Required permissions\n\nThe following permissions are required to view and list repositories:\n\n- ` artifactregistry.repositories.get `\n- ` artifactregistry.repositories.list`\n\n\nYou might also be able to get\nthese permissions\nwith [custom roles](/iam/docs/creating-custom-roles) or\nother [predefined roles](/iam/docs/roles-overview#predefined).\n\nViewing repositories\n--------------------\n\nYou can view repositories within a Google Cloud project.\n\nTo view a list of repositories: \n\n### Console\n\nOpen the **Repositories** page in the Google Cloud console.\n\n\u003cbr /\u003e\n\n[Open the Repositories page](https://console.cloud.google.com/artifacts)\n\n\u003cbr /\u003e\n\nThe page displays a list of your repositories.\n\nTo filter the Artifact Registry repository list:\n\n1. Above the repository list, click **Filter Table**.\n2. Choose a filter from the filter list.\n3. Specify the value that you want to use for filtering the list.\n\n### gcloud\n\nTo list existing repositories, run the following command: \n\n```bash\ngcloud artifacts repositories list [--project=PROJECT] \\\n[--location=LOCATION]\n```\n\nTo view the type of encryption configured for a repository, run the following\ncommand: \n\n```bash\ngcloud artifacts repositories describe REPOSITORY \\\n[--project=PROJECT] [--location=LOCATION]\n```\n\nIn the previous commands, replace the following values:\n\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT\u003c/code\u003e\u003c/var\u003e is the project ID. If this flag is omitted, the current or default project is used.\n- \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eREPOSITORY\u003c/code\u003e\u003c/var\u003e is the name of the repository.\n-\n\n \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eLOCATION\u003c/code\u003e\u003c/var\u003e is the regional or multi-regional\n [location](/artifact-registry/docs/repo-locations) of the repository.\n\n\n Use the `--location` flag to view repositories in a specific location.\n You can also use `--location=all` to list repositories across all\n locations.\n\n If you omit this flag, the command uses the [default](/artifact-registry/docs/repositories/gcloud-defaults#set)\n location if a default is configured. Otherwise, omitting this flag lists\n repositories across all locations.\n\nFor more information about the command, run the following command: \n\n gcloud artifacts repositories list --help\n\nWhat's next\n-----------\n\n- Configure [access](/artifact-registry/docs/access-control) to your repositories.\n- [Download individual files](/artifact-registry/docs/repositories/download-files) within artifacts stored in your repositories.\n- Learn to [restrict artifact downloads with download rules](/artifact-registry/docs/restrict-artifact-downloads)."]]
