Method: organizations.sources.findings.list

Hier werden die Ergebnisse einer Organisation oder Quelle aufgeführt.

Wenn Sie die Produkte in allen Quellen auflisten möchten, geben Sie - als Quell-ID an. Beispiel: /v1beta1/organizations/{organization_id}/sources/-/findings

HTTP-Anfrage


Die URLs verwenden die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Pflichtangabe. Name der Quelle, zu der die Ergebnisse gehören. Das Format lautet „organizations/[organization_id]/sources/[source_id]“. Wenn Sie die Produkte in allen Quellen auflisten möchten, geben Sie „-“ als „source_id“ an. Beispiel: organizations/{organization_id}/sources/-

Abfrageparameter

Parameter
filter

string

Ausdruck, der den Filter definiert, der auf alle Ergebnisse angewendet werden soll. Der Ausdruck besteht aus einer Liste mit einer oder mehreren Einschränkungen, die über die logischen Operatoren AND und OR kombiniert werden. Klammern werden nicht unterstützt und OR hat eine höhere Priorität als AND.

Einschränkungen haben das Format <field> <operator> <value> und können ein --Zeichen vorangestellt haben, um eine Verneinung anzugeben. Hier einige Beispiele:

  • Name
  • sourceProperties.a_property
  • securityMarks.marks.marka

Folgende Operatoren werden unterstützt:

  • = für alle Werttypen.
  • >, <, >=, <= für Ganzzahlwerte.
  • :, d. h. Teilstringabgleich, für Strings.

Folgende Werttypen werden unterstützt:

  • Stringliterale in Anführungszeichen.
  • Ganzzahlliterale ohne Anführungszeichen.
  • Boolesche Literale true und false ohne Anführungszeichen

sourceProperties.size = 100 ist beispielsweise ein gültiger Filterstring.
orderBy

string

Ausdruck, der festlegt, welche Felder und welche Reihenfolge für die Sortierung verwendet werden sollen. Der Stringwert sollte in der SQL-Syntax als eine durch Komma getrennte Liste von Feldern angegeben sein. Beispiel: „name,resourceProperties.a_property“. Standardmäßig werden die Einträge aufsteigend sortiert. Wenn Sie ein Feld absteigend sortieren möchten, sollte das Suffix „desc“ an den Feldnamen angehängt werden. Beispiel: „name desc,sourceProperties.a_property“. Überflüssige Leerzeichen in der Syntax werden nicht berücksichtigt. „name desc,sourceProperties.a_property“ und „name desc , sourceProperties.a_property“ sind äquivalent.
readTime

string (Timestamp format)

Zeitpunkt, der beim Filtern von Ergebnissen als Referenzpunkt verwendet wird. Der Filter ist auf Ergebnisse beschränkt, die zum angegebenen Zeitpunkt vorhanden sind. Die Werte sind die zu diesem Zeitpunkt. Wenn dieses Feld nicht vorhanden ist, wird standardmäßig die Version von NOW der API verwendet.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
fieldMask

string (FieldMask format)

Optional. Eine Feldmaske zur Angabe der Suchfelder, die in der Antwort aufgeführt werden sollen. In einer leeren Feldmaske werden alle Felder aufgeführt.
pageToken

string

Der Wert, der vom letzten ListFindingsResponse zurückgegeben wurde. Gibt an, dass dies eine Fortsetzung eines vorherigen findings.list-Aufrufs ist und dass das System die nächste Datenseite zurückgeben soll.
pageSize

integer

Die maximale Anzahl von Ergebnissen, die in einer einzelnen Antwort zurückgegeben werden sollen. Der Standardwert ist 10, der Mindestwert ist 1 und der Höchstwert ist 1.000.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für die Auflistung von Ergebnissen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "findings": [
    {
      object (Finding)
    }
  ],
  "readTime": string,
  "nextPageToken": string,
  "totalSize": integer
}
Felder
findings[]

object (Finding)

Ergebnisse, die mit der Listenanfrage übereinstimmen.
readTime

string (Timestamp format)

Zeit, die für die Ausführung der Listenanfrage benötigt wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
nextPageToken

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse vorhanden sind.
totalSize

integer

Die Gesamtzahl der Ergebnisse, die mit der Suchanfrage übereinstimmen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.