‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

המשימה Suspend מאפשרת להשהות באופן זמני את ההפעלה של אינטגרציה, ואז להמשיך אותה.

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

תפוגת זמן ההשעיה שצוין.
אחרי קבלת בקשה להמשך ביצוע מ-API של Suspensions.

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

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

שלוש המשימות (Approval,‏ Suspend ו-Timer) מבצעות פונקציה דומה של השהיה וחידוש של אינטגרציה. עם זאת, יש ביניהם הבדלים קלים. בטבלה הבאה מתוארים ההבדלים בין שלוש המשימות.

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

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

כדי להגדיר את המשימה Suspend:

נכנסים לדף Application Integration במסוף Google Cloud .
כניסה ל-Application Integration
בתפריט הניווט, לוחצים על Integrations (שילובים).
מופיע הדף Integrations, שבו מפורטים כל השילובים שזמינים בפרויקט בענן ב-Google Cloud.
בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.
אם אתם יוצרים שילוב חדש:
1. מזינים שם ותיאור בחלונית Create Integration.
2. בוחרים אזור לשילוב.
  הערה: בתפריט הנפתח Regions מופיעים רק האזורים שהוקצו בפרויקט בענן שלכם ב-Google Cloud. כדי להקצות אזור חדש, לוחצים על Enable Region. מידע נוסף זמין במאמר הפעלת אזור חדש.
3. בוחרים חשבון שירות לשילוב. אתם יכולים לשנות או לעדכן את פרטי חשבון השירות של שילוב בכל שלב, דרך החלונית סיכום השילוב בסרגל הכלים של השילוב.
  הערה: האפשרות לבחור חשבון שירות מוצגת רק אם הפעלתם את ניהול השילובים באזור שנבחר.
4. לוחצים על יצירה. האינטגרציה החדשה שנוצרה נפתחת בעורך האינטגרציות.
בסרגל הניווט של עורך השילובים, לוחצים על Tasks כדי להציג את רשימת המשימות והמחברים הזמינים.
לוחצים על רכיב המשימה Suspend וממקמים אותו בעורך השילובים.
לוחצים על רכיב המשימה Suspend במעצב כדי להציג את חלונית ההגדרות של המשימה Suspend.
מגדירים את שאר השדות באמצעות מאפייני ההגדרה של המשימה, כפי שמפורט בטבלאות שבהמשך.
כל השינויים במאפיינים נשמרים באופן אוטומטי.

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

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

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

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

ה-API של ההשעיות מאפשר לבטל השעיה באמצעות קריאה ל-API. כדי לבטל השעיה באמצעות ה-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 הם שדות חובה.

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

בדוגמאות הבאות מוסבר איך לבטל השעיה באמצעות ה-API של השעיות.

דוגמה 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.

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

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

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

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