PutMetadata

Describe las opciones para actualizar los metadatos de objetos.

Representación JSON 
{
  "customMetadata": {
    string: string,
    ...
  },
  "contentDisposition": string,
  "contentEncoding": string,
  "contentLanguage": string,
  "contentType": string,
  "cacheControl": string,
  "customTime": string,
  "objectRetention": {
    object (ObjectRetention)
  }
}
Campos
customMetadata

map (key: string, value: string)

Es opcional. Actualiza los metadatos personalizados del objeto. Esta operación agrega o establece pares clave-valor de metadatos personalizados individuales. Las claves especificadas con valores vacíos tienen sus valores borrados. Las claves de metadatos personalizados existentes que no se incluyen en la solicitud permanecen sin cambios. Para obtener más información, consulta Metadatos personalizados.

Un objeto que contiene una lista de "key": value pares. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contentDisposition

string

Es opcional. Actualiza los metadatos fijos Content-Disposition de los objetos. Se ignoran los valores no establecidos en la solicitud. Para borrar los metadatos, establece un valor vacío. Para obtener más información, consulta Content-Disposition.
contentEncoding

string

Es opcional. Actualiza los metadatos fijos Content-Encoding de los objetos. Se ignoran los valores no establecidos en la solicitud. Para borrar los metadatos, establece un valor vacío. Para obtener más información, consulta Content-Encoding.
contentLanguage

string

Es opcional. Actualiza los metadatos fijos Content-Language de los objetos. Los valores de los metadatos deben usar códigos de idioma ISO 639-1. La longitud máxima para los valores de los metadatos es de 100 caracteres. Se ignoran los valores no establecidos en la solicitud. Para borrar los metadatos, establece un valor vacío. Para obtener más información, consulta Content-Language.
contentType

string

Es opcional. Actualiza los metadatos fijos Content-Type de los objetos. Se ignoran los valores no establecidos en la solicitud. Para borrar los metadatos, establece un valor vacío. Para obtener más información, consulta Content-Type.
cacheControl

string

Es opcional. Actualiza los metadatos fijos Cache-Control de los objetos. Se ignoran los valores no establecidos en la solicitud. Para borrar los metadatos, establece un valor vacío. Además, el valor de Custom-Time no puede disminuir. Para obtener más información, consulta Cache-Control.
customTime

string

Es opcional. Actualiza los metadatos fijos Custom-Time de los objetos. Se ignoran los valores no establecidos en la solicitud. Para borrar los metadatos, establece un valor vacío. La hora debe especificarse en formato RFC 3339, por ejemplo, YYYY-MM-DD'T'HH:MM:SS'Z' o YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Para obtener más información, consulta Custom-Time.
objectRetention

object (ObjectRetention)

Es opcional. Actualiza la configuración de retención de un objeto. Para borrar la retención de un objeto, se deben dejar sin configurar (omitir) retentionMode y retainUntilTime. Configurar retentionMode como RETENTION_MODE_UNSPECIFIED se trata como una operación no operativa. A diferencia de un campo no establecido, no modifica ni borra la configuración de retención. No se puede borrar la retención de un objeto con el modo de retención LOCKED ni se puede reducir su retainUntilTime. Para obtener más información, consulta Retención de objetos.

ObjectRetention

Describe las opciones para actualizar la retención de objetos.

Representación JSON 
{
  "retainUntilTime": string,
  "retentionMode": enum (RetentionMode)
}
Campos
retainUntilTime

string

Obligatorio. Es la hora de vencimiento de la retención del objeto, durante la cual el objeto está protegido contra la eliminación o la sobreescritura. La hora debe especificarse en formato RFC 3339, por ejemplo, YYYY-MM-DD'T'HH:MM:SS'Z' o YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Para borrar la retención de un objeto, se deben dejar sin configurar (omitir) retentionMode y retainUntilTime. Configurar retentionMode como RETENTION_MODE_UNSPECIFIED se trata como una operación no operativa. A diferencia de un campo no establecido, no modifica ni borra la configuración de retención.
retentionMode

enum (RetentionMode)

Obligatorio. Es el modo de retención.

RetentionMode

Es el modo de retención.

Enums
RETENTION_MODE_UNSPECIFIED No se especifica el modo de retención.
LOCKED Cuando el modo de retención es LOCKED, no se puede quitar ni reducir retainUntilTime.
UNLOCKED Cuando el modo de retención es UNLOCKED, se puede quitar o modificar retainUntilTime.