PutMetadata

Descrive le opzioni per l'aggiornamento dei metadati degli oggetti.

Rappresentazione JSON 
{
  "customMetadata": {
    string: string,
    ...
  },
  "contentDisposition": string,
  "contentEncoding": string,
  "contentLanguage": string,
  "contentType": string,
  "cacheControl": string,
  "customTime": string,
  "objectRetention": {
    object (ObjectRetention)
  }
}
Campi
customMetadata

map (key: string, value: string)

Facoltativo. Aggiorna i metadati personalizzati dell'oggetto. Questa operazione aggiunge o imposta singole coppie chiave-valore di metadati personalizzati. I valori delle chiavi specificate con valori vuoti vengono cancellati. Le chiavi dei metadati personalizzati esistenti non incluse nella richiesta rimangono invariate. Per i dettagli, vedi Metadati personalizzati.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contentDisposition

string

Facoltativo. Aggiorna i metadati fissi Content-Disposition degli oggetti. I valori non impostati nella richiesta vengono ignorati. Per cancellare i metadati, imposta un valore vuoto. Per i dettagli, vedi Content-Disposition.
contentEncoding

string

Facoltativo. Aggiorna i metadati fissi Content-Encoding degli oggetti. I valori non impostati nella richiesta vengono ignorati. Per cancellare i metadati, imposta un valore vuoto. Per i dettagli, vedi Content-Encoding.
contentLanguage

string

Facoltativo. Aggiorna i metadati fissi Content-Language degli oggetti. I valori dei metadati devono utilizzare i codici lingua ISO 639-1. La lunghezza massima dei valori dei metadati è di 100 caratteri. I valori non impostati nella richiesta vengono ignorati. Per cancellare i metadati, imposta un valore vuoto. Per i dettagli, vedi Content-Language.
contentType

string

Facoltativo. Aggiorna i metadati fissi Content-Type degli oggetti. I valori non impostati nella richiesta vengono ignorati. Per cancellare i metadati, imposta un valore vuoto. Per i dettagli, vedi Content-Type.
cacheControl

string

Facoltativo. Aggiorna i metadati fissi Cache-Control degli oggetti. I valori non impostati nella richiesta vengono ignorati. Per cancellare i metadati, imposta un valore vuoto. Inoltre, il valore di Custom-Time non può diminuire. Per i dettagli, vedi Cache-Control.
customTime

string

Facoltativo. Aggiorna i metadati fissi Custom-Time degli oggetti. I valori non impostati nella richiesta vengono ignorati. Per cancellare i metadati, imposta un valore vuoto. L'ora deve essere specificata nel formato RFC 3339, ad esempio YYYY-MM-DD'T'HH:MM:SS'Z' o YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Per i dettagli, vedi Custom-Time.
objectRetention

object (ObjectRetention)

Facoltativo. Aggiorna la configurazione della conservazione di un oggetto. Per cancellare la conservazione di un oggetto, sia retentionMode sia retainUntilTime devono essere lasciati non impostati (omessi). L'impostazione di retentionMode su RETENTION_MODE_UNSPECIFIED viene trattata come un'operazione no-op. A differenza di un campo non impostato, non modifica né cancella le impostazioni di conservazione. Non è possibile cancellare la conservazione o ridurre il valore di retainUntilTime di un oggetto con la modalità di conservazione LOCKED. Per ulteriori informazioni, vedi Conservazione degli oggetti.

ObjectRetention

Descrive le opzioni per l'aggiornamento della conservazione degli oggetti.

Rappresentazione JSON 
{
  "retainUntilTime": string,
  "retentionMode": enum (RetentionMode)
}
Campi
retainUntilTime

string

Obbligatorio. L'ora di scadenza della conservazione dell'oggetto, durante la quale l'oggetto è protetto dall'eliminazione o dalla sovrascrittura. L'ora deve essere specificata nel formato RFC 3339, ad esempio YYYY-MM-DD'T'HH:MM:SS'Z' o YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Per cancellare la conservazione di un oggetto, sia retentionMode sia retainUntilTime devono essere lasciati non impostati (omessi). L'impostazione di retentionMode su RETENTION_MODE_UNSPECIFIED viene trattata come un'operazione no-op. A differenza di un campo non impostato, non modifica né cancella le impostazioni di conservazione.
retentionMode

enum (RetentionMode)

Obbligatorio. La modalità di conservazione.

RetentionMode

La modalità di conservazione.

Enum
RETENTION_MODE_UNSPECIFIED La modalità di conservazione non è specificata.
LOCKED Quando la modalità di conservazione è LOCKED, non è possibile rimuovere o ridurre il valore di retainUntilTime.
UNLOCKED Quando la modalità di conservazione è UNLOCKED, è possibile rimuovere o modificare il valore di retainUntilTime.