Package google.longrunning

אינדקס

תפעול

ניהול פעולות ממושכות באמצעות שירות API.

אם שיטה (method) של API בדרך כלל נמשכת זמן רב, אפשר לתכנן אותה כך שתחזיר Operation ללקוח, והלקוח יוכל להשתמש בממשק הזה כדי לקבל את התגובה האמיתית באופן אסינכרוני על ידי דגימת משאב הפעולה, או להעביר את משאב הפעולה ל-API אחר (כמו Pub/Sub API) כדי לקבל את התגובה. כל שירות API שמחזיר פעולות ממושכות צריך להטמיע את הממשק Operations כדי שהמפתחים יוכלו ליהנות מחוויית לקוח עקבית.

CancelOperation

rpc CancelOperation(CancelOperationRequest) returns (Empty)

(לא נתמך כרגע) מתחיל ביטול אסינכרוני של פעולה ממושכת.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
DeleteOperation

rpc DeleteOperation(DeleteOperationRequest) returns (Empty)

(כרגע לא נתמך) מחיקת פעולה ממושכת.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetOperation

rpc GetOperation(GetOperationRequest) returns (Operation)

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב name:

  • routeoptimization.operations.get

מידע נוסף מופיע במאמרי העזרה בנושא IAM.
ListOperations

rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse)

(לא נתמך כרגע) פעולות ברשימות שתואמות למסנן שצוין בבקשה.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
WaitOperation

rpc WaitOperation(WaitOperationRequest) returns (Operation)

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

CancelOperationRequest

ההודעה עם הבקשה מ-Operations.CancelOperation.

שדות
name

string

שם משאב הפעולה שרוצים לבטל.

DeleteOperationRequest

ההודעה עם הבקשה מ-Operations.DeleteOperation.

שדות
name

string

שם משאב הפעולה שרוצים למחוק.

GetOperationRequest

ההודעה עם הבקשה מ-Operations.GetOperation.

שדות
name

string

השם של משאב הפעולה.

ListOperationsRequest

ההודעה עם הבקשה מ-Operations.ListOperations.

שדות
name

string

השם של משאב ההורה של הפעולה.
filter

string

מסנן הרשימה הרגיל.
page_size

int32

גודל הדף הרגיל ברשימה.
page_token

string

טוקן הדף של רשימת ברירת המחדל.
return_partial_success

bool

כשהערך מוגדר כ-true, פעולות שאפשר להגיע אליהן מוחזרות כרגיל, ופעולות שלא ניתן להגיע אליהן מוחזרות בשדה ListOperationsResponse.unreachable.

הערך הזה יכול להיות true רק כשקוראים נתונים מכמה אוספים. לדוגמה, כשמגדירים את parent לערך "projects/example/locations/-".

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

ListOperationsResponse

הודעת התשובה ל-Operations.ListOperations.

שדות
operations[]

Operation

רשימת פעולות שתואמות למסנן שצוין בבקשה.
next_page_token

string

טוקן רגיל של דף הבא ברשימה.
unreachable[]

string

רשימה לא ממוינת. משאבים שלא ניתן להגיע אליהם. השדה מאוכלס כשהבקשה מגדירה ListOperationsRequest.return_partial_success וקוראת באוספים. לדוגמה, כשמנסים ליצור רשימה של כל המשאבים בכל המיקומים הנתמכים.

פעולה

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

שדות
name

string

השם שהוקצה על ידי השרת, שהוא ייחודי רק בתוך אותו שירות שהחזיר אותו במקור. אם משתמשים במיפוי HTTP שמוגדר כברירת מחדל, name צריך להיות שם משאב שמסתיים ב-operations/{unique_id}.
metadata

Any

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

bool

אם הערך הוא false, המשמעות היא שהפעולה עדיין מתבצעת. אם הערך הוא true, הפעולה הושלמה ואפשר להשתמש בערך error או response.
שדה איחוד result. תוצאת הפעולה, שיכולה להיות error או response חוקי. אם done == false, אף אחת מההגדרות error ו-response לא מוגדרת. אם done == true, אפשר להגדיר בדיוק אחד מהערכים error או response. יכול להיות שחלק מהשירותים לא יספקו את התוצאה. הערך result יכול להיות רק אחד מהבאים:
error

Status

תוצאת השגיאה של הפעולה במקרה של כשל או ביטול.
response

Any

התגובה הרגילה והמוצלחת של הפעולה. אם השיטה המקורית לא מחזירה נתונים במקרה של הצלחה, כמו Delete, התגובה היא google.protobuf.Empty. אם השיטה המקורית היא סטנדרטית Get/Create/Update, התגובה צריכה להיות המשאב. בשיטות אחרות, התשובה צריכה להיות מהסוג XxxResponse, כאשר Xxx הוא שם השיטה המקורי. לדוגמה, אם שם השיטה המקורי הוא TakeSnapshot(), סוג התגובה שמוסק הוא TakeSnapshotResponse.

WaitOperationRequest

ההודעה עם הבקשה מ-Operations.WaitOperation.

שדות
name

string

השם של משאב הפעולה שממתינים לסיום שלו.
timeout

Duration

משך הזמן המקסימלי להמתנה לפני פסק זמן. אם משאירים את השדה ריק, ההמתנה תהיה לכל היותר הזמן שמותר לפי פרוטוקול HTTP/RPC הבסיסי. אם מציינים גם תאריך יעד להקשר של RPC, המערכת תשתמש בתאריך הקצר יותר.