Method: projects.locations.httpRoutes.list

הצגת רשימה של HttpRoute בפרויקט ובמיקום נתונים.

בקשת HTTP

GET https://networkservices.googleapis.com/v1/{parent=projects/*/locations/*}/httpRoutes

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

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

פרמטרים
parent

string

חובה. הפרויקט והמיקום שמהם צריך להציג את HttpRoutes, בפורמט projects/*/locations/*.

כדי לקבל הרשאה, צריך את הרשאת IAM הבאה במשאב שצוין parent:

  • networkservices.httpRoutes.list

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

פרמטרים
pageSize

integer

מספר ה-HttpRoutes המקסימלי שיוחזר בכל קריאה.

pageToken

string

הערך שמוחזר על ידי ה-ListHttpRoutesResponse האחרון מציין שזה המשך של קריאת httpRoutes.list קודמת, ושהמערכת צריכה להחזיר את דף הנתונים הבא.

returnPartialSuccess

boolean

זה שינוי אופציונלי. אם הערך הוא true, המערכת מאפשרת תשובות חלקיות לבקשות של רשימה נצברת בכמה אזורים. אחרת, אם אחד מהמיקומים לא פעיל או לא נגיש, הבקשה של Aggregated List תיכשל.

גוף הבקשה

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

גוף התשובה

התשובה שהוחזרה על ידי השיטה httpRoutes.list.

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

ייצוג ב-JSON
{
  "httpRoutes": [
    {
      object (HttpRoute)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
שדות
httpRoutes[]

object (HttpRoute)

רשימה של משאבי HttpRoute.

nextPageToken

string

אם יכול להיות שיש יותר תוצאות מאלה שמופיעות בתשובה הזו, אז nextPageToken נכלל. כדי לקבל את קבוצת התוצאות הבאה, צריך להפעיל שוב את השיטה הזו באמצעות הערך של nextPageToken בתור pageToken.

unreachable[]

string

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

היקפי הרשאות

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

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

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