클라이언트 라이브러리 엔드포인트 구성

각 Google Cloud API 서비스는 서비스별 엔드포인트를 통해 액세스합니다.

예를 들어 Java-Speech 및 Java-Translate 클라이언트 라이브러리의 기본 엔드포인트는 각각 https://speech.googleapis.com:443 및 https://translate.googleapis.com:443입니다.

Java용 Cloud 클라이언트 라이브러리는 클라이언트 초기화 중에 올바른 서비스 엔드포인트를 자동으로 결정합니다. 맞춤 엔드포인트가 구성되지 않은 경우 라이브러리는 서비스의 기본 엔드포인트를 사용합니다.

엔드포인트의 구조

Java-Speech 엔드포인트를 예로 들어 다음 표에는 엔드포인트를 구성하는 섹션이 자세히 설명되어 있습니다.

스킴 서비스 이름 Universe 도메인 포트
https:// speech googleapis.com 443

서비스 이름을 제외한 모든 Java용 Cloud 클라이언트 라이브러리 엔드포인트의 기본값입니다. 모든 Google Cloud 서비스의 값이 다르기 때문에 서비스 이름에는 기본값이 없습니다.

맞춤 엔드포인트를 구성해야 하는 경우

다음과 같은 기본 엔드포인트를 대체하는 특정 사용 사례가 있습니다.

  • 서비스에서 리전 엔드포인트를 제공합니다. 기본 엔드포인트는 지역별 변형을 고려하지 않습니다.
  • 프로덕션에서 작업하고 있지 않습니다. 예를 들어 TLS를 구성하지 않고 에뮬레이터로 로컬에서 테스트하고 있습니다.

필요한 경우에만 엔드포인트 구성을 수정하세요. 맞춤 엔드포인트를 사용하는 경우 포트 번호 (예: example.com:443)를 포함해야 합니다. 클라이언트 라이브러리는 기본 서비스 엔드포인트와 달리 맞춤 엔드포인트에 443과 같은 기본 포트를 자동으로 추가하지 않습니다.

맞춤 엔드포인트 구성

Java용 Cloud 클라이언트 라이브러리에서 서비스별 ClientSettings를 사용하여 엔드포인트를 설정할 수 있습니다.

다음 예에서는 Java-KMS를 사용합니다.

  1. ClientSettings.Builder에서 엔드포인트를 설정하고 ClientSettings를 만듭니다.

    // Replace with your desired endpoint
String endpoint = "customEndpoint.com:443";
KeyManagementServiceSettings keyManagementServiceSettings =
 KeyManagementServiceSettings.newBuilder()
    .setEndpoint(endpoint)
    .build();

  2. ClientSettings로 클라이언트를 시작합니다.

    try (KeyManagementServiceClient keyManagementServiceClient =
  KeyManagementServiceClient.create(keyManagementServiceSettings)) {
  ...
}

    엔드포인트가 customEndpoint.com:443로 확인됩니다.

    클라이언트는 다음 소스 중 엔드포인트를 제공하는 첫 번째 소스의 엔드포인트를 사용합니다.

    1. ClientSettings.Builder.setEndpoint()를 통해 프로그래매틱 방식으로 설정된 엔드포인트입니다.
    2. 서비스의 기본 엔드포인트(예: https://{serviceName}.googleapis.com:443)

다음 스니펫은 클라이언트의 확인된 엔드포인트를 확인하는 방법을 보여줍니다.

// The client's settings class contains a getter for the endpoint
keyManagementServiceClient.getSettings().getEndpoint();