Versions Compared

Version Old Version 1 New Version 2
Changes made by

Assaf Cohen (Deactivated)

Assaf Cohen (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

User will need an admin or operator access for this API, Unauthorized users will get "401 Unauthorized"


Add and setup a device:

Ommited boolean paramters are persumed to be false, it's not allowed to setup wsm without setting up log targets

POST /op/api/v1/devices?name=wdp6&host=10.0.0.13&somaPort=5550&somaUser=admin&somaPass=password&logtargetAddress=10.0.0.13&monitorResources=false&monitorServices=true&syslogAgentName=MonTier-SyslogAgent-1&setupSyslogforDomains=true&wsmAgentName=MonTier-WsmAgent-1&setupWsmforDomains=true&setupCertificateMonitor=true
{
"resultCode": "OK",
"resultMessage": ""
}

Info

Error messages are issued for input validation errors , errors while inserting the device into derby/es and errors that happened during the device-level syslog setup, when an error happens during those steps - the transaction is rolled-back and the device is removed from DPOD, so the command can be issued again without failing on a duplicate device error.
Warning messages are issued for errors that happened while setting up log targets for all domains, setting up wsm for all domains or setting up certificate monitoring, the operation stops, but the transaction will not roll-back from DPOD, so manual steps will be needed in order to complete the setup.

Error - The operation either failed the input validation checks, or started but stopped, the device was rolled back from DPOD.

{
"resultCode": "ERROR",
"resultMessage": "A device with this name already exists, name=wdp6"
}

Warning - the operation started but stopped, we did not roll back the device or any setup done to this point, so the user will need to manually check what was setup and complete it manually.
{
"resultCode": "WARNING",
"resultMessage": "Error setting up WS-M agent for the following domains: Domain: APIMgmt_963162B289, Message: +DPOD WSM agent cannot be reached from the device. Error is: Cannot ping both host and IP address: TCP connection to \"10.0.0.38 port 60020\" failed (connection refused)"
}