Jump to

• Request
• Response
• Examples

Get the Routing Object Between Two Nodes

get

/v1/nodes/{srcNodeId}/route/{destNodeId}

Returns the routing object between two specific nodes.

Request

Path Parameters

• destNodeId(required): string
  The destination node identifier.
• srcNodeId(required): string
  The source node identifier

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

The routing object has been returned successfully.

Body ()

Root Schema : RouteResponse

Type: object

The response schema to get a route's information.

Show Source

• destinationNodeID(required): string
  The identifier of the destination node.

  Example: z8kfsx-16it-3res21sew
• routingAttrs: routingAttrs
• routingField: string
  The field defined in NPL used for routing.
• routingFunction(required): routingFunction
• sourceNodeID(required): string
  The identifier of the source node.

  Example: z8kfsx-16it-l0mbm95p

{
    "required":[
        "destinationNodeID",
        "routingFunction",
        "sourceNodeID"
    ],
    "properties":{
        "destinationNodeID":{
            "description":"The identifier of the destination node.",
            "example":"z8kfsx-16it-3res21sew",
            "nullable":false,
            "type":"string"
        },
        "routingAttrs":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/RoutingAttributes"
                },
                {
                    "description":"The attributes against which routing fields are compared using various operations."
                }
            ]
        },
        "routingField":{
            "description":"The field defined in NPL used for routing.",
            "type":"string"
        },
        "routingFunction":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/RoutingFunctionEnum1"
                },
                {
                    "description":"The routing function used for the channel.",
                    "example":"DIRECTED",
                    "nullable":false
                }
            ]
        },
        "sourceNodeID":{
            "description":"The identifier of the source node.",
            "example":"z8kfsx-16it-l0mbm95p",
            "nullable":false,
            "type":"string"
        }
    },
    "description":"The response schema to get a route's information.",
    "type":"object"
}

Nested Schema : routingAttrs

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.
• The attributes against which routing fields are compared using various operations.

{
    "allOf":[
        {
            "$ref":"#/components/schemas/RoutingAttributes"
        },
        {
            "description":"The attributes against which routing fields are compared using various operations."
        }
    ]
}

Nested Schema : routingFunction

Match All

The routing function used for the channel.

Show Source

• string
  Allowed Values: [ "DIRECTED", "MODULUS", "MULTICAST", "ROUND_ROBIN" ]
• The routing function used for the channel.

  Example: DIRECTED

{
    "allOf":[
        {
            "$ref":"#/components/schemas/RoutingFunctionEnum1"
        },
        {
            "description":"The routing function used for the channel.",
            "example":"DIRECTED",
            "nullable":false
        }
    ]
}

Nested Schema : RoutingAttributes

Type: object

The 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): operator

{
    "required":[
        "operand1",
        "operator"
    ],
    "properties":{
        "operand1":{
            "description":"The values against which the operator acts on the routing field.",
            "items":{
                "type":"string"
            },
            "nullable":false,
            "type":"array"
        },
        "operand2":{
            "description":"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.",
            "items":{
                "type":"string"
            },
            "type":"array"
        },
        "operator":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/OperatorEnum1"
                },
                {
                    "description":"The expression representing action to be performed on routing field.",
                    "example":"EQUALS",
                    "nullable":false
                }
            ]
        }
    },
    "description":"The schema defining routing attributes for a route.",
    "type":"object"
}

Nested Schema : operand1

Type: array

The values against which the operator acts on the routing field.

Show Source

• Array of: string

{
    "description":"The values against which the operator acts on the routing field.",
    "items":{
        "type":"string"
    },
    "nullable":false,
    "type":"array"
}

Nested Schema : operand2

Type: array

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.

Show Source

• Array of: string

{
    "description":"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.",
    "items":{
        "type":"string"
    },
    "type":"array"
}

Nested Schema : operator

Match All

The expression representing action to be performed on routing field.

Show Source

• string
  Allowed Values: [ "EQUALS", "GREATER_THAN", "IN_BETWEEN", "LESS_THAN", "LIST_EQUALS", "LIST_NOT_EQUALS", "NOT_EQUALS", "NOT_SUBSET_OF", "SUBSET_OF" ]
