שימוש בדליים שנמחקו זמנית

סקירה כללית של התכונה 'מחיקה עם אפשרות שחזור'

בדף הזה מוסבר איך להציג רשימה של קטגוריות שנמחקו זמנית ולשחזר אותן.

סקירה כללית

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

לתשומת ליבכם

  • כדי להגן מפני מחיקה זדונית, אי אפשר למחוק סופית קטגוריה שנמחקה זמנית עד שתקופת השמירה של המחיקה הזמנית של הקטגוריה תסתיים.

  • אחרי שמבצעים מחיקה רכה של קטגוריה, צריך לשחזר אותה כדי שיהיה אפשר להציג או לשחזר את האובייקטים שנמחקו בה.

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

  • אפשר לשחזר קטגוריה שנמחקה זמנית רק אם אין קטגוריה פעילה עם אותו שם. אם אתם או מישהו אחר יוצרים קטגוריה עם אותו שם של קטגוריה שנמחקה זמנית, לא תוכלו לשחזר את הקטגוריה שנמחקה זמנית עד שהקטגוריה החדשה תימחק.

  • כשמשחזרים קטגוריה שנמחקה זמנית באמצעות ה-CLI של gcloud או API בפורמט JSON, האובייקטים בקטגוריה לא משוחזרים. כדי לשחזר אובייקטים שנמחקו זמנית, צריך לבצע פעולת שחזור אובייקט אחרי שמשחזרים את הבאקט שנמחק זמנית.

  • יכול להיות שלא ניתן יהיה לשחזר את הקישורים של התגים כשמשחזרים דלי שנמחק באופן זמני עם תגים. כדי למנוע אובדן נתונים, כשמשחזרים קטגוריה שנמחקה זמנית עם קשרי תגים, מומלץ לבדוק שקשרי התגים של הקטגוריה שוחזרו. אם לא שוחזרו הקישורים של התגים לדלי, תצטרכו לקשר ידנית את התגים שלא שוחזרו לדלי.

ההרשאות הנדרשות

כדי לקבל את ההרשאות שנדרשות לשחזור קטגוריות שנמחקו זמנית, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Storage Admin (roles/storage.admin) בפרויקט Cloud Storage.

התפקיד המוגדר מראש הזה כולל את ההרשאות שנדרשות לשחזור קטגוריות שנמחקו זמנית. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי לשחזר דליים שנמחקו זמנית, נדרשות ההרשאות הבאות:

  • storage.buckets.list
  • storage.buckets.restore
  • שחזור אובייקטים כשמשתמשים במסוף כדי לשחזר קטגוריה שנמחקה זמנית:
      Google Cloud
    • storage.objects.restore
    • storage.objects.create

הצגת רשימה של קטגוריות שנמחקו זמנית

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

כדי להציג את רשימת הקטגוריות שנמחקו זמנית בפרויקט, משתמשים בהוראות הבאות:

המסוף

  1. במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.

    כניסה לדף Buckets

  2. לוחצים על אפשרויות תצוגה.

  3. בוחרים באפשרות רק דליים שנמחקו זמנית.

  4. לוחצים על Save.

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

שורת הפקודה

כדי להציג רשימה של קטגוריות שנמחקו זמנית, משתמשים בפקודה gcloud storage ls:

gcloud storage ls --buckets --soft-deleted --full

ממשקי API ל-REST

‫API בפורמט JSON

  1. התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת Authorization.

  2. משתמשים ב- cURL כדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשת Buckets: list שמשתמשת בפרמטר השאילתה softDeleted:

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER&softDeleted=true"

    מחליפים את PROJECT_IDENTIFIER במזהה או במספר של הפרויקט שמכיל את הקטגוריות שנמחקו זמנית שרוצים להציג ברשימה.

שחזור קטגוריה שנמחקה באופן זמני

כדי לשחזר קטגוריה שנמחקה זמנית, פועלים לפי ההוראות הבאות.

כשמשחזרים קטגוריה שנמחקה זמנית באמצעות המסוף Google Cloud , אפשר גם לשחזר את האובייקטים שנמחקו זמנית שהיו בקטגוריה.

