URL

/rw/iosystem/networks

Method

POST

URL Params

action=search Required

Data Params

name The network name e.g. Virtual or Local
state The network state e.g. running

Only one Data Param is mandatory ("name (or) state") . Example: name=local&state=running (or) state=running

Success Response

HTTP_OK(200)

see HTTP Status codes

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<html xmlns="http://www.w3.org/1999/xhtml">
   <title>io</title>
   <head>
      <base href="http://localhost/rw/iosystem/" />
   </head>
   <body>
      <div class="state">
         <a href="networks" rel="self" />
         <ul>
            <li class="ios-network-li" title="Local">
               <a href="networks/Local" rel="self"></a>
               <a href="devices?network=Local" rel="devices"></a>
               <span class="name">Local</span>
               <span class="pstate">running</span>
               <span class="lstate">started</span>
            </li>
            <li class="ios-network-li" title="Virtual">
               <a href="networks/Virtual" rel="self"></a>
               <a href="devices?network=Virtual" rel="devices"></a>
               <span class="name">Virtual</span>
               <span class="pstate">running</span>
               <span class="lstate">started</span>
            </li>
         </ul>
      </div>
   </body>
</html>

Resources

ios-network-li
- name Name of the IO-network
- pstate Physical state of the network: {halted, running, error, startup, init, unknown}
- lstate Logical state
- rel
  - devices Link to devices connected to this network

Error Response

BAD_REQUEST(400)

See Robot controller return codes

Sample Call

Search IO Networks

curl --digest -u "Default User":robotics -d "name=Local&state=running" -X POST "http://localhost/rw/iosystem/networks?action=search"

Notes

Not supported in bootserver mode