PutMetadata

Décrit les options permettant de mettre à jour les métadonnées des objets.

Représentation JSON 
{
  "customMetadata": {
    string: string,
    ...
  },
  "contentDisposition": string,
  "contentEncoding": string,
  "contentLanguage": string,
  "contentType": string,
  "cacheControl": string,
  "customTime": string,
  "objectRetention": {
    object (ObjectRetention)
  }
}
Champs
customMetadata

map (key: string, value: string)

Facultatif. Met à jour les métadonnées personnalisées de l'objet. Cette opération ajoute ou définit des paires clé-valeur de métadonnées personnalisées individuelles. Les clés spécifiées avec des valeurs vides verront leurs valeurs effacées. Les clés de métadonnées personnalisées existantes non incluses dans la requête restent inchangées. Pour en savoir plus, consultez Métadonnées personnalisées.

Objet contenant une liste de "key": value paires. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contentDisposition

string

Facultatif. Met à jour des métadonnées Content-Disposition fixes de l'objet. Les valeurs non définies dans la requête sont ignorées. Pour effacer les métadonnées, définissez une valeur vide. Pour en savoir plus, consultez Content-Disposition.
contentEncoding

string

Facultatif. Met à jour les métadonnées Content-Encoding fixes de l'objet. Les valeurs non définies dans la requête sont ignorées. Pour effacer les métadonnées, définissez une valeur vide. Pour en savoir plus, consultez Content-Encoding.
contentLanguage

string

Facultatif. Met à jour les métadonnées fixes Content-Language de l'objet. Les valeurs des métadonnées doivent utiliser les codes de langue ISO 639-1. Les valeurs de métadonnées ne doivent pas dépasser 100 caractères. Les valeurs non définies dans la requête sont ignorées. Pour effacer les métadonnées, définissez une valeur vide. Pour en savoir plus, consultez Content-Language.
contentType

string

Facultatif. Met à jour des métadonnées Content-Type fixes de l'objet. Les valeurs non définies dans la requête sont ignorées. Pour effacer les métadonnées, définissez une valeur vide. Pour en savoir plus, consultez Content-Type.
cacheControl

string

Facultatif. Met à jour les métadonnées Cache-Control fixes de l'objet. Les valeurs non définies dans la requête sont ignorées. Pour effacer les métadonnées, définissez une valeur vide. De plus, la valeur de Custom-Time ne peut pas diminuer. Pour en savoir plus, consultez Cache-Control.
customTime

string

Facultatif. Met à jour les métadonnées Custom-Time fixes de l'objet. Les valeurs non définies dans la requête sont ignorées. Pour effacer les métadonnées, définissez une valeur vide. La date et l'heure doivent être spécifiées au format RFC 3339, par exemple YYYY-MM-DD'T'HH:MM:SS'Z' ou YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Pour en savoir plus, consultez Custom-Time.
objectRetention

object (ObjectRetention)

Facultatif. Met à jour la configuration de conservation d'un objet. Pour effacer la conservation d'un objet, retentionMode et retainUntilTime doivent être laissés non définis (omis). Définir retentionMode sur RETENTION_MODE_UNSPECIFIED est considéré comme une opération sans effet. Contrairement à un champ non défini, il ne modifie ni n'efface les paramètres de conservation. Il n'est pas possible d'effacer la conservation ni de réduire la valeur retainUntilTime d'un objet dont le mode de conservation est défini sur LOCKED. Pour en savoir plus, consultez Conservation des objets.

ObjectRetention

Décrit les options permettant de mettre à jour la conservation des objets.

Représentation JSON 
{
  "retainUntilTime": string,
  "retentionMode": enum (RetentionMode)
}
Champs
retainUntilTime

string

Obligatoire. Délai d'expiration de la conservation de l'objet, pendant lequel l'objet est protégé contre la suppression ou l'écrasement. La date et l'heure doivent être spécifiées au format RFC 3339, par exemple YYYY-MM-DD'T'HH:MM:SS'Z' ou YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Pour effacer la conservation d'un objet, retentionMode et retainUntilTime doivent être laissés non définis (omis). Définir retentionMode sur RETENTION_MODE_UNSPECIFIED est considéré comme une opération sans effet. Contrairement à un champ non défini, il ne modifie ni n'efface les paramètres de conservation.
retentionMode

enum (RetentionMode)

Obligatoire. Mode de conservation.

RetentionMode

Mode de conservation.

Enums
RETENTION_MODE_UNSPECIFIED Le mode de conservation n'est pas spécifié.
LOCKED Lorsque le mode de conservation est défini sur LOCKED, la valeur retainUntilTime ne peut pas être supprimée ni réduite.
UNLOCKED Lorsque le mode de conservation est défini sur UNLOCKED, la valeur retainUntilTime peut être supprimée ou modifiée.