Search all history events and return them.

POST 
/graph/:graph_id/search/history/list

Search all history events and return them. A section can be defined (defaults to / == root) to interpret relative property paths. Example: is(volume) and (reported.age>23d or desired.clean==true or metadata.version==2)

Request

Path Parameters

graph_id stringrequired
The identifier of the graph
Example: fix

Query Parameters

section string

Possible values: [reported, desired, metadata]

The name of the section used for all property paths. If not defined root is assumed.

with-kind boolean

Include the kind of the node in the result node.

count boolean

Default value: true

Optional parameter to get a Ck-Element-Count header which returns the number of returned json elements

before date-time

Optional parameter to get all history events before the given timestamp

after date-time

Optional parameter to get all history events after the given timestamp

change string

Possible values: [node_created, node_updated, node_deleted]

Optional parameter to get all history events with the given change type

at date-time

The timestamp to use for the search. If not defined the latest version of the graph is used.

text/plain

Body

The search to perform

string

Responses

200

The result of this search in the defined format

application/json

Schema

Schema

• Array [

kind string

The kind of this node.

• ]

Example (from schema)

[
  {
    "id": "123456",
    "reported": {
      "kind": "test.person",
      "name": "Batman",
      "city": "Gotham"
    }
  }
]

application/x-ndjson

Schema

Schema

kind string

The kind of this node.

property name* any

Example (from schema)

{
  "id": "123456",
  "reported": {
    "kind": "test.person",
    "name": "Batman",
    "city": "Gotham"
  }
}

Example

{"type": "node", "id": "root", "revision": "123", "reported": {"kind": "graph_root", "id": "root", "tags": {}, "name": "root"}}
{"type": "node", "id": "cloud_id",  "revision": "12", "reported": {"kind": "cloud", "id": "onelogin", "tags": {}, "name": "onelogin", "ctime": "2021-12-14T08:49:52Z", "age": "6d7h"}}
{"type": "edge", "from": "root", "to": "cloud_id", "edge_type": "default"}

text/plain

Schema

Schema

any

Example

reported:
  kind: graph_root
  id: root
  tags: {}
  name: root
metadata:
  cleaned: false
  phantom: true
  protected: false

application/yaml

Schema

Schema

any

Example

id: root
type: node
revision: _daGy-Bu---
reported:
    kind: graph_root
    id: root
    tags: { }
    name: root
metadata:
    python_type: fixlib.baseresources.GraphRoot
    cleaned: false
    phantom: true
    protected: false
kinds:
    - graph_root
---
id: 2RZlTX9yzeBwTNT_H1KZVA
type: node
revision: _daGy-Bi---
reported:
    kind: cloud
    id: onelogin
    tags: { }
    name: onelogin
    ctime: '2021-12-14T08:49:52Z'
    age: 6d7h
metadata:
    python_type: fixlib.baseresources.Cloud
    cleaned: false
    phantom: false
    protected: false
    descendant_summary:
        onelogin_account: 1
        onelogin_region: 1
        onelogin_user: 1034
    descendant_count: 1036
ancestors:
    cloud:
        reported:
            name: onelogin
            id: onelogin
kinds:
    - cloud
    - base_cloud
    - resource
---
type: edge
from: root
to: 2RZlTX9yzeBwTNT_H1KZVA
edge_type: default

Loading...