THthingsboard
edge-controller

Find related edges (findByQuery)

Returns all edges that are related to the specific entity. The entity id, relation type, edge types, depth of the search, and other query parameters defined using complex 'EdgeSearchQuery' object. See 'Model' tab of the Parameters for more info.

Available for users with 'TENANT_ADMIN' or 'CUSTOMER_USER' authority.

post/api/edges

Request

Request body

relationTypestring

Type of the relation between root entity and edge (e.g. 'Contains' or 'Manages').

edgeTypesstring[]

Array of edge types to filter the related entities (e.g. 'Silos', 'Stores').

Example request

{
  "parameters": {
    "rootId": "784f394c-42b6-435a-983c-b7beff2784f9"
  }
}

Response

OK

createdTimeinteger

Timestamp of the edge creation, in milliseconds

namestring required

Unique Edge Name in scope of Tenant

typestring required

Edge type

labelstring

Label that may be used in widgets

routingKeystring required

Edge routing key ('username') to authorize on cloud

secretstring required

Edge secret ('password') to authorize on cloud

versioninteger
additionalInfounknown

Example response

[
  {
    "id": {
      "id": "784f394c-42b6-435a-983c-b7beff2784f9",
      "entityType": "EDGE"
    },
    "createdTime": 1609459200000,
    "tenantId": {
      "id": "784f394c-42b6-435a-983c-b7beff2784f9",
      "entityType": "TENANT"
    },
    "customerId": {
      "id": "784f394c-42b6-435a-983c-b7beff2784f9",
      "entityType": "CUSTOMER"
    },
    "rootRuleChainId": {
      "id": "784f394c-42b6-435a-983c-b7beff2784f9",
      "entityType": "RULE_CHAIN"
    },
    "name": "Silo_A_Edge",
    "type": "Silos",
    "label": "Silo Edge on far field",
    "additionalInfo": {}
  }
]

Changes

No recorded changes to this operation across all 2 revisions of this API.