停用 Gemini Cloud Assist

注意：使用 Gemini Cloud Assist 的预览版产品受 Google Cloud 协议的约束，包括Google Cloud 服务专用条款中的非正式版产品使用条款，如 Gemini for Google Cloud 可信测试员计划条款的增补内容所述。

本页面介绍了如何停用 Gemini Cloud Assist。

如需了解如何更改控制与 Google 共享 Gemini Cloud Assist 提示和回答的设置，请参阅为 Gemini Cloud Assist 配置提示与回答共享功能。

准备工作

如需获得关闭 Gemini Cloud Assist 所需的权限，请让您的管理员为您授予项目的所有者或管理员基本角色（roles/owner 或 roles/admin）。

这两个角色都包含移除用户访问权限和停用服务所需的权限。

如需查看所需的确切权限，请展开所需权限部分：

所需权限

• resourcemanager.projects.getIamPolicy
• resourcemanager.projects.setIamPolicy
• serviceusage.services.disable
• 如果您打算使用 Google Cloud 控制台停用 Gemini Cloud Assist，还应拥有以下权限：
  • serviceusage.services.get
  • serviceusage.services.list

您可以使用其他预定义角色或自定义角色来获取这些权限。

停用 Gemini Cloud Assist

如需停用 Gemini Cloud Assist，请执行以下操作：

控制台

1. 如需限制组织中特定用户的访问权限，请为 Gemini Cloud Assist 移除 Identity and Access Management 权限：

   1. 前往 IAM 和管理页面。

      转到“IAM 和管理”

   2. 在主账号列中，找到要移除其对 Gemini Cloud Assist 的访问权限的主账号，然后在该行中点击 修改主账号。

   3. 在修改访问权限窗格中，执行以下操作：

      1. 找到 Gemini for Google Cloud User 角色，然后点击 删除角色。

      2. 找到 Gemini Cloud Assist User 角色，然后点击 删除角色。

         注意：根据您授予主账号访问 Gemini Cloud Assist 的时间，他们可能未被同时授予 Gemini for Google Cloud User 和 Gemini Cloud Assist User 两个角色。

      3. 找到 Service Usage Consumer 角色，然后点击 删除角色。

   4. 点击保存。

2. 停用 Gemini Cloud Assist API (geminicloudassist.googleapis.com)：

   1. 前往已启用的 API 和服务页面。

      前往“已启用的 API 和服务”

   2. 如需选择要停用 Gemini Cloud Assist API 的 Google Cloud 项目，请执行以下任一操作：

      • 在选择近期的项目部分中，点击Google Cloud 项目。

      • 使用选择一项资源对话框：

        1. 点击选择项目。
        2. 在选择项目对话框中，点击要停用 API 的Google Cloud 项目的名称。

   3. 点击 Gemini Cloud Assist API 条目。如果您在查找 API 时需要帮助，请使用 Google Cloud 控制台工具栏中的搜索字段。

   4. 点击 停用 API。

   注意：在某些情况下（例如，在 2025 年 4 月之前启用了 Gemini Cloud Assist 的项目），此 API 可能已被停用。

3. 可选：如果您要停用所有 Gemini for Google Cloud 产品，请重复上一步骤以停用 Gemini for Google Cloud API (cloudaicompanion.googleapis.com)。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. 如需限制组织中特定用户的访问权限，请为 Gemini Cloud Assist 移除 Identity and Access Management 权限：

   1. 使用命令 gcloud projects remove-iam-policy-binding 移除角色 roles/cloudaicompanion.user：

      gcloud projects remove-iam-policy-binding PROJECT_ID \
      --member=PRINCIPAL --role=roles/cloudaicompanion.user
      

      替换以下内容：

      • PROJECT_ID：您的Google Cloud 项目的 ID，例如 1234567890。
      • PRINCIPAL：主账号的标识符，例如 user:[e-mail]。

      输出是一个政策绑定列表。

      注意：根据您向主账号授予 Gemini Cloud Assist 访问权限的时间，他们可能未被授予 roles/cloudaicompanion.user 角色。

   2. 对以下角色重复上一步：

      • roles/geminicloudassist.user
      • roles/serviceusage.serviceUsageConsumer
      注意：根据您向主账号授予 Gemini Cloud Assist 访问权限的时间，他们可能未被授予 roles/geminicloudassist.user 角色。

3. 使用命令 gcloud services disable 停用 Gemini Cloud Assist API (geminicloudassist.googleapis.com)：

    gcloud services disable geminicloudassist.googleapis.com
   

   如果成功，该命令将生成类似于以下内容的输出：

    Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
    Operation finished successfully.
   

   注意：在某些情况下（例如，在 2025 年 4 月之前启用了 Gemini Cloud Assist 的项目），此 API 可能已被停用。

4. 可选：如果您要停用所有 Gemini for Google Cloud 产品，请重复上一步骤以停用 cloudaicompanion.googleapis.com API。

API

这些说明使用 cURL 来调用 API 方法。

1. 如需限制组织中特定用户的访问权限，请为 Gemini Cloud Assist 移除 Identity and Access Management 权限：

   1. 创建一个包含以下信息的 JSON 文件：

        {
          "options": {
            "requestedPolicyVersion": 3
          }
        }
      

   2. 使用 projects.getIamPolicy 方法检索项目的现有 IAM 政策：

        curl -X POST --data-binary @JSON_FILE_NAME \
          -H "Authorization: Bearer $(gcloud auth print-access-token)" \
          -H "Content-Type: application/json" \
          "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"
      

      替换以下内容：

      • JSON_FILE_NAME：您在上一步中创建的 JSON 文件的路径。

      • PROJECT_ID：项目的 ID。

      如果成功，响应会返回项目的 IAM 政策。

   3. 将项目的 IAM 政策复制到空的 JSON 文件中，然后移除您要限制其访问权限的用户。您应从以下字段的 members 字段中移除所有此类用户：

      • "role": "roles/cloudaicompanion.user”
      • "role": "roles/geminicloudassist.user”
      • "role": "roles/serviceusage.serviceUsageConsumer”

   4. 使用 projects.setIamPolicy 方法将更新后的 IAM 政策应用于项目：

        curl -X POST --data-binary @JSON_FILE_NAME \
          -H "Authorization: Bearer $(gcloud auth print-access-token)" \
          -H "Content-Type: application/json" \
          "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"
      

      替换以下内容：

      • JSON_FILE_NAME：您在上一步中创建的 JSON 文件的路径。

      • PROJECT_ID：项目的 ID。

      如果成功，响应会返回项目的更新后 IAM 政策。

2. 使用 services.disable 方法停用 Gemini Cloud Assist API (geminicloudassist.googleapis.com)：

   curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:disable"
   

   将 PROJECT_ID 替换为您要停用 Gemini Cloud Assist 的项目的 ID。

   如果命令成功，则会返回一个 long-running operation，其中包含 name 字段。您可以使用 name 字段中的值来检查操作的状态。

3. 可选：如果您要停用所有 Gemini for Google Cloud 产品，请重复上一步骤以停用 cloudaicompanion.googleapis.com API。