리전 엔드포인트 지정

Cloud Translation - Advanced는 EU 리전 API 엔드포인트를 제공합니다. 리전 엔드포인트를 사용하는 경우 저장 데이터는 EU의 대륙 경계 내에 유지됩니다. 엔드포인트 지정은 현지 규제 요건을 준수하기 위해 데이터 위치를 제어해야 하는 경우에 중요합니다. Cloud Translation - Advanced EU 리전 API 엔드포인트는 translate-eu.googleapis.com입니다.

EU 리전 API 엔드포인트를 사용할 경우 전역 엔드포인트(translate.googleapis.com)를 사용할 때와 몇 가지 차이점이 있습니다.

  • 커스텀 AutoML 모델을 사용하는 텍스트 번역은 지원되지 않습니다. 선행 학습된 NMT 모델만 사용할 수 있습니다.
  • 일괄 번역은 지원되지 않습니다.
  • Document Translation처럼 GA가 아닌 기능(아직 미리보기 모드)은 지원되지 않습니다.
  • 전역 엔드포인트를 통한 호출에서는 europe-west1 위치의 EU 엔드포인트를 사용하여 생성된 리소스에 액세스할 수 없습니다. 마찬가지로 EU 엔드포인트를 통한 호출은 전역 엔드포인트를 사용하여 생성된 리소스에도 액세스할 수 없습니다.

리소스 위치 제한

조직 정책 관리자는 리소스 위치 제약조건을 만들어 Cloud Translation - Advanced 리소스에 사용 가능한 리전을 제한할 수 있습니다.

사용 예

다음 예시에서는 리전 엔드포인트를 사용하는 텍스트 번역을 보여줍니다. 클라이언트 라이브러리를 사용하는 경우 API 엔드포인트를 클라이언트 옵션의 일부로 설정합니다. 몇 가지 예시를 보려면 Cloud Natural Language API 가이드에서 클라이언트 라이브러리를 사용하여 위치 설정을 참조하세요.

REST 및 명령줄

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트 번호 또는 ID
  • ENDPOINT: 데이터가 있는 위치를 결정하는 리전 엔드포인트입니다. translate-eu.googleapis.com).
  • LOCATION: 이 작업을 실행할 리전입니다. 리전 엔드포인트의 대륙 경계 내에 있는 리전을 선택해야 합니다. 예를 들어 translate-eu.googleapis.com 엔드포인트를 사용하는 경우 europe-west1과 같은 유럽 리전을 지정합니다.

HTTP 메서드 및 URL:

POST https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText

JSON 요청 본문:

{
  "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base",
  "sourceLanguageCode": "en",
  "targetLanguageCode": "de",
  "contents": ["Come here!"]
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText "

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText " | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "translations": [
    {
      "translatedText": "Komm her!",
      "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base"
    }
  ]
}