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

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

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

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

המסוף

כדי למחוק אפליקציה, פועלים לפי השלבים הבאים:

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

   ‫Gemini Enterprise

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

3. בתיבת הדו-שיח למחוק את האפליקציה?, מזינים את שם האפליקציה ולוחצים על אישור.

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