전역 및 멀티 리전 엔드포인트

Cloud Translation - Advanced는 전역 엔드포인트는 물론 EU 및 US 멀티 리전 엔드포인트를 제공합니다.

  • translate.googleapis.com(전역)
  • translate-eu.googleapis.com
  • translate-us.googleapis.com

멀티 리전 엔드포인트를 사용하는 경우 저장 데이터 및 머신러닝 처리가 EU 또는 US의 대륙 경계 내에 유지됩니다. 이러한 멀티 리전 엔드포인트는 현지 규제 요건을 준수하기 위해 데이터 위치를 제어해야 하는 경우에 중요합니다.

엔드포인트를 지정하지 않으면 Cloud Translation - Advanced에서 기본적으로 전역 엔드포인트를 사용합니다.

전역 엔드포인트와 멀티 리전 엔드포인트 비교

멀티 리전 엔드포인트를 사용하는 경우 전역 엔드포인트를 사용할 때와 다른 점이 몇 가지 있습니다.

  • 커스텀 AutoML 모델을 사용하는 텍스트 번역은 지원되지 않습니다. 미리 학습된 NMT 모델만 사용할 수 있습니다.
  • GA가 아닌 기능(미리보기에서 지원)은 지원되지 않습니다.
  • 전역 엔드포인트를 통한 호출에서는 멀티 리전 엔드포인트를 사용하여 생성된 리소스에 액세스할 수 없습니다. 마찬가지로 멀티 리전 엔드포인트를 통한 호출에서는 전역 엔드포인트를 사용하여 생성된 리소스에 액세스할 수 없습니다.

리소스 위치 제한

조직 정책 관리자는 리소스 위치 제약조건을 만들어 Cloud Translation - Advanced 리소스에 사용 가능한 리전을 제한할 수 있습니다. 이렇게 하면 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 print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
     -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 print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

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"
    }
  ]
}