Method: projects.locations.urlLists.list

Lists UrlLists in a given project and location.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The project and location from which the UrlLists should be listed, specified in the format projects/{project}/locations/{location}.

Authorization requires the following IAM permission on the specified resource parent:

  • networksecurity.urlLists.list

Query parameters

Parameters
pageSize

integer

Maximum number of UrlLists to return per call.

pageToken

string

The value returned by the last ListUrlListsResponse Indicates that this is a continuation of a prior urlLists.list call, and that the system should return the next page of data.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response returned by the urlLists.list method.

JSON representation
{
  "urlLists": [
    {
      object (UrlList)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Fields
urlLists[]

object (UrlList)

List of UrlList resources.

nextPageToken

string

If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.

unreachable[]

string

Locations that could not be reached.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.