HTTP

מחבר ה-HTTP מספק קישוריות לשירות HTTP ומאפשר לכם להשתמש בממשקי API שמבוססים על HTTP. המחבר תומך גם בקישוריות SSL/TLS באמצעות הגדרה מותאמת אישית, ובמנגנוני אימות שונים כמו OAuth 2.0 Client Credentials Grant, ‏ Basic ו-Digest.

לפני שמתחילים

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

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

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

    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

    אם השירותים או ההרשאות האלה לא הופעלו בפרויקט שלכם בעבר, תתבקשו להפעיל אותם כשאתם מגדירים את המחבר.

הגדרת המחבר

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

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, בוחרים את המיקום של החיבור.
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות HTTP מהרשימה הנפתחת של המחברים הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. אפשר גם לציין כתובת URL של נקודת קצה בשדה בדיקת סטטוס כדי לבדוק את סטטוס החיבור. כתובת ה-URL יכולה לכלול גם כתובת IP של קובץ מצורף של נקודת קצה. הסטטוס הוא פעיל כברירת מחדל.
    8. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

    9. שימוש ב-proxy: מסמנים את התיבה כדי להגדיר שרת proxy לחיבור.
      1. לוחצים על + הוספת יעד.
      2. בוחרים סוג יעד.
        • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.

          כדי ליצור חיבור פרטי לשרת העורפי, פועלים לפי השלבים הבאים:

    10. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    11. אם רוצים להשתמש ב-SSL, בוחרים באפשרות הפעלת SSL. יוצגו פרטי ההגדרה של SSL.
      1. בוחרים סוג של מאגר אישורים. הוא יכול להיות גלוי לכולם, פרטי או חיבור לא מאובטח.
      2. בוחרים את האישורים שמוצגים על סמך הבחירה שלכם במאגר האישורים.
      3. אם אתם משתמשים באישור בחתימה עצמית או באישור של מאגר אישורים פרטי, אתם צריכים לאחסן את אישור הבסיס כסוד ב-Secret Manager בפורמט PEM (דואר עם פרטיות משודרגת), ואז במאגר אישורים מותאם אישית, לבחור את הסוד הנדרש.
      4. אם אתם משתמשים ב-mTLS, בוחרים את האישורים של מאגר המפתחות בקטע Key Store.
      5. אופציונלי: בוחרים את גרסת ה-TLS.
      6. מזינים את סט האלגוריתמים להצפנה הנתמך. מזינים כמה חבילות הצפנה, מופרדות בפסיקים. מידע נוסף זמין במאמר בנושא חבילות הצפנה נתמכות.
    12. לוחצים על הבא.
  5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
    1. סוג היעד: בוחרים סוג יעד.
      • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
      • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.

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

      כדי להזין יעדים נוספים, לוחצים על + הוספת יעד.

    2. לוחצים על הבא.
  6. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      חיבור ה-HTTP תומך בסוגי האימות הבאים:

      2. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

    2. לוחצים על הבא.
  7. בדיקה: בודקים את פרטי החיבור והאימות.
  8. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

  • אימות מותאם אישית

    אפשר להוסיף פרטי הרשאה מותאמים אישית ככותרת בקשה במהלך ביצוע הפעולה של משימת המחברים.

  • OAuth 2.0 – הענקת פרטי כניסה של לקוח
    • ‫Client ID: מזהה הלקוח שישמש לאימות בקשת HTTP.
    • Client Secret: סוד ב-Secret Manager שמכיל את סוד הלקוח לאימות בקשת HTTP.
    • פורמט הבקשה לאסימון גישה: פורמט הבקשה שמשמש לבקשות שנשלחות כדי לאחזר אסימון גישה משרת האימות. בוחרים באפשרות body כדי להעביר את מזהה הלקוח ואת הסוד כגוף הבקשה, או באפשרות header כדי להעביר אותם ככותרת מקודדת.
    • נתיב לבקשת טוקן: נתיב הבקשה שיוצמד לכתובת ה-URL של שרת האימות כדי לאחזר את כתובת ה-URL של טוקן הגישה.
    • זמן התפוגה שמוגדר כברירת מחדל: זמן התפוגה שמוגדר כברירת מחדל (בשניות) לאסימון הגישה. הזמן הזה ישמש במקרה שלתגובת טוקן הגישה אין תאריך תפוגה. אם לא תספקו את הערך הזה, הטוקן יתעדכן תוך 6 שעות.
  • Basic Authentication
    • שם משתמש: שם המשתמש שמשמש ליצירת בקשת HTTP.
    • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת לשם המשתמש שצוין.
  • Digest Authentication
    • שם משתמש: שם המשתמש שמשמש ליצירת בקשת HTTP.
    • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת לשם המשתמש שצוין.
  • OAuth 2.0 – קוד הרשאה
    • Client ID: מזהה הלקוח כפי שסופק על ידי האפליקציה החיצונית.
    • היקפי הרשאות: היקפי הרשאות שנתמכים על ידי האפליקציה החיצונית.
    • סוד לקוח: בוחרים באפשרות סוד ב-Secret Manager. צריך ליצור את הסוד של Secret Manager לפני שמגדירים את ההרשאה הזו.
    • גרסת סוד: גרסת סוד ב-Secret Manager של סוד הלקוח.
    • אופציונלי: מפעילים PKCE (מפתח אימות להחלפת קוד) אם שרת הקצה העורפי תומך בו.
    • כתובת URL להרשאה: מזינים את כתובת ה-URL להרשאה של האפליקציה החיצונית.
    • כתובת אתר של טוקן גישה: מזינים את כתובת ה-URL לקבלת טוקן הגישה של האפליקציה החיצונית.

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

  • חשבון שירות

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

    • היקפים: בוחרים את היקפי OAuth 2.0 הנדרשים מהתפריט הנפתח. מידע נוסף זמין במאמר בנושא היקפי גישה.
  • אימות באמצעות אסימון מזהה של חשבון שירות

    בוחרים באפשרות הזו כדי לבצע אימות באמצעות אסימון המזהה שנוצר מחשבון השירות שציינתם בשלבים הקודמים. האימות הזה מתבסס על אסימוני JWT (‏JSON Web Tokens). ספק האסימונים המזהים חותם על אסימוני ה-JWT ומוציא אותם לאימות באמצעות חשבון שירות.

    • קהל: מזינים את הנמענים שאליהם ה-JWT מיועד.
    • שם הכותרת: מזינים את שם הכותרת של טוקן המזהה שנוצר, לשימוש בכותרת ה-HTTP. אם לא מציינים ערך בשדה הזה, ערך ברירת המחדל של המפתח הוא Authorization.
  • אימות באמצעות מפתח API

    בוחרים באפשרות הזו כדי לבצע אימות באמצעות מפתח API.

    • מפתח API: בוחרים את הסוד של מפתח ה-API ב-Secret Manager.
    • גרסת Secret: בוחרים את גרסת ה-Secret.
    • שם הפרמטר של מפתח ה-API: מזינים שם פרמטר למפתח ה-API. מפתח API נשלח לשרת הקצה העורפי שלכם כצמד מפתח/ערך. הערך שמזינים כאן ישמש כשם המפתח של מפתח ה-API שנבחר קודם.
    • מיקום מפתח ה-API: בוחרים את המיקום שבו רוצים להוסיף את מפתח ה-API בבקשה.

