סקירה כללית על נקודת קצה ל-API של Google Cloud

נקודת קצה ל-API, או נקודת קצה של שירות, היא כתובת URL שמציינת את כתובת הרשת של שירות API, כמו Google Cloud .bigquery.googleapis.com שירותים מאפשרים גישה למשאבים באמצעות סוגים שונים של נקודות קצה ל-API, כולל אזוריות, רב-אזוריות, גלובליות ומיקומיות. התמיכה בכל סוג של נקודת קצה תלויה בשירות.Google Cloud

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

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

נקודות קצה אזוריות של API מספקות גישה לשירותים דרך נקודת קצה של API שמצומצמת לאזור יחיד. התעבורה שנשלחת לנקודת קצה אזורית מעובדת ומסתיימת ב-TLS באופן מלא באזור שצוין. Google Cloud Google Cloud

ברוב השירותים Google Cloud , אפשר להשתמש בנקודות קצה אזוריות כדי לעבוד עם משאבים אזוריים באזור שצוין. בדרך כלל אין תמיכה בפעולות על משאבים גלובליים, על משאבים בכמה אזורים ועל משאבים אזוריים מחוץ לאזור מנקודת הקצה האזורית.

נקודות קצה אזוריות של API מציינות את המיקום כתת-דומיין. נקודות קצה אזוריות ציבוריות הן בפורמט הבא:

SERVICE.REGION.rep.googleapis.com

  • ‫SERVICE: השם של שירות Google Cloud , כמו storage,‏ compute או bigquery.
  • ‫REGION: שם האזור, למשל Google Cloud או us-central1.europe-west1

נקודות קצה פרטיות ל-API אזורי הן בפורמט הבא:

SERVICE.REGION.p.rep.googleapis.com

  • ‫SERVICE: השם של שירות Google Cloud , כמו storage,‏ compute או bigquery.
  • ‫REGION: שם האזור, למשל Google Cloud או us-central1.europe-west1
  • ‫.p.: מציין יעד פרטי שמיועד לקישוריות של Private Service Connect.

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

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

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

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

SERVICE.MULTI_REGION.rep.googleapis.com

  • ‫SERVICE: השם של שירות Google Cloud , כמו storage,‏ compute או bigquery.
  • ‫MULTI_REGION: השם של Google Cloud האזור המרובה, למשל us או eu.

נקודות קצה פרטיות של API עם מספר אזורים מופיעות בפורמט הבא:

SERVICE.MULTI_REGION.p.rep.googleapis.com

  • ‫SERVICE: השם של שירות Google Cloud , כמו storage,‏ compute או bigquery.
  • ‫MULTI_REGION: השם של האזור הרב-אזורי, למשל us או eu. Google Cloud
  • ‫.p.: מציין יעד פרטי שמיועד לקישוריות של Private Service Connect.

נקודות קצה גלובליות

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

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

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

SERVICE.googleapis.com

‫SERVICE הוא שם השירות Google Cloud , למשל storage,‏ compute או bigquery.

נקודות קצה למיקום

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

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

  • חיבורים שעומדים בדרישות בנושא מיקום הנתונים, ממערכות מקומיות דרך האינטרנט
  • בידוד של דומיין כשל

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

LOCATION-SERVICE.googleapis.com

  • ‫LOCATION: שם האזור, למשל Google Cloud ,‏ us-central1 או europe-west1.us
  • ‫SERVICE: השם של שירות Google Cloud , כמו storage,‏ compute או bigquery.

מאמרי עזרה

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