앱 삭제

이 페이지에서는 앱을 안전하게 삭제하기 위한 권장사항과 안내를 설명합니다.

앱 삭제 단계

다음 안내는 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. 앱 삭제: 영향을 확인한 후 앱 삭제 단계 섹션에 설명된 대로 앱을 삭제합니다.