המאמר הזה מתאר איך להפעיל, להשבית ולבדוק את הסטטוס של ניהול גרסאות של אובייקטים בקטגוריה. במאמר שימוש באובייקטים בגרסאות מוסבר איך להציג, לשחזר ולמחוק את האובייקטים הנשמרים במסגרת 'ניהול גרסאות של אובייקטים'.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות להגדרה ולניהול של ניהול גרסאות של אובייקטים בקטגוריה, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM 'אדמין לניהול אחסון' (roles/storage.admin) בקטגוריה או בפרויקט שמכיל את הקטגוריה. התפקיד המוגדר מראש הזה מכיל את ההרשאות שנדרשות להגדרה ולניהול של ניהול גרסאות של אובייקטים בקטגוריה. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
storage.buckets.getstorage.buckets.updatestorage.buckets.list- ההרשאה הזו נדרשת רק אם אתם מתכננים להשתמש במסוףCloud de Confiance כדי לבצע את ההוראות שבדף הזה.
יכול להיות שתוכלו לקבל את ההרשאות האלה גם באמצעות תפקידים בהתאמה אישית.
במאמר הגדרה וניהול של מדיניות IAM בקטגוריות מוסבר איך מקצים תפקידים בקטגוריות. מידע על הקצאת תפקידים בפרויקטים מופיע במאמר ניהול הגישה לפרויקטים.
הגדרת 'ניהול גרסאות של אובייקטים' בקטגוריה
כדי להפעיל או להשבית את התכונה 'ניהול גרסאות של אובייקטים', צריך להגדיר אותה בקטגוריה. אחרי שמפעילים את התכונה 'ניהול גרסאות של אובייקטים', בכל פעם שגרסה של אובייקט פעיל מוחלפת או נמחקת, הגרסה הזו הופכת לגרסה לא עדכנית.
המסוף
- במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על השם של הקטגוריה שבה רוצים להפעיל או להשבית את התכונה 'ניהול גרסאות של אובייקטים'.
בוחרים בכרטיסייה Protection ליד החלק העליון של הדף.
הסטטוס הנוכחי של גרסאות של אובייקטים נמצא בסעיף Object versioning.
בסעיף Object versioning, לוחצים על הסטטוס הנוכחי כדי לשנות אותו.
מופיעה תיבת הדו-שיח Object versioning.
- אם מפעילים את התכונה 'ניהול גרסאות של אובייקטים' ורוצים לצמצם את עלויות האחסון, מסמנים את התיבה Add recommended lifecycle rules to manage version costs.
לוחצים על Confirm.
שורת הפקודה
משתמשים בפקודה gcloud storage buckets update עם הדגל המתאים:
gcloud storage buckets update gs://BUCKET_NAME FLAG
כאשר:
BUCKET_NAMEהוא שם הקטגוריה הרלוונטית. לדוגמה,my-bucket.FLAGהיא--versioningכדי להפעיל את התכונה 'יצירת גרסאות של אובייקטים' או--no-versioningכדי להשבית אותה.
אם הפעולה בוצעה ללא שגיאות, התגובה תיראה דומה לדוגמה הבאה:
Updating gs://my-bucket/... Completed 1
ספריות לקוח
C++
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C++ API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
הדוגמה הבאה מפעילה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
הדוגמה הבאה משביתה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
C#
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C# API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
הדוגמה הבאה מפעילה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
הדוגמה הבאה משביתה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
Go
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Go API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
הדוגמה הבאה מפעילה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
הדוגמה הבאה משביתה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
Java
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Java API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
הדוגמה הבאה מפעילה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
הדוגמה הבאה משביתה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
Node.js
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Node.js API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
הדוגמה הבאה מפעילה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
הדוגמה הבאה משביתה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
PHP
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage PHP API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
הדוגמה הבאה מפעילה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
הדוגמה הבאה משביתה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
Python
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Python API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
הדוגמה הבאה מפעילה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
הדוגמה הבאה משביתה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
Ruby
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Ruby API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
הדוגמה הבאה מפעילה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
הדוגמה הבאה משביתה את התכונה 'ניהול גרסאות של אובייקטים' בקטגוריה:
ממשקי API ל-REST
API ל-JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.יוצרים קובץ JSON שמכיל את הפרטים הבאים:
{ "versioning": { "enabled": STATE } }
כאשר הערך של STATE הוא
trueאוfalse.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של קטגורייתPATCH:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=versioning"
כאשר:
-
JSON_FILE_NAMEהוא הנתיב לקובץ JSON שיצרתם בשלב 2. -
BUCKET_NAMEהוא שם הקטגוריה הרלוונטית. לדוגמה,my-bucket.
-
API בפורמט XML
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.יוצרים קובץ XML שמכיל את הפרטים הבאים:
<VersioningConfiguration> <Status>STATE</Status> </VersioningConfiguration>
כאשר STATE הוא
EnabledאוSuspended.כדי לשלוח קריאה ל-
cURLAPI בפורמט XML, באמצעות בקשת קטגוריהPUTופרמטר מחרוזת שאילתהversioning:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME?versioning"
כאשר:
-
XML_FILE_NAMEהוא הנתיב לקובץ XML שיצרתם בשלב 2. -
BUCKET_NAMEהוא שם הקטגוריה הרלוונטית. לדוגמה,my-bucket.
-
בדיקה אם התכונה 'ניהול גרסאות של אובייקטים' מופעלת
כדי לבדוק אם התכונה 'ניהול גרסאות של אובייקטים' מופעלת בקטגוריה:
המסוף
- במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, הסטטוס של 'ניהול גרסאות של אובייקטים' מופיע בעמודה Protection.
כשהמדיניות מופעלת, יופיע הטקסט ניהול גרסאות של אובייקטים.
שורת הפקודה
משתמשים בפקודה gcloud storage buckets describe עם הדגל --format:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(versioning_enabled)"
כאשר BUCKET_NAME הוא השם של הקטגוריה שבסטטוס שלה אתם רוצים לצפות. לדוגמה, my-bucket.
אם הפקודה הצליחה והתכונה 'ניהול גרסאות של אובייקטים' מופעלת, התשובה תיראה דומה לדוגמה הבאה:
versioning: enabled: true
אם הפקודה הצליחה והתכונה 'ניהול גרסאות של אובייקטים' לא מופעלת, התשובה תיראה דומה לדוגמה הבאה:
nullממשקי API ל-REST
API ל-JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של קטגורייתGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=versioning"
כאשר
BUCKET_NAMEהוא השם של הקטגוריה הרלוונטית. לדוגמה,my-bucket.
אם הפקודה הצליחה והתכונה 'ניהול גרסאות של אובייקטים' מופעלת, התשובה תיראה דומה לדוגמה הבאה:
{ "versioning": { "enabled": true } }
אם הפקודה הצליחה והתכונה 'ניהול גרסאות של אובייקטים' לא מופעלת, התשובה תיראה דומה לדוגמה הבאה:
{}API בפורמט XML
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.כדי לשלוח קריאה ל-
cURLAPI בפורמט XML, באמצעות בקשת קטגוריהGETופרמטר מחרוזת שאילתהversioning:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME?versioning"
כאשר
BUCKET_NAMEהוא השם של הקטגוריה הרלוונטית. לדוגמה,my-bucket.
אם הפקודה הצליחה והתכונה 'ניהול גרסאות של אובייקטים' מופעלת, התשובה תיראה דומה לדוגמה הבאה:
<VersioningConfiguration>
<Status>Enabled</Status>
</VersioningConfiguration>אם הפקודה הצליחה והתכונה 'ניהול גרסאות של אובייקטים' לא מופעלת, התשובה תיראה דומה לדוגמה הבאה:
<VersioningConfiguration/>
המאמרים הבאים
- מידע נוסף על ניהול גרסאות של אובייקטים.
- מידע על עבודה עם אובייקטים לא עדכניים.
- מידע על שימוש בניהול מחזור חיים של אובייקטים כדי לנהל גרסאות של אובייקטים באופן אוטומטי.
- מידע על שימוש בתנאים מוקדמים לבקשה כדי למנוע מרוץ תהליכים.