アプリを削除する

このページでは、アプリを安全に削除するためのベスト プラクティスと手順について説明します。

アプリを削除する手順

次の手順は、 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 のマルチリージョンの場合は 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. 既存のバインディングをすべて削除するには、リクエスト本文で bindings 配列を空にして setIamPolicy メソッドを使用します。

      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 のマルチリージョンの場合は 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. アプリを削除する: 影響を確認したら、アプリを削除する手順の説明に沿って、アプリの削除に進みます。