סטים נתמכים של אלגוריתמים להצפנה

גרסת TLS סטים נתמכים של אלגוריתמים להצפנה
1.2
  • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
  • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
  • TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA
  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA
  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
‫1.3
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256
  • TLS_AES_128_GCM_SHA256

שלבים נוספים אחרי יצירת החיבור

אם בחרתם באפשרות OAuth 2.0 - Authorization code לאימות, אתם צריכים לבצע את השלבים הנוספים הבאים אחרי יצירת החיבור:

  1. בדף החיבורים, מאתרים את החיבור החדש.

    שימו לב שהסטטוס של המחבר החדש יהיה נדרשת הרשאה.

  2. לוחצים על דרושה הרשאה.

    יוצג לוח עריכת הרשאה.

  3. מעתיקים את הערך של Redirect URI (ה-URI של ההפניה האוטומטית) לאפליקציה החיצונית.
  4. מאמתים את פרטי ההרשאה.
  5. לוחצים על Authorize.

    אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

אישור מחדש של קוד הרשאה

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

  1. לוחצים על החיבור הרצוי בדף החיבורים.

    ייפתח הדף עם פרטי החיבור.

  2. לוחצים על עריכה כדי לערוך את פרטי החיבור.
  3. בודקים את הפרטים של OAuth 2.0 – קוד הרשאה בקטע אימות.

    אם צריך, מבצעים את השינויים הנדרשים.

  4. לוחצים על Save. הלחיצה תעביר אתכם לדף פרטי החיבור.
  5. בקטע אימות, לוחצים על עריכת הרשאה. מוצגת החלונית Authorize (אישור).
  6. לוחצים על Authorize.

    אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

