Method: projects.locations.urlLists.list

Listet UrlLists in einem bestimmten Projekt und an einem bestimmten Standort auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Projekt und der Speicherort, von dem aus die UrlLists aufgelistet werden sollen, im Format projects/{project}/locations/{location}.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • networksecurity.urlLists.list

Suchparameter

Parameter
pageSize

integer

Maximale Anzahl von UrlLists, die pro Aufruf zurückgegeben werden sollen.
pageToken

string

Der vom letzten ListUrlListsResponse zurückgegebene Wert gibt an, dass dies eine Fortsetzung eines vorherigen urlLists.list-Aufrufs ist und dass das System die nächste Seite mit Daten zurückgeben soll.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Von der Methode urlLists.list zurückgegebene Antwort

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "urlLists": [
    {
      object (UrlList)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
urlLists[]

object (UrlList)

Liste der UrlList-Ressourcen.
nextPageToken

string

Wenn in dieser Antwort möglicherweise mehr Ergebnisse vorhanden sind als die, die in dieser Antwort angezeigt werden, wird nextPageToken eingeschlossen. Um die nächsten Ergebnisse zu erhalten, rufen Sie diese Methode noch einmal auf und verwenden Sie dabei den Wert von nextPageToken als pageToken.
unreachable[]

string

Standorte, die nicht erreicht werden konnten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.