Method: providers.tasks.list

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
header

object (DeliveryRequestHeader)

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

pageSize

integer

זה שינוי אופציונלי. המספר המקסימלי של משימות שצריך להחזיר. השירות עשוי להחזיר פחות מהערך הזה. אם לא תציינו את הערך הזה, השרת יקבע את מספר התוצאות שיוחזרו.

pageToken

string

זה שינוי אופציונלי. אסימון דף שהתקבל מקריאה קודמת של tasks.list. תוכלו לספק אותו כדי לאחזר את הדף הבא.

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

filter

string

זה שינוי אופציונלי. שאילתת סינון שצריך להחיל כשיוצרים רשימה של Tasks. בכתובת http://aip.dev/160 אפשר לראות דוגמאות לתחביר של מסננים. אם לא מציינים ערך או אם מסננים לפי מחרוזת ריקה, המערכת מחזירה את כל המשימות. מידע נוסף על מאפייני המשימות שאפשר לסנן לפיהם זמין במאמר רשימת משימות.

גוף הבקשה

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

גוף התשובה

התשובה tasks.list שמכילה את קבוצת המשימות שעומדות בקריטריוני הסינון בListTasksRequest.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "tasks": [
    {
      object (Task)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
שדות
tasks[]

object (Task)

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

nextPageToken

string

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

totalSize

string (int64 format)

המספר הכולל של משימות שתואמות לקריטריונים של הבקשה, בכל הדפים.