הגדרת נקודות קצה של ספריות לקוח

הגישה לכל שירות Google Cloud API מתבצעת דרך נקודת קצה ספציפית לשירות.

לדוגמה, לספריות הלקוח Java-Speech ו-Java-Translate יש נקודות קצה שמוגדרות כברירת מחדל: https://speech.googleapis.com:443 ו-https://translate.googleapis.com:443 בהתאמה.

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

המבנה של נקודת קצה

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

Scheme	שם השירות	דומיין היקום	יציאה
https://	דיבור	googleapis.com	443

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

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

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

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

משנים את הגדרות נקודת הקצה רק אם יש צורך בכך. כשמשתמשים בנקודת קצה מותאמת אישית, צריך לכלול את מספר היציאה (לדוגמה, example.com:443). ספריות הלקוח לא מוסיפות באופן אוטומטי יציאת ברירת מחדל כמו 443 לנקודות קצה מותאמות אישית, בניגוד למה שקורה עם נקודות קצה של שירותי ברירת מחדל.

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

אפשר להגדיר את נקודת הקצה מתוך ClientSettings ספציפי לשירות בספריות הלקוח של Cloud ל-Java.

בדוגמה הבאה מוצג שימוש ב-Java-KMS:

1. מגדירים את נקודת הקצה ב-ClientSettings.Builder ויוצרים את ClientSettings:

   // Replace with your desired endpoint
   String endpoint = "customEndpoint.com:443";
   KeyManagementServiceSettings keyManagementServiceSettings =
    KeyManagementServiceSettings.newBuilder()
       .setEndpoint(endpoint)
       .build();
   

2. מפעילים את הלקוח באמצעות ClientSettings:

   try (KeyManagementServiceClient keyManagementServiceClient =
     KeyManagementServiceClient.create(keyManagementServiceSettings)) {
     ...
   }
   

   נקודת הקצה הופכת ל-customEndpoint.com:443.

   הלקוח משתמש בנקודת הקצה מהמקור הראשון מבין המקורות הבאים שמספק נקודת קצה:

   1. נקודת הקצה מוגדרת באופן פרוגרמטי באמצעות ClientSettings.Builder.setEndpoint().
   2. נקודת הקצה שמוגדרת כברירת מחדל בשירות, כמו https://{serviceName}.googleapis.com:443.

בקטע הקוד הבא אפשר לראות איך קובעים את נקודת הקצה שנפתרה של הלקוח:

// The client's settings class contains a getter for the endpoint
keyManagementServiceClient.getSettings().getEndpoint();