הפונקציה ממתינה עד שהפעולה הממושכת שצוינה מסתיימת או עד שהיא מגיעה לזמן קצוב לתפוגה, ומחזירה את המצב העדכני. אם הפעולה כבר בוצעה, המצב האחרון מוחזר באופן מיידי. אם זמן הקצאת הזמן שצוין גדול מזמן הקצאת הזמן שמוגדר כברירת מחדל ל-HTTP/RPC, המערכת תשתמש בזמן הקצאת הזמן של HTTP/RPC. אם השרת לא תומך בשיטה הזו, הוא מחזיר את הערך google.rpc.Code.UNIMPLEMENTED
. חשוב לזכור שהשיטה הזו פועלת על בסיס האפשרות הטובה ביותר. יכול להיות שהיא תחזיר את המצב האחרון לפני זמן הקצוב לתפוגה (כולל באופן מיידי), כלומר גם תגובה מיידית לא מבטיחה שהפעולה הושלמה.
בקשת HTTP
POST https://earthengine.googleapis.com/v1/{name=projects/*/operations/**}:wait
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
name |
השם של משאב הפעולה שעליו צריך להמתין. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "timeout": string } |
שדות | |
---|---|
timeout |
משך הזמן המקסימלי להמתנה לפני סיום הזמן הקצוב לתפוגה. אם השדה הזה יישאר ריק, משך ההמתנה יהיה לכל היותר הזמן המותרת על ידי פרוטוקול HTTP/RPC הבסיסי. אם יצוין גם מועד יעד להקשר של ה-RPC, המערכת תשתמש במועד הקצר יותר. משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-' |
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Operation
.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
מידע נוסף זמין בOAuth 2.0 Overview.