List All Node Chains
get
/v1/nodeChains/{nodeManagerId}
Returns a list of all the node chains in a Node Manager.
Request
Path Parameters
-
nodeManagerId(required): string
The Node Manager identifier
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
The node chains were listed successfully.
Root Schema : schema
Type:
Show Source
array
-
Array of:
object NodeChainResponse
The response schema for getting list of node chains associated with the queried Node Manager.
Nested Schema : NodeChainResponse
Type:
object
The response schema for getting list of node chains associated with the queried Node Manager.
Show Source
-
nodeChains(required): array
nodeChains
The details of the node chains.
-
nodeManagers(required): array
nodeManagers
The Node Managers associated with nodes that are part of the node chain.
-
queryNmId(required): string
The identifier of the queried Node Manager.
Nested Schema : nodeChains
Type:
array
The details of the node chains.
Show Source
-
Array of:
object NodeChainResponseChainItem
The schema defining a node chain's information which is part of list node chains response.
Nested Schema : nodeManagers
Type:
array
The Node Managers associated with nodes that are part of the node chain.
Show Source
-
Array of:
object NodeChainResponseNMItem
THe schema defining a Node Manager's information associated with a node chain which is part of list node chains response.
Nested Schema : NodeChainResponseChainItem
Type:
object
The schema defining a node chain's information which is part of list node chains response.
Show Source
-
nmId(required): string
The identifier of the Node Manager.
-
nodes(required): array
nodes
The details for nodes that are part of the node chain.
Nested Schema : nodes
Type:
array
The details for nodes that are part of the node chain.
Show Source
-
Array of:
object NodeChainResponseNodeItem
The schema defining a node's information associated with a node chain which is part of list node chains response.
Nested Schema : NodeChainResponseNodeItem
Type:
object
The schema defining a node's information associated with a node chain which is part of list node chains response.
Show Source
-
displayName(required): string
The display name of the node.
-
id(required): string
The identifier of the node.
-
nodeType(required):
nodeType
-
routes(required): array
routes
The details for outgoing routes from the node.
Nested Schema : nodeType
Match All
The node type details of the node.
Show Source
-
object
NodeChainResponseNodeTypeItem
The schema defining node type information for a node associated with a node chain which is part of list node chains response.
-
The node type details of the node.
Nested Schema : routes
Type:
array
The details for outgoing routes from the node.
Show Source
-
Array of:
object NodeChainResponseRouteAttrs
The schema defining a route's information associated with a node chain which is part of list node chains response.
Nested Schema : NodeChainResponseNodeTypeItem
Type:
object
The schema defining node type information for a node associated with a node chain which is part of list node chains response.
Show Source
-
context(required): string
The context of the node.
-
marketSegment(required): string
The market segment of the node.
-
name(required): string
The name of the node.
-
type(required): string
The type of the node, for example, EI, DC, etc.
Nested Schema : NodeChainResponseRouteAttrs
Type:
object
The schema defining a route's information associated with a node chain which is part of list node chains response.
Show Source
-
destNmId(required): string
The identifier destination node's Node Manager.
-
destNodeId(required): string
The identifier of destination node.
-
isRemote(required): boolean
The flag indicating if the route is remote.
-
routingFn(required): string
The routing function used for the channel.
Nested Schema : NodeChainResponseNMItem
Type:
object
THe schema defining a Node Manager's information associated with a node chain which is part of list node chains response.
Show Source
-
nmHost(required): string
The host name at which Node Manager is hosted.
-
nmId(required): string
The identifier of the Node Manager.
-
nmName(required): string
THe name of the Node Manager.
-
nmPort(required): integer
(int32)
The port at which Node Manager is hosted.
-
nodesCount(required): integer
(int32)
The number of nodes associated with the Node Manager.
400 Response
The server cannot process the request due to a client error.
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.
401 Response
The client does not have the correct privileges.
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.
403 Response
The request was not authorized.
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.
404 Response
The requested resource cannot be found.
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.
405 Response
This method is not allowed.
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.
409 Response
The request could not be processed due to a conflict with the existing state of the resource.
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.
500 Response
The system has encountered an internal server error.
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.
Examples
The following example shows how to get a list of all node chains in a Node Manager 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/nodeChains/NMGR-31eoh3-16it-m8fkvbje' -d @sampleListAllNodeChains.json
Example of the Response Body
If successful, the response code 200 is returned with the following response body.
{ "nodeChains": [ { "nmId": "NMGR-31eoh3-16it-m8fkvbje", "nodes": [ { "displayName": "cc1", "id": "31eoh3-16it-m8fn0qbj", "nodeType": { "context": "CartridgeKit#EI#FlatFileEINode", "inputType": "TEXT", "marketSegment": "CartridgeKit", "name": "ASCII Collection Cartridge", "outputType": "NAR", "type": "CC" }, "routes": [ { "destNmId": "NMGR-31eoh6-16it-m8fkvbjc", "destNodeId": "31eoh6-16it-m8fn2ear", "isRemote": true, "routingFn": "Multicast" } ], "startState": true, "testId": "T-c5b4f7b0-901d-4132-8882-e8735badc012" } ] }, { "nmId": "NMGR-31eoh3-16it-m8fkvbje", "nodes": [ { "displayName": "cc2", "id": "31eoh3-16it-m8fn193f", "nodeType": { "context": "CartridgeKit#EI#FlatFileEINode", "inputType": "TEXT", "marketSegment": "CartridgeKit", "name": "ASCII Collection Cartridge", "outputType": "NAR", "type": "CC" }, "routes": [], "startState": false } ] }, { "nmId": "NMGR-31eoh6-16it-m8fkvbjc", "nodes": [ { "displayName": "dc", "id": "31eoh6-16it-m8fn2ear", "nodeType": { "context": "CartridgeKit#OI#FFOINode", "inputType": "NAR", "marketSegment": "CartridgeKit", "name": "ASCII Distribution Cartridge", "outputType": "TEXT", "type": "DC" }, "routes": [], "startState": true, "testId": "T-c5b4f7b0-901d-4132-8882-e8735badc012" } ] } ], "nodeManagers": [ { "nmHost": "nm-1-0", "nmId": "NMGR-31eoh3-16it-m8fkvbje", "nmName": "nm-1-0", "nmPort": 55109, "nodesCount": 2 }, { "nmHost": "nm-2-0", "nmId": "NMGR-31eoh6-16it-m8fkvbjc", "nmName": "nm-2-0", "nmPort": 55109, "nodesCount": 1 } ], "queryNmId": "NMGR-31eoh3-16it-m8fkvbje" }