Method: projects.locations.operations.cancel

מתחיל ביטול אסינכרוני של פעולה ממושכת. השרת עושה כמיטב יכולתו לבטל את הפעולה, אך הצלחה אינה מובטחת. אם השרת אינו תומך בשיטה זו, הוא מחזיר google.rpc.Code.UNIMPLEMENTED. לקוחות יכולים להשתמש ב-Operations.GetOperation או בשיטות אחרות כדי לבדוק האם הביטול הצליח או האם הפעולה הושלמה למרות הביטול. לאחר ביטול מוצלח, הפעולה לא נמחקת; במקום זאת, היא הופכת לפעולה עם ערך Operation.error וערך google.rpc.Status.code של 1, התואם לערך Code.CANCELLED.

בקשת HTTP

POST https://storagebatchoperations.googleapis.com/v1/{name=projects/*/locations/*/operations/*}:cancel

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
name

string

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

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: Authentication Overview.

הרשאות IAM

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

  • storagebatchoperations.operations.cancel

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