Method: projects.locations.urlLists.list

Enumera UrlLists en una ubicación y un proyecto determinados.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El proyecto y la ubicación de los que se deben mostrar las UrlLists, especificados en el formato projects/{project}/locations/{location}.

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • networksecurity.urlLists.list

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de UrlLists que se mostrarán por llamada.

pageToken

string

El valor que muestra el último ListUrlListsResponse indica que se trata de una continuación de una llamada urlLists.list anterior y que el sistema debe mostrar la siguiente página de datos.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la respuesta que muestra el método urlLists.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "urlLists": [
    {
      object (UrlList)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
urlLists[]

object (UrlList)

Es una lista de recursos de UrlList.

nextPageToken

string

Si es posible que haya más resultados que los que aparecen en esta respuesta, se incluye nextPageToken. Para obtener el siguiente conjunto de resultados, vuelve a llamar a este método con el valor de nextPageToken como pageToken.

unreachable[]

string

Ubicaciones en las que no se pudo acceder.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.