הדף הזה מתאר את השדות של המטא-נתונים שנמצאים בשימוש נפוץ ונשמרים יחד עם האובייקטים ב-Cloud Storage.
מבוא
אובייקטים שמאוחסנים ב-Cloud Storage כוללים מטא-נתונים שמשויכים אליהם.
שדות המטא-נתונים מזהים את המאפיינים של האובייקט, וגם איך לטפל באובייקט כשניגשים אליו. מטא-נתונים קיימים כצמדי מפתח/ערך. לדוגמה, סוג אחסון (storage class) של אובייקט מיוצג על ידי רשומת המטא-נתונים storageClass:STANDARD. storageClass הוא המפתח של המטא-נתונים, ולכל האובייקטים משויך מפתח כזה.
STANDARD מציין את הערך שיש לאובייקט הספציפי הזה. הערך משתנה מאובייקט לאובייקט.
יכולת השינוי של שדות המטא-נתונים משתנה: חלק מהמטא-נתונים אפשר לערוך בכל שלב, חלק מהמטא-נתונים אפשר להגדיר רק בזמן יצירת האובייקט, ובחלק מהמטא-נתונים אפשר רק לצפות. לדוגמה, את הערך של שדה המטא-נתונים Cache-Control אפשר לערוך בכל שלב, אבל את שדה המטא-נתונים storageClass אפשר להקצות רק בזמן יצירה או כתיבה מחדש של האובייקט, ואת שדה המטא-נתונים generation אי אפשר לערוך ישירות, למרות שהערך של generation משתנה כשהאובייקט מוחלף.
מטא-נתונים שניתנים לעריכה
יש שתי קטגוריות של מטא-נתונים שמשתמשים יכולים לשנות באובייקטים:
מטא-נתונים עם מפתח קבוע: מטא-נתונים שהמפתחות שלהם מוגדרים, אבל אפשר לציין את הערך שלהם.
מטא-נתונים בהתאמה אישית: מטא-נתונים שמוסיפים על ידי ציון מפתח והערך שמשויך למפתח הזה.
כשעורכים מטא-נתונים, בדרך כלל כדאי להימנע מתווים שאינם מסוג ASCII, מכיוון שהם אסורים לשימוש בכותרות HTTP שבהן משתמש ה-API בפורמט XML.
מטא-נתונים עם מפתח קבוע
אפשר לערוך את המטא-נתונים הבאים של אובייקטים, אבל נדרשת הרשאה מספקת כדי לעשות זאת:
- מטא-נתונים של בקרת גישה
- סמל המטמון
- ניסוח התוכן
- קידוד התוכן
- שפת התוכן
- סוג התוכן
- זמן בהתאמה אישית
- החזקות אובייקטים
- הגדרות שימור
מטא-נתונים של בקרת גישה
Cloud Storage משתמש בניהול זהויות והרשאות גישה (IAM) וברשימות של בקרת גישה (ACLs) כדי לשלוט בגישה לאובייקטים. בקישורים האלו מופיע מידע נוסף על השיטות האלו לבקרת גישה ועל המטא-נתונים המשויכים.
סמל המטמון
שדה המטא-נתונים Cache-Control יכול לציין שני אספקטים שונים של אופן הצגת הנתונים מ-Cloud Storage: האם אפשר לשמור את הנתונים במטמון והאם אפשר לבצע להם טרנספורמציה.
שמירת נתונים במטמון
שדה המטא-נתונים Cache-Control מאפשר לקבוע האם ולמשך כמה זמן האובייקטים יישמרו במטמון כדי למלא בקשות נוספות. המטמון יכול לכלול מטמון של דפדפן ושל האינטרנט, וגם שמירה מובנית במטמון ב-Cloud Storage.
אם האובייקט הרלוונטי לא כולל את רשומת המטא-נתונים Cache-Control, Cloud Storage ישתמש בערך ברירת המחדל, שהוא:
public, max-age=3600, אם האובייקט לא מוצפן באמצעות מפתח הצפנה בניהול הלקוח או מאוחסן בתוך גבולות גזרה לשירות ענן וירטואלי פרטי.
no-cache, no-store, max-age=0, אם האובייקט מוצפן באמצעות מפתח הצפנה בניהול הלקוח.
private, max-age=0, אם האובייקט מאוחסן בגבולות גזרה לשירות ענן וירטואלי פרטי.
no-cache, no-store, max-age=0, must-revalidate, אם האובייקט מאוחסן בגבולות גזרה לשירות ענן וירטואלי פרטי ומוצפן באמצעות מפתח הצפנה בניהול הלקוח.
אם מאפשרים שמירה במטמון, יכול להיות שפעולות של הורדה ימשיכו לקבל גרסאות ישנות יותר של אובייקט, גם אחרי שמעלים גרסה חדשה יותר. הסיבה לכך היא שגרסאות קודמות כאלה נשארות 'רעננות' במטמון במשך פרק זמן שנקבע על ידי max-age. בנוסף, מכיוון שניתן לשמור אובייקטים במטמון במקומות שונים באינטרנט, אין דרך לגרום לפקיעת תוקף גלובלית של אובייקט ששמור במטמון. המשמעות היא שאם מבטלים גישה ציבורית לאובייקט, יכול להיות שהאובייקט עדיין יוגש ממטמון, בהתאם למועד הגישה האחרון אליו ולהגדרה של Cache-Control. לדוגמה, אם האובייקט הוגש עם Cache-Control של public, max-age=3600, הוא יכול להישמר במטמון למשך שעה. אם רוצים למנוע הצגה של גרסאות שנשמרו במטמון של אובייקטים קריאים באופן ציבורי, צריך להגדיר את האובייקט עם Cache-Control: no-store.
אם אתם צריכים שליטה גדולה יותר על ההתנהגות של המטמון, אפשר להגדיר את Cloud CDN לפני הקטגוריה.
טרנספורמציה של נתונים
שדה המטא-נתונים Cache-Control מאפשר גם להציג אובייקטים כפי שהם מאוחסנים, בלי להחיל על הנתונים טרנספורמציות כמו הסרת קידוד תוכן מסוג gzip בשביל לקוחות ללא תאימות לכך. כדי להציג אובייקט כפי שהוא, מגדירים Cache-Control:no-transform.
ניסוח התוכן
שדה המטא-נתונים Content-Disposition מייצג את פרטי ההצגה של הנתונים שמועברים. הגדרה של Content-Disposition מאפשרת לשלוט בסגנון ההצגה של התוכן, למשל להחליט אם להציג קובץ מצורף באופן אוטומטי או אם משתמשים צריכים לבצע פעולה כלשהי כדי לפתוח אותו. המפרט של Content-Disposition זמין בכתובת https://datatracker.ietf.org/doc/html/rfc6266.
קידוד התוכן
שדה המטא-נתונים Content-Encoding יכול לשמש כדי לציין שאובייקט דחוס, ועדיין לשמור על ה-Content-Type שבבסיסו.
לדוגמה, אם קובץ טקסט דחוס ב-gzip אפשר לציין את העובדה שזהו קובץ טקסט ב-Content-Type ואת העובדה שהוא דחוס ב-gzip ב-Content-Encoding. חשוב לוודא שהקבצים אכן דחוסים באמצעות הקידוד שצוין ב-Content-Encoding לפני שמעלים אותם, אחרת תתרחש התנהגות בלתי צפויה כשמנסים להוריד את האובייקטים. מידע נוסף מופיע בדף ההסבר על המרת קידוד.
בשביל תוכן שאפשר לדחוס, כמו טקסט, השימוש ב-Content-Encoding: gzip חוסך בעלויות הרשת ובאחסון ומשפר את הביצועים כשמציגים תוכן. עם זאת, בשביל תוכן שכבר דחוס מטבעו, כמו ארכיונים ופורמטים רבים של מדיה, החלה של רמת דחיסה נוספת וסימון באמצעות שדה המטא-נתונים Content-Encoding בדרך כלל פוגעים גם בגודל האובייקט וגם בביצועים, ומומלץ להימנע מכך.
שפת התוכן
שדה המטא-נתונים Content-Language מציין את השפות שאליהן האובייקט מיועד. לערכים האופייניים של שדה המטא-נתונים הזה עיינו בקודי השפה של ISO 639-1.
Cloud Storage תומך בערכים של Content-Language באורך של עד 100 תווים.
סוג התוכן
שדה המטא-נתונים הנפוץ ביותר הוא Content-Type (שנקרא גם סוג מדיה), שמאפשר לדפדפנים לעבד את האובייקט באופן נכון. לכל האובייקטים יש ערך שמצוין בשדה המטא-נתונים Content-Type, אבל הוא לא בהכרח תואם לסוג הבסיסי של האובייקט. לדוגמה, אם מעלה התוכן לא ציין Content-Type ולא ניתן לקבוע מהו, הוא מוגדר להיות application/octet-stream או application/x-www-form-urlencoded, בהתאם לאופן ההעלאה של האובייקט. רשימה של סוגי תוכן תקינים מופיעה בדף סוגי מדיה של IANA.
זמן בהתאמה אישית
שדה המטא-נתונים Custom-Time הוא תאריך ושעה שצוינו על ידי המשתמש, והם מיוצגים בפורמט RFC 3339 YYYY-MM-DD'T'HH:MM:SS.SS'Z' או YYYY-MM-DD'T'HH:MM:SS'Z', כאשר אלפיות השנייה הן אפס. בדרך כלל, מגדירים את המטא-נתונים האלו כדי להשתמש בתנאי DaysSinceCustomTime בניהול מחזור החיים של אובייקטים.
אי אפשר להסיר את Custom-Time אחרי שהוא מוגדר באובייקט. בנוסף, הערך של Custom-Time לא יכול לרדת. כלומר, לא ניתן להגדיר את Custom-Time כך שיהיה תאריך/שעה מוקדמים יותר מה-Custom-Time הקיים. עם זאת, אפשר להסיר או לאפס את Custom-Time על ידי כתיבה מחדש של האובייקט.
החזקות אובייקטים
משתמשים בדגלים של מטא-נתונים כדי להגדיר השהיות של אובייקטים, שמונעות מחיקה או החלפה של אובייקטים. למידע נוסף, עיינו בדף השהיות אובייקטים.
הגדרות שמירה
אם קיימת הגדרת שמירת נתונים לאובייקט, היא מגדירה תאריך ושעה שלפני כן אי אפשר למחוק או להחליף את האובייקט. מידע נוסף מופיע במאמר נעילת שמירת אובייקטים.
מטא-נתונים בהתאמה אישית
מטא-נתונים בהתאמה אישית הם מטא-נתונים שמגדירים להם גם את המפתח וגם את הערך. כדי ליצור מטא-נתונים בהתאמה אישית, צריך לציין גם מפתח וגם ערך. אחרי שיוצרים צמד של key:value למטא-נתונים בהתאמה אישית, אפשר למחוק את המפתח או לשנות את הערך.
מטא-נתונים בהתאמה אישית כפופים למגבלת גודל וחלות עליהם עלויות אחסון.
בדף צפייה במטא-נתונים ועריכה שלהם יש מידע על הגדרת מטא-נתונים בהתאמה אישית.
הקידומת x-goog-meta-
API בפורמט XML מגדיר ומאחזר מטא-נתונים של אובייקטים באמצעות כותרות בקשה, ו-API בפורמט JSON מאפשר להגדיר מטא-נתונים בהתאמה אישית במסגרת הבקשה הסופית של העלאה שניתן להמשיך, באמצעות כותרות בקשה. כדי להבחין באופן ברור בין כותרות של מטא-נתונים בהתאמה אישית לכותרות בקשה רגילות, שני ממשקי ה-API האלו מוסיפים את הקידומת x-goog-meta- לכותרות של מטא-נתונים בהתאמה אישית.
מטא-נתונים שאינם ניתנים לעריכה
את חלק משדות המטא-נתונים אי אפשר לערוך באופן ישיר. המטא-נתונים האלו מוגדרים בזמן היצירה או הכתיבה מחדש של האובייקט. במסגרת יצירה או כתיבה מחדש של אובייקטים, אפשר להגדיר חלק משדות המטא-נתונים האלו, כמו סוג האחסון (storage class) של האובייקט או מפתחות הצפנה בניהול הלקוח. מטא-נתונים אחרים נוספים באופן אוטומטי ואפשר רק לצפות בהם, למשל מספר הגנרציה או זמן היצירה של האובייקט.
מספרי גנרציה ומטא-גנרציה
כחלק מהמטא-נתונים, לכל אובייקט של Cloud Storage יש מאפיין generation מספרי ומאפיין metageneration מספרי שמזהים את האובייקט באופן ייחודי:
| מאפיין | תיאור |
|---|---|
generation |
מזהה את הגרסה של אובייקט. קיים לכל אובייקט, ללא קשר אם הקטגוריה משתמשת בניהול גרסאות של אובייקטים.
|
metageneration |
מזהה את גרסת המטא-נתונים, וגדל בכל פעם שיש עדכון במטא-נתונים של generation מסוים.
|
המאפיינים generation ו-metageneration נמצאים בשימוש בנסיבות הבאות:
כשמשתמשים בתנאים מוקדמים בבקשות: התנאים המוקדמים גורמים לבקשה להיכשל אם התנאי המוקדם לא מתקיים. כשל כזה מונע מהבקשה לחול על גרסה לא צפויה של האובייקט, למשל אחזור של נתוני האובייקט הלא נכונים או שינוי המצב הלא נכון של המטא-נתונים של האובייקט.
במהלך הצגה, גישה, שחזור ומחיקה של גרסאות לא עדכניות של אובייקטים: גרסאות לא עדכניות של אובייקטים רלוונטיות באופן ספציפי בקטגוריות שמשתמשות או שהשתמשו בעבר בניהול גרסאות של אובייקטים.
סכומי ביקורת
סיכומי ביקורת (checksums) הם מטא-נתונים שמחושבים מנתוני האובייקט המשויך. סכומי ביקורת משמשים לאימות נתוני האובייקט כדי לוודא שהם לא פגומים. לאובייקטים ב-Cloud Storage יש כמה שדות מטא-נתונים של סכומי ביקורת.
CRC32C
לכל האובייקטים של Cloud Storage יש גיבוב CRC32C. ספריות לחישוב CRC32C כוללות:
- CRC32C של Google בשביל C++
- hash/crc32 בשביל Go
- GoogleAPIs Guava בשביל Java
- google-crc32c בשביל Python
- digest-crc ב-Ruby
CRC32C בקידוד Base64 מופיע בסדר בייטים big-endian.
MD5
לאובייקטים ב-Cloud Storage יש גיבוב מסוג MD5 אם הם עומדים בקריטריונים הבאים:
- האובייקט הוא לא אובייקט מורכב.
- האובייקט לא הועלה באמצעות העלאה מרובת חלקים של API בפורמט XML.
אם הכותרת Content-MD5 מופיעה בבקשה, מערכת Cloud Storage מאמתת את שלמות נתוני האובייקט על ידי השוואה בין גיבוב MD5 שסופק לבין הגיבוב המחושב של האובייקט שהועלה. אם הגיבובים לא תואמים, הבקשה נדחית.
ETags
לכל האובייקטים של Cloud Storage יש ETag. עם זאת, לאותו אובייקט יכול להיות ערך ETag שונה כשנשלחת בקשה מ-API בפורמט XML, לעומת API בפורמט JSON. ברוב המקרים, המשתמשים לא צריכים להניח הנחות לגבי הערך שנעשה בו שימוש ב-ETag, למעט שהוא משתנה בכל פעם שהנתונים או המטא-נתונים הבסיסיים משתנים, בהתאם למפרט.
כותרת ETag של אובייקט מחזירה את ערך ה-MD5 של האובייקט אם כל הערכים הבאים נכונים:
- הבקשה מתבצעת באמצעות XML API
- האובייקט משתמש רק בGoogle-owned and Google-managed encryption keys להצפנה בצד השרת.
- האובייקט הוא לא אובייקט מורכב ולא הועלה באמצעות העלאה מרובת חלקים של XML API
חותמות זמן
המטא-נתונים של אובייקט ב-Cloud Storage יכולים לכלול את חותמות הזמן הבאים. שמות השדות משתנים בהתאם לכלי או לשפת ה-SDK שבהם אתם משתמשים כדי לעבוד עם האובייקט. לגבי ערכות SDK, אפשר לעיין במסמכי התיעוד הרלוונטיים של ספריית הלקוח.
שורת הפקודה
| שם השדה | תיאור |
|---|---|
creation_time |
זמן היצירה של האובייקט. חותמת הזמן הזו לא משתנה. |
update_time |
זמן השינוי האחרון של המטא-נתונים של האובייקט. הערך הזה מוגדר בהתחלה לזמן היצירה של האובייקט, ולאחר מכן הוא מתעדכן בכל פעם שהמטא-נתונים של האובייקט משתנים. השינויים האלו כוללים שינויים שבוצעו על ידי מגיש הבקשה, כמו שינוי של מטא-נתונים בהתאמה אישית, וגם שינויים ש-Cloud Storage מבצע בשם המבקש, כמו שינוי של סוג אחסון (storage class) על סמך הגדרות מחזור החיים של האובייקט. |
noncurrent_time |
השעה שבה האובייקט נמחק. מוחזר אך ורק אם הגרסה הזו של האובייקט כבר לא פעילה, אבל נשארה בקטגוריה כגרסה לא עדכנית. |
soft_delete_time |
השעה שבה האובייקט נמחק זמנית. האפשרות הזו זמינה רק לאובייקטים בקטגוריות עם מדיניות מחיקה עם יכולת שחזור. |
hard_delete_time |
הזמן שבו אובייקט שנמחק זמנית יימחק באופן סופי ולא ניתן יהיה לשחזר אותו. הערך הזה הוא סכום הערכים של זמן המחיקה עם יכולת שחזור ומשך השמירה שמוגדר במדיניות שמירת הנתונים של הקטגוריה. האפשרות הזו זמינה רק לאובייקטים בקטגוריות עם מדיניות מחיקה עם יכולת שחזור. שימו לב: אחרי שמגדירים את הערך של זמן המחיקה בלי יכולת שחזור, הוא נשאר קבוע ולא משתנה בתגובה לשינויים במשך תקופת השמירה. |
retention_settings.retainUntilTime |
הזמן המוקדם ביותר שבו ניתן למחוק או להחליף את האובייקט. הערך הזה לא תלוי במדיניות שמירת נתונים שהוגדרה לקטגוריה שמכילה את האובייקט. הערך המקסימלי הוא 3,155,760,000 שניות (100 שנים) מהתאריך והשעה הנוכחיים. |
retention_expiration |
הזמן המוקדם ביותר שבו ניתן למחוק את האובייקט. הערך הזה תלוי בהגדרת השמירה שמוגדרת לאובייקט ובמדיניות שמירת נתונים שמוגדרת לקטגוריה שמכילה את האובייקט. |
storage_class_update_time |
התאריך והשעה שבהם סוג האחסון של האובייקט השתנה בפעם האחרונה. בשלב הראשוני של יצירת האובייקט, הערך מוגדר לזמן היצירה של האובייקט. |
finalize_time |
זמן הסיום של האובייקט. |
contexts.KEY.createTime |
השעה שבה מפתח ההקשר של האובייקט הזה נוסף לאובייקט בפעם הראשונה. |
contexts.KEY.updateTime |
השעה שבה עודכן לאחרונה מפתח ההקשר של האובייקט הזה. |
custom_time |
חותמת זמן שהמשתמש מציין לאובייקט. אחרי שמגדירים זמן מותאם אישית לאובייקט, אי אפשר להסיר את הזמן המותאם אישית ואי אפשר להגדיר תאריך ושעה מוקדמים יותר. מידע נוסף על השימוש בזמן המותאם אישית זמין במאמר בנושא מטא-נתונים של זמן מותאם אישית. |
ממשקי API
API ל-JSON
| שם השדה | תיאור |
|---|---|
timeCreated |
זמן היצירה של האובייקט. חותמת הזמן הזו לא משתנה. |
updated |
זמן השינוי האחרון של המטא-נתונים של האובייקט. הערך הזה מוגדר בהתחלה לזמן היצירה של האובייקט, ולאחר מכן הוא מתעדכן בכל פעם שהמטא-נתונים של האובייקט משתנים. השינויים האלו כוללים שינויים שבוצעו על ידי מגיש הבקשה, כמו שינוי של מטא-נתונים בהתאמה אישית, וגם שינויים ש-Cloud Storage מבצע בשם המבקש, כמו שינוי של סוג אחסון (storage class) על סמך הגדרות מחזור החיים של האובייקט. |
timeDeleted |
השעה שבה האובייקט נמחק. מוחזר אך ורק אם הגרסה הזו של האובייקט כבר לא פעילה, אבל נשארה בקטגוריה כגרסה לא עדכנית. |
softDeleteTime |
השעה שבה האובייקט נמחק זמנית. האפשרות הזו זמינה רק לאובייקטים בקטגוריות עם מדיניות מחיקה עם יכולת שחזור. |
hardDeleteTime |
הזמן שבו אובייקט שנמחק זמנית יימחק באופן סופי ולא ניתן יהיה לשחזר אותו. הערך הזה הוא סכום הערכים של זמן המחיקה עם יכולת שחזור ומשך השמירה שמוגדר במדיניות שמירת הנתונים של הקטגוריה. האפשרות הזו זמינה רק לאובייקטים בקטגוריות עם מדיניות מחיקה עם יכולת שחזור. שימו לב: אחרי שמגדירים את הערך של זמן המחיקה בלי יכולת שחזור, הוא נשאר קבוע ולא משתנה בתגובה לשינויים במשך תקופת השמירה. |
retention.retainUntilTime |
הזמן המוקדם ביותר שבו ניתן למחוק או להחליף את האובייקט. הערך הזה לא תלוי במדיניות שמירת נתונים שהוגדרה לקטגוריה שמכילה את האובייקט. הערך המקסימלי הוא 3,155,760,000 שניות (100 שנים) מהתאריך והשעה הנוכחיים. |
retentionExpirationTime |
הזמן המוקדם ביותר שבו ניתן למחוק את האובייקט. הערך הזה תלוי בהגדרת השמירה שמוגדרת לאובייקט ובמדיניות שמירת נתונים שמוגדרת לקטגוריה שמכילה את האובייקט. |
timeStorageClassUpdated |
התאריך והשעה שבהם סוג האחסון של האובייקט השתנה בפעם האחרונה. בשלב הראשוני של יצירת האובייקט, הערך מוגדר לזמן היצירה של האובייקט. |
timeFinalized |
זמן הסיום של האובייקט. |
contexts.custom.KEY.createTime |
השעה שבה מפתח ההקשר של האובייקט הזה נוסף לאובייקט בפעם הראשונה. |
contexts.custom.KEY.updateTime |
השעה שבה עודכן לאחרונה מפתח ההקשר של האובייקט הזה. |
customTime |
חותמת זמן שהמשתמש מציין לאובייקט. אחרי שמגדירים זמן מותאם אישית לאובייקט, אי אפשר להסיר את הזמן המותאם אישית ואי אפשר להגדיר תאריך ושעה מוקדמים יותר. מידע נוסף על השימוש בזמן המותאם אישית זמין במאמר בנושא מטא-נתונים של זמן מותאם אישית. |
API בפורמט XML
| שם השדה | תיאור |
|---|---|
Created |
זמן היצירה של האובייקט. חותמת הזמן הזו לא משתנה. |
LastModified |
זמן השינוי האחרון של המטא-נתונים של האובייקט. הערך הזה מוגדר בהתחלה לזמן היצירה של האובייקט, ולאחר מכן הוא מתעדכן בכל פעם שהמטא-נתונים של האובייקט משתנים. השינויים האלו כוללים שינויים שבוצעו על ידי מגיש הבקשה, כמו שינוי של מטא-נתונים בהתאמה אישית, וגם שינויים ש-Cloud Storage מבצע בשם המבקש, כמו שינוי של סוג אחסון (storage class) על סמך הגדרות מחזור החיים של האובייקט. |
DeletedTime |
השעה שבה האובייקט נמחק. מוחזר אך ורק אם הגרסה הזו של האובייקט כבר לא פעילה, אבל נשארה בקטגוריה כגרסה לא עדכנית. |
x-goog-object-lock-retain-until-date |
הזמן המוקדם ביותר שבו ניתן למחוק או להחליף את האובייקט. הערך הזה לא תלוי במדיניות שמירת נתונים שהוגדרה לקטגוריה שמכילה את האובייקט. הערך המקסימלי הוא 3,155,760,000 שניות (100 שנים) מהתאריך והשעה הנוכחיים. |
Finalized |
זמן הסיום של האובייקט. |
x-goog-custom-time |
חותמת זמן שהמשתמש מציין לאובייקט. אחרי שמגדירים זמן מותאם אישית לאובייקט, אי אפשר להסיר את הזמן המותאם אישית ואי אפשר להגדיר תאריך ושעה מוקדמים יותר. מידע נוסף על השימוש בזמן המותאם אישית זמין במאמר בנושא מטא-נתונים של זמן מותאם אישית. |
API ל-RPC
| שם השדה | תיאור |
|---|---|
create_time |
זמן היצירה של האובייקט. חותמת הזמן הזו לא משתנה. |
update_time |
זמן השינוי האחרון של המטא-נתונים של האובייקט. הערך הזה מוגדר בהתחלה לזמן היצירה של האובייקט, ולאחר מכן הוא מתעדכן בכל פעם שהמטא-נתונים של האובייקט משתנים. השינויים האלו כוללים שינויים שבוצעו על ידי מגיש הבקשה, כמו שינוי של מטא-נתונים בהתאמה אישית, וגם שינויים ש-Cloud Storage מבצע בשם המבקש, כמו שינוי של סוג אחסון (storage class) על סמך הגדרות מחזור החיים של האובייקט. |
delete_time |
השעה שבה האובייקט נמחק. מוחזר אך ורק אם הגרסה הזו של האובייקט כבר לא פעילה, אבל נשארה בקטגוריה כגרסה לא עדכנית. |
soft_delete_time |
השעה שבה האובייקט נמחק זמנית. האפשרות הזו זמינה רק לאובייקטים בקטגוריות עם מדיניות מחיקה עם יכולת שחזור. |
hard_delete_time |
הזמן שבו אובייקט שנמחק זמנית יימחק באופן סופי ולא ניתן יהיה לשחזר אותו. הערך הזה הוא סכום הערכים של זמן המחיקה עם יכולת שחזור ומשך השמירה שמוגדר במדיניות שמירת הנתונים של הקטגוריה. האפשרות הזו זמינה רק לאובייקטים בקטגוריות עם מדיניות מחיקה עם יכולת שחזור. שימו לב: אחרי שמגדירים את הערך של זמן המחיקה בלי יכולת שחזור, הוא נשאר קבוע ולא משתנה בתגובה לשינויים במשך תקופת השמירה. |
retention.retain_until_time |
הזמן המוקדם ביותר שבו ניתן למחוק או להחליף את האובייקט. הערך הזה לא תלוי במדיניות שמירת נתונים שהוגדרה לקטגוריה שמכילה את האובייקט. הערך המקסימלי הוא 3,155,760,000 שניות (100 שנים) מהתאריך והשעה הנוכחיים. |
retention_expire_time |
הזמן המוקדם ביותר שבו ניתן למחוק את האובייקט. הערך הזה תלוי בהגדרת השמירה שמוגדרת לאובייקט ובמדיניות שמירת נתונים שמוגדרת לקטגוריה שמכילה את האובייקט. |
update_storage_class_time |
התאריך והשעה שבהם סוג האחסון של האובייקט השתנה בפעם האחרונה. בשלב הראשוני של יצירת האובייקט, הערך מוגדר לזמן היצירה של האובייקט. |
finalize_time |
זמן הסיום של האובייקט. |
contexts.custom.KEY.createTime |
השעה שבה מפתח ההקשר של האובייקט הזה נוסף לאובייקט בפעם הראשונה. |
contexts.custom.KEY.updateTime |
השעה שבה עודכן לאחרונה מפתח ההקשר של האובייקט הזה. |
custom_time |
חותמת זמן שהמשתמש מציין לאובייקט. אחרי שמגדירים זמן מותאם אישית לאובייקט, אי אפשר להסיר את הזמן המותאם אישית ואי אפשר להגדיר תאריך ושעה מוקדמים יותר. מידע נוסף על השימוש בזמן המותאם אישית זמין במאמר בנושא מטא-נתונים של זמן מותאם אישית. |
המאמרים הבאים
- צפייה במטא-נתונים של אובייקטים ועריכה שלהם.
- מידע נוסף על סוגי אחסון זמינים.
- תיאור מפורט של כל שדות המטא-נתונים של האובייקטים שזמינים ב-API בפורמט JSON מופיע במאמרי העזרה ל-JSON בנושא אובייקטים.
- מידע על דוחות מלאי, שמאפשרים לקבל בבת אחת את המטא-נתונים של כל האובייקטים בקטגוריה מסוימת.