השהיית המשימה

המשימה השהיה מאפשרת להשהות באופן זמני את ההפעלה של שילוב ואז להמשיך אותה.

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

  • תפוגת התוקף של תקופת ההשעיה שצוינה.
  • אחרי קבלת בקשה להמשך ההפעלה מ-API‏ Suspensions.

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

השוואה בין משימת אישור, משימת השהיה ומשימת טיימר

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

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

הגדרת המשימה 'השעיה'

כדי להגדיר את המשימה השעיה, מבצעים את השלבים הבאים:

  1. נכנסים לדף Application Integration במסוף Google Cloud .

    מעבר אל Application Integration

  2. בתפריט הניווט, לוחצים על Integrations (שילובים).

    מוצג הדף Integrations (שילובים) עם רשימה של כל השילובים שזמינים בפרויקט בענן של Google.

  3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

    אם יוצרים שילוב חדש:

    1. מזינים שם ותיאור בחלונית יצירת שילוב.
    2. בוחרים אזור לשילוב.
    3. בוחרים חשבון שירות לאינטגרציה. אפשר לשנות או לעדכן את פרטי חשבון השירות של שילוב בכל שלב מחלונית סיכום השילוב בסרגל הכלים של השילוב.
    4. לוחצים על יצירה. השילוב החדש שנוצר ייפתח בכלי השילובים.

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

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

מאפייני ההגדרה

בטבלה הבאה מתוארים מאפייני ההגדרה של המשימה 'השעיה'.

נכס סוג הנתונים תיאור
Suspension Time מספר שלם משך הזמן (בדקות) עד להשעיית ההרצה של האינטגרציה. הגבלת הזמן המקסימלית היא 44,640 דקות (31 ימים), וזה גם ערך ברירת המחדל.

אם הביצוע של השילוב לא יתחדש בתוך מגבלת הזמן שצוינה, השילוב יחדש אוטומטית את הביצוע אחרי שתוקף מגבלת הזמן יפוג ויגדיר את הערך של המשתנה Suspension result ל-Expired.

Suspension result String משתנה לאחסון התוצאה של משימת ההשהיה. הגדרת הערך למשתנה הזה היא אופציונלית. אפשר להגדיר את המשתנה הזה לכל ערך בהתאם לדרישות שלכם. המשתנה הזה שימושי אם רוצים לשלוט יותר בתהליך ההפעלה של השילוב. לדוגמה, אפשר לקרוא את תוצאת ההשעיה ולהגדיר החלטות מותנות על סמך הערך בכל אחת מהמשימות הבאות בשרשרת.
Suspension Id String מזהה ייחודי של משימת ההשעיה. הערך של המשתנה הזה מוגדר מיד אחרי שהשילוב מושעה. אפשר לקבל את ערך המזהה מהדף execution logs בממשק המשתמש של השילוב. אפשר גם לקבל את ערך המזהה מאובייקט התגובה של API אם משתמשים ב-API כדי להפעיל את השילוב.

אפשר להמשיך את ההפעלה של השילוב באמצעות מזהה ההשעיה או באמצעות מזהה ההפעלה של השילוב.

ביטול השעיה באמצעות Suspensions API

ה-API של ההשעיות מאפשר לבטל השעיה באמצעות קריאה ל-API. כדי לבטל השעיה באמצעות Suspensions API, צריך את מזהה ההפעלה של השילוב או את מזהה ההשעיה של משימת ההשעיה. כדי לבטל השעיה, צריך לשלוח בקשת POST ל-API הבא:

https://REGION-integrations.googleapis.com/v1/{name=projects/PROJECT/locations/LOCATION/integrations/INTEGRATION_ID/executions/EXECUTION_ID/suspensions/SUSPENSION_ID}:lift

ב-API הזה, הפרמטר INTEGRATION_ID הוא אופציונלי. עם זאת, חובה לספק את EXECUTION_ID או את SUSPENSION_ID. אם אין לכם את ערכי המזהים, אתם יכולים להזין במקומם את הערך -. ב-API הזה, השדות REGION,‏ PROJECT ו-LOCATION הם שדות חובה.

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

בדוגמאות הבאות מוצגות דרכים לביטול השעיה באמצעות ה-API של suspensions.

דוגמה 1: ביטול השעיה באמצעות מזהה ההשעיה בלבד

הפקודה הבאה curl מראה איך לבטל השעיה כשזמין רק מזהה ההשעיה:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"Approved"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/-/suspensions/c6a13a79-a918-41e2-82b9-32b5a010755a:lift

בדוגמה הזו, המשתנה Suspension result מוגדר ל-Approved עבור מזהה ההשעיה c6a13a79-a918-41e2-82b9-32b5a010755a.

דוגמה 2: ביטול השעיה באמצעות מזהה הביצוע בלבד

הפקודה curl הבאה מראה איך לבטל השעיה כשזמין רק מזהה הביצוע:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"true"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/76a391e7-c801-45d7-8046-eab20d167ec5/suspensions/-:lift

בדוגמה הזו, המשתנה Suspension result מוגדר ל-true עבור מזהה ההרצה 76a391e7-c801-45d7-8046-eab20d167ec5.

דוגמה 3: ביטול השעיה באמצעות מזהה הביצוע ומזהה ההשעיה

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

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"{processname: "Release", owner: "John", status: "approved"};"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/9b721baa-0a23-4576-b2b6-d251d163ea6f/suspensions/f01815bf-ed18-4e01-9d41-cc2ce7861e95:lift

בדוגמה הזו, המשתנה Suspension result מוגדר ל-{processname: "Release", owner: "John", status: "approved"}; עבור מזהה ההשעיה f01815bf-ed18-4e01-9d41-cc2ce7861e95.

אסטרטגיה לטיפול בשגיאות

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

מכסות ומגבלות

מידע על מכסות ומגבלות זמין במאמר מכסות ומגבלות.

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