Learn about your container images with Gemini assistance
Stay organized with collections
Save and categorize content based on your preferences.
This document describes how you can use Gemini Cloud Assist to list
your Artifact Registry repositories and container images stored in
Docker-format repositories.
To get the permissions that
you need to list repositories and container images in Artifact Registry,
ask your administrator to grant you the
Artifact Registry Reader (roles/artifactregistry.reader)
IAM role on the project or repository.
For more information about granting roles, see Manage access to projects, folders, and organizations.
To open the Cloud Assist panel, click
sparkOpen or close Gemini AI chat.
To enter a prompt, type the prompt and click
sendSend prompt.
List repositories
You can prompt Gemini Cloud Assist to list repositories in the current project
and filter the response by the following:
Location (required). The location of the repositories you
want to list.
Labels (optional). Labels are key-value pairs that are used
to organize resources.
Tags (optional). Tags are used to group repositories and other
resources across Google Cloud for reporting, auditing, and access control
within your Google Cloud organization.
To list repositories, do the following:
In Gemini Cloud Assist chat, enter the following prompt:
List repositories in the location LOCATION
Replace LOCATION with the location of your
repositories—for example, us-west1.
For example, the following prompt asks Gemini Cloud Assist
to list repositories in the region us-west1 that have the label
env:dev:
List repositories for us-west1 with the label env:dev
The response includes a list of repositories in the specified location
that have the label env:dev.
List container images
You can prompt Gemini Cloud Assist to list container images in a
Docker format repository in the current project, and filter
the response by the following:
Repository ID (required). The repository ID.
Location (required). The location of the repository you want to list
images from.
Labels (optional). Labels are key-value pairs that are used
to organize resources.
Docker tags (optional). Docker tags are used when you
push or pull an image to a repository to specify the version of an image.
To list your images in a repository, do the following:
In Gemini Cloud Assist chat, enter the following prompt:
List my images for REPOSITORY in LOCATION with the tag TAG
Replace the following:
REPOSITORY: the repository ID
LOCATION: the location of the
repository—for example, us-west1
TAG: a Docker tag—for example, latest
The response includes a list of images that have the specified tag,
repository, and location.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eGemini Cloud Assist allows users to list Artifact Registry repositories and container images stored in Docker-format repositories.\u003c/p\u003e\n"],["\u003cp\u003eTo list repositories, users can prompt Gemini Cloud Assist by specifying the location, and optionally, labels and tags to filter the results.\u003c/p\u003e\n"],["\u003cp\u003eTo list container images, users need to provide the repository ID and location, and can optionally use labels and Docker tags for filtering.\u003c/p\u003e\n"],["\u003cp\u003eBefore using Gemini Cloud Assist, users need to ensure that their Google Cloud project is within an organization, that Gemini Cloud Assist is set up for their account and project, and that they have the necessary IAM permissions.\u003c/p\u003e\n"],["\u003cp\u003eGemini Cloud Assist is a pre-GA feature, available "as is," and its output should be validated as it may sometimes be factually incorrect.\u003c/p\u003e\n"]]],[],null,["# Learn about your container images with Gemini assistance\n\n| **Preview\n| --- [Gemini Cloud Assist](/gemini/docs/cloud-assist/overview)**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis document describes how you can use Gemini Cloud Assist to list\nyour Artifact Registry repositories and container images stored in\nDocker-format repositories.\n\nLearn [how and when Gemini\nfor Google Cloud uses your data](/gemini/docs/discover/data-governance).\n\nLimitations\n-----------\n\nYour Google Cloud project must be created in an [organization](/resource-manager/docs/cloud-platform-resource-hierarchy#organizations).\n\nBefore you begin\n----------------\n\n1. In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n2. If you don't have any container images stored in an Artifact Registry repository, then follow the instructions in [Store Docker container images in Artifact Registry](/artifact-registry/docs/docker/store-docker-container-images).\n3. [Ensure that\n Gemini Cloud Assist is set up for your Google Cloud user\n account and project](/gemini/docs/cloud-assist/set-up-gemini).\n4. Ensure that you have the [necessary Identity and Access Management (IAM) permissions](#required-roles) to complete the tasks in this document.\n\n### Required roles\n\n\nTo get the permissions that\nyou need to list repositories and container images in Artifact Registry,\n\nask your administrator to grant you the\n\n\n[Artifact Registry Reader](/iam/docs/roles-permissions/artifactregistry#artifactregistry.reader) (`roles/artifactregistry.reader`)\nIAM role on the project or 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\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nOpen Gemini Cloud Assist chat\n-----------------------------\n\n| As an early-stage technology, Gemini for Google Cloud\n| products can generate output that seems plausible but is factually incorrect. We recommend that you\n| validate all output from Gemini for Google Cloud products before you use it.\n| For more information, see\n| [Gemini for Google Cloud and responsible AI](/gemini/docs/discover/responsible-ai).\n\nYou can open the **Cloud Assist** panel to use Gemini Cloud Assist chat\nfrom anywhere in the Google Cloud console.\n\n1. In the Google Cloud console, select a project where you have container images stored in Artifact Registry. \n\n[Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard) \n- To open the **Cloud Assist** panel, click spark **Open or close Gemini AI chat**.\n2. To enter a prompt, type the prompt and click send **Send prompt**.\n\n\u003cbr /\u003e\n\nList repositories\n-----------------\n\nYou can prompt Gemini Cloud Assist to list repositories in the current project\nand filter the response by the following:\n\n- **Location** (required). The [location](/artifact-registry/docs/repositories/repo-locations) of the repositories you want to list.\n- **Labels** (optional). [Labels](/artifact-registry/docs/repositories/label-repos) are key-value pairs that are used to organize resources.\n- **Tags** (optional). [Tags](/artifact-registry/docs/repositories/tag-repos) are used to group repositories and other resources across Google Cloud for reporting, auditing, and access control within your Google Cloud organization.\n\nTo list repositories, do the following:\n\n- In **Gemini Cloud Assist** chat, enter the following prompt:\n\n List repositories in the location \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e with the location of your\n repositories---for example, `us-west1`.\n\n For example, the following prompt asks Gemini Cloud Assist\n to list repositories in the region `us-west1` that have the label\n `env:dev`: \n\n List repositories for us-west1 with the label env:dev\n\n The response includes a list of repositories in the specified location\n that have the label `env:dev`.\n\nList container images\n---------------------\n\nYou can prompt Gemini Cloud Assist to list container images in a\nDocker [format](/artifact-registry/docs/supported-formats) repository in the current project, and filter\nthe response by the following:\n\n- **Repository ID** (required). The repository ID.\n- **Location** (required). The location of the repository you want to list images from.\n- **Labels** (optional). [Labels](/artifact-registry/docs/repositories/label-repos) are key-value pairs that are used to organize resources.\n- **Docker tags** (optional). [Docker tags](/artifact-registry/docs/container-concepts#tags) are used when you push or pull an image to a repository to specify the version of an image.\n\nTo list your images in a repository, do the following:\n\n- In **Gemini Cloud Assist** chat, enter the following prompt:\n\n List my images for \u003cvar translate=\"no\"\u003eREPOSITORY\u003c/var\u003e in \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e with the tag \u003cvar translate=\"no\"\u003eTAG\u003c/var\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eREPOSITORY\u003c/var\u003e: the repository ID\n - \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the location of the repository---for example, `us-west1`\n - \u003cvar translate=\"no\"\u003eTAG\u003c/var\u003e: a Docker tag---for example, `latest`\n\n The response includes a list of images that have the specified tag,\n repository, and location.\n\nWhat's next\n-----------\n\n- Learn more about [Gemini Cloud Assist](/gemini/docs/cloud-assist/overview)."]]
