Click here for a complete list of operations.

RequestActuation

Requests an actuation against an enrolled subject at a node. Requires a valid single-use MoD authorisation token obtained by countersigning a GetAuthorisationChallenge nonce.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /services/Actuation.asmx HTTP/1.1
Host: devcon-dc01.local
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://devcon-dc01.local/sentris/RequestActuation"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <RequestActuation xmlns="http://devcon-dc01.local/sentris/">
      <nodeId>string</nodeId>
      <subjectMac>string</subjectMac>
      <tier>string</tier>
      <authorisationToken>string</authorisationToken>
    </RequestActuation>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 500 Internal Server Error
Content-Type: text/xml; charset=utf-8

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <soap:Fault>
      <faultcode>soap:Server</faultcode>
      <faultstring>AuthorisationGatewayUnavailable: The Ministry authorisation gateway (ADONIS) has been unreachable since 2015-03-14; no authorisation token can be validated. The request has been logged to the approvals queue and assigned to Lt.Col.P.Ainley@devcon-dc01.local for sign-off.</faultstring>
      <detail>
        <SentrisFault xmlns="http://devcon-dc01.local/sentris/"><code>AuthorisationGatewayUnavailable</code><degradedSince>2015-03-14</degradedSince></SentrisFault>
      </detail>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>