클라이언트를 초기화하는 방법

Google Cloud Rust용 클라이언트 라이브러리는 클라이언트를 특정 서비스와 인터페이스하는 기본 추상화로 사용합니다. 클라이언트는 서비스에서 제공하는 각 RPC에 해당하는 메서드가 있는 Rust 구조체로 구현됩니다. 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