- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- NodeSource
- Try it!
Full name: projects.locations.instances.findingsGraph.initializeGraph
Initialize a graph from a resource such as a detection or an entity.
HTTP request
GET https://chronicle.googleapis.com/v1alpha/{name}:initializeGraph
Path parameters
Parameters | |
---|---|
name |
Required. The resource name of the FindingsGraph resource. Format: projects/{project}/locations/{location}/instances/{instance}/findingsGraph |
Query parameters
Parameters | |
---|---|
nodeSource |
Required. An identifier for the detection/alert or entity to show associations for in the response. |
timeRange |
Required. The time range that the graph exploration is limited to. IDs for nodes that can be used in subsequent calls to expand the nodes will be tied to this time range, so changing the graph time range requires initializing the graph again. |
params |
Optional. The options to initialize the graph. |
Request body
The request body must be empty.
Response body
Response message to initialize a graph from a resource and a time range.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "root_node": { object ( |
Fields | |
---|---|
root_node |
The root node of the whole graph generated by the given NodeSource. |
graph |
A graph composed of nodes and the edges between these nodes and the root node. |
next_page_token |
A token, which can be sent as |
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
Requires the following IAM permission on the name
resource:
chronicle.findingsGraphs.initializeGraph
For more information, see the IAM documentation.
NodeSource
A node source which tells which resource is an individual node is generated from. For a detection node, it is the detection id. For an entity node, it is the entity resource name.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field
|
|
detection_id |
A detection id. |
entity |
The resource name of an entity. Format: projects/{project}/locations/{location}/instances/{instance}/entities/{entity} |