クライアントを初期化する方法

Google Cloud Rust 用クライアント ライブラリは、特定のサービスとやり取りするためのメインの抽象化としてクライアントを使用します。クライアントは Rust 構造体として実装され、サービスが提供する各 RPC に対応するメソッドがあります。Rust クライアント ライブラリを使用してGoogle Cloud サービスを使用するには、まずクライアントを初期化する必要があります。

このガイドでは、クライアントを初期化し、そのクライアントを使用して Secret Manager API を使用して RPC を作成します。同じ構造が Google Cloudの他のサービスにも適用されます。

このガイドに進む前に、次のことを行ってください。

• Secret Manager のスタートガイド（シークレットを作成する方法に関するガイドなど）のいずれかに沿って操作します。これらのガイドでは、サービス固有のコンセプトについて詳しく説明し、プロジェクトの前提条件に関する詳細なガイダンスを提供します。
• クライアント ライブラリを使用して認証するガイドの手順に沿って操作します。このガイドでは、このガイドで使用するアプリケーションのデフォルト認証情報にログインする方法について説明します。

依存関係

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