Cara melakukan inisialisasi klien

Google Cloud Client Libraries for Rust menggunakan klien sebagai abstraksi utama untuk berinteraksi dengan layanan tertentu. Klien diimplementasikan sebagai struct Rust, dengan metode yang sesuai dengan setiap RPC yang ditawarkan oleh layanan. Untuk menggunakan layanan Google Cloud menggunakan library klien Rust, Anda harus menginisialisasi klien terlebih dahulu.

Dalam panduan ini, Anda akan melakukan inisialisasi klien, lalu menggunakan klien untuk membuat RPC menggunakan Secret Manager API. Struktur yang sama berlaku untuk layanan lain di Google Cloud.

Sebelum mengikuti panduan ini, Anda harus melakukan hal berikut:

• Ikuti salah satu panduan memulai Secret Manager, seperti panduan tentang cara Membuat secret. Panduan ini mencakup konsep khusus layanan secara lebih mendetail, dan memberikan panduan mendetail tentang prasyarat project.
• Ikuti petunjuk di panduan Melakukan autentikasi untuk menggunakan library klien. Panduan ini akan menunjukkan cara login untuk mengonfigurasi Kredensial Default Aplikasi yang digunakan dalam panduan ini.

Dependensi

Dengan Rust, Anda harus mendeklarasikan dependensi dalam file Cargo.toml:

$ cargo add google-cloud-secretmanager-v1

Untuk menginisialisasi klien, Anda harus memanggil Client::builder() terlebih dahulu untuk mendapatkan ClientBuilder yang sesuai lalu memanggil build() pada builder tersebut untuk membuat klien.

Berikut membuat klien dengan konfigurasi default, yang dirancang untuk memenuhi persyaratan sebagian besar kasus penggunaan.

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

Setelah klien berhasil diinisialisasi, Anda dapat menggunakannya untuk membuat RPC:

    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);
        }
    }

Contoh ini menunjukkan panggilan ke list_locations, yang menampilkan informasi tentang lokasi yang didukung untuk layanan (dalam hal ini, Secret Manager).

Output contoh akan terlihat seperti ini:

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