- [HTTP request](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#body.HTTP_TEMPLATE)
- [Path parameters](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#body.PATH_PARAMETERS)
- [Query parameters](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#body.QUERY_PARAMETERS)
- [Request body](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#body.request_body)
- [Response body](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#body.response_body)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#body.ListSearchedResultsResponse.SCHEMA_REPRESENTATION)
- [Authorization scopes](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#body.aspect)
- [IAM Permissions](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#body.aspect_1)
- [SearchedResult](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#SearchedResult)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#SearchedResult.SCHEMA_REPRESENTATION)
- [ResultRow](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ResultRow)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ResultRow.SCHEMA_REPRESENTATION)
- [EventRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EventRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EventRecord.SCHEMA_REPRESENTATION)
- [Annotation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#Annotation)
- [StatsRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#StatsRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#StatsRecord.SCHEMA_REPRESENTATION)
- [StatsColumnData](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#StatsColumnData)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#StatsColumnData.SCHEMA_REPRESENTATION)
- [ColumnType](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnType)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnType.SCHEMA_REPRESENTATION)
- [ColumnValue](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValue)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValue.SCHEMA_REPRESENTATION)
- [ColumnValueList](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValueList)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValueList.SCHEMA_REPRESENTATION)
- [EntityContextRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EntityContextRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EntityContextRecord.SCHEMA_REPRESENTATION)
- [JoinRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#JoinRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#JoinRecord.SCHEMA_REPRESENTATION)
- [DataTableRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DataTableRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DataTableRecord.SCHEMA_REPRESENTATION)
- [SearchDataTableRowCell](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#SearchDataTableRowCell)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#SearchDataTableRowCell.SCHEMA_REPRESENTATION)
- [CaseRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseRecord.SCHEMA_REPRESENTATION)
- [CaseHistoryRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistoryRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistoryRecord.SCHEMA_REPRESENTATION)
- [CaseHistory](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistory)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistory.SCHEMA_REPRESENTATION)
- [CaseResponsePlatformInfo](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseResponsePlatformInfo)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseResponsePlatformInfo.SCHEMA_REPRESENTATION)
- [ResponsePlatformType](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ResponsePlatformType)
- [CaseHistorySlaType](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistorySlaType)
- [CaseHistoryActivityType](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistoryActivityType)
- [AgentInvestigationState](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#AgentInvestigationState)
- [DetectionRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DetectionRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DetectionRecord.SCHEMA_REPRESENTATION)
- [RawLogRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#RawLogRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#RawLogRecord.SCHEMA_REPRESENTATION)
- [RawLogSnippetRecord](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#RawLogSnippetRecord)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#RawLogSnippetRecord.SCHEMA_REPRESENTATION)
- [ColumnNames](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnNames)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnNames.SCHEMA_REPRESENTATION)
- [ColumnSchema](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnSchema)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnSchema.SCHEMA_REPRESENTATION)
- [TableMetadata](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#TableMetadata)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#TableMetadata.SCHEMA_REPRESENTATION)
- [DataSource](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DataSource)

**Full name**: projects.locations.instances.searchSessions.searchedResults.list

Retrieves results from a completed Search operation.

### HTTP request

`GET https://{endpoint}/v1alpha/{parent}/searchedResults`

Where `{endpoint}` is one of the [supported service endpoints](https://docs.cloud.google.com/chronicle/docs/reference/rest#rest_endpoints).

### Path parameters

| Parameters ||
|---|---|
| `parent` | `string` Required. The parent SearchSession resource name. Format: projects/{project}/locations/{location}/instances/{instance}/searchSessions/{searchSession} |

### Query parameters

| Parameters ||
|---|---|
| `pageSize` | `integer` Optional. The maximum number of results to return. The service may return fewer. If unspecified, at most 100 results will be returned. The maximum value is 1000. |
| `pageToken` | `string` Optional. A page token, received from a previous `searchedResults.list` call. Provide this to retrieve the subsequent page. |
| `orderBy` | `string` Optional. The column to sort the results on. Example: "eventTimestamp desc", "principal.hostname asc". Multi-columnar sorting is not supported. |
| `skip` | `integer` Optional. The number of results to skip before starting to return results. This field should not be used in conjunction with pageToken. |

### Request body

The request body must be empty.

### Response body

Response message for the searchedResults.list method. Next ID: 6

If successful, the response body contains data with the following structure:

| JSON representation |
|---|
| ``` { "searchedResults": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#SearchedResult`) } ], "totalSize": integer, "columnNames": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnNames`) }, "columnSchema": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnSchema`) }, "nextPageToken": string } ``` |

| Fields ||
|---|---|
| `searchedResults[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#SearchedResult`)`` List of Searched Results. |
| `totalSize` | `integer` Total number of rows in the result set of the search query. |
| `columnNames` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnNames`)`` List of column names for the outcome section of the query result. |
| `columnSchema` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnSchema`)`` Column schema for the results based on the query columns. Contains metadata like data source, eventName etc. |
| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |

### Authorization scopes

Requires one of the following OAuth scopes:

- `https://www.googleapis.com/auth/cloud-platform`
- `
  https://www.googleapis.com/auth/chronicle`

For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication#authorization-gcp).

### IAM Permissions

Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:

- `chronicle.searchedResults.list`

For more information, see the [IAM documentation](https://cloud.google.com/iam/docs).

## SearchedResult

SearchedResult contains the results of a Search operation. Next ID: 4

| JSON representation |
|---|
| ``` { "name": string, "resultRow": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ResultRow`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the search results. Format: projects/{project}/locations/{location}/instances/{instance}/searchSessions/{searchSession}/searchedResults/{searchedResult} |
| `resultRow` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ResultRow`)`` Contains a flexible row which can support a standard UDM Event, Stats, Entity Context, Join result, Data Table, etc. |

## ResultRow

ResultRow is a flexible collection that captures a search result row. It can currently support UDM Events, Entity Contexts, Data Tables, Join results, etc. and will support all other data sources in the future. Next ID: 11

| JSON representation |
|---|
| ``` { "outcomes": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnType`) } ], // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "eventRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EventRecord`) }, "statsRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#StatsRecord`) }, "entityContextRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EntityContextRecord`) }, "joinRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#JoinRecord`) }, "detectionRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DetectionRecord`) }, "dataTableRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DataTableRecord`) }, "caseRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseRecord`) }, "caseHistoryRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistoryRecord`) }, "rawLogRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#RawLogRecord`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `outcomes[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnType`)`` Outcome fields for an event specified in query request. |
| A result row of the search query. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `eventRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EventRecord`)`` UDM event. |
| `statsRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#StatsRecord`)`` Stats record. |
| `entityContextRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EntityContextRecord`)`` Entity context graph. |
| `joinRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#JoinRecord`)`` Join results. |
| `detectionRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DetectionRecord`)`` Detection. |
| `dataTableRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DataTableRecord`)`` Data table. |
| `caseRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseRecord`)`` Case. |
| `caseHistoryRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistoryRecord`)`` Case history. |
| `rawLogRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#RawLogRecord`)`` Raw log match. |
| End of mutually exclusive fields. ||

