מקור מידע: פעולה
משאב זה מייצג פעולה ממושכת, שהיא תוצאה של קריאה ל-API של רשת.
ייצוג JSON |
---|
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field |
שדות | |
---|---|
name |
השם שהוקצה על ידי השרת, והוא ייחודי רק במסגרת אותו שירות שמחזיר אותו במקור. אם משתמשים במיפוי ה-HTTP שמוגדר כברירת מחדל, |
metadata |
מטא-נתונים ספציפיים לשירות שמשויכים לפעולה. בדרך כלל הנתונים כוללים מידע על ההתקדמות ומטא-נתונים נפוצים, כמו שעת היצירה. ייתכן ששירותים מסוימים לא יספקו מטא-נתונים כאלה. כל שיטה שמחזירה פעולה ממושכת צריכה לתעד את סוג המטא-נתונים, אם קיים. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
done |
אם הערך הוא |
שדה איחוד result . תוצאת הפעולה, שיכולה להיות error או response חוקית. אם done == false , לא הוגדרו error וגם response . אם done == true , אפשר להגדיר בדיוק אחד מהערכים error או response . יכול להיות ששירותים מסוימים לא יספקו את התוצאה. הערך של result יכול להיות רק אחת מהאפשרויות הבאות: |
|
error |
תוצאת השגיאה של הפעולה במקרה של כשל או ביטול. |
response |
התגובה הרגילה המוצלחת של הפעולה. אם השיטה המקורית לא מחזירה נתונים לגבי הצלחה, למשל אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
שיטות |
|
---|---|
|
הפעלת ביטול אסינכרוני בפעולה ממושכת. |
|
מוחקים פעולה ממושכת. |
|
הפונקציה מקבלת את המצב העדכני של פעולה ממושכת. |
|
בתיבת הדו-שיח הזו מפורטים הפעולות שתואמות למסנן שצוין בבקשה. |
|
בהמתנה עד שהפעולה הממושכת שצוינה תסתיים או תגיע לכל היותר הזמן הקצוב לתפוגה שהוגדר, והחזרת המצב האחרון. |