ישויות, פעולות ופעולות

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

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

    עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

  • פעולה: פעולה היא הפעילות שאפשר לבצע בישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:

    בחירה של ישות מתוך הרשימה הזמינה יוצרת רשימה של פעולות שזמינות לישות. תיאור מפורט של הפעולות זמין במאמר פעולות על ישויות של משימת המחברים. עם זאת, אם מחבר לא תומך באף אחת מהפעולות על ישויות, הפעולות הלא נתמכות האלה לא יופיעו ברשימה Operations.

  • פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

מגבלות המערכת

  • מחבר ה-HTTP לא תומך בסוג התוכן multipart/form-data.

  • מחבר HTTP יכול לעבד 100 טרנזקציות בשנייה, לכל צומת, ומגביל את כל הטרנזקציות שחורגות מהמגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

    מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

פעולות נתמכות

מחבר ה-HTTP תומך בפעולות הבאות:

פעולת HttpRequest

מחבר ה-HTTP מבטיח לפחות ניסיון אחד לשלוח את הבקשה לנקודת הקצה שהוגדרה. השימוש כפוף להסכם רמת השירות (SLA) של Application Integration. בטבלאות הבאות מתוארים פרמטרי הקלט והפלט של פעולת HttpRequest.

פרמטרים של קלט לפעולה HttpRequest

שם הפרמטר סוג נתונים חובה תיאור
כתובת אתר Struct לא כתובת ה-URL שאליה רוצים לשלוח את הבקשה. כתובת ה-URL היא בפורמט <scheme>://<netloc>/<path>;<params>?<query>#<fragment>. אם מציינים את netloc, הוא מבטל את שם המארח שצוין במהלך יצירת החיבור.
‏Method String לא שיטת בקשת HTTP, כמו GET, ‏ POST, ‏ DELETE או PUT. ערך ברירת המחדל הוא GET.
כותרות Struct לא כותרות של בקשת HTTP.
גוף String לא גוף בקשת HTTP.
RequestHasBytes בוליאני לא האם לשלוח את הבקשה כבייטים. אם הערך הוא true, צריך לשלוח את הבקשה כמחרוזת בקידוד Base64 בפרמטר Body. ערך ברירת המחדל הוא false.
ResponseHasBytes בוליאני לא האם לקבל את התשובה כבייטים. אם הערך הוא true, התגובה תתקבל כמחרוזת בקידוד Base64 בפרמטר הפלט ResponseBody. ערך ברירת המחדל הוא false.
HttpVersion String לא גרסת ה-HTTP שבה יש להשתמש כששולחים בקשה. הערכים הנתמכים הם 1.1 ו-2. אם מציינים גרסה 2, מתבצע משא ומתן של ALPN (התאמת פרוטוקול בשכבת האפליקציה), ואם השרת לא תומך בגרסה 2, נעשה שימוש בגרסה 1.1. ערך ברירת המחדל הוא 2.
ResponseFormat String לא מציין את הפורמט של התגובה מהמחבר. הערכים הנתמכים הם v1 ו-v2. ערך ברירת המחדל הוא v1.

דוגמה לתשובה בגרסה v1:

[{
"ResponseBody": "{\n \"status\": 200\n}"
}, {
"StatusCode": 200.0
}, {
"HttpVersion": "2"
}, {
"ResponseHeaders": {
":status": "200",
"content-length": "19"
}
}]

דוגמה לתשובה בגרסה 2:

[{
"ResponseBody": "{\n \"status\": 200\n}",
"StatusCode": 200.0,
"HttpVersion": "2",
"ResponseHeaders": {
":status": "200",
"content-length": "19"
}
}]
FailOnError בוליאני לא מגדיר את אופן הפעולה של החיבור אם יש שגיאה באפליקציית ה-Backend.
  • ‫true – מעלה חריגה. החריגה שנוצרת ב-backend מועברת בתגובה של החיבור.
  • ‫false – לא מוצגת חריגה. אבל מחזירה את קוד השגיאה ואת הודעת השגיאה בתגובה.

ערך ברירת המחדל הוא true.
זמן קצוב לתפוגה מספר שלם לא ערך פסק הזמן לבקשת HTTP בשניות. הערך המקסימלי המותר הוא 150 שניות.

פרמטרים של פלט של פעולת HttpRequest

שם הפרמטר סוג נתונים תיאור
ResponseBody String התקבלה תגובה משרת ה-HTTP.
StatusCode מספר שלם קוד הסטטוס שהתקבל משרת ה-HTTP.
HttpVersion String הגרסה שנקבעה בבקשת ה-HTTP.
ResponseHeaders Struct כותרות של תגובת HTTP בצורה של זוגות key,value.

דוגמאות

בדוגמאות שבקטע הזה מתוארות הפעולות הבאות:

  • הגדרת מטען ייעודי (payload) של בקשה
  • שליחת תוכן בבייטים
  • שליפת תוכן בבייטים

