איך מוחקים אפליקציה?

בדף הזה מפורטות שיטות מומלצות והוראות למחיקת אפליקציה באופן בטוח.

שלבים למחיקת אפליקציה

ההוראות הבאות מיועדות למסוף Google Cloud .

המסוף

כדי למחוק אפליקציה:

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   ‫Gemini Enterprise

2. באפליקציה שרוצים למחוק, לוחצים על ואז על Delete.

3. בתיבת הדו-שיח Delete the app?‎, מזינים את שם האפליקציה ולוחצים על Confirm.

שיטות מומלצות למחיקת אפליקציה עם מדיניות IAM

מחיקת אפליקציה היא פעולה בלתי הפיכה. לכן, אם הגדרתם אמצעי בקרת גישה לאפליקציה, אתם יכולים להסיר את כל המשתמשים ממדיניות ה-IAM שלה לפני שאתם מוחקים אותה. כך עושים את זה:

1. ניקוי מדיניות ה-IAM: לפני שמוחקים את האפליקציה, צריך לנקות את מדיניות ה-IAM שלה כדי להסיר את הגישה של המשתמשים. כדי לעשות את זה, מגדירים מערך bindings ריק.

   1. מאתרים את מדיניות ה-IAM הנוכחית של האפליקציה באמצעות השיטה getIamPolicy.

      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: מזהה הפרויקט.
      • ‫ENDPOINT_LOCATION: האזור במספר אזורים של בקשת ה-API. מציינים אחד מהערכים הבאים:
        • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
        • ‫eu למספר אזורים באיחוד האירופי
        • ‫global למיקום הגלובלי
        מידע נוסף זמין במאמר בנושא הגדרת מספר אזורים למאגר הנתונים.
      • ‫LOCATION: האזור של מאגר הנתונים: global,‏ us או eu
      • ‫APP_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. כדי להסיר את כל הקישורים הקיימים, משתמשים ב-method‏ 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: הערך של etag שקיבלתם בתגובה כשהשתמשתם ב-method‏ getIamPolicy.
      • ‫PROJECT_ID: מזהה הפרויקט.
      • ‫ENDPOINT_LOCATION: האזור במספר אזורים של בקשת ה-API. מציינים אחד מהערכים הבאים:
        • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
        • ‫eu למספר אזורים באיחוד האירופי
        • ‫global למיקום הגלובלי
        מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
      • ‫LOCATION: האזור המרובה של מאגר הנתונים: ‫global,‏ us או eu
      • ‫APP_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. מחיקת האפליקציה: אחרי שמאשרים את ההשפעה, ממשיכים למחיקת האפליקציה כמו שמתואר בקטע שלבי מחיקת האפליקציה.