Subscribe On System Energy Changes.
URL
/subscription
Method
POST
URL Params
None
See Common URL parameters
Data Params
- resources = An identifier Required
- <identifier> = The subscription resource URI (The URI here is: '/rw/system/energy') Required
- <identifier>-p = The priority associated with the subscription resource Required
Success Response
CREATED(201)
see HTTP Status codes
Example Response
<?xml version="1.0" encoding="UTF-8"?>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Event</title>
<base href="http://localhost/"/>
</head>
<body>
<div class="state">
<a href="subscription/7" rel="group" />
<a href="ws://localhost/poll/7" rel="self" />
<a href="subscription/7?action=show" rel="action" />
<ul>
<li class="sys-energy-ev" title="energy">
<a href="/rw/system/energy" rel="self" />
<span class="energy-state">blocked</span>
</li>
</ul>
</div>
</body>
</html>
Error Response
UNSUPPORTED_MEDIA(415),BAD_REQUEST(400)
HTTP Errors, see HTTP Status codes
Robot controller errors, see Robot controller return codes
Sample Call
only low priority subscription(-p=0) and medium priority subscription(-p=1) are allowed on this resource
curl --digest -u "Default User":robotics -d "resources=1&1=/rw/system/energy&1-p=0" -X POST "http://localhost/subscription"
curl --digest -u "Default User":robotics -d "resources=1&1=/rw/system/energy&1-p=1" -X POST "http://localhost/subscription"
Notes
Not supported in bootserver mode