PutMetadata

Descreve opções para atualização de metadados de objetos.

Representação 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)

Opcional. Atualiza os metadados personalizados do objeto. Essa operação adiciona ou define pares de chave-valor de metadados personalizados individuais. As chaves especificadas com valores vazios têm os valores limpos. As chaves de metadados personalizados atuais que não estão incluídas na solicitação permanecem inalteradas. Para mais detalhes, consulte Metadados personalizados.

Um objeto com uma lista de "key": value pares. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contentDisposition

string

Opcional. Atualiza os metadados fixos Content-Disposition dos objetos. Os valores não definidos na solicitação são ignorados. Para limpar os metadados, defina um valor vazio. Para mais detalhes, consulte Content-Disposition.
contentEncoding

string

Opcional. Atualiza os metadados fixos Content-Encoding dos objetos. Os valores não definidos na solicitação são ignorados. Para limpar os metadados, defina um valor vazio. Para mais detalhes, consulte Content-Encoding.
contentLanguage

string

Opcional. Atualiza os metadados fixos Content-Language dos objetos. Os valores de metadados precisam usar códigos de idioma ISO 639-1. O comprimento máximo dos valores de metadados é de 100 caracteres. Os valores não definidos na solicitação são ignorados. Para limpar os metadados, defina um valor vazio. Para mais detalhes, consulte Content-Language.
contentType

string

Opcional. Atualiza os metadados fixos Content-Type dos objetos. Os valores não definidos na solicitação são ignorados. Para limpar os metadados, defina um valor vazio. Para mais detalhes, consulte Content-Type.
cacheControl

string

Opcional. Atualiza os metadados fixos Cache-Control dos objetos. Os valores não definidos na solicitação são ignorados. Para limpar os metadados, defina um valor vazio. Além disso, o valor de Custom-Time não pode diminuir. Para mais detalhes, consulte Cache-Control.
customTime

string

Opcional. Atualiza os metadados fixos Custom-Time dos objetos. Os valores não definidos na solicitação são ignorados. Para limpar os metadados, defina um valor vazio. O horário precisa ser especificado no formato RFC 3339, por exemplo, YYYY-MM-DD'T'HH:MM:SS'Z' ou YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Para mais detalhes, consulte Custom-Time.
objectRetention

object (ObjectRetention)

Opcional. Atualiza a configuração de retenção de um objeto. Para limpar a retenção de um objeto, retentionMode e retainUntilTime precisam ser deixados indefinidos (omitidos). Definir retentionMode como RETENTION_MODE_UNSPECIFIED é tratado como uma operação nula. Ao contrário de um campo indefinido, ele não modifica nem limpa as configurações de retenção. Um objeto com o modo de retenção LOCKED não pode ter a retenção limpa nem o retainUntilTime reduzido. Para mais informações, consulte Retenção de objetos.

ObjectRetention

Descreve opções para atualização de retenção de objetos.

Representação JSON 
{
  "retainUntilTime": string,
  "retentionMode": enum (RetentionMode)
}
Campos
retainUntilTime

string

Obrigatório. O tempo de validade da retenção do objeto, durante o qual o objeto fica protegido contra exclusão ou substituição. O horário precisa ser especificado no formato RFC 3339, por exemplo, YYYY-MM-DD'T'HH:MM:SS'Z' ou YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Para limpar a retenção de um objeto, retentionMode e retainUntilTime precisam ser deixados indefinidos (omitidos). Definir retentionMode como RETENTION_MODE_UNSPECIFIED é tratado como uma operação nula. Ao contrário de um campo indefinido, ele não modifica nem limpa as configurações de retenção.
retentionMode

enum (RetentionMode)

Obrigatório. O modo de retenção.

RetentionMode

O modo de retenção.

Tipos enumerados
RETENTION_MODE_UNSPECIFIED O modo de retenção não está especificado.
LOCKED Quando o modo de retenção é LOCKED, o retainUntilTime não pode ser removido ou reduzido.
UNLOCKED Quando o modo de retenção é UNLOCKED, o retainUntilTime pode ser removido ou modificado.