기본 엔드포인트 재정의

Rust 클라이언트 라이브러리는 각 서비스의 엔드포인트를 자동으로 구성합니다. 일부 애플리케이션은 네트워크에 특정 요구사항이 있거나 서비스의 지역 버전을 사용해야 하기 때문에 기본 엔드포인트를 재정의해야 할 수 있습니다. 이 가이드에서는 기본값을 재정의하는 방법을 보여줍니다.

기본 요건

이 가이드에서는 Secret Manager API를 사용합니다. 이 API를 사용 설정하려면 서비스 빠른 시작을 따르세요.

Rust 클라이언트 라이브러리의 전체 설정 안내는 Rust 시작하기를 참고하세요.

종속 항목

Cargo.toml 파일에서 종속 항목을 선언해야 합니다.

cargo add google-cloud-secretmanager-v1 google-cloud-gax

기본 엔드포인트

먼저 기본 엔드포인트로 클라이언트 라이브러리를 사용하는 방법을 검토합니다. 먼저 사용 선언을 작성하여 나머지 예시를 간소화합니다.

1. 프로젝트 ID를 매개변수로 받는 함수에 예시를 작성합니다.

   /// # Parameters
   /// - `project_id`: the id of a Google Cloud project, or its numeric ID.
   ///   For example: `my-project`.
   pub async fn sample(project_id: &str) -> anyhow::Result<()> {

2. 예시 코드를 간소화하기 위해 몇 가지 사용 선언을 추가합니다.

   pub use google_cloud_gax::paginator::ItemPaginator;
   pub use google_cloud_secretmanager_v1::client::SecretManagerService;

3. 기본값을 사용하여 클라이언트를 초기화합니다.

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

4. 이 클라이언트를 평소와 같이 사용합니다.

   let mut items = client
       .list_secrets()
       .set_parent(format!("projects/{project_id}"))
       .by_item();
   println!("listing all secrets in project {project_id}");
   while let Some(secret) = items.next().await.transpose()? {
       println!("  {secret:?}");
   }
   println!("DONE");

기본 엔드포인트 재정의

이 예에서는 Secret Manager의 리전 엔드포인트를 사용하도록 클라이언트 라이브러리를 구성합니다. 동일한 재정의를 사용하여 비공개 액세스 옵션 중 하나로 엔드포인트를 구성하거나 이를 지원하는 서비스의 위치 엔드포인트를 구성할 수 있습니다.

1. 이전과 마찬가지로 프로젝트 ID와 리전을 매개변수로 수신하는 예시를 작성합니다.

   /// # Parameters
   /// - `project_id`: the id of a Google Cloud project, or its numeric ID.
   ///   For example: `my-project`.
   /// - `region`: the id of a Gooogle Cloud region. For example `us-central1`.
   pub async fn sample(project_id: &str, region: &str) -> anyhow::Result<()> {

2. 사용 선언을 추가하여 코드를 단순화합니다.

   pub use google_cloud_gax::paginator::ItemPaginator;
   pub use google_cloud_secretmanager_v1::client::SecretManagerService;

3. 타겟 엔드포인트를 사용하여 클라이언트를 초기화합니다.

   let client = SecretManagerService::builder()
       .with_endpoint(format!("https://secretmanager.{region}.rep.googleapis.com"))
       .build()
       .await?;

4. 이 클라이언트를 평소와 같이 사용합니다.

   let mut items = client
       .list_secrets()
       .set_parent(format!("projects/{project_id}/locations/{region}"))
       .by_item();
   println!("listing all secrets in project {project_id} and region {region}");
   while let Some(secret) = items.next().await.transpose()? {
       println!("  {secret:?}");
   }
   println!("DONE");