刪除應用程式

本頁說明安全刪除應用程式的最佳做法和操作說明。

刪除應用程式的步驟

以下操作說明適用於 Google Cloud 控制台。

控制台

如要刪除應用程式，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

   Gemini Enterprise

2. 找到要刪除的應用程式，然後依序按一下 和「刪除」。

3. 在「要刪除應用程式嗎？」對話方塊中輸入應用程式名稱，然後按一下「確認」。

刪除含有 IAM 政策的應用程式的最佳做法

應用程式刪除後即無法復原，因此，如果應用程式已設定存取權控管機制，您可以在刪除應用程式前，先從 IAM 政策中移除所有使用者。請按照下列步驟操作：

1. 清除 IAM 政策：刪除應用程式前，請先清除其 IAM 政策，移除使用者存取權。方法是設定空白的 bindings 陣列。

   1. 使用 getIamPolicy 方法，取得應用程式目前的 IAM 政策。

      REST

      重要用語：在 Gemini Enterprise 中，API 脈絡的「應用程式」一詞可與「引擎」互換使用。Gemini Enterprise 引擎是通用搜尋引擎，其中 app_type 欄位設為 APP_TYPE_INTRANET。

      curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID:getIamPolicy"
      

      更改下列內容：

      • PROJECT_ID：專案的 ID。
      • ENDPOINT_LOCATION：API 要求適用的多區域。請指定下列其中一個值：
        • us 適用於美國多區域
        • eu 代表歐盟多區域
        • global 適用於全域位置
        詳情請參閱「為資料儲存庫指定多區域」。
      • LOCATION：資料儲存庫的多區域：global、us 或 eu
      • APP_ID：要設定的應用程式 ID。

      注意： 請從回應中複製 etag 值。更新 IAM 政策時，必須提供這個值。etag 值會隨著每次政策更新而變更。

      指令與結果範例

      curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      "https://global-discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app:getIamPolicy"
      
      {
        "version": 1,
        "etag": "1234567890"
      }
        

   2. 如要移除所有現有繫結，請使用 setIamPolicy 方法，並在要求主體中加入空白的 bindings 陣列。

      REST

      重要用語：在 Gemini Enterprise 中，API 脈絡的「應用程式」一詞可與「引擎」互換使用。Gemini Enterprise 引擎是通用搜尋引擎，其中 app_type 欄位設為 APP_TYPE_INTRANET。

      curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
            "policy": {
              "etag": "ETAG",
              "bindings": []
            }
          }' \
      "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID:setIamPolicy"
      

      更改下列內容：

      • ETAG：使用 getIamPolicy 方法時，您在回應中取得的 etag 值。
      • PROJECT_ID：專案的 ID。
      • ENDPOINT_LOCATION：API 要求適用的多區域。請指定下列其中一個值：
        • us 適用於美國多區域
        • eu 代表歐盟多區域
        • global 適用於全域位置
        詳情請參閱「為資料儲存庫指定多區域」。
      • LOCATION：資料儲存庫的多區域：global、us 或 eu
      • APP_ID：要設定的應用程式 ID。

      指令與結果範例

      curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
            "policy": {
              "etag": "1234567890",
              "bindings": []
            }
          }' \
      "https://global-discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app:setIamPolicy"
      
      {
        "version": 1,
        "etag": "3456789012"
      }
        

2. 確認對使用者的影響：清除政策並等待傳播時間過後，請確認存取權撤銷作業是否對使用者造成任何非預期問題。

3. 刪除應用程式：確認影響後，請按照「刪除應用程式的步驟」一節的說明刪除應用程式。