שימוש בהחזקות של אובייקטים

סקירה כללית

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

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

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

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

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

  • אם אתם משתמשים ב-IAM, צריכות להיות לכם ההרשאות storage.buckets.update, storage.buckets.get,storage.objects.update ו-storage.objects.get בקטגוריה הרלוונטית. במאמר שימוש בהרשאות IAM מוסבר איך מקבלים תפקיד, למשל אדמין של Storage, שיש לו את ההרשאות האלה.

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

שימוש במאפיין (property) ברירת המחדל של השהיה מבוססת-אירועים

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

הגדרת מאפיין ברירת מחדל של השהיה מבוססת-אירועים

כדי להפעיל או להשבית את מאפיין ברירת המחדל של השהיה מבוססת-אירועים בקטגוריה מסוימת:

המסוף

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

    כניסה לדף Buckets

  2. ברשימת הקטגוריות, לוחצים על שם הקטגוריה שרוצים להגדיר לה את מאפיין ברירת המחדל של השהיה מבוססת-אירועים.

  3. בוחרים בכרטיסייה Protection ליד החלק העליון של הדף.

    הסטטוס הנוכחי של הקטגוריה מופיע בקטע Default event-based hold option.

  4. בקטע Default event-based hold option, לוחצים על הסטטוס הנוכחי כדי לשנות אותו.

    הסטטוס שיופיע יהיה Enabled או Disabled.

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

שורת הפקודה

משתמשים בפקודה gcloud storage buckets update עם הדגל המתאים:

gcloud storage buckets update gs://BUCKET_NAME FLAG

כאשר:

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

  • ‫FLAG הוא --default-event-based-hold כדי להפעיל השהיות אובייקטים מבוססות-אירועים כברירת מחדל, או --no-default-event-based-hold כדי להשבית אותן.

ספריות לקוח

C++

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C++ API.

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

הדוגמה הבאה מפעילה השהיות מבוססות-אירועים כברירת מחדל בקטגוריה מסוימת:

namespace gcs = ::google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name) {
  StatusOr<gcs::BucketMetadata> original =
      client.GetBucketMetadata(bucket_name);
  if (!original) throw std::move(original).status();

  StatusOr<gcs::BucketMetadata> patched = client.PatchBucket(
      bucket_name,
      gcs::BucketMetadataPatchBuilder().SetDefaultEventBasedHold(true),
      gcs::IfMetagenerationMatch(original->metageneration()));
  if (!patched) throw std::move(patched).status();

  std::cout << "The default event-based hold for objects in bucket "
            << bucket_name << " is "
            << (patched->default_event_based_hold() ? "enabled" : "disabled")
            << "\n";
}

הדוגמה הבאה משביתה השהיות מבוססות-אירועים כברירת מחדל בקטגוריה מסוימת:

namespace gcs = ::google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name) {
  StatusOr<gcs::BucketMetadata> original =
      client.GetBucketMetadata(bucket_name);

  if (!original) throw std::move(original).status();
  StatusOr<gcs::BucketMetadata> patched = client.PatchBucket(
      bucket_name,
      gcs::BucketMetadataPatchBuilder().SetDefaultEventBasedHold(false),
      gcs::IfMetagenerationMatch(original->metageneration()));
  if (!patched) throw std::move(patched).status();

  std::cout << "The default event-based hold for objects in bucket "
            << bucket_name << " is "
            << (patched->default_event_based_hold() ? "enabled" : "disabled")
            << "\n";
}

C#

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C# API.

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

הדוגמה הבאה מפעילה השהיות מבוססות-אירועים כברירת מחדל בקטגוריה מסוימת:


using Google.Apis.Storage.v1.Data;
using Google.Cloud.Storage.V1;
using System;

public class EnableBucketDefaultEventBasedHoldSample
{
    public Bucket EnableBucketDefaultEventBasedHold(string bucketName = "your-unique-bucket-name")
    {
        var storage = StorageClient.Create();
        var bucket = storage.GetBucket(bucketName);
        bucket.DefaultEventBasedHold = true;
        bucket = storage.UpdateBucket(bucket);
        Console.WriteLine($"Default event-based hold was enabled for {bucketName}");
        return bucket;
    }
}

הדוגמה הבאה משביתה השהיות מבוססות-אירועים כברירת מחדל בקטגוריה מסוימת:


using Google.Apis.Storage.v1.Data;
using Google.Cloud.Storage.V1;
using System;

public class DisableDefaultEventBasedHoldSample
{
    public Bucket DisableDefaultEventBasedHold(string bucketName = "your-unique-bucket-name")
    {