Get the Routing Objects from Source Node
get
/v1/nodes/{srcNodeId}/route
Returns the routing objects from the specified source node.
Request
Path Parameters
-
srcNodeId(required): string
The source node identifier.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
The routing objects have been successfully fetched from the source node.
Root Schema : schema
Type:
Show Source
array-
Array of:
object RouteResponse
The response schema to get a route's information.
Nested Schema : RouteResponse
Type:
objectThe response schema to get a route's information.
Show Source
-
destinationNodeID(required): string
The identifier of the destination node.Example:
z8kfsx-16it-3res21sew -
routingAttrs: object
routingAttrs
The attributes against which routing fields are compared using various operations.
-
routingField: string
Field defined in NPL used for routing
-
routingFunction(required): string
routingFunction
The routing function used for the channel.
-
sourceNodeID(required): string
Identifier of the source nodeExample:
z8kfsx-16it-l0mbm95p
Nested Schema : routingAttrs
Type:
objectThe attributes against which routing fields are compared using various operations.
Match All
The attributes against which routing fields are compared using various operations.
Show Source
-
object
RoutingAttributes
The schema defining routing attributes for a route.
Nested Schema : routingFunction
The routing function used for the channel.
Match All
The routing function used for the channel.
Show Source
-
string
Allowed Values:
[ "ROUND ROBIN", "MULTICAST", "MODULUS", "DIRECTED" ]
Example:
DIRECTEDNested Schema : RoutingAttributes
Type:
objectThe schema defining routing attributes for a route.
Show Source
-
operand1(required): array
operand1
The values against which the operator acts on the routing field.
-
operand2: array
operand2
The values against which operator acts on the routing field, two operands are required when an operator is used which requires 3 variables. For example, IN_BETWEEN operator.
-
operator(required): string
operator
The expression representing action to be performed on routing field.
Nested Schema : operand1
Type:
arrayThe values against which the operator acts on the routing field.
Show Source
Nested Schema : operand2
Type:
arrayThe values against which operator acts on the routing field, two operands are required when an operator is used which requires 3 variables. For example, IN_BETWEEN operator.
Show Source
Nested Schema : operator
The expression representing action to be performed on routing field.
Match All
The expression representing action to be performed on routing field.
Show Source
-
string
Allowed Values:
[ "EQUALS", "NOT_EQUALS", "LESS_THAN", "GREATER_THAN", "IN_BETWEEN", "LIST_EQUALS", "LIST_NOT_EQUALS", "SUBSET_OF", "NOT_SUBSET_OF" ]
Example:
EQUALS400 Response
The request cannot be processed due to a client error.
Root Schema : Error
Type:
objectUsed when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@type: string
Defines the sub-class entity when sub-classing.
-
cause: string
Cause of the exception
-
code(required): string
The application relevant details defined in the API or a common list.
-
message: string
The details and corrective actions for the error shown to the client user.
-
reason(required): string
The reason for the error, which is shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error
-
status: string
HTTP Error code extension
401 Response
The client does not have the correct privileges.
Root Schema : Error
Type:
objectUsed when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@type: string
Defines the sub-class entity when sub-classing.
-
cause: string
Cause of the exception
-
code(required): string
The application relevant details defined in the API or a common list.
-
message: string
The details and corrective actions for the error shown to the client user.
-
reason(required): string
The reason for the error, which is shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error
-
status: string
HTTP Error code extension
403 Response
The request was not authorized.
Root Schema : Error
Type:
objectUsed when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@type: string
Defines the sub-class entity when sub-classing.
-
cause: string
Cause of the exception
-
code(required): string
The application relevant details defined in the API or a common list.
-
message: string
The details and corrective actions for the error shown to the client user.
-
reason(required): string
The reason for the error, which is shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error
-
status: string
HTTP Error code extension
404 Response
The requested resource cannot be found.
Root Schema : Error
Type:
objectUsed when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@type: string
Defines the sub-class entity when sub-classing.
-
cause: string
Cause of the exception
-
code(required): string
The application relevant details defined in the API or a common list.
-
message: string
The details and corrective actions for the error shown to the client user.
-
reason(required): string
The reason for the error, which is shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error
-
status: string
HTTP Error code extension
405 Response
This method is not allowed.
Root Schema : Error
Type:
objectUsed when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@type: string
Defines the sub-class entity when sub-classing.
-
cause: string
Cause of the exception
-
code(required): string
The application relevant details defined in the API or a common list.
-
message: string
The details and corrective actions for the error shown to the client user.
-
reason(required): string
The reason for the error, which is shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error
-
status: string
HTTP Error code extension
409 Response
The request cannot be processed due to a conflict in the existing state of the resource.
Root Schema : Error
Type:
objectUsed when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@type: string
Defines the sub-class entity when sub-classing.
-
cause: string
Cause of the exception
-
code(required): string
The application relevant details defined in the API or a common list.
-
message: string
The details and corrective actions for the error shown to the client user.
-
reason(required): string
The reason for the error, which is shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error
-
status: string
HTTP Error code extension
500 Response
The system has encountered an internal server error.
Root Schema : Error
Type:
objectUsed when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@type: string
Defines the sub-class entity when sub-classing.
-
cause: string
Cause of the exception
-
code(required): string
The application relevant details defined in the API or a common list.
-
message: string
The details and corrective actions for the error shown to the client user.
-
reason(required): string
The reason for the error, which is shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error
-
status: string
HTTP Error code extension
Examples
The following example shows how to get the routing objects from a specified source node by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X GET 'http://hostname:port/nodes/31eoef-otm-lna51qht/route'
Example of the Response Body
If successful, the response code 200 is returned along with the following response payload.
[
{
"destinationNodeID": "31eoef-otm-lna53s09",
"routingAttrs": {
"operand1": [
""
],
"operand2": [
""
]
},
"routingField": "",
"routingFunction": "MULTICAST",
"sourceNodeID": "31eoef-otm-lna51qht"
}