Method: organizations.sources.findings.list

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

Per elencare tutti gli elementi in tutte le origini, specifica - come ID origine. Esempio: /v1beta1/organizations/{organization_id}/sources/-/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. Il formato è "organizations/[organization_id]/sources/[source_id]". Per elencare tutti gli elementi in tutte le origini, specifica un valore source_id pari a -. Ad esempio: organizations/{organization_id}/sources/-

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 non sono supportate e OR ha una precedenza maggiore rispetto a AND.

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

  • nome
  • sourceProperties.a_property
  • 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.

Ad esempio, sourceProperties.size = 100 è una stringa filtro valida.
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,resourceProperties.a_property". 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,sourceProperties.a_property". Gli spazi ridondanti nella sintassi sono irrilevanti. "name desc,sourceProperties.a_property" e " name desc , sourceProperties.a_property " sono equivalenti.
readTime

string (Timestamp format)

Ora utilizzata come punto di riferimento per filtrare i risultati. Il filtro è limitato ai risultati esistenti al momento specificato e i relativi valori sono quelli in quel momento specifico. In assenza di questo campo, verrà utilizzata per impostazione predefinita la versione di NOW dell'API.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
fieldMask

string (FieldMask format)

Facoltativo. 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

Messaggio di risposta per i risultati della scheda.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "findings": [
    {
      object (Finding)
    }
  ],
  "readTime": string,
  "nextPageToken": string,
  "totalSize": integer
}
Campi
findings[]

object (Finding)

Risultati corrispondenti alla richiesta dell'elenco.
readTime

string (Timestamp format)

Tempo utilizzato per l'esecuzione della richiesta dell'elenco.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
nextPageToken

string

Token per recuperare la pagina di risultati successiva o vuoto se non ci sono altri risultati.
totalSize

integer

Il numero totale di risultati corrispondenti alla query.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione Authentication Overview.