Method: organizations.sources.locations.findings.list

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

Wenn Sie alle Quellen für einen bestimmten Standort auflisten möchten, geben Sie - als Quell-ID an. Wenn kein Standort angegeben ist, wird davon ausgegangen, dass sich die Ergebnisse auf „Global“ beziehen. Die folgende Liste enthält einige Beispiele:

  • /v2/organizations/{organization_id}/sources/-/findings + /v2/organizations/{organization_id}/sources/-/locations/{locationId}/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. Wenn kein Standort angegeben ist, ist „global“ die Standardeinstellung. Die folgende Liste enthält einige Beispiele:

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

Wenn Sie die Produkte in allen Quellen auflisten möchten, geben Sie „-“ als „source_id“ an. Die folgende Liste enthält einige Beispiele:

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

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

Die folgenden Kombinationen aus Feld und Operator werden unterstützt:

  • Name: =
  • parent: =, :
  • resourceName: =, :
  • state: =, :
  • category: =, :
  • externalUri: =, :
  • eventTime: =, >, <, >=, <=

Verwendung: Dies sollte in Millisekunden seit der Epoche oder als RFC3339-String angegeben werden. Beispiele: 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

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,parent“. 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,parent“. Überflüssige Leerzeichen in der Syntax werden nicht berücksichtigt. „name desc,parent“ und „name desc , parent“ sind äquivalent.

Die folgenden Felder werden unterstützt: name, parent, state, category, resourceName, eventTime und securityMarks.marks.
fieldMask

string (FieldMask format)

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

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ListFindingsResponse.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.