Method: projects.sources.findings.list

Muestra una lista de los hallazgos de una organización o fuente.

Para mostrar una lista de todas las fuentes de una ubicación determinada, proporciona un - como el ID de fuente. Si no se especifica una ubicación, se supone que los resultados son globales. En la siguiente lista, se muestran algunos ejemplos:

  • /v2/organizations/{organization_id}/sources/-/findings + /v2/organizations/{organization_id}/sources/-/locations/{locationId}/findings

Solicitud HTTP


Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el nombre de la fuente a la que pertenecen los resultados. Si no se especifica una ubicación, la predeterminada es global. En la siguiente lista, se muestran algunos ejemplos:

  • organizations/[organization_id]/sources/[source_id] + organizations/[organization_id]/sources/[source_id]/locations/[locationId]
  • folders/[folder_id]/sources/[source_id]
  • folders/[folder_id]/sources/[source_id]/locations/[locationId]
  • projects/[projectId]/sources/[source_id]
  • projects/[projectId]/sources/[source_id]/locations/[locationId]

Para obtener una lista de todas las fuentes, proporciona un source_id de -. En la siguiente lista, se muestran algunos ejemplos:

  • organizations/{organization_id}/sources/-
  • organizations/{organization_id}/sources/-/locations/{locationId}
  • folders/{folder_id}/sources/-
  • folders/{folder_id}/sources/-locations/{locationId}
  • projects/{projects_id}/sources/-
  • projects/{projects_id}/sources/-/locations/{locationId}

Parámetros de consulta

Parámetros
filter

string

Es una expresión que define el filtro que se aplicará a todos los resultados. La expresión es una lista de una o más restricciones combinadas a través de los operadores lógicos AND y OR. Se admiten paréntesis, y OR tiene una prioridad más alta que AND.

Las restricciones tienen el formato <field> <operator> <value> y pueden tener un carácter - delante para indicar la negación. Los ejemplos incluyen:

  • nombre
  • securityMarks.marks.marka

Los operadores admitidos son los siguientes:

  • = para todos los tipos de valores.
  • >, <, >=, <= para valores enteros
  • :, que significa coincidencia de substring, para cadenas.

Los tipos de valores admitidos son los siguientes:

  • literales de cadena entre comillas.
  • literales de número entero sin comillas.
  • Literales booleanos true y false sin comillas.

Se admiten las siguientes combinaciones de campos y operadores:

  • nombre: =
  • superior: =, :
  • resourceName: =, :
  • estado: =, :
  • categoría: =, :
  • externalUri: =, :
  • eventTime: =, >, <, >=, <=

Uso: Debe ser una cadena RFC3339 o milisegundos desde la época. Ejemplos: eventTime = "2019-06-10T16:07:18-07:00" eventTime = 1560208038000

  • gravedad: =, :
  • securityMarks.marks: =, :
  • resource:
  • resource.name: =, :
  • resource.parent_name: =, :
  • resource.parent_display_name: =, :
  • resource.project_name: =, :
  • resource.project_display_name: =, :
  • resource.type: =, :
  • resource.folders.resource_folder: =, :
  • resource.display_name: =, :
orderBy

string

Es una expresión que define qué campos y orden usar para ordenar los datos. El valor de cadena debe seguir la sintaxis de SQL: lista de campos separados por comas. Por ejemplo: "name,parent". El orden de clasificación predeterminado es ascendente. Para especificar el orden descendente de un campo, se debe agregar un sufijo " desc" al nombre del campo. Por ejemplo: "name desc,parent". Los caracteres de espacio redundantes en la sintaxis son insignificantes. "name desc,parent" y " name desc , parent " son equivalentes.

Se admiten los siguientes campos: name parent state category resourceName eventTime securityMarks.marks
fieldMask

string (FieldMask format)

Es una máscara de campo para especificar los campos de búsqueda que se mostrarán en la respuesta. Una máscara de campo vacía mostrará todos los campos.
pageToken

string

El valor que muestra el último ListFindingsResponse indica que esta es una continuación de una llamada findings.list anterior y que el sistema debe mostrar la siguiente página de datos.
pageSize

integer

Es la cantidad máxima de resultados que se mostrarán en una sola respuesta. El valor predeterminado es 10, el mínimo es 1 y el máximo es 1, 000.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ListFindingsResponse.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Authentication Overview.