Method: projects.locations.urlLists.list

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

בקשת HTTP

GET https://networksecurity.googleapis.com/v1beta1/{parent=projects/*/locations/*}/urlLists

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

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

פרמטרים
parent

string

חובה. הפרויקט והמיקום שממנו צריך להציג את רשימות כתובות ה-URL, בפורמט projects/{project}/locations/{location}.

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

  • networksecurity.urlLists.list

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

פרמטרים
pageSize

integer

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

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (UrlList)

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

string

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

string

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

היקפי הרשאות

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

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

מידע נוסף מופיע במאמר סקירה כללית על אימות.