PutMetadata

מתאר אפשרויות לעדכון מטא-נתונים של אובייקטים.

ייצוג JSON 
{
  "customMetadata": {
    string: string,
    ...
  },
  "contentDisposition": string,
  "contentEncoding": string,
  "contentLanguage": string,
  "contentType": string,
  "cacheControl": string,
  "customTime": string,
  "objectRetention": {
    object (ObjectRetention)
  }
}
שדות
customMetadata

map (key: string, value: string)

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

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contentDisposition

string

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

string

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

string

זה שינוי אופציונלי. מעדכן את האובייקטים Content-Language מטא-נתונים קבועים. ערכי מטא-נתונים חייבים להשתמש בקודי שפה ISO 639-1. האורך המרבי עבור ערכי מטא-דאטה הוא 100 תווים. ערכים שלא הוגדרו בבקשה מתעלמים. כדי לנקות את המטא-דאטה, הגדר ערך ריק. לפרטים, ראה שפת תוכן.
contentType

string

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

string

זה שינוי אופציונלי. מעדכן את האובייקטים Cache-Control מטא-נתונים קבועים. ערכים שלא הוגדרו בבקשה מתעלמים. כדי לנקות את המטא-דאטה, הגדר ערך ריק. בנוסף, הערך עבור Custom-Time לא יכול לרדת. לפרטים, ראה בקרת מטמון.
customTime

string

זה שינוי אופציונלי. מעדכן את האובייקטים Custom-Time מטא-נתונים קבועים. ערכים שלא הוגדרו בבקשה מתעלמים. כדי לנקות את המטא-דאטה, הגדר ערך ריק. יש לציין את השעה בפורמט RFC 3339, לדוגמה YYYY-MM-DD'T'HH:MM:SS'Z' או YYYY-MM-DD'T'HH:MM:SS.SS'Z'. לפרטים, ראה זמן מותאם אישית.
objectRetention

object (ObjectRetention)

זה שינוי אופציונלי. עדכון הגדרת השמירה של אובייקט. כדי לנקות את שמירת האובייקט, יש להשאיר את retentionMode ואת retainUntilTime ללא הגדרה (להשמטה). הגדרת retentionMode ל-RETENTION_MODE_UNSPECIFIED נחשבת כ"אין פעולה". בניגוד לשדה שאינו מוגדר, היא אינה משנה או מנקה את הגדרות השמירה. לא ניתן לנקות את השמירה או להפחית את ה-retainUntilTime של אובייקט עם מצב שמירה של LOCKED. למידע נוסף, ראו שמירת אובייקטים.

ObjectRetention

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

ייצוג JSON 
{
  "retainUntilTime": string,
  "retentionMode": enum (RetentionMode)
}
שדות
retainUntilTime

string

חובה. זמן התפוגה של שמירת הנתונים של האובייקט, שבמהלכו האובייקט מוגן מפני מחיקה או החלפה. יש לציין את השעה בפורמט RFC 3339, לדוגמה YYYY-MM-DD'T'HH:MM:SS'Z' או YYYY-MM-DD'T'HH:MM:SS.SS'Z'. כדי לנקות את שמירת האובייקט, יש להשאיר את retentionMode ואת retainUntilTime ללא הגדרה (להשמטה). הגדרת retentionMode ל-RETENTION_MODE_UNSPECIFIED נחשבת כ"אין פעולה". בניגוד לשדה שאינו מוגדר, היא אינה משנה או מנקה את הגדרות השמירה.
retentionMode

enum (RetentionMode)

חובה. מצב השמירה.

RetentionMode

מצב השמירה.

טיפוסים בני מנייה (enum)
RETENTION_MODE_UNSPECIFIED מצב השמירה לא צוין.
LOCKED כאשר מצב השמירה הוא LOCKED, לא ניתן להסיר או להפחית את ה-retainUntilTime.
UNLOCKED כאשר מצב השמירה הוא UNLOCKED, ניתן להסיר או לשנות את ה-retainUntilTime.