Method: projects.locations.serverTlsPolicies.list

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

בקשת HTTP

GET https://networksecurity.googleapis.com/v1beta1/{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/-".

גוף הבקשה

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

גוף התשובה

תגובה שמוחזרת על ידי ה-method‏ 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.