Quando aggiorni una risorsa in Google Cloud, spesso vuoi modificare campi specifici senza sostituire l'intera risorsa. Le librerie client di Cloud per Rust supportano le maschere di campo in modo da poter specificare quali campi vengono modificati da un'operazione di aggiornamento e lasciare invariati tutti gli altri campi.
Prima di iniziare
Questo documento utilizza l'API Secret Manager, anche se gli stessi concetti si applicano ad altri servizi Google Cloud .
Prima di eseguire il codice in questo documento, completa i seguenti prerequisiti:
- Segui Inizia a utilizzare Rust per configurare l'ambiente di sviluppo.
- Segui Crea e accedi a un secret utilizzando Secret Manager per abilitare l'API Secret Manager e configurare l'autenticazione.
Dipendenze
Il crate google-cloud-wkt fornisce tipi noti per le API Google Cloud, tra cui FieldMask. Aggiungi google-cloud-secretmanager-v1,
google-cloud-wkt, anyhow e tokio al file Cargo.toml:
cargo add google-cloud-secretmanager-v1 google-cloud-wkt anyhow
cargo add tokio --features macros,rt-multi-thread
Come funzionano le maschere di campo
Un FieldMask contiene un insieme di percorsi di campi simbolici che identificano i campi modificati da un'operazione di aggiornamento o restituiti da un'operazione di lettura.
In un'operazione di aggiornamento, il servizio modifica solo i campi elencati nella maschera e ignora i valori di tutti i campi non elencati nel messaggio di richiesta. Se ometti la maschera di campo in una richiesta di aggiornamento, l'operazione viene applicata a tutti i campi modificabili.
Per reimpostare un campo specifico sul valore predefinito, includi il percorso del campo nella maschera e lascia il campo sul valore predefinito nella struttura della risorsa.
Aggiorna i campi di una risorsa
Per creare un secret e aggiornare in modo selettivo i campi labels e annotations utilizzando un FieldMask, completa i seguenti passaggi:
Inizializza un client
SecretManagerServicee crea un secret conlabelseannotationsvuoti:Invia una richiesta
update_secretche impostalabels,annotations, il valoreetagcorrente per impedire la sovrascrittura degli aggiornamenti simultanei e una maschera di aggiornamento che copre"annotations"e"labels":La chiamata
set_update_maskspecifica i percorsi esatti dei campi da modificare:
L'output conferma che l'operazione ha aggiornato entrambi i campi:
labels: {"updated": "your-label"},
...
annotations: {"updated": "your-annotations"},
Completamento codice
La seguente funzione combina la creazione del secret e l'aggiornamento della maschera di campo:
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi e per prevenire
errori ALREADY_EXISTS nelle esecuzioni successive, elimina il secret your-secret al termine.