PutMetadata

Beschreibt Optionen zum Aktualisieren von Objektmetadaten.

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

map (key: string, value: string)

Optional. Aktualisiert die benutzerdefinierten Metadaten des Objekts. Mit diesem Vorgang werden einzelne benutzerdefinierte Metadaten-Schlüssel/Wert-Paare hinzugefügt oder festgelegt. Bei Schlüsseln, die mit leeren Werten angegeben werden, werden die Werte gelöscht. Vorhandene benutzerdefinierte Metadatenschlüssel, die nicht in der Anfrage enthalten sind, bleiben unverändert. Weitere Informationen finden Sie unter Benutzerdefinierte Metadaten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contentDisposition

string

Optional. Aktualisiert die festen Content-Disposition-Metadaten von Objekten. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Weitere Informationen finden Sie unter Content-Disposition.
contentEncoding

string

Optional. Aktualisiert die festen Content-Encoding-Metadaten von Objekten. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Weitere Informationen finden Sie unter Content-Encoding.
contentLanguage

string

Optional. Aktualisiert die festen Content-Language-Metadaten von Objekten. Für Metadatenwerte müssen ISO 639-1-Sprachcodes verwendet werden. Metadatenwerte dürfen maximal 100 Zeichen lang sein. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Weitere Informationen finden Sie unter Content-Language.
contentType

string

Optional. Aktualisiert die festen Content-Type-Metadaten von Objekten. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Weitere Informationen finden Sie unter Content-Type.
cacheControl

string

Optional. Aktualisiert die festen Cache-Control-Metadaten von Objekten. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Außerdem kann sich der Wert für Custom-Time nicht verkürzen. Weitere Informationen finden Sie unter Cache-Control.
customTime

string

Optional. Aktualisiert die festen Custom-Time-Metadaten von Objekten. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Die Zeit muss im RFC 3339-Format angegeben werden, z. B. YYYY-MM-DD'T'HH:MM:SS'Z' oder YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Weitere Informationen finden Sie unter Custom-Time.
objectRetention

object (ObjectRetention)

Optional. Aktualsiert die Aufbewahrungskonfiguration eines Objekts. Um die Aufbewahrung eines Objekts zu löschen, müssen sowohl retentionMode als auch retainUntilTime nicht festgelegt (ausgelassen) werden. Wenn Sie retentionMode auf RETENTION_MODE_UNSPECIFIED festlegen, hat dies keine Auswirkungen. Im Gegensatz zu einem nicht festgelegten Feld werden die Aufbewahrungseinstellungen dadurch nicht geändert oder gelöscht. Bei einem Objekt mit dem Aufbewahrungsmodus LOCKED kann die Aufbewahrung nicht aufgehoben und die retainUntilTime nicht verkürzt werden. Weitere Informationen finden Sie unter Objektaufbewahrung.

ObjectRetention

Beschreibt Optionen zum Aktualisieren der Objektaufbewahrung.

JSON-Darstellung 
{
  "retainUntilTime": string,
  "retentionMode": enum (RetentionMode)
}
Felder
retainUntilTime

string

Erforderlich. Das Ablaufdatum der Aufbewahrung des Objekts, während dessen das Objekt vor dem Löschen oder Überschreiben geschützt ist. Die Zeit muss im RFC 3339-Format angegeben werden, z. B. YYYY-MM-DD'T'HH:MM:SS'Z' oder YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Um die Aufbewahrung eines Objekts zu löschen, müssen sowohl retentionMode als auch retainUntilTime nicht festgelegt (ausgelassen) werden. Wenn Sie retentionMode auf RETENTION_MODE_UNSPECIFIED festlegen, hat dies keine Auswirkungen. Im Gegensatz zu einem nicht festgelegten Feld werden die Aufbewahrungseinstellungen dadurch nicht geändert oder gelöscht.
retentionMode

enum (RetentionMode)

Erforderlich. Der Aufbewahrungsmodus.

RetentionMode

Der Aufbewahrungsmodus.

Enums
RETENTION_MODE_UNSPECIFIED Der Aufbewahrungsmodus ist nicht angegeben.
LOCKED Wenn der Aufbewahrungsmodus LOCKED ist, kann retainUntilTime nicht entfernt oder verkürzt werden.
UNLOCKED Wenn der Aufbewahrungsmodus UNLOCKED ist, kann retainUntilTime entfernt oder geändert werden.