נקודות קצה גלובליות ונקודות קצה במספר אזורים

‫Cloud Translation – Advanced מציע נקודת קצה גלובלית וגם נקודות קצה במספר אזורים באיחוד האירופי ובארה"ב:

• translate.googleapis.com (גלובלי)
• translate-eu.googleapis.com
• translate-us.googleapis.com

אם משתמשים בנקודת קצה רב-אזורית, הנתונים באחסון ועיבוד הלמידה החישובית נשארים בגבולות היבשתיים של האיחוד האירופי או ארה"ב. נקודות הקצה האלה שפועלות בכמה אזורים חשובות אם אתם צריכים לשלוט במיקום הנתונים כדי לעמוד בדרישות רגולטוריות מקומיות.

אם לא מציינים נקודת קצה, Cloud Translation Advanced משתמש בנקודת הקצה הגלובלית כברירת מחדל.

נקודות קצה גלובליות לעומת נקודות קצה במספר אזורים

כשמשתמשים בנקודת קצה רב-אזורית, יש כמה הבדלים בהשוואה לשימוש בנקודת הקצה הגלובלית:

• אין תמיכה בתרגומים של טקסט באמצעות מודלים מותאמים אישית של AutoML. אפשר להשתמש רק במודל NMT שעבר אימון מראש.
• אין תמיכה בתכונות שלא זמינות לקהל הרחב (עדיין בגרסת טרום-השקה).
• בשיחות דרך נקודת הקצה הגלובלית אין גישה למשאבים שנוצרו באמצעות נקודת קצה שכוללת מספר אזורים. באופן דומה, שיחות דרך נקודת קצה (endpoint) רב-אזורית לא יכולות לגשת למשאבים שנוצרו באמצעות נקודת הקצה הגלובלית.

הגבלת מיקומי משאבים

אדמינים של מדיניות הארגון יכולים להגביל את האזורים שזמינים למשאבים של Cloud Translation Advanced על ידי יצירת מגבלה על מיקומי משאבים. אם המדיניות מוגדרת, משתמשים ב-Cloud Translation Advanced יוכלו ליצור משאבים רק במיקום מסוים.

הגבלת השימוש בנקודת קצה גלובלית של API

כדי לאכוף את השימוש בנקודות קצה אזוריות, אדמינים של מדיניות הארגון יכולים להשתמש באילוץ constraints/gcp.restrictEndpointUsage של מדיניות הארגון כדי לחסום בקשות לנקודת קצה ל-API הגלובלית. מידע נוסף מופיע במאמר בנושא הגבלת השימוש בנקודות קצה.

ציון נקודת קצה

בדוגמה הבאה מוצגת תרגום טקסט באמצעות נקודת קצה (endpoint) מרובת אזורים. אם משתמשים בספריות לקוח, צריך להגדיר את נקודת קצה ל-API כחלק מאפשרויות הלקוח. בדוגמאות מסוימות, אפשר לראות איך מגדירים את המיקום באמצעות ספריות לקוח במדריך Cloud Natural Language API.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_NUMBER_OR_ID: המזהה המספרי או האלפאנומרי של פרויקט Google Cloud
• ‫ENDPOINT: נקודת קצה אזורית, שקובעת איפה הנתונים שלכם נמצאים. לדוגמה, translate-eu.googleapis.com.
• ‫LOCATION: האזור שבו רוצים להריץ את הפעולה הזו. צריך לבחור אזור שנמצא בתוך הגבול היבשתי של נקודת הקצה האזורית. לדוגמה, אם משתמשים בנקודת הקצה translate-eu.googleapis.com, צריך לציין אזור באירופה כמו europe-west1.

ה-method של ה-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

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם 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

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם 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"
    }
  ]
}