Update a Node
patch
/v1/nodes/{id}
Updates a node with a specified ID.
Request
Path Parameters
-
id(required): string
The node identifier.
Supported Media Types
- application/json;charset=utf-8
Root Schema : schema
Type:
object
The payload schema to update an existing node.
Show Source
-
dcNodeConfigData:
dcNodeConfigData
-
displayName(required): string
The display name of the node.Example:
CC Node 1
-
ruleFileDisplayName(required): string
The selected rule file display name for the node.
-
ruleFileName(required): string
The selected rule file name for the node.Example:
ASCII_Sample.npl
Nested Schema : dcNodeConfigData
Match All
The configuration data of the node.
Show Source
-
object
DCNodeConfigDataRSM
The schema defining node configuration data for a node.
-
The configuration data of the node.
Nested Schema : DCNodeConfigDataRSM
Type:
object
The schema defining node configuration data for a node.
Show Source
-
configRules: array
configRules
The secondary configuration data of the node.
-
nodeConfigVariables: array
nodeConfigVariables
The general configuration data of the node.
-
ruleName: string
The selected rule file name for the node.
Nested Schema : configRules
Type:
array
The secondary configuration data of the node.
Show Source
-
Array of:
object SecondaryConfigData
The schema defining secondary configuration data for a node.
Nested Schema : nodeConfigVariables
Type:
array
The general configuration data of the node.
Show Source
-
Array of:
object NodeConfigVariable
The schema defining configuration variable for a node.
Nested Schema : SecondaryConfigData
Type:
object
The schema defining secondary configuration data for a node.
Show Source
-
fileConfigVariables(required): array
fileConfigVariables
The list of secondary configuration variables for the node.
-
fileName(required): string
The secondary configuration data file name.
Nested Schema : fileConfigVariables
Type:
array
The list of secondary configuration variables for the node.
Show Source
-
Array of:
object NodeConfigVariable
The schema defining configuration variable for a node.
Nested Schema : NodeConfigVariable
Type:
object
The schema defining configuration variable for a node.
Show Source
-
name(required): string
The key name of the configuration variable.Example:
processedFileSuffix
-
value(required): string
TThe value of the configuration variable for a key.Example:
complete
Response
Supported Media Types
- application/json
200 Response
The node was updated successfully.
Root Schema : NodeResponse
Type:
object
The response schema for getting a node's information.
Show Source
-
@type: string
Defines the sub-class entity when sub-classing.
-
dcNodeConfigData:
dcNodeConfigData
-
dcNodeType:
dcNodeType
-
destinationNode: array
destinationNode
The details of destination nodes for routes originating from the node.
-
displayName(required): string
The display name of the node.Example:
CC Node 1
-
marketSegment(required): string
The market segment of the node.Example:
CartridgeKit
-
NMhref(required): string
(uri)
The reference to get Node Manager information.
-
nodeContext(required): string
The context of a node.
-
nodeId(required): string
The node identifier.Example:
z8kfsx-16it-l0mbm95p
-
nodeLabel(required): string
The node label.Example:
3
-
nodeManagerID(required): string
The Node Manager identifier.
-
ruleFileDisplayName(required): string
The selected rule file display name of the node.
-
ruleFileName(required): string
The selected rule file name of the node.Example:
ASCII_Sample.npl
-
startState(required): boolean
The starting state of the node.Example:
STOPPED
Nested Schema : dcNodeConfigData
Match All
The configuration data of the node.
Show Source
-
object
DCNodeConfigDataRSM
The schema defining node configuration data for a node.
-
The configuration data of the node.
Nested Schema : dcNodeType
Match All
The node type information of the node.
Show Source
-
object
DCNodeTypeRSM
The schema defining node type information for a node.
-
The node type information of the node.
Nested Schema : destinationNode
Type:
array
The details of destination nodes for routes originating from the node.
Show Source
-
Array of:
object DestinationNodeConfig
The schema defining destination node's reference for a route.
Nested Schema : DCNodeConfigDataRSM
Type:
object
The schema defining node configuration data for a node.
Show Source
-
configRules: array
configRules
The secondary configuration data of the node.
-
nodeConfigVariables: array
nodeConfigVariables
The general configuration data of the node.
-
ruleName: string
The selected rule file name for the node.
Nested Schema : configRules
Type:
array
The secondary configuration data of the node.
Show Source
-
Array of:
object SecondaryConfigData
The schema defining secondary configuration data for a node.
Nested Schema : nodeConfigVariables
Type:
array
The general configuration data of the node.
Show Source
-
Array of:
object NodeConfigVariable
The schema defining configuration variable for a node.
Nested Schema : SecondaryConfigData
Type:
object
The schema defining secondary configuration data for a node.
Show Source
-
fileConfigVariables(required): array
fileConfigVariables
The list of secondary configuration variables for the node.
-
fileName(required): string
The secondary configuration data file name.
Nested Schema : fileConfigVariables
Type:
array
The list of secondary configuration variables for the node.
Show Source
-
Array of:
object NodeConfigVariable
The schema defining configuration variable for a node.
Nested Schema : NodeConfigVariable
Type:
object
The schema defining configuration variable for a node.
Show Source
-
name(required): string
The key name of the configuration variable.Example:
processedFileSuffix
-
value(required): string
TThe value of the configuration variable for a key.Example:
complete
Nested Schema : DCNodeTypeRSM
Type:
object
The schema defining node type information for a node.
Show Source
-
configDataClass(required): string
The config data class name of the node.Example:
com.oracle.nm.collector.file.FtpEIConfigData
-
configDataGuiClass(required): string
The config data GUI class name of the node.Example:
com.oracle.nm.collector.file.FileEIConfigGUI
-
displayString(required): string
The display string represented as 'majorType : minorType'.Example:
EI : FileEI
-
majorType(required): string
The major type of the node.Example:
EI
-
minorType(required): string
The minor type of the node.Example:
FileEI
-
nodeClass(required): string
The class name of the node.Example:
com.oracle.nm.collector.file.FileEINode
Nested Schema : DestinationNodeConfig
Type:
object
The schema defining destination node's reference for a route.
Show Source
-
channelID(required): string
The identifier of the channel.Example:
1
-
destinationNodeID(required): string
The identifier of the destination node.Example:
z8kfsx-16it-3res21sew
-
Returns an object of type RoutingConfig(required): string
(uri)
The reference to get channel information for the route between the given node and its destination node.Example:
server:port/nodes/{id}/route/{destNodeId}
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
This example shows how to update a node's details by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X PATCH 'http://hostname:port/nodes/31eoef-otm-lna53s09'
Example of the Response Body
If successful, the response code 200 is returned with the following response body.
{
"dcNodeConfigData": {
"nodeConfigVariables": [
{
"name": "narbackup",
"value": "false"
},
{
"name": "fileleveltransaction",
"value": "false"
},
{
"name": "mtCheck",
"value": "false"
},
{
"name": "recordStatistics",
"value": "false"
}
],
"configRules" : [
]
},
"displayName": "Node-7",
"ruleFileDisplayName": "NewFile2",
"ruleFileName": "NewFile2.npl"
}