URL

/rw/mastership

Method

GET

URL Params

action=show Required

Returns action Forms for this resource

See Common URL parameters

Data Params

None

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">
    <head>
    <title>MasterShip</title>
    <base href="http://localhost/"/>
    </head>
    <body>    
    <div class="state">  
        <form id="request-mastership" method='post' action="/rw/mastership?action=request">     
        </form> 
        <form id="release-mastership" method='post' action="/rw/mastership?action=release">     
        </form>     
        <form id="subscribe" method="post" action="subscription">
            <fieldset name="cfg">
                <input name="resources" value="1" type="hidden"/>
                <input name="1" maxlength="500" value="/rw/mastership/cfg" type="hidden"/>
                <select name="1-p">
                    <option value="0" selected="selected"></option>
                    <option value="1"></option>
                </select>
            </fieldset>
            <fieldset name="motion">
                <input name="resources" value="2" type="hidden"/>
                <input name="2" maxlength="500" value="/rw/mastership/motion" type="hidden"/>
                <select name="2-p">
                    <option value="0" selected="selected"></option>
                    <option value="1"></option>
                </select>
            </fieldset>
            <fieldset name="rapid">
               <input name="resources" value="3" type="hidden"/>
               <input name="3" maxlength="500" value="/rw/mastership/rapid" type="hidden"/>
                <select name="3-p">
                    <option value="0" selected="selected"></option>
                    <option value="1"></option>
                </select>
            </fieldset>             
        </form> 
    </div>
    </body>
</html>

Actions

request-mastership

Request mastership on all resources under mastership i.e. on CFG, MOTION and RAPID domains

curl --digest -u "Default User":robotics -X POST "http://localhost/rw/mastership?action=request"
release-mastership

Release mastership on all resources under mastership i.e. on CFG, MOTION and RAPID domains

curl --digest -u "Default User":robotics -X POST "http://localhost/rw/mastership?action=release"
subscribe

Subscribe on mastership request/release events on all domains.

e.g: curl --digest -u "Default User":robotics -d "resources=1&1=/rw/mastership/cfg&1-p=0&resources=2&2=/rw/mastership/rapid&2-p=0&resources=3&3=/rw/mastership/motion&3-p=0" -X POST "http://localhost/subscription"

Error Response

BAD_REQUEST(400)

NOT_FOUND(404)

Robot controller errors, see Robot controller return codes

Sample Call

curl --digest -u "Default User":robotics "http://localhost/rw/mastership?action=show"

Notes

Not supported in bootserver mode