המסוף

  1. במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.

    כניסה לדף Buckets

  2. הצגת קטגוריות שנמחקו זמנית ברשימת הקטגוריות, אם הן לא מופיעות כבר. הוראות מפורטות מופיעות במאמר בנושא הצגת קטגוריות שנמחקו זמנית.

  3. בשורה של מאגר המידע שרוצים לשחזר, לוחצים על שחזור.

  4. אם יש בדלי כמה דורות, בכרטיסייה Specify bucket generation (ציון דור הדלי) בוחרים את הדור לשחזור.

  5. לוחצים על הכרטיסייה Specify objects to restore (ציון אובייקטים לשחזור).

  6. בקטע Specify objects to restore (ציון אובייקטים לשחזור), בוחרים אם רוצים לשחזר את האובייקטים שנמחקו זמנית שהיו בדלי. אלה האפשרויות הזמינות:

    • לא לשחזר אובייקטים.

      במידת הצורך, אפשר לשחזר אובייקטים שנמחקו זמנית מאוחר יותר.

    • שחזור כל האובייקטים.

    • שחזור אובייקטים שתואמים לקריטריונים. צריך לבצע את הפעולות הבאות:

      1. בוחרים את טווח הזמן שממנו רוצים לשחזר אובייקטים.

      2. אופציונלי: כדי לשחזר רק את האובייקטים שתואמים לתבנית glob, בוחרים באפשרות סינון לפי תבנית glob ומזינים תבנית glob.

  7. אופציונלי: מציינים התנהגויות שחזור נוספות בקטע אפשרויות נוספות.

  8. לוחצים על שחזור.

    ‫Cloud Storage משחזר את הקטגוריה שנמחקה זמנית למצב פעיל.

    אם משחזרים את האובייקטים בקטגוריה, Cloud Storage יוצר פעולת שחזור בכמות גדולה של האובייקטים. הפעולה מתבצעת באופן אסינכרוני, ויכול להיות שיעבור שעה או יותר עד שהיא תתחיל. כדי לעקוב אחרי התקדמות הפעולה, לוחצים על הלחצן Notifications () בכותרת של מסוף Google Cloud . אפשר גם להשתמש ב-CLI של gcloud כדי לעקוב אחרי הסטטוס של פעולה ממושכת משויכת.

שורת הפקודה

כדי לשחזר קטגוריה שנמחקה זמנית, משתמשים בפקודה gcloud storage restore:

  gcloud storage restore gs://BUCKET_NAME#GENERATION_NUMBER

מחליפים את מה שכתוב בשדות הבאים:

  • ‫BUCKET_NAME: השם של הקטגוריה שנמחקה זמנית שרוצים לשחזר.

  • ‫GENERATION_NUMBER: מספר הגנרציה הייחודי והקבוע של הקטגוריה שנמחקה זמנית שרוצים לשחזר. כדי לקבל את מספר הדור של הקטגוריה, אפשר לעיין במאמר בנושא הצגת רשימה של קטגוריות שנמחקו זמנית.

‫Cloud Storage משחזר את הקטגוריה שנמחקה זמנית למצב פעיל. שימו לב: שחזור הקטגוריה לא משחזר את האובייקטים שהיו בקטגוריה. כדי לשחזר אובייקטים שנמחקו זמנית, ראו שחזור אובייקט שנמחק זמנית.

ממשקי API ל-REST

‫API בפורמט JSON

  1. התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת Authorization.

  2. משתמשים ב- cURL כדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשת Buckets: restore:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/restore?generation=GENERATION_NUMBER

    כאשר:

    • ‫BUCKET_NAME הוא שם הקטגוריה שרוצים לשחזר. לדוגמה, my-bucket.

    • ‫GENERATION_NUMBER הוא מספר הגנרציה הקבוע והייחודי של הדלי שנמחק זמנית ורוצים לשחזר. כדי לקבל את מספר הדור של הקטגוריה, אפשר לעיין במאמר בנושא הצגת רשימה של קטגוריות שנמחקו זמנית.

    ‫Cloud Storage משחזר את הקטגוריה שנמחקה זמנית למצב פעיל. שימו לב: שחזור הקטגוריה לא ישחזר את האובייקטים שהיו בה. כדי לשחזר אובייקטים שנמחקו זמנית, ראו שחזור אובייקט שנמחק זמנית.

המאמרים הבאים