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

בדף הזה מוסבר על נקודות קצה (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 גלובלית. מידע נוסף מופיע במאמר בנושא הגבלת השימוש בנקודות קצה.

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