## EventRecord

EventRecord stores information about a UDM event. Next ID: 8

| JSON representation |
|---|
| ``` { "event": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.events#Event`) }, "eventLogToken": string, "alertNumber": integer, "alertViewId": string, "annotations": [ enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#Annotation`) ], "detections": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Collection`) } ], "table": string } ``` |

| Fields ||
|---|---|
| `event` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.events#Event`)`` The UDM Event. |
| `eventLogToken` | `string (https://developers.google.com/discovery/v1/type-format format)` Raw log tokens mapped to the event. Can be used to locate the raw log entry that generated the event. A base64-encoded string. |
| `alertNumber` | `integer` If the event should be treated as an alert, the unique identifier for the alert. |
| `alertViewId` | `string (https://developers.google.com/discovery/v1/type-format format)` Alert View specific Id. Helps create a link to Alert View. A base64-encoded string. |
| `annotations[]` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#Annotation`)`` Annotations added to an event. |
| `detections[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Collection`)`` Detections associated with an event. |
| `table` | `string` User defined table name for the event in joins query. |

## Annotation

Annotation for an event.

| Enums ||
|---|---|
| `ANNOTATION_UNSPECIFIED` | Unspecified - no annotation to display. |
| `ANNOTATION_ALERT` | Event is associated with one or more alerts. |

## StatsRecord

StatsRecord contains a row in the response of a stats query. Next ID: 2

