앱 삭제

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

앱을 삭제하는 단계

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