אחסון אובייקטים באמצעות Google Cloud CLI

יצירת קטגוריה

קטגוריות הן הקונטיינרים הבסיסיים ששומרים את הנתונים שלכם ב-Cloud Storage.

כדי ליצור קטגוריה:

1. פותחים חלון טרמינל.

2. משתמשים בפקודה gcloud storage buckets create ובשם ייחודי גלובלי כדי ליצור קטגוריה:

   gcloud storage buckets create gs://BUCKET_NAME/ --uniform-bucket-level-access --location=LOCATION_NAME

   מחליפים את BUCKET_NAME בשם של הקטגוריה.

   ראו את הדרישות למתן שמות לקטגוריות.

   • שמות של קטגוריות יכולים להכיל רק אותיות קטנות, ספרות, מקפים (-) וקווים תחתונים (_). הם לא יכולים להכיל רווחים.
   • שמות של קטגוריות צריכים להתחיל ולהסתיים בספרה או באות.
   • שמות של קטגוריות צריכים להכיל 3-63 תווים. שמות שמכילים נקודות יכולים להכיל עד 222 תווים, אבל כל רכיב שמופרד באמצעות נקודות יכול להיות באורך של עד 63 תווים.
   • אי אפשר לייצג שמות של קטגוריות ככתובות IP בסימון עם נקודה עשרונית (לדוגמה, 192.168.5.4).
   • שמות של קטגוריות לא יכולים להתחיל בקידומת 'goog'.
   • שמות של קטגוריות לא יכולים להכיל את המחרוזת "google" או שגיאות איות דומות כמו "g00gle".

   אם הפקודה מסתיימת בלי שגיאות, היא מחזירה תגובה שדומה לזו:

   Creating gs://my-awesome-bucket/...

   אם שם הקטגוריה שבחרתם כבר נמצא בשימוש שלכם או של מישהו אחר, הפקודה מחזירה תגובה כמו ServiceException: 409 Bucket my-awesome-bucket already exists. צריך לנסות שוב עם שם קטגוריה אחר.

יצרתם עכשיו קטגוריה שבה תוכלו לאחסן את הנתונים שלכם!

העלאת אובייקט לקטגוריה

1. שומרים את התמונה הבאה במחשב, למשל בשולחן העבודה.

   

2. משתמשים בפקודה gcloud storage cp כדי להעתיק את התמונה מהמיקום שבו שמרתם אותה אל הקטגוריה שיצרתם:

   gcloud storage cp Desktop/kitten.png gs://BUCKET_NAME

   אם הפקודה מסתיימת בלי שגיאות, היא מחזירה תגובה שדומה לזו:

   Copying file://Desktop/kitten.png to gs://my-awesome-bucket/kitten.png
     Completed files 1/1 | 8.6kiB/8.6kiB

   אחסנתם עכשיו אובייקט בקטגוריה.

הורדת האובייקט מהקטגוריה

1. משתמשים בפקודה gcloud storage cp כדי להוריד את התמונה שאחסנתם בקטגוריה למקום כלשהו במחשב, למשל לשולחן העבודה:

   gcloud storage cp gs://BUCKET_NAME/kitten.png Desktop/kitten2.png

   אם הפקודה מסתיימת בלי שגיאות, היא מחזירה תגובה שדומה לזו:

   Copying gs://my-awesome-bucket/kitten.png to file://Desktop/kitten2.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

   הורדתם עכשיו משהו מהקטגוריה.

העתקת האובייקט לתיקייה מדומה בקטגוריה

1. משתמשים בפקודה gcloud storage cp כדי ליצור תיקייה מדומה ולהעתיק אליה את התמונה:

   gcloud storage cp gs://BUCKET_NAME/kitten.png gs://BUCKET_NAME/quickstart-folder/kitten3.png

   אם הפקודה מסתיימת בלי שגיאות, היא מחזירה תגובה שדומה לזו:

   Copying gs://my-awesome-bucket/kitten.png to gs://my-awesome-bucket/quickstart-folder/kitten3.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

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

הצגת רשימת תכנים של קטגוריה

1. משתמשים בפקודה gcloud storage ls כדי להציג את רשימת התכנים ברמה העליונה של הקטגוריה שלכם:

   gcloud storage ls gs://BUCKET_NAME

   אם הפקודה מסתיימת בלי שגיאות, היא מחזירה תגובה שדומה לזו:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/quickstart-folder/

   ראיתם עכשיו את התוכן ברמה העליונה של הקטגוריה.

הצגת רשימת פרטים של אובייקט

1. משתמשים בפקודה gcloud storage ls עם הדגל --long כדי לקבל פרטים מסוימים על אחת מהתמונות שלכם:

   gcloud storage ls gs://BUCKET_NAME/kitten.png --long

   אם הפקודה מסתיימת בלי שגיאות, היא מחזירה תגובה שדומה לזו:

   8775  2026-01-21T01:22:17Z  gs://srs-bucketcli/kitten.png
   TOTAL: 1 objects, 8775 bytes (8.57kiB)

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

הגדרת האובייקטים כנגישים באופן ציבורי

1. משתמשים בפקודה gcloud storage buckets add-iam-policy-binding כדי להעניק לכל המשתמשים הרשאה לקרוא את התמונות שמאוחסנות בקטגוריה:

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=allUsers --role=roles/storage.objectViewer

   הפקודה מסתיימת ללא שגיאות אם התגובה שאתם מקבלים מכילה:

   bindings:
     - members:
       - allUsers
       role: roles/storage.objectViewer
   

   עכשיו כולם יכולים לקבל את התמונות שלכם.

2. כדי להסיר את הרשאת הגישה הזו, משתמשים בפקודה הבאה:

   gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --member=allUsers --role=roles/storage.objectViewer

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

   הסרתם את הגישה הציבורית לתמונות שבקטגוריה.

מתן גישה לקטגוריה לאדם ספציפי

1. משתמשים בפקודה gcloud storage buckets add-iam-policy-binding כדי לתת לכתובת אימייל ספציפית הרשאה להוסיף אובייקטים לקטגוריה:

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=user:example-service-account@example-project.s3ns.iam.gserviceaccount.com --role=roles/storage.objectCreator

   הפקודה מסתיימת ללא שגיאות אם התגובה שאתם מקבלים מכילה:

   bindings:
     - members:
       - user:example-service-account@example-project.s3ns.iam.gserviceaccount.com
       role: roles/storage.objectCreator
   

   עכשיו המשתמש הזה יכול להוסיף פריטים לקטגוריה.

2. כדי להסיר את ההרשאה הזו, משתמשים בפקודה הבאה:

   gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --member=user:example-service-account@example-project.s3ns.iam.gserviceaccount.com --role=roles/storage.objectCreator

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

   הסרתם את הרשאת הגישה של המשתמש לקטגוריה.

מחיקת אובייקט

1. משתמשים בפקודה gcloud storage rm כדי למחוק אחת מהתמונות:

   gcloud storage rm gs://BUCKET_NAME/kitten.png

   אם הפקודה מסתיימת בלי שגיאות, היא מחזירה תגובה שדומה לזו:

   Removing gs://my-awesome-bucket/kitten.png...

   העותק הזה של התמונה לא מאוחסן יותר ב-Cloud Storage (אבל העותק שיצרתם בתיקייה המדומה quickstart-folder/ עדיין קיים).