| JSON representation |
|---|
| ``` { "results": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#StatsColumnData`) } ] } ``` |

| Fields ||
|---|---|
| `results[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#StatsColumnData`)`` Contains all columns resulting from a stats query and one row of values. |

## StatsColumnData

Represents a single column with a single cell in the set of columns returned as the stats query result. Next ID: 3

| JSON representation |
|---|
| ``` { "column": string, "values": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnType`) } } ``` |

| Fields ||
|---|---|
| `column` | `string` Used to store column names. |
| `values` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnType`)`` Store the values in a single column. |

## ColumnType

Singular vs list of values in a single column. Next ID: 3

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "value": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValue`) }, "list": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValueList`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| Store single value or list of values in a column. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `value` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValue`)`` Single value in a column. |
| `list` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValueList`)`` List of values in a column e.g. IPs. |
| End of mutually exclusive fields. ||

## ColumnValue

Represents a single value in the set of values returned as the query result. Next ID: 11

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "nullVal": boolean, "boolVal": boolean, "bytesVal": string, "doubleVal": number, "int64Val": string, "uint64Val": string, "stringVal": string, "timestampVal": string, "dateVal": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Date`) }, "protoVal": { "@type": string, field1: ..., ... } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| Value of the column based on data type. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `nullVal` | `boolean` True if the value is NULL. |
| `boolVal` | `boolean` Boolean value. |
| `bytesVal` | `string (https://developers.google.com/discovery/v1/type-format format)` Bytes value. A base64-encoded string. |
| `doubleVal` | `number` Double value. |
| `int64Val` | `string (https://developers.google.com/discovery/v1/type-format format)` Integer value (signed). |
| `uint64Val` | `string` Un-signed integer value. |
| `stringVal` | `string` String value. Enum values are returned as strings. |
| `timestampVal` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Timestamp values. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `dateVal` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Date`)`` Date values. |
| `protoVal` | `object` For any proto values that are not any of the above. An object containing fields of an arbitrary type. An additional field `"@type"` contains a URI identifying the type. Example: `{ "id": 1234, "@type": "types.example.com/standard/id" }`. |
| End of mutually exclusive fields. ||

## ColumnValueList

Store list of values for a single column. Next ID: 2

| JSON representation |
|---|
| ``` { "values": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValue`) } ] } ``` |

| Fields ||
|---|---|
| `values[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ColumnValue`)`` List of values in one cell of the column. |

## EntityContextRecord

EntityContextRecord stores information about a entity context graph. Next ID: 5

| JSON representation |
|---|
| ``` { "entity": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.entities#Entity`) }, "eventLogToken": string, "timed": boolean, "table": string } ``` |

| Fields ||
|---|---|
| `entity` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.entities#Entity`)`` The entity information to be retrieved with UDM ECG search. |
| `eventLogToken` | `string` Raw log tokens mapped to the event that created the entity. This is only for entity context events. |
| `timed` | `boolean` If the entity is timed or not. |
| `table` | `string` User defined table name for the entity in joins query. |

## JoinRecord

JoinRecord stores information about a join result. Next ID: 6

| JSON representation |
|---|
| ``` { "events": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EventRecord`) } ], "entities": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EntityContextRecord`) } ], "dataTables": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DataTableRecord`) } ], "cases": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseRecord`) } ], "caseHistories": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistoryRecord`) } ] } ``` |

| Fields ||
|---|---|
| `events[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EventRecord`)`` The events that are joined. |
| `entities[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EntityContextRecord`)`` The entities that are joined. |
| `dataTables[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DataTableRecord`)`` The data tables that are joined. |
| `cases[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseRecord`)`` The cases that are joined. |
| `caseHistories[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistoryRecord`)`` The case histories that are joined. |

## DataTableRecord

DataTableRecord contains information about a Data table. Next ID: 3

| JSON representation |
|---|
| ``` { "dataTable": string, "cells": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#SearchDataTableRowCell`) } ] } ``` |

| Fields ||
|---|---|
| `dataTable` | `string` The resource name of the Data table. Format: projects/{projectId}/locations/{location}/instances/{instances}/dataTables/{dataTable} |
| `cells[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#SearchDataTableRowCell`)`` Stores information about a single row of a Data table. |

## SearchDataTableRowCell

Contains a key-value pair of column name and its value. It represents a cell in the Data Table. Next ID: 3

| JSON representation |
|---|
| ``` { "column": string, "value": string } ``` |

| Fields ||
|---|---|
| `column` | `string` The name of the column. |
| `value` | `string` The value of the column. |

## CaseRecord

CaseRecord stores information about a SOAR case.

| JSON representation |
|---|
| ``` { "soarCase": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.cases#Case`) }, "table": string } ``` |

| Fields ||
|---|---|
| `soarCase` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.cases#Case`)`` The case. |
| `table` | `string` Optional. User defined identifier for a case. For example, if the query is `$c1.case.name != "abc"`, then the table name will be `c1`. |

## CaseHistoryRecord

CaseHistoryRecord stores information about a SOAR case history.

| JSON representation |
|---|
| ``` { "soarCaseHistory": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistory`) }, "table": string } ``` |

| Fields ||
|---|---|
| `soarCaseHistory` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistory`)`` The case history. |
| `table` | `string` Optional. User defined identifier for a case history. For example, if the query is `$ch1.case_history.name != "abc"`, then the table name will be `ch1`. |

