Saat memperbarui resource di Google Cloud, Anda sering kali ingin mengubah kolom tertentu tanpa mengganti seluruh resource. Library Klien Cloud untuk Rust mendukung masker kolom sehingga Anda dapat menentukan kolom mana yang diubah oleh operasi update dan membiarkan semua kolom lainnya tidak berubah.
Sebelum memulai
Dokumen ini menggunakan Secret Manager API, meskipun konsep yang sama berlaku untuk layanan Google Cloud lainnya.
Sebelum menjalankan kode dalam dokumen ini, selesaikan prasyarat berikut:
- Ikuti Memulai Rust untuk menyiapkan lingkungan pengembangan Anda.
- Ikuti Membuat dan mengakses secret menggunakan Secret Manager untuk mengaktifkan Secret Manager API dan mengonfigurasi autentikasi.
Dependensi
Crate google-cloud-wkt menyediakan jenis yang dikenal untuk API Google Cloud, termasuk FieldMask. Tambahkan google-cloud-secretmanager-v1,
google-cloud-wkt, anyhow, dan tokio ke file Cargo.toml Anda:
cargo add google-cloud-secretmanager-v1 google-cloud-wkt anyhow
cargo add tokio --features macros,rt-multi-thread
Cara kerja mask kolom
FieldMask berisi kumpulan jalur kolom simbolis yang mengidentifikasi kolom mana yang diubah oleh operasi update atau ditampilkan oleh operasi baca.
Dalam operasi update, layanan hanya mengubah kolom yang tercantum dalam mask dan mengabaikan nilai pada kolom yang tidak tercantum dalam pesan permintaan. Jika Anda menghilangkan mask kolom pada permintaan update, operasi akan berlaku untuk semua kolom yang dapat diubah.
Untuk mereset kolom tertentu ke nilai defaultnya, sertakan jalur kolom di masker dan biarkan kolom tersebut pada nilai defaultnya di struct resource.
Memperbarui kolom pada resource
Untuk membuat secret dan memperbarui kolom labels dan annotations secara selektif
menggunakan FieldMask, selesaikan langkah-langkah berikut:
Lakukan inisialisasi klien
SecretManagerServicedan buat secret denganlabelsdanannotationskosong:Kirim permintaan
update_secretyang menetapkanlabels,annotations,etagsaat ini untuk mencegah penimpaan update serentak, dan mask update yang mencakup"annotations"dan"labels":Panggilan
set_update_maskmenentukan jalur kolom yang tepat untuk diubah:
Output mengonfirmasi bahwa operasi memperbarui kedua kolom:
labels: {"updated": "your-label"},
...
annotations: {"updated": "your-annotations"},
Kode lengkap
Fungsi berikut menggabungkan pembuatan secret dan update field-mask:
Pembersihan
Agar akun Google Cloud Anda tidak dikenai biaya dan untuk mencegah error ALREADY_EXISTS pada operasi berikutnya, hapus secret your-secret setelah Anda selesai.