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 固定元資料。請求中未設定的值將被忽略。若要清除元數據，請設定空值。有關詳細信息，請參閱 Content-Disposition。
contentEncoding

string

選用。更新物件 Content-Encoding 的固定元資料。請求中未設定的值將被忽略。若要清除元數據，請設定空值。有關詳細信息，請參閱Content-Encoding。
contentLanguage

string

選用。更新物件 Content-Language 的固定元資料。元資料值必須使用 ISO 639-1 語言代碼。元資料值的最大長度為 100 個字元。請求中未設定的值將被忽略。若要清除元數據，請設定空值。有關詳細信息，請參閱 Content-Language。
contentType

string

選用。更新物件 Content-Type 固定元資料。請求中未設定的值將被忽略。若要清除元數據，請設定空值。有關詳細信息，請參閱 Content-Type。
cacheControl

string

選用。更新物件 Cache-Control 的固定元資料。請求中未設定的值將被忽略。若要清除元數據，請設定空值。此外，Custom-Time 的值不能減少。有關詳細信息，請參閱 Cache-Control。
customTime

string

選用。更新物件 Custom-Time 的固定元資料。請求中未設定的值將被忽略。若要清除元數據，請設定空值。時間必須以 RFC 3339 格式指定，例如 YYYY-MM-DD'T'HH:MM:SS'Z' 或 YYYY-MM-DD'T'HH:MM:SS.SS'Z'。有關詳細信息，請參閱Custom-Time。
objectRetention

object (ObjectRetention)

選用。更新對象的保留配置。要清除物件的保留狀態，retentionMode 和 retainUntilTime 都必須留空（省略）。將 retentionMode 設為 RETENTION_MODE_UNSPECIFIED 被視為無效操作。與未設定欄位不同，它不會修改或清除保留設定。具有 LOCKED 保留模式的物件不能清除其保留狀態，也不能減少其 retainUntilTime 狀態。有關更多信息，請參閱物件保留。

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

保持模式。

列舉
RETENTION_MODE_UNSPECIFIED 未指定保留模式。
LOCKED 當保留模式為LOCKED時，retainUntilTime無法移除或減少。
UNLOCKED 當保留模式為UNLOCKED時，retainUntilTime可以移除或修改。