Method: projects.locations.tlsRoutes.list

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

בקשת HTTP

GET https://networkservices.googleapis.com/v1alpha1/{parent=projects/*/locations/*}/tlsRoutes

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

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

פרמטרים
parent

string

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

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

  • networkservices.tlsRoutes.list

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

פרמטרים
pageSize

integer

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

string

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

boolean

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

גוף הבקשה

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

גוף התשובה

תשובה שמוחזרת על ידי ה-method‏ tlsRoutes.list.

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

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

object (TlsRoute)

רשימה של משאבי TlsRoute.
nextPageToken

string

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

string

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

היקפי הרשאות

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

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

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