בטבלה הבאה מפורטים תרחישים לדוגמה וההגדרות המתאימות להם במשימה Connectors:

משימה הגדרות אישיות
הגדרת מטען ייעודי (payload) של בקשה
  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה HttpRequest ולוחצים על סיום.
  3. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Url": {
    "scheme": "https",
    "netloc": "httpbin.org",
    "path": "post",
    "query": "example=A&sort=value",
    "fragment": "exampleFragment"
  },
  "Method": "POST",
  "Headers": {
    "Accept": ["application/json", "application/xml"],
    "a": "b"
  },
  "Body": "{\"thisIsRequestJSON\":\"someValue\"}"
}
  4. לוחצים על Save.

בדוגמה הזו נשלחת בקשת POST לכתובת ה-URL‏ https://httpbin.org/post?example=A&=value#exampleFragment. בנוסף, מכיוון שהערך netloc מסופק במטען הייעודי (payload), הוא מבטל את שם המארח שסופק במהלך יצירת החיבור.

שליחת תוכן בבייטים

כדי לשלוח תוכן של בייטים (כמו קבצים), צריך להגדיר את מאפיין הבקשה RequestHasBytes לערך true, ואת מאפיין body למחרוזת המקודדת ב-Base64 שרוצים לשלוח, כמו בדוגמה הבאה.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה HttpRequest ולוחצים על סיום.
  3. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Url": {
    "scheme": "https",
    "netloc": "httpbin.org",
  },
  "Method": "POST",
  "Headers": {
    "Accept": ["application/json", "application/xml"],
    "a": "b"
  },
  "Body": "SGVsbG8gV29ybGQ=",
  "RequestHasBytes":true
}
  4. לוחצים על Save.

בדוגמה הזו מתבצעת בקשת POST לשרת httpbin.org, ובגוף הבקשה נשלח תוכן הקובץ כמחרוזת מקודדת של Base64. השרת יכול להחליט איך לעבד את תוכן הקובץ.
שליפת תוכן בבייטים

כדי לקבל בייטים (כמחרוזת Base64) מהשרת, צריך להגדיר את מאפיין הבקשה ResponseHasBytes לערך true, כמו בדוגמה הבאה.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה HttpRequest ולוחצים על סיום.
  3. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Url": {
    "scheme": "https",
    "netloc": "httpbin.org",
  },
  "Method": "GET",
  "ResponseHasBytes":true
}
  4. לוחצים על Save.

בדוגמה הזו מתבצעת בקשת GET לשרת httpbin.org, ובגוף הבקשה מוגדר הערך true ל-ResponseHasBytes.

קודי שגיאה

בקטע הזה מתוארות הודעות השגיאה שעשויות להופיע כשמשתמשים בחיבור HTTP.

הודעת השגיאה מטרה
שגיאה בחיבור לשרת ה-HTTP החיבור ל-HTTP נכשל כי לא הצלחנו ליצור חיבור עם השרת בגלל כשל בלחיצת היד של SSL או בגלל נקודת קצה שגויה של שרת HTTP.
התקבלה תגובת שגיאה משרת ה-HTTP שרת ה-HTTP שאליו אתם מנסים להתחבר מחזיר תגובת שגיאה עם קוד סטטוס 4xx או 5xx. דוגמה לתשובה: 
{
  "error": {
    "code": 400,
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "metadata": {
          "Body": "{\"thisIsResponseJSON\":\"someValue\"}"
          "Error": "Error response received from the HTTP server",
          "Headers": "{\":status\":[\"400\"], \"access-control-allow-credentials\":[\"true\"]}",
          "StatusCode": "400",
          "connection_type": "Http"
        }
      }
    ],
    "message": "Unable to execute HTTP Request",
    "status": "FAILED_PRECONDITION"
  }
}
שגיאה באחזור טוקן גישה אירעה שגיאה באחזור טוקן הגישה לסוג האימות OAuth Client Credentials Grant.
שגיאה באימות באמצעות תקציר זמן הריצה של המחבר לא קיבל אתגר סיכום או שהאתגר הוא מסוג לא נתמך.
שגיאה 400 שרת ה-HTTP מחזיר תגובת שגיאה עם קוד סטטוס 400. פרטים נוספים מופיעים בגוף התגובה.

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

כדי לראות תבנית לדוגמה של Terraform ליצירת חיבור, אפשר לעיין בתבנית לדוגמה.

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

שם הפרמטר סוג נתונים חובה תיאור
proxy_enabled בוליאני לא נכון מסמנים את תיבת הסימון הזו כדי להגדיר שרת Proxy לחיבור.

שימוש בחיבור HTTP בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

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