• The expression representing action to be performed on routing field.

  Example: EQUALS

{
    "allOf":[
        {
            "$ref":"#/components/schemas/OperatorEnum1"
        },
        {
            "description":"The expression representing action to be performed on routing field.",
            "example":"EQUALS",
            "nullable":false
        }
    ]
}

400 Response

The request cannot be processed due to a client error.

Body ()

Root Schema : Error

Type: object

Used 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
  The 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)
  The URI of the documentation describing the error.
• status: string
  The HTTP error code describing the error.

{
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "@type":{
            "description":"Defines the sub-class entity when sub-classing.",
            "type":"string"
        },
        "cause":{
            "description":"The cause of the exception.",
            "type":"string"
        },
        "code":{
            "description":"The application relevant details defined in the API or a common list.",
            "nullable":false,
            "type":"string"
        },
        "message":{
            "description":"The details and corrective actions for the error shown to the client user.",
            "type":"string"
        },
        "reason":{
            "description":"The reason for the error, which is shown to a client user.",
            "nullable":false,
            "type":"string"
        },
        "referenceError":{
            "description":"The URI of the documentation describing the error.",
            "format":"uri",
            "type":"string"
        },
        "status":{
            "description":"The HTTP error code describing the error.",
            "type":"string"
        }
    },
    "description":"Used when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).",
    "type":"object"
}

401 Response

The client does not have the corrrect privileges.

Body ()

Root Schema : Error

Type: object

Used 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
  The 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)
  The URI of the documentation describing the error.
• status: string
  The HTTP error code describing the error.

{
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "@type":{
            "description":"Defines the sub-class entity when sub-classing.",
            "type":"string"
        },
        "cause":{
            "description":"The cause of the exception.",
            "type":"string"
        },
        "code":{
            "description":"The application relevant details defined in the API or a common list.",
            "nullable":false,
            "type":"string"
        },
        "message":{
            "description":"The details and corrective actions for the error shown to the client user.",
            "type":"string"
        },
        "reason":{
            "description":"The reason for the error, which is shown to a client user.",
            "nullable":false,
            "type":"string"
        },
        "referenceError":{
            "description":"The URI of the documentation describing the error.",
            "format":"uri",
            "type":"string"
        },
        "status":{
            "description":"The HTTP error code describing the error.",
            "type":"string"
        }
    },
    "description":"Used when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).",
    "type":"object"
}

403 Response

The request was not authorized.

Body ()

Root Schema : Error

Type: object

Used 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
  The 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)
  The URI of the documentation describing the error.
• status: string
  The HTTP error code describing the error.

{
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "@type":{
            "description":"Defines the sub-class entity when sub-classing.",
            "type":"string"
        },
        "cause":{
            "description":"The cause of the exception.",
            "type":"string"
        },
        "code":{
            "description":"The application relevant details defined in the API or a common list.",
            "nullable":false,
            "type":"string"
        },
        "message":{
            "description":"The details and corrective actions for the error shown to the client user.",
            "type":"string"
        },
        "reason":{
            "description":"The reason for the error, which is shown to a client user.",
            "nullable":false,
            "type":"string"
        },
        "referenceError":{
            "description":"The URI of the documentation describing the error.",
            "format":"uri",
            "type":"string"
        },
        "status":{
            "description":"The HTTP error code describing the error.",
            "type":"string"
        }
    },
    "description":"Used when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).",
    "type":"object"
}

404 Response

The requested resource cannot be found.

Body ()

Root Schema : Error

Type: object

Used 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
  The 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)
  The URI of the documentation describing the error.
• status: string
  The HTTP error code describing the error.

