Method: projects.locations.serverTlsPolicies.list

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

בקשת HTTP

GET https://networksecurity.googleapis.com/v1/{parent=projects/*/locations/*}/serverTlsPolicies

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

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

פרמטרים
parent

string

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

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

  • networksecurity.serverTlsPolicies.list

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

פרמטרים
pageSize

integer

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

string

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

boolean

זה שינוי אופציונלי. אם מגדירים את השדה הזה לערך true, הבקשה תכלול את המשאבים שאפשר להגיע אליהם, ואת השמות של המשאבים שאי אפשר להגיע אליהם בשדה [ListServerTlsPoliciesResponse.unreachable]. הערך הזה יכול להיות רק true כשקוראים בין אוספים, למשל כש-parent מוגדר ל-"projects/example/locations/-".

גוף הבקשה

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

גוף התשובה

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

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

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

object (ServerTlsPolicy)

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

string

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

string

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

היקפי הרשאות

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

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

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