PutMetadata

Menjelaskan opsi untuk pembaruan metadata objek.

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

map (key: string, value: string)

Opsional. Memperbarui metadata kustom objek. Operasi ini menambahkan atau mengatur pasangan kunci-nilai metadata kustom individual. Kunci yang ditentukan dengan nilai kosong akan dihapus nilainya. Kunci metadata kustom yang sudah ada dan tidak termasuk dalam permintaan tetap tidak berubah. Untuk detailnya, lihat Metadata kustom.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

contentDisposition

string

Opsional. Memperbarui objek Content-Disposition metadata tetap. Nilai yang tidak diatur dalam permintaan akan diabaikan. Untuk menghapus metadata, atur nilai kosong. Untuk detailnya, lihat Content-Disposition.

contentEncoding

string

Opsional. Memperbarui metadata tetap objek Content-Encoding. Nilai yang tidak diatur dalam permintaan akan diabaikan. Untuk menghapus metadata, atur nilai kosong. Untuk detailnya, lihat Content-Encoding.

contentLanguage

string

Opsional. Memperbarui metadata tetap objek Content-Language. Nilai metadata harus menggunakan kode bahasa ISO 639-1. Panjang maksimum untuk nilai metadata adalah 100 karakter. Nilai yang tidak ditetapkan dalam permintaan akan diabaikan. Untuk menghapus metadata, tetapkan nilai kosong. Untuk mengetahui detailnya, lihat Content-Language.

contentType

string

Opsional. Memperbarui metadata tetap objek Content-Type. Nilai yang tidak ditetapkan dalam permintaan akan diabaikan. Untuk menghapus metadata, tetapkan nilai kosong. Untuk mengetahui detailnya, lihat Content-Type.

cacheControl

string

Opsional. Memperbarui metadata tetap objek Cache-Control. Nilai yang tidak ditetapkan dalam permintaan akan diabaikan. Untuk menghapus metadata, tetapkan nilai kosong. Selain itu, nilai untuk Custom-Time tidak dapat dikurangi. Untuk mengetahui detailnya, lihat Cache-Control.

customTime

string

Opsional. Memperbarui metadata tetap objek Custom-Time. Nilai yang tidak ditetapkan dalam permintaan akan diabaikan. Untuk menghapus metadata, tetapkan nilai kosong. Waktu harus ditentukan dalam format RFC 3339, misalnya YYYY-MM-DD'T'HH:MM:SS'Z' atau YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Untuk mengetahui detailnya, lihat Custom-Time.

objectRetention

object (ObjectRetention)

Opsional. Memperbarui konfigurasi retensi objek. Untuk menghapus retensi objek, retentionMode dan retainUntilTime harus dibiarkan tidak disetel (dihilangkan). Menetapkan retentionMode ke RETENTION_MODE_UNSPECIFIED dianggap sebagai operasi tanpa efek. Tidak seperti kolom yang tidak ditetapkan, kolom ini tidak mengubah atau menghapus setelan retensi. Objek dengan mode retensi LOCKED tidak dapat dihapus retensinya atau dikurangi retainUntilTime-nya. Untuk mengetahui informasi selengkapnya, lihat Retensi objek.

ObjectRetention

Menjelaskan opsi untuk update retensi objek.

Representasi JSON
{
  "retainUntilTime": string,
  "retentionMode": enum (RetentionMode)
}
Kolom
retainUntilTime

string

Wajib. Waktu habis masa berlaku retensi objek, selama objek dilindungi agar tidak dihapus atau ditimpa. Waktu harus ditentukan dalam format RFC 3339, misalnya YYYY-MM-DD'T'HH:MM:SS'Z' atau YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Untuk menghapus retensi objek, retentionMode dan retainUntilTime harus dibiarkan tidak disetel (dihilangkan). Menetapkan retentionMode ke RETENTION_MODE_UNSPECIFIED dianggap sebagai operasi tanpa efek. Tidak seperti kolom yang tidak ditetapkan, kolom ini tidak mengubah atau menghapus setelan retensi.

retentionMode

enum (RetentionMode)

Wajib. Mode retensi.

RetentionMode

Mode retensi.

Enum
RETENTION_MODE_UNSPECIFIED Mode retensi tidak ditentukan.
LOCKED Jika mode retensi adalah LOCKED, retainUntilTime tidak dapat dihapus atau dikurangi.
UNLOCKED Jika mode retensi adalah UNLOCKED, retainUntilTime dapat dihapus atau diubah.