Wenn Sie eine Ressource in Google Cloudaktualisieren, möchten Sie oft bestimmte Felder ändern, ohne die gesamte Ressource zu ersetzen. Die Cloud-Clientbibliotheken für Rust unterstützen Feldmasken, sodass Sie angeben können, welche Felder durch einen Aktualisierungsvorgang geändert werden, und alle anderen Felder unverändert lassen können.
Hinweis
In diesem Dokument wird die Secret Manager API verwendet. Die Konzepte gelten jedoch auch für andere Google Cloud -Dienste.
Bevor Sie den Code in diesem Dokument ausführen, müssen die folgenden Voraussetzungen erfüllt sein:
- Folgen Sie der Anleitung unter Erste Schritte mit Rust, um Ihre Entwicklungsumgebung einzurichten.
- Folgen Sie der Anleitung unter Secret mit Secret Manager erstellen und darauf zugreifen, um die Secret Manager API zu aktivieren und die Authentifizierung zu konfigurieren.
Abhängigkeiten
Die google-cloud-wkt-Crate bietet bekannte Typen für Google Cloud-APIs, einschließlich FieldMask. Fügen Sie der Datei Cargo.toml die Elemente google-cloud-secretmanager-v1, google-cloud-wkt, anyhow und tokio hinzu:
cargo add google-cloud-secretmanager-v1 google-cloud-wkt anyhow
cargo add tokio --features macros,rt-multi-thread
Funktionsweise von Feldmasken
Ein FieldMask enthält eine Reihe symbolischer Feldpfade, die angeben, welche Felder durch einen Aktualisierungsvorgang geändert oder von einem Lesevorgang zurückgegeben werden.
Bei einem Aktualisierungsvorgang ändert der Dienst nur die in der Maske aufgeführten Felder und ignoriert Werte in nicht aufgeführten Feldern in der Anfragenachricht. Wenn Sie die Feldmaske bei einer Aktualisierungsanfrage weglassen, gilt der Vorgang für alle änderbaren Felder.
Wenn Sie ein bestimmtes Feld auf den Standardwert zurücksetzen möchten, fügen Sie den Feldpfad in die Maske ein und belassen Sie das Feld in der Ressourcenstruktur auf dem Standardwert.
Felder einer Ressource aktualisieren
So erstellen Sie ein Secret und aktualisieren die Felder labels und annotations selektiv mit einer FieldMask:
Initialisieren Sie einen
SecretManagerService-Client und erstellen Sie ein Secret mit leeremlabelsundannotations:Senden Sie eine
update_secret-Anfrage, in derlabels,annotations, der aktuelleetag, um das Überschreiben gleichzeitiger Aktualisierungen zu verhindern, und eine Aktualisierungsmaske für"annotations"und"labels"festgelegt werden:Der Aufruf
set_update_maskgibt die genauen Feldpfade an, die geändert werden sollen:
Die Ausgabe bestätigt, dass beide Felder aktualisiert wurden:
labels: {"updated": "your-label"},
...
annotations: {"updated": "your-annotations"},
Vollständiger Code
Mit der folgenden Funktion werden die Erstellung des Secrets und die Aktualisierung der Feldmaske kombiniert:
Bereinigen
Löschen Sie das Secret your-secret, wenn Sie fertig sind, um zu verhindern, dass Ihrem Google Cloud -Konto Gebühren in Rechnung gestellt werden und bei nachfolgenden Ausführungen ALREADY_EXISTS-Fehler auftreten.