[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-25。"],[[["\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)."]]