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

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

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

ההוראות הבאות מיועדות למסוף 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. מחיקת האפליקציה: אחרי שבדקתם את ההשפעה, אתם יכולים למחוק את האפליקציה לפי ההוראות בקטע שלבים למחיקת אפליקציה.