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可以被移除或修改。