Method: projects.sources.findings.group

Filtra i risultati di un'organizzazione o di una fonte e li raggruppa in base alle proprietà specificate in una località. Se non viene specificata alcuna località, si presume che i risultati siano a livello globale

Per raggruppare tutti i dati in base a tutte le origini, specifica - come ID origine. Di seguito sono riportati alcuni esempi:

  • /v2/organizations/{organization_id}/sources/-/findings + /v2/organizations/{organization_id}/sources/-/locations/{locationId}/findings
  • /v2/folders/{folder_id}/sources/-/findings
  • /v2/folders/{folder_id}/sources/-/locations/{locationId}/findings
  • /v2/projects/{projectId}/sources/-/findings
  • /v2/projects/{projectId}/sources/-/locations/{locationId}/findings

Richiesta HTTP


Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Nome dell'origine da aggregare. Se non viene specificata alcuna località, si presume che il rilevamento sia a livello globale. Di seguito sono riportati alcuni esempi:

  • 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]

Per eseguire il raggruppamento in base a tutte le origini, specifica un valore source_id pari a -. Di seguito sono riportati alcuni esempi:

  • organizations/{organization_id}/sources/-
  • organizations/{organization_id}/sources/-/locations/[locationId]
  • folders/{folder_id}/sources/-
  • folders/{folder_id}/sources/-/locations/[locationId]
  • projects/{projectId}/sources/-
  • projects/{projectId}/sources/-/locations/[locationId]

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "filter": string,
  "groupBy": string,
  "pageToken": string,
  "pageSize": integer
}
Campi
filter

string

Espressione che definisce il filtro da applicare ai risultati. L'espressione è un elenco di una o più limitazioni combinate tramite gli operatori logici AND e OR. Le parentesi sono supportate e OR ha la precedenza su AND.

Le limitazioni hanno il formato <field> <operator> <value> e possono essere precedute dal carattere - per indicare la negazione. Ecco alcuni esempi:

  • nome
  • securityMarks.marks.marka

Gli operatori supportati sono:

  • = per tutti i tipi di valori.
  • >, <, >=, <= per valori interi.
  • :, che indica la corrispondenza sottostringa, per le stringhe.

I tipi di valori supportati sono:

  • Valori letterali stringa tra virgolette.
  • letterali interi senza virgolette.
  • Valori letterali booleani true e false senza virgolette.

Sono supportate le seguenti combinazioni di campi e operatori:

  • nome: =
  • parent: =, :
  • resourceName: =, :
  • stato: =, :
  • Categoria: =, :
  • externalUri: =, :
  • eventTime: =, >, <, >=, <=

Utilizzo: deve essere espresso in millisecondi dall'epoca o in una stringa RFC3339. Esempi: eventTime = "2019-06-10T16:07:18-07:00" eventTime = 1560208038000

  • severity: =, :
  • securityMarks.marks: =, :
  • resource:
  • resource.name: =, :
  • resource.parent_name: =, :
  • resource.parent_display_name: =, :
  • resource.project_name: =, :
  • resource.project_display_name: =, :
  • resource.type: =, :
groupBy

string

Obbligatorio. Espressione che definisce i campi degli asset da utilizzare per il raggruppamento. Il valore della stringa deve seguire la sintassi SQL: elenco di campi separati da virgole. Ad esempio: "parent,resourceName".
pageToken

string

Il valore restituito dall'ultimo GroupFindingsResponse; indica che si tratta della continuazione di una chiamata findings.group precedente e che il sistema deve restituire la pagina di dati successiva.
pageSize

integer

Il numero massimo di risultati da restituire in una singola risposta. Il valore predefinito è 10, il minimo è 1 e il massimo è 1000.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di GroupFindingsResponse.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione Authentication Overview.