기본 엔드포인트 재정의

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