כדי להגן על הנתונים ב-Cloud Storage מפני מחיקה או החלפה, אפשר להשתמש בהקפאת אובייקטים. ההשעיות האלה עוזרות לכם לעמוד בדרישות רגולטוריות או בדרישות של גילוי מסמכים משפטי. אפשר להחיל השהיות מבוססות-אירועים והשהיות זמניות על אובייקטים ספציפיים. בנוסף, אפשר להגדיר קטגוריות כך שהשהיות מבוססות-אירועים יחולו על אובייקטים חדשים כברירת מחדל.
בדף הזה מוסבר איך להשתמש בהשהיות של אובייקטים, כולל הצבת השהיות כברירת מחדל על אובייקטים חדשים והצבת השהיות על אובייקטים בודדים.
ההרשאות הנדרשות
כדי להשתמש בתכונה הזו ב-Cloud Storage, צריכה להיות לכם הרשאה מספקת כדי לצפות בקטגוריות ואובייקטים ב-Cloud Storage ולעדכן אותם:
אם אתם הבעלים של הפרויקט שמכיל את הקטגוריה, סביר להניח שיש לכם את ההרשאות הנדרשות.
אם אתם משתמשים ב-IAM, צריכות להיות לכם ההרשאות
storage.buckets.update,storage.buckets.get,storage.objects.updateו-storage.objects.getבקטגוריה הרלוונטית. במאמר שימוש בהרשאות IAM מוסבר איך מקבלים תפקיד, למשל אדמין של Storage, שיש לו את ההרשאות האלה.אם אתם משתמשים ברשימות ACL, צריכה להיות לכם הרשאת בעלים בקטגוריה הרלוונטית ובאובייקטים שבתוכה. להוראות איך לבצע זאת, ראו הגדרת רשימות ACL.
שימוש במאפיין (property) ברירת המחדל של השהיה מבוססת-אירועים
המשימות הבאות מדגימות איך להגדיר את מאפיין ברירת המחדל של השהיה מבוססת-אירועים בקטגוריה ולצפות בו. כשהמאפיין הזה מופעל, השהיה מבוססת-אירועים מוצבת באופן אוטומטי על אובייקטים חדשים שמתווספים לקטגוריה.
הגדרת מאפיין ברירת מחדל של השהיה מבוססת-אירועים
כדי להפעיל או להשבית את מאפיין ברירת המחדל של השהיה מבוססת-אירועים בקטגוריה מסוימת:
המסוף
- במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על שם הקטגוריה שרוצים להגדיר לה את מאפיין ברירת המחדל של השהיה מבוססת-אירועים.
בוחרים בכרטיסייה Protection ליד החלק העליון של הדף.
הסטטוס הנוכחי של הקטגוריה מופיע בקטע Default event-based hold option.
בקטע Default event-based hold option, לוחצים על הסטטוס הנוכחי כדי לשנות אותו.
הסטטוס שיופיע יהיה Enabled או Disabled.
במאמר פתרון בעיות מוסבר איך מקבלים מידע מפורט על שגיאות בנושא פעולות ב-Cloud Storage שנכשלו ב Cloud de Confiance מסוף.
שורת הפקודה
משתמשים בפקודה 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. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה 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.
הדוגמה הבאה מפעילה השהיות מבוססות-אירועים כברירת מחדל בקטגוריה מסוימת:
הדוגמה הבאה משביתה השהיות מבוססות-אירועים כברירת מחדל בקטגוריה מסוימת:
Rust
הדוגמה הבאה מפעילה השהיות מבוססות-אירועים כברירת מחדל בקטגוריה מסוימת:
הדוגמה הבאה משביתה השהיות מבוססות-אירועים כברירת מחדל בקטגוריה מסוימת:
ממשקי API ל-REST
API בפורמט JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.יוצרים קובץ JSON שמכיל את הפרטים הבאים:
{ "defaultEventBasedHold": 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=defaultEventBasedHold"
כאשר:
-
JSON_FILE_NAMEהוא הנתיב לקובץ שיצרתם בשלב 2. -
BUCKET_NAMEהוא שם הקטגוריה הרלוונטית. לדוגמה,my-bucket.
-
API בפורמט XML
אי אפשר להשתמש ב-API מבוסס-XML כדי לעבוד עם השהיות אובייקטים. במקום זאת, צריך להשתמש באחד מהכלים האחרים של Cloud Storage, כמו ה-CLI של gcloud.
הצגת סטטוס השהיה כברירת מחדל של קטגוריה
כדי לראות אם קטגוריה מציבה השהיות מבוססות-אירועים על אובייקטים חדשים כברירת מחדל:
המסוף
- במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על שם הקטגוריה שלגביה רוצים לבדוק את הסטטוס של השהיה מבוססת-אירועים כברירת מחדל.
בוחרים בכרטיסייה Protection ליד החלק העליון של הדף.
הסטטוס מופיע בקטע Default event-based hold option.
במאמר פתרון בעיות מוסבר איך מקבלים מידע מפורט על שגיאות בנושא פעולות ב-Cloud Storage שנכשלו ב Cloud de Confiance מסוף.
שורת הפקודה
משתמשים בפקודה gcloud storage buckets describe עם הדגל --format:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(default_event_based_hold)"
כאשר BUCKET_NAME הוא השם של הקטגוריה שבסטטוס שלה אתם רוצים לצפות. לדוגמה, my-bucket.
אם הפעולה בוצעה ללא שגיאות, התשובה נראית דומה לדוגמה הבאה:
default_event_based_hold: true
ספריות לקוח
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.
Rust
ממשקי API ל-REST
API בפורמט JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של קטגורייתGETשכוללת אתfieldsהרצוי:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
כאשר
BUCKET_NAMEהוא השם של הקטגוריה הרלוונטית. לדוגמה,my-bucket.אם בקטגוריה מופעלת השהיה מבוססת-אירועים כברירת מחדל, מתקבלת תגובה שדומה לדוגמה הבאה:
{ "defaultEventBasedHold": true }
API בפורמט XML
אי אפשר להשתמש ב-API מבוסס-XML כדי לעבוד עם השהיות אובייקטים. במקום זאת, צריך להשתמש באחד מהכלים האחרים של Cloud Storage, כמו ה-CLI של gcloud.
ניהול השהיות על אובייקטים בודדים
במשימות הבאות מוסבר איך לשנות השהיות על אובייקטים בודדים ולצפות בהן.
הצבת השהיה על אובייקט או הסרה שלה
כדי להציב או להסיר השהיה על אובייקט בקטגוריה:
המסוף
- במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על שם הקטגוריה שמכילה את האובייקטים שרוצים להציב עליהם השהיות או להסיר מהם.
מסמנים את התיבה ליד שמות האובייקטים שרוצים להציב עליהם השהיות או להסיר מהם.
לוחצים על הלחצן Manage holds.
החלון Manage holds יופיע.
מחליפים את מצב תיבות הסימון של כל סוג השהיה כפי שרוצים.
לוחצים על Save hold settings.
במאמר פתרון בעיות מוסבר איך מקבלים מידע מפורט על שגיאות בנושא פעולות ב-Cloud Storage שנכשלו ב Cloud de Confiance מסוף.
שורת הפקודה
משתמשים בפקודה gcloud storage objects update עם הדגל המתאים:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME FLAG
כאשר:
-
BUCKET_NAMEהוא שם הקטגוריה הרלוונטית. לדוגמה,my-bucket. -
OBJECT_NAMEהוא שם האובייקט הרלוונטי. לדוגמה,pets/dog.png.
FLAGהוא אחד מהבאים:-
--event-based-holdכדי להפעיל השהיה מבוססת-אירועים על אובייקט. -
--no-event-based-holdכדי להשבית את כל ההשהיות מבוססות-אירועים על אובייקט. -
--temporary-holdכדי להפעיל השהיה זמנית על אובייקט. -
--no-temporary-holdכדי להשבית את כל ההשהיות הזמניות על האובייקט.
-
מידע נוסף על סוגי ההשהיות מופיע במאמר השהיות אובייקטים.
ספריות לקוח
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.
הדוגמה הבאה מגדירה השהיה מבוססת-אירועים על אובייקט:
הדוגמה הבאה מסירה השהיה מבוססת-אירועים על אובייקט:
הדוגמה הבאה מגדירה השהיה זמנית על אובייקט:
הדוגמה הבאה מסירה השהיה זמנית על אובייקט:
Rust
הדוגמה הבאה מגדירה השהיה מבוססת-אירועים על אובייקט:
הדוגמה הבאה מסירה השהיה מבוססת-אירועים על אובייקט:
הדוגמה הבאה מגדירה השהיה זמנית על אובייקט:
הדוגמה הבאה מסירה השהיה זמנית על אובייקט:
ממשקי API ל-REST
API בפורמט JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.יוצרים קובץ JSON שמכיל את הפרטים הבאים:
{ "HOLD_TYPE": STATE }
כאשר:
-
HOLD_TYPEהוא סוג ההשהיה שרוצים להגדיר לאובייקט או להסיר ממנו. לדוגמה,temporaryHoldאוeventBasedHold. מידע נוסף על סוגי ההשהיות מופיע במאמר השהיות אובייקטים. -
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/o/OBJECT_NAME"
כאשר:
-
JSON_FILE_NAMEהוא הנתיב לקובץ שיצרתם בשלב 2. -
BUCKET_NAMEהוא שם הקטגוריה הרלוונטית. לדוגמה,my-bucket. -
OBJECT_NAMEהוא שם האובייקט הרלוונטי, בקידוד התווים שמתאימים לכתובות URL. לדוגמה,pets/dog.pngיותאם לקידודי התווים שמתאימים לכתובות URL באופן הבא:pets%2Fdog.png.
-
API בפורמט XML
אי אפשר להשתמש ב-API מבוסס-XML כדי לעבוד עם השהיות אובייקטים. במקום זאת, צריך להשתמש באחד מהכלים האחרים של Cloud Storage, כמו ה-CLI של gcloud.
קבלת סטטוס ההשהיה של אובייקט
כדי לראות אילו השהיות יש לאובייקט, אם יש כאלה, צריך לפעול לפי ההוראות הכלליות לצפייה במטא-נתונים של אובייקט.
הצבת השהיות על אובייקטים או הסרה שלהן בכמות גדולה
כדי להציב או להסיר השהיות על מיליוני או מיליארדי אובייקטים באמצעות משימה אחת, צריך להשתמש בפעולות באצווה ב-Storage. כדי ליצור משימה, מציינים את האובייקטים שרוצים להגדיר או לבטל לגביהם השהיות. אפשר לעשות זאת על ידי ציון רשימה של אובייקטים בקובץ מניפסט או באמצעות קידומות של אובייקטים. אחרי שמציינים את רשימת האובייקטים, יוצרים משימה של פעולת אצווה לעדכון של השהיות אובייקטים.
המאמרים הבאים
- מידע נוסף על השהיות אובייקט, כולל סוגי ההשהיות השונים שיכולים להיות לאובייקט.
- הסבר על השימוש במדיניות שמירת נתונים
- הסבר על השימוש בתנאים מוקדמים לבקשות כדי למנוע מרוץ תהליכים.