## CaseHistory

LINT.IfChange(CaseHistory) CaseHistory is a representation of the history of SOAR case updates.

| JSON representation |
|---|
| ``` { "id": string, "caseResponsePlatformInfo": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseResponsePlatformInfo`) }, "eventTime": string, "stage": string, "assignee": string, "priority": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Priority`), "status": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.cases#CaseStatus`), "incident": boolean, "important": boolean, "slaType": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistorySlaType`), "caseActivity": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistoryActivityType`), "agentInvestigationState": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#AgentInvestigationState`), "alertCount": string } ``` |

| Fields ||
|---|---|
| `id` | `string` A unique identifier (GUID) for the SOAR case history. |
| `caseResponsePlatformInfo` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseResponsePlatformInfo`)`` The case response platform info. |
| `eventTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` The timestamp when the event occurred. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `stage` | `string` The new stage of the case after the event. |
| `assignee` | `string` The new assignee of the case after the event. |
| `priority` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Priority`)`` The new priority of the case after the event. |
| `status` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.cases#CaseStatus`)`` The new status of the case after the event. |
| `incident` | `boolean` Whether the case is marked as an incident after the event. |
| `important` | `boolean` Whether the case is marked as important after the event. |
| `slaType` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistorySlaType`)`` The type of SLA that was exceeded. |
| `caseActivity` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#CaseHistoryActivityType`)`` The type of activity that occurred (e.g., stage change, assignee change, case creation). |
| `agentInvestigationState` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#AgentInvestigationState`)`` Output only. Captures the investigation state of the case. |
| `alertCount` | `string (https://developers.google.com/discovery/v1/type-format format)` The number of alerts associated with the case. |

## CaseResponsePlatformInfo

CaseResponsePlatformInfo represents the response platform information of a case.

| JSON representation |
|---|
| ``` { "caseResource": string, "caseId": string, "responsePlatformType": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ResponsePlatformType`) } ``` |

| Fields ||
|---|---|
| `caseResource` | `string` The case resource name |
| `caseId` | `string` The case id. |
| `responsePlatformType` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#ResponsePlatformType`)`` The response platform type. |

## ResponsePlatformType

Available response platforms.

| Enums ||
|---|---|
| `RESPONSE_PLATFORM_TYPE_UNSPECIFIED` | Response platform not specified. |
| `RESPONSE_PLATFORM_TYPE_SIEMPLIFY` | Siemplify |

## CaseHistorySlaType

Represents the type of SLA that was exceeded.

| Enums ||
|---|---|
| `CASE_HISTORY_SLA_TYPE_UNSPECIFIED` | The SLA type is unspecified. |
| `CASE_SLA` | The SLA type is case SLA. |
| `ALERT_SLA` | The SLA type is alert SLA. |
| `STAGE_SLA` | The SLA type is stage SLA. |

## CaseHistoryActivityType

CaseHistoryActivityType is an enum representing the type of activity that occurred on a case.

| Enums ||
|---|---|
| `CASE_HISTORY_ACTIVITY_TYPE_UNSPECIFIED` | The activity type is unspecified. |
| `STAGE_CHANGE` | The case stage changed. |
| `ASSIGNEE_CHANGE` | The case assignee changed. |
| `CREATE_CASE` | The case was created. |
| `PRIORITY_CHANGE` | The case priority changed. |
| `CLOSE_CASE` | The case was closed. |
| `REOPEN_CASE` | The case was reopened. |
| `MARK_INCIDENT` | The case was marked as an incident. |
| `MARK_IMPORTANT` | The case was marked as important. |
| `EXCEEDED_SLA` | The case exceeded its SLA. |

