נקודות קצה גלובליות ואזוריות של שירותים

בדף הזה מוסבר על נקודות קצה (endpoints) של שירות Spanner ברמה הגלובלית והאזורית, ואיך משתמשים בהן.

נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. ל-Spanner יש נקודות קצה גלובליות ואזוריות. אפשר להשתמש בנקודת קצה (endpoint) של שירות גלובלי או אזורי כדי לשלוח בקשות ל-Spanner.

אם אין לכם דרישות מחמירות להגבלות אזוריות, כדאי להשתמש בנקודת הקצה הגלובלית. למרות שהנתונים מאוחסנים באזור שנבחר, יכול להיות שהם יעובדו מחוץ לאזור. נקודת הקצה הגלובלית של Spanner היא spanner.googleapis.com. נקודת הקצה ל-API שמוגדרת כברירת מחדל היא נקודת הקצה הגלובלית.

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

כאן אפשר לראות אילו אזורים זמינים לשימוש בנקודות קצה אזוריות. מדיניות האחסון הבסיסית של Spanner לא משתנה, לא משנה באיזו נקודת קצה משתמשים.

אבטחה ותאימות לנקודות קצה אזוריות

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

אפשר להשתמש רק בנקודות קצה אזוריות ששייכות להגדרת המופע האזורי הזה. לדוגמה, אי אפשר להשתמש ב-spanner.me-central2.rep.googleapis.com כדי להגיב לבקשות אם המופע שאליו אתם ניגשים שייך להגדרת המופע האזורי us-central1. הבקשה תידחה עם שגיאת InvalidRegionalRequest.

מגבלות של נקודות קצה אזוריות

אי אפשר לגשת להגדרת מופע בשני אזורים או במספר אזורים באמצעות נקודת קצה אזורית. כדי לגשת להגדרות של מופע בשני אזורים או במספר אזורים, צריך להשתמש בנקודת הקצה הגלובלית. לדוגמה, אם יש לכם מופע בהגדרת מופע מרובה אזורים nam7, אתם לא יכולים להשתמש בנקודת הקצה האזורית spanner.us-central1.rep.googleapis.com כדי לשלוח בקשות למופע שלכם ב-nam7.

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

מוסכמה למתן שמות של נקודות קצה אזוריות

השמות של נקודות הקצה האזוריות ב-Spanner זהים למוסכמת מתן השמות של שמות ההגדרות של מופעים אזוריים. נקודת הקצה האזורית היא בפורמט spanner.REGION.rep.googleapis.com. לדוגמה, גם השם של הגדרת מופע אזורי וגם השם של נקודת קצה אזורית בדמאם הם me-central2. לכן, נקודת הקצה האזורית היא spanner.me-central2.rep.googleapis.com.

מידע נוסף זמין במאמר אזורים שבהם אפשר להשתמש בנקודות קצה אזוריות.

ציון נקודת קצה אזורית

אפשר לציין נקודת קצה אזורית של Spanner באמצעות בקשות ל-Google Cloud CLI, ל-REST או ל-RPC API.

gcloud

כדי לציין נקודת קצה אזורית ולבטל את נקודת הקצה הגלובלית, מריצים את הפקודה הבאה:

gcloud config set api_endpoint_overrides/spanner https://spanner.REGION.rep.googleapis.com/

מציינים את הערך הבא:

REGION
האזור שעבורו רוצים להגדיר נקודת קצה אזורית. לדוגמה, me-central2.

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

gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/

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

gcloud config unset api_endpoint_overrides/spanner

API ל-REST

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

https://spanner.REGION.rep.googleapis.com

לדוגמה, אם רוצים לאכוף את ערבויות הנתונים בהגדרת המופע האזורי דמאם (me-central2), משתמשים בפקודה הבאה:

  https://spanner.me-central2.rep.googleapis.com

מידע נוסף זמין במאמרים API בארכיטקטורת REST ואזורים שבהם נקודות קצה אזוריות זמינות.

API ל-RPC

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

spanner.REGION.rep.googleapis.com

לדוגמה, אם רוצים לאכוף את ערבויות הנתונים בהגדרת המופע האזורי דמאם (me-central2), משתמשים בפקודה הבאה:

spanner.me-central2.rep.googleapis.com

מידע נוסף זמין במאמרים בנושא RPC API ואזורים שבהם נקודות קצה אזוריות זמינות.

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

נקודות קצה אזוריות של Spanner זמינות באזורים הבאים:

שם אזורי בסיסי תיאור האזור
אמריקה
us-central1 איווה
us-central2 אוקלהומה
us-east1 דרום קרוליינה
us-east4 צפון וירג'יניה
us-east5 קולומבוס
us-east7 אלבמה
us-south1 דאלאס
us-west1 אורגון
us-west2 לוס-אנג׳לס
us-west3 סולט לייק סיטי
us-west4 לאס וגאס
us-west8 פיניקס
המזרח התיכון
me-central2 דמאם
אירופה
europe-west8 מילאנו

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

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

המאמרים הבאים