URL

/rw/mastership/{domain-name}

Method

GET

URL Params

None

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/rw/mastership/cfg/"/>
    </head>
    <body>
        <div class="state">
        <a href="" rel="self"/>
        <a href="?action=show" rel="action"/>
        <ul>
        <li class="msh-resource" title="motion">
         <span class="uid">15</span>
         <span class="location"></span>
         <span class="alias"></span>
         <span class="application">RobAPI2-Client</span>
         <span class="mastership">remote</span>
         <span class="mastershipheldbyme">FALSE</span>
        </li>
        </ul>
        </div>
    </body>
</html>

Resources

msh-resource The specified mastership resource.
uid = Unique User ID
location = Where the application is located.
alias = alternate name for the location.
application = the application holding the mastership in the domain.
mastership = Used to specify current master of a resource.
- values of mastership are listed belows
  - nomaster - Mastership is not held.
  - remote - Mastership is held by a remote user.
  - local - Mastership is held by a local user, e.g., the GTPU.
  - internal - Mastership is held by an internal user (e.g., master of resource Jog is held during execution).
mastershipheldbyme = TRUE if the user holding the mastership is the user associated with the given client id (cid), FALSE otherwise.

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/cfg"

Notes

Not supported in bootserver mode