Endpoint globali e multiregionali

Cloud Translation - Advanced offre un endpoint globale, nonché endpoint multiregionali per l'UE e gli Stati Uniti:

  • translate.googleapis.com (globale)
  • translate-eu.googleapis.com
  • translate-us.googleapis.com

Se utilizzi un endpoint multiregionale, i dati archiviati e l'elaborazione di machine learning rimangono all'interno dei confini continentali dell'UE o degli Stati Uniti. Questi endpoint multiregionali sono importanti se la posizione dei tuoi dati deve essere controllata per rispettare i requisiti normativi locali.

Se non specifichi un endpoint, Cloud Translation - Advanced utilizza l'endpoint globale per impostazione predefinita.

Endpoint globali e multiregionali

Quando utilizzi un endpoint multiregionale, ci sono alcune differenze rispetto all'utilizzo dell'endpoint globale:

  • Le traduzioni di testo che utilizzano modelli AutoML personalizzati non sono supportate. Puoi utilizzare solo il modello NMT preaddestrato.
  • Le funzionalità non GA (ancora in anteprima) non sono supportate.
  • Le chiamate tramite l'endpoint globale non possono accedere alle risorse create utilizzando un endpoint multiregionale. Allo stesso modo, le chiamate tramite un endpoint multiregionale non possono accedere alle risorse create utilizzando l'endpoint globale.

Limitazione delle località delle risorse

Gli amministratori delle policy dell'organizzazione possono limitare le regioni disponibili per le risorse Cloud Translation - Advanced creando un vincolo di località delle risorse. Se impostato, gli utenti di Cloud Translation - Advanced potranno creare risorse solo in una posizione specifica.

Limitazione dell'utilizzo dell'endpoint API globale

Per contribuire a imporre l'utilizzo di endpoint regionali, gli amministratori delle policy dell'organizzazione possono utilizzare il vincolo delle policy dell'organizzazione constraints/gcp.restrictEndpointUsage per bloccare le richieste all'endpoint API globale. Per ulteriori informazioni, vedi Limitare l'utilizzo dell'endpoint.

Specifica un endpoint

L'esempio seguente mostra una traduzione di testo che utilizza un endpoint multiregionale. Se utilizzi le librerie client, imposta l'endpoint API come parte delle opzioni client. Per alcuni esempi, consulta Impostazione della località utilizzando le librerie client nella guida all'API Cloud Natural Language.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo Google Cloud progetto
  • ENDPOINT: endpoint regionale, che determina la posizione dei dati. Ad esempio, translate-eu.googleapis.com.
  • LOCATION: la regione in cui vuoi eseguire questa operazione. Devi scegliere una regione all'interno del confine continentale dell'endpoint regionale. Ad esempio, se utilizzi l'endpoint translate-eu.googleapis.com, specifica una regione in Europa, ad esempio europe-west1.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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