Method: projects.locations.agentGateways.list

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

  • iam.permissions.none

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

פרמטרים
pageSize

integer

זה שינוי אופציונלי. מספר ה-AgentGateways המקסימלי שיוחזר בכל קריאה.
pageToken

string

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

boolean

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (AgentGateway)

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

string

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

string

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

היקפי הרשאות

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

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

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