Client initialisieren

In den Google Cloud Clientbibliotheken für Rust werden Clients als Hauptabstraktion für die Interaktion mit bestimmten Diensten verwendet. Clients werden als Rust-Strukturen implementiert, wobei jede RPC-Methode des Dienstes einer Methode entspricht. Wenn Sie einenGoogle Cloud -Dienst mit den Rust-Clientbibliotheken verwenden möchten, müssen Sie zuerst einen Client initialisieren.

In dieser Anleitung initialisieren Sie einen Client und verwenden ihn dann, um einen RPC mit der Secret Manager API auszuführen. Dieselbe Struktur gilt für alle anderen Dienste in Google Cloud.

Bevor Sie diese Anleitung durcharbeiten, sollten Sie Folgendes tun:

• Folgen Sie einem der Secret Manager-Startleitfäden, z. B. dem Leitfaden zum Erstellen eines Secrets. In diesen Leitfäden werden dienstspezifische Konzepte ausführlicher behandelt und detaillierte Informationen zu den Projektvoraussetzungen bereitgestellt.
• Folgen Sie der Anleitung im Leitfaden zur Authentifizierung für die Verwendung von Clientbibliotheken. In dieser Anleitung erfahren Sie, wie Sie sich anmelden, um die Standardanmeldedaten für Anwendungen zu konfigurieren, die in dieser Anleitung verwendet werden.

Abhängigkeiten

In Rust müssen Sie die Abhängigkeit in der Datei Cargo.toml deklarieren:

$ cargo add google-cloud-secretmanager-v1

Rufen Sie zuerst Client::builder() auf, um ein geeignetes ClientBuilder zu erhalten, und rufen Sie dann build() für diesen Builder auf, um einen Client zu erstellen.

Mit dem folgenden Code wird ein Client mit der Standardkonfiguration erstellt, die für die meisten Anwendungsfälle geeignet ist.

    let client = SecretManagerService::builder().build().await?;

Sobald der Client erfolgreich initialisiert wurde, können Sie ihn für RPCs verwenden:

    use google_cloud_gax::paginator::Paginator as _;
    let mut items = client
        .list_locations()
        .set_name(format!("projects/{project_id}"))
        .by_page();
    while let Some(page) = items.next().await {
        let page = page?;
        for location in page.locations {
            println!("{}", location.name);
        }
    }

In diesem Beispiel wird list_locations aufgerufen, um Informationen zu den unterstützten Standorten für den Dienst (in diesem Fall Secret Manager) zurückzugeben.

Die Ausgabe des Beispiels sollte in etwa so aussehen:

projects/123456789012/locations/europe-west8
projects/123456789012/locations/europe-west9
projects/123456789012/locations/us-east5