## AgentInvestigationState

The investigation state of the case.

| Enums ||
|---|---|
| `AGENT_INVESTIGATION_STATE_UNSPECIFIED` | This value is used to indicate that the investigation state is not set. |
| `AGENT_INVESTIGATED` | The agent has investigated some alerts in the case but not all of them. |
| `ALL_ALERTS_INVESTIGATED` | All alerts in the case were investigated. |

## DetectionRecord

DetectionRecord stores information about a detection. Next ID: 3

| JSON representation |
|---|
| ``` { "id": string, "collection": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Collection`) } } ``` |

| Fields ||
|---|---|
| `id` | `string (https://developers.google.com/discovery/v1/type-format format)` The ID of the detection. A base64-encoded string. |
| `collection` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Collection`)`` The detection. |

## RawLogRecord

RawLogRecord stores a single raw log matched by a `RAW_LOG` dialect search. Mirrors `LegacySearchRawLogsV2`'s `RawLogResult`.

| JSON representation |
|---|
| ``` { "rawLogId": string, "logType": string, "summary": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "eventRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EventRecord`) }, "entityContextRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EntityContextRecord`) }, "snippetRecord": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#RawLogSnippetRecord`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `rawLogId` | `string` Output only. Identifier of the raw log entry. The underlying identifier is binary and is encoded here with unpadded base64url, as defined in RFC 4648 section 5, so that it is safe to use as the last segment of a `SearchedResult` resource name. |
| `logType` | `string` The log type of the raw log. Format: projects/{project}/locations/{location}/instances/{instance}/logTypes/{logType} |
| `summary` | `string` Human readable summary of the raw log. Same semantics as `RawLogResult.summary`: for unparsed logs this is the same string as `snippetRecord.snippet`; for parsed logs it is derived from the UDM event. |
| Explicit three-way oneof, matching `RawLogResult.result`. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `eventRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EventRecord`)`` The raw log was normalized into a UDM event. |
| `entityContextRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#EntityContextRecord`)`` The raw log was normalized into an entity context record. |
| `snippetRecord` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#RawLogSnippetRecord`)`` The raw log was not normalized. |
| End of mutually exclusive fields. ||

## RawLogSnippetRecord

Unparsed raw log match.

| JSON representation |
|---|
| ``` { "snippet": string, "ingestionTime": string } ``` |

| Fields ||
|---|---|
| `snippet` | `string` The matching window of the raw log payload. Not guaranteed to be the full payload (identical to `LegacySearchRawLogsV2`); use `rawLogId` with the existing raw log fetch APIs to retrieve the full payload. |
| `ingestionTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` The time the raw log was ingested into Chronicle. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |

## ColumnNames

List of column names for the outcome section of the query result. Next ID: 2

| JSON representation |
|---|
| ``` { "names": [ string ] } ``` |

| Fields ||
|---|---|
| `names[]` | `string` List of column names. |

## ColumnSchema

Schema of the tables used in a query. Next ID: 2

| JSON representation |
|---|
| ``` { "metadata": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#TableMetadata`) } ] } ``` |

| Fields ||
|---|---|
| `metadata[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#TableMetadata`)`` Metadata about the tables used in the query. |

## TableMetadata

Metadata about a table used in a query.

| JSON representation |
|---|
| ``` { "table": string, "dataSource": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DataSource`), "index": integer } ``` |

| Fields ||
|---|---|
| `table` | `string` The alias of the table in the query. |
| `dataSource` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.searchSessions.searchedResults/list#DataSource`)`` The type of data source. |
| `index` | `integer` The index of the table in the query. |

## DataSource

The type of data source.

| Enums ||
|---|---|
| `DATA_SOURCE_UNSPECIFIED` | Unspecified data source. |
| `EVENTS` | UDM events. |
| `ENTITY_CONTEXT` | Entity context. |
| `DATA_TABLES` | Data tables. |
| `DETECTIONS` | Detections. |
| `SOAR_CASE` | SOAR cases. |
| `SOAR_CASE_HISTORY` | SOAR case histories. |