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:
objectThe 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:
arrayThe 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:
arrayThe 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:
objectThe 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:
arrayThe 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:
objectThe 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:
arrayThe 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:
objectThe 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:
objectThe 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:
objectTHe 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:
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
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:
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
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:
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
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:
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
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:
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
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:
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
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:
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
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"
}