Method: providers.tasks.create

יצירה ומחזירה של אובייקט Task חדש.

בקשת HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
parent

string

חובה. חייב להיות בפורמט providers/{provider}. השדה provider חייב להיות מזהה הפרויקט ב-Google Cloud. לדוגמה, sample-cloud-project.

פרמטרים של שאילתה

פרמטרים
header

object (DeliveryRequestHeader)

אפשרות. כותרת הבקשה הרגילה של ה-API למסירה.
taskId

string

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

  • חייבת להיות מחרוזת Unicode חוקית.
  • מוגבל לאורך מקסימלי של 64 תווים.
  • מנורמל לפי טופס נירמול Unicode.
  • אינו יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ',' או '#'.

גוף הבקשה

גוף הבקשה מכיל מופע של Task.

גוף התגובה

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