Method: projects.sources.locations.findings.list

Elenca i risultati di un'organizzazione o di una fonte.

Per elencare tutte le origini per una determinata località, fornisci - come ID origine. Se non viene specificata alcuna località, si presume che i risultati siano a livello globale. Di seguito sono riportati alcuni esempi:

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

Richiesta HTTP


Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Nome dell'origine a cui appartengono i risultati. Se non viene specificata alcuna località, il valore predefinito è 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 elencare tutti gli elementi in 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/{projects_id}/sources/-
  • projects/{projects_id}/sources/-/locations/{locationId}

Parametri di query

Parametri
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: =, :
  • resource.folders.resource_folder: =, :
  • resource.display_name: =, :
orderBy

string

Espressione che definisce i campi e l'ordine da utilizzare per l'ordinamento. Il valore della stringa deve seguire la sintassi SQL: elenco di campi separati da virgole. Ad esempio: "name,parent". L'ordinamento predefinito è crescente. Per specificare l'ordinamento decrescente per un campo, è necessario aggiungere il suffisso " desc" al nome del campo. Ad esempio: "name desc,parent". Gli spazi ridondanti nella sintassi sono irrilevanti. "name desc,parent" ed " name desc , parent " sono equivalenti.

Sono supportati i seguenti campi: name parent state category resourceName eventTime securityMarks.marks
fieldMask

string (FieldMask format)

Una maschera di campo per specificare i campi di risultati da elencare nella risposta. Una maschera di campo vuota elenca tutti i campi.
pageToken

string

Il valore restituito dall'ultimo ListFindingsResponse; indica che si tratta della continuazione di una chiamata findings.list 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 richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione Authentication Overview.