Method: projects.locations.gateways.list

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

  • networkservices.gateways.list

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

פרמטרים
pageSize

integer

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

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (Gateway)

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

string

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

string

מיקומים שלא ניתן להגיע אליהם.

היקפי הרשאות

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

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

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