{
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "@type":{
            "description":"Defines the sub-class entity when sub-classing.",
            "type":"string"
        },
        "cause":{
            "description":"The cause of the exception.",
            "type":"string"
        },
        "code":{
            "description":"The application relevant details defined in the API or a common list.",
            "nullable":false,
            "type":"string"
        },
        "message":{
            "description":"The details and corrective actions for the error shown to the client user.",
            "type":"string"
        },
        "reason":{
            "description":"The reason for the error, which is shown to a client user.",
            "nullable":false,
            "type":"string"
        },
        "referenceError":{
            "description":"The URI of the documentation describing the error.",
            "format":"uri",
            "type":"string"
        },
        "status":{
            "description":"The HTTP error code describing the error.",
            "type":"string"
        }
    },
    "description":"Used when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).",
    "type":"object"
}

405 Response

This method is not allowed.

Body ()

Root Schema : Error

Type: object

Used 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
  The 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)
  The URI of the documentation describing the error.
• status: string
  The HTTP error code describing the error.

{
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "@type":{
            "description":"Defines the sub-class entity when sub-classing.",
            "type":"string"
        },
        "cause":{
            "description":"The cause of the exception.",
            "type":"string"
        },
        "code":{
            "description":"The application relevant details defined in the API or a common list.",
            "nullable":false,
            "type":"string"
        },
        "message":{
            "description":"The details and corrective actions for the error shown to the client user.",
            "type":"string"
        },
        "reason":{
            "description":"The reason for the error, which is shown to a client user.",
            "nullable":false,
            "type":"string"
        },
        "referenceError":{
            "description":"The URI of the documentation describing the error.",
            "format":"uri",
            "type":"string"
        },
        "status":{
            "description":"The HTTP error code describing the error.",
            "type":"string"
        }
    },
    "description":"Used when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).",
    "type":"object"
}

409 Response

The request cannot be processed due to a conflict in the existing state of the resource.

Body ()

Root Schema : Error

Type: object

Used 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
  The 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)
  The URI of the documentation describing the error.
• status: string
  The HTTP error code describing the error.

{
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "@type":{
            "description":"Defines the sub-class entity when sub-classing.",
            "type":"string"
        },
        "cause":{
            "description":"The cause of the exception.",
            "type":"string"
        },
        "code":{
            "description":"The application relevant details defined in the API or a common list.",
            "nullable":false,
            "type":"string"
        },
        "message":{
            "description":"The details and corrective actions for the error shown to the client user.",
            "type":"string"
        },
        "reason":{
            "description":"The reason for the error, which is shown to a client user.",
            "nullable":false,
            "type":"string"
        },
        "referenceError":{
            "description":"The URI of the documentation describing the error.",
            "format":"uri",
            "type":"string"
        },
        "status":{
            "description":"The HTTP error code describing the error.",
            "type":"string"
        }
    },
    "description":"Used when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).",
    "type":"object"
}

500 Response

The system has encountered an internal server error.

Body ()

Root Schema : Error

Type: object

Used 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
  The 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)
  The URI of the documentation describing the error.
• status: string
  The HTTP error code describing the error.

{
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "@type":{
            "description":"Defines the sub-class entity when sub-classing.",
            "type":"string"
        },
        "cause":{
            "description":"The cause of the exception.",
            "type":"string"
        },
        "code":{
            "description":"The application relevant details defined in the API or a common list.",
            "nullable":false,
            "type":"string"
        },
        "message":{
            "description":"The details and corrective actions for the error shown to the client user.",
            "type":"string"
        },
        "reason":{
            "description":"The reason for the error, which is shown to a client user.",
            "nullable":false,
            "type":"string"
        },
        "referenceError":{
            "description":"The URI of the documentation describing the error.",
            "format":"uri",
            "type":"string"
        },
        "status":{
            "description":"The HTTP error code describing the error.",
            "type":"string"
        }
    },
    "description":"Used when an API encounters an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).",
    "type":"object"
}

Back to Top

Examples

The following example shows how to get the routing object between a source node and a destination 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/31eoef-otm-lna53s09'

Example of the Response Body

If successful, the response code 200 is returned with the following response body.

{
  "destinationNodeID": "31eoef-otm-lna53s09",
  "routingAttrs": {
    "operand1": [
      ""
    ],
    "operand2": [
      ""
    ]
  },
  "routingField": "",
  "routingFunction": "MULTICAST",
  "sourceNodeID": "31eoef-otm-lna51qht"
}

Back to Top