Dependencies

Resource Operation Description
DELETE DELETE /v1/teams/(team_id)/labels/(label)/nodes/(path:node) Delete a node.
GET GET /v1/teams/(team_id)/labels/(label)/nodes/(path:node)/impacted/count Count the total number of nodes impacted by a given node.
  GET /v1/teams/(team_id)/labels/(label)/nodes/(path:node)/impacted/all Get a JSON payload containing all nodes impacted by a given node.
  GET /v1/teams/(team_id)/labels/(label)/nodes/(path:node)/impacted Get the nodes impacted by a given node.
  GET /v1/teams/(team_id)/labels/(label)/nodes/(path:node)/count Count the dependencies of a node.
  GET /v1/teams/(team_id)/labels/(label)/nodes/(path:node) Get the dependencies of a node.
  GET /v1/teams/(team_id)/labels/(label)/nodes Get the nodes of a label.
  GET /v1/teams/(team_id)/labels Get the labels of a team.
GET /v1/teams/(team_id)/labels/(label)/nodes/(path: node)/impacted/count

Count the total number of nodes impacted by a given node.

Example request:

GET /v1/teams/66859c4a-3e0a-4968-a5a4-4c3b8662acb7/labels/Website/nodes/example.com/impacted/count?impactedLabel=Offer HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK

{
  "count": 1
}
Parameters:
  • impactedLabel – impacted nodes for the given label
Response Headers:
 
Status Codes:
  • 200 OK – the array of impacted nodes
GET /v1/teams/(team_id)/labels/(label)/nodes/(path: node)/impacted/all

Get a JSON payload containing all nodes impacted by a given node.

Example request:

GET /v1/teams/66859c4a-3e0a-4968-a5a4-4c3b8662acb7/labels/Apache/nodes/apache2/impacted/all?impactedLabel=Offer&ts=1564645344 HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK

[
  {
    "active": true,
    "from": null,
    "name": "premium",
    "to": null
  }
]
Parameters:
  • impactedLabel – impacted nodes for the given label
  • ts – unix timestamp to check if the nodes are active or not at this timestamp
  • inactive – return inactive impacted nodes in the downloaded file or not (default is False)
Response Headers:
 
Status Codes:
  • 200 OK – the array of impacted nodes
GET /v1/teams/(team_id)/labels/(label)/nodes/(path: node)/impacted

Get the nodes impacted by a given node.

Example request:

GET /v1/teams/66859c4a-3e0a-4968-a5a4-4c3b8662acb7/labels/Apache/nodes/apache2/impacted?impactedLabel=Offer&skip=0&limit=25&ts=1564645111 HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK

[
  {
    "active": true,
    "from": null,
    "name": "premium",
    "to": null
  }
]
Parameters:
  • impactedLabel – impacted nodes for the given label
  • skip – skip the given number of values (default is 0)
  • limit – limit to the given number of values (default is 25)
  • ts – unix timestamp to check if the nodes are active or not at this timestamp
Response Headers:
 
Status Codes:
  • 200 OK – the array of impacted nodes
GET /v1/teams/(team_id)/labels/(label)/nodes/(path: node)/count

Count the dependencies of a node.

Example request:

GET /v1/teams/66859c4a-3e0a-4968-a5a4-4c3b8662acb7/labels/MyLabel/nodes/mynode/count HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK

{
  'count': 10
}
Response Headers:
 
Status Codes:
  • 200 OK – the number of dependencies
GET /v1/teams/(team_id)/labels/(label)/nodes/(path: node)

Get the dependencies of a node.

Example request:

GET /v1/teams/66859c4a-3e0a-4968-a5a4-4c3b8662acb7/labels/Website/nodes/example.com HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK

{
  "dependencies": {
    "Apache": [{
      "name": "apache1",
      "old": false,
      "periods": [0]
    }],
    "Filer": [{
      "name": "filer1",
      "old": false,
      "periods": [0]
    }],
    "Website": [{
        "name": "example.com"
     }]
  },
  "graph": {
    "nodes": [{
      "id": 8226314,
      "label": "example.com",
      "title": "Website"
    }, {
      "id": 8226318,
      "label": "apache1",
      "title": "Apache"
    }, {
      "id": 8226316,
      "label": "filer1",
      "title": "Filer"
    }],
    "relationships": [{
      "arrows": "to",
      "from": 8226314,
      "id": 13558159,
      "periods": [0],
      "to": 8226318
    }, {
      "arrows": "to",
      "from": 8226314,
      "id": 13558157,
      "periods": [0],
      "to": 8226316
    }]
  },
  "name": "example.com"
}
Parameters:
  • alone – Returns the node without its dependencies
  • day – Filter by day (default is today)
  • config – Only include labels used in configuration
  • inactive – Include the inactive nodes
  • impacted – Display the impacted nodes
Response Headers:
 
Status Codes:
  • 200 OK – the list of dependencies
DELETE /v1/teams/(team_id)/labels/(label)/nodes/(path: node)

Delete a node.

Example request:

DELETE /v1/teams/66859c4a-3e0a-4968-a5a4-4c3b8662acb7/labels/Website/nodes/example.com HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK

{}
Response Headers:
 
Parameters:
  • detach – Remove the relations of the node
Status Codes:
  • 200 OK – the node has been deleted
GET /v1/teams/(team_id)/labels/(label)/nodes

Get the nodes of a label.

Example request:

GET /v1/teams/66859c4a-3e0a-4968-a5a4-4c3b8662acb7/labels/Website/nodes HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK

[
  "example-one.com",
  "example-two.com"
]
Parameters:
  • name – Filter the list by name
  • limit – Limit the number of results
  • random – Return random items
Response Headers:
 
Status Codes:
  • 200 OK – the list of nodes
GET /v1/teams/(team_id)/labels

Get the labels of a team.

Example request:

GET /v1/teams/66859c4a-3e0a-4968-a5a4-4c3b8662acb7/labels HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK

[
  {
    "name": "Filer",
    "nodes_count": 2,
    "qos_query": "rule.Servers"
  },
  {
    "name": "Website",
    "nodes_count": 2,
    "qos_query": "operation.AND[Filer, Apache]"
  },
  {
    "name": "Apache",
    "nodes_count": 2,
    "qos_query": "rule.Servers"
  },
  {
    "name": "Offer",
    "nodes_count": 1,
    "qos_query": "aggregation.AVERAGE[Website]"
  }
]
Response Headers:
 
Status Codes:
  • 200 OK – the list of labels