Es posible que parte de la información de esta página (o toda) no se aplique a Trusted Cloud de S3NS.
Cómo ver y mostrar una lista de repositorios
En esta página, se describe cómo ver y enumerar repositorios de Artifact Registry.
Antes de comenzar
Opcional: Configura valores predeterminados para los comandos de Google Cloud CLI.
Roles obligatorios
Para obtener los permisos que
necesitas para ver y enumerar repositorios,
pídele a tu administrador que te otorgue los
siguientes roles de IAM:
Para obtener más información sobre cómo otorgar roles, consulta Administra 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 son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para ver y enumerar repositorios:
-
artifactregistry.repositories.get
-
artifactregistry.repositories.list
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Ve repositorios
Puedes ver los repositorios dentro de un proyecto Trusted Cloud .
Para ver una lista de repositorios, haz lo siguiente:
Console
Abre la página Repositorios en la consola de Trusted Cloud .
Abrir la página repositorios
En la página, se muestra una lista de tus repositorios.
Para filtrar la lista de repositorios de Artifact Registry, haz lo siguiente:
- Sobre la lista de repositorios, haz clic en Filtrar tabla.
- Elige un filtro de la lista.
- Especifica el valor que deseas usar para filtrar la lista.
gcloud
Para enumerar los repositorios existentes, ejecuta el siguiente comando:
gcloud artifacts repositories list [--project=PROJECT] \
[--location=LOCATION]
Para ver el tipo de encriptación configurado para un repositorio, ejecuta el siguiente comando:
gcloud artifacts repositories describe REPOSITORY \
[--project=PROJECT] [--location=LOCATION]
En los comandos anteriores, reemplaza los siguientes valores:
PROJECT es el ID del proyecto. Si se omite esta marca, se usa 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 en 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 usa la ubicación predeterminada, si se configuró una. De lo contrario, omitir esta marca enumera los repositorios de todas las ubicaciones.
Para obtener más información sobre el comando, ejecuta el siguiente comando:
gcloud artifacts repositories list --help
¿Qué sigue?
- Configura el acceso a tus repositorios.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-18 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-18 (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)."]]
