איך מאתחלים לקוח

Google Cloud ספריות הלקוח של Rust משתמשות בלקוחות כהפשטה העיקרית ליצירת ממשק עם שירותים ספציפיים. הלקוחות מיושמים כמבני Rust, עם שיטות שמתאימות לכל RPC שהשירות מציע. כדי להשתמש בשירותGoogle Cloud באמצעות ספריות הלקוח של Rust, צריך קודם לאתחל לקוח.

במדריך הזה תאתחלו לקוח ואז תשתמשו בו כדי לבצע RPC באמצעות Secret Manager API. אותה מבנה חל על כל שירות אחר ב- Google Cloud.

לפני שממשיכים במדריך הזה, צריך:

• פועלים לפי אחד מהמדריכים לתחילת העבודה עם Secret Manager, כמו המדריך בנושא יצירת סוד. במדריכים האלה מוסברים מושגים ספציפיים לשירותים בפירוט רב יותר, ומופיעות הנחיות מפורטות לגבי הדרישות המוקדמות של הפרויקט.
• פועלים לפי ההוראות במדריך בנושא אימות לצורך שימוש בספריות לקוח. במדריך הזה נסביר איך להתחבר כדי להגדיר Application Default Credentials שמשמשים במדריך הזה.

תלויות

ב-Rust, צריך להצהיר על התלות בקובץ Cargo.toml:

$ cargo add google-cloud-secretmanager-v1

כדי לאתחל לקוח, קודם קוראים ל-Client::builder() כדי לקבל ClientBuilder מתאים ואז קוראים ל-build() בבונה הזה כדי ליצור לקוח.

הקוד הבא יוצר לקוח עם הגדרת ברירת המחדל, שנועדה לעמוד בדרישות של רוב תרחישי השימוש.

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

אחרי שהלקוח מאותחל בהצלחה, אפשר להשתמש בו כדי לבצע קריאות 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);
        }
    }

בדוגמה הזו מוצגת קריאה אל list_locations, שמחזירה מידע על המיקומים הנתמכים של השירות (במקרה הזה, Secret Manager).

הפלט של הדוגמה אמור להיראות כך:

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