Worker object

You can use the Worker object to get information about and stop a specific Execution Worker attached to a Runtime cloud.

Structure

<Worker 
  atomId=""
  atomtName=""
  workerId=""
  status=""
  stopReason=""
  startTime=""
  shutdownTime=""
  endOfLifeTime=""
  nodeId=""
  state=""
/>

Field	Type	Description
`atomId`	string	The ID of the Runtime cloud.
`atomName`	string	The name of the Runtime cloud.
`workerId`	string	The ID of the Execution Worker.
`status`	string	The status of the Execution Worker. Possible values are COMPLETE, COMPLETE_WARN, ABORTED, or STARTED.
`stopReason`	string	The reason that the Execution Worker stopped.
`startTime`	dateTime yyyy-MM-dd'T'HH:mm:ss'Z'	The date and time that the Execution Worker was started.
`shutdownTime`	dateTime yyyy-MM-dd'T'HH:mm:ss'Z'	The date and time that the Execution Worker was shut down.
`endOfLifeTime`	dateTime yyyy-MM-dd'T'HH:mm:ss'Z'	The Time To Live set for the Execution Worker.
`nodeId`	string	The ID of the Runtime cloud node.
`state`	string	The state of the Execution Worker. Possible values are ACTIVE or INACTIVE.

Supported operations

GET	QUERY	CREATE	UPDATE	EXECUTE	DELETE

Using the GET operation

The ordinary GET operation returns a single Worker object based on the supplied workerId.

Using the QUERY operation

You can use the following fields as QUERY filters for the Worker object:

Field	Allowed Values
atomId	Required (must be valid, non-deleted)
workerId	Optional
state	Optional (if present, allowed values should be ACTIVE, INACTIVE)

note

If specified atomId does not have the Workers feature enabled (such as a Runtime or Runtime cluster, or a private Cloud with workers disabled), the query will return 0 results.

The operator allowed for the Worker object filter is:

EQUALS

note

The maximum number of results returned per QUERY response is 100. Response includes a queryToken element, which means there are more than 100 results to retrieve. The Query paging topic describes how to use a queryMore call to retrieve more results.

Using the UPDATE operation

The UPDATE operation is used to stop any of the ACTIVE execution workers running on the authenticated account. You can stop only one worker at a time by passing the workerID in the request. You also need to pass the state of the worker in the request. Currently only state supported in INACTIVE.

SOAP implementation

GET operation

Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:api="http://api.platform.boomi.com/">
<soapenv:Header>
  <wsse:Security
   xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
    <wsse:UsernameToken wsu:Id="UsernameToken" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
      <wsse:Username>ATOMSPHERE_USER_NAME</wsse:Username>
      <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">ATOMSPHERE_PASSWORD</wsse:Password>
    </wsse:UsernameToken>
  </wsse:Security>
</soapenv:Header>
<soapenv:Body>
  <api:get>
     <api:objectType>Worker</api:objectType>
     <api:objectId>worker-faf01b5b-1048-46bd-b50b-33f68556eec0-2023.11.10</api:objectId>
  </api:get>
</soapenv:Body>
</soapenv:Envelope>

Response:

<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <bns:getResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:bns="http://api.platform.boomi.com/">
        <bns:result xsi:type="bns:Worker" atomId="3e7ba6b2-0f75-49fd-bcc1-bf6c23b0d126" instanceId="padmaqa-UDY2V4.H1XMY0" workerId="worker-faf01b5b-1048-46bd-b50b-33f68556eec0-2023.11.10" status="COMPLETE" stopReason="Normal Shutdown" startTime="2023-11-10 09:54:40 EST" shutdownTime="2023-11-11 01:12:42 EST" endOfLifeTime="2023-11-11 09:54:40 EST" nodeId="atom01[worker-faf01b5b-1048-46bd-b50b-33f68556eec0-2023.11.10]" state="INACTIVE" atomName="Test_GroovyScriptMemoryIssue"/>
    </bns:getResponse>
  </S:Body>
</S:Envelope>

QUERY operation

Request:

  <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:api="http://api.platform.boomi.com/">
 <soapenv:Header>
    <wsse:Security
     xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
      <wsse:UsernameToken wsu:Id="UsernameToken" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
        <wsse:Username>ATOMSPHERE_USER_NAME</wsse:Username>
        <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">ATOMSPHERE_PASSWORD</wsse:Password>
      </wsse:UsernameToken>
    </wsse:Security>
 </soapenv:Header>
 <soapenv:Body>
    <api:query>
       <api:objectType>Worker</api:objectType>
       <api:queryConfig>
           <api:QueryFilter>
             <api:expression operator="EQUALS" property="atomId"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="api:SimpleExpression">
               <api:argument>8477dd27-894c-4752-a3ca-3d7dd5f0cba3</api:argument>
             </api:expression>
           </api:QueryFilter>
       </api:queryConfig>
    </api:query>
 </soapenv:Body>

Response:

  <?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
      <bns:queryResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:bns="http://api.platform.boomi.com/">
          <bns:results numberOfResults="4">
              <bns:result xsi:type="bns:Worker" atomId="8477dd27-894c-4752-a3ca-3d7dd5f0cba3" workerId="worker-2b101433-4556-4566-b8cf-24491a6e7c66-2024.01.11" status="COMPLETE" stopReason="Normal Shutdown" startTime="2024-01-11 18:24:00 GMT" shutdownTime="2024-01-11 18:26:02 GMT" endOfLifeTime="2024-01-12 18:24:00 GMT" nodeId="TestJMXLocalNode0[worker-2b101433-4556-4566-b8cf-24491a6e7c66-2024.01.11]" state="INACTIVE" atomName="TestJMXLocal"/>
              <bns:result xsi:type="bns:Worker" atomId="8477dd27-894c-4752-a3ca-3d7dd5f0cba3" workerId="worker-aabd17ab-f839-486d-9b0a-cc863474db13-2024.01.11" status="COMPLETE" stopReason="Normal Shutdown" startTime="2024-01-11 18:24:00 GMT" shutdownTime="2024-01-11 18:26:02 GMT" endOfLifeTime="2024-01-12 18:24:00 GMT" nodeId="TestJMXLocalNode0[worker-aabd17ab-f839-486d-9b0a-cc863474db13-2024.01.11]" state="INACTIVE" atomName="TestJMXLocal"/>
              <bns:result xsi:type="bns:Worker" atomId="8477dd27-894c-4752-a3ca-3d7dd5f0cba3" workerId="worker-a2bcc897-a137-4425-9287-7fe4ed7fbd92-2024.01.11" status="STARTED" startTime="2024-01-11 18:27:19 GMT" endOfLifeTime="2024-01-12 18:27:19 GMT" nodeId="TestJMXLocalNode0[worker-a2bcc897-a137-4425-9287-7fe4ed7fbd92-2024.01.11]" state="ACTIVE" atomName="TestJMXLocal"/>
              <bns:result xsi:type="bns:Worker" atomId="8477dd27-894c-4752-a3ca-3d7dd5f0cba3" workerId="worker-f5e80108-0f13-45d7-b3e9-5b2f72e9d615-2024.01.11" status="STARTED" startTime="2024-01-11 18:27:20 GMT" endOfLifeTime="2024-01-12 18:27:20 GMT" nodeId="TestJMXLocalNode0[worker-f5e80108-0f13-45d7-b3e9-5b2f72e9d615-2024.01.11]" state="ACTIVE" atomName="TestJMXLocal"/>
          </bns:results>
      </bns:queryResponse>
  </S:Body>
  </S:Envelope>

UPDATE operation

Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:par="http://api.platform.boomi.com/" xmlns:api="http://api.platform.boomi.com/">
<soapenv:Header>
  <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
    <wsse:UsernameToken wsu:Id="UsernameToken" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
      <wsse:Username>ATOMSPHERE_USER_NAME</wsse:Username>
      <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">ATOMSPHERE_PASSWORD</wsse:Password>
    </wsse:UsernameToken>
  </wsse:Security>
</soapenv:Header> 
<soapenv:Body>
  <api:update>
    <object xsi:type="api:Worker" xmlns:api="http://api.platform.boomi.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" workerId="worker-aa6f8ba5-e31e-49cb-a580-3942ecbe3ebd-2023.11.22"
        state="INACTIVE">
    </object>
  </api:update>
</soapenv:Body>
</soapenv:Envelope>

Response:

<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <bns:updateResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:bns="http://api.platform.boomi.com/">
        <result xsi:type="bns:Worker" workerId="worker-28de5b32-d3ed-4aa8-9d26-e73bf47e4137-2023.08.23" state="INACTIVE"/>
    </bns:updateResponse>
  </S:Body>
</S:Envelope>

Structure​

Supported operations​

Using the GET operation​

Using the QUERY operation​

Using the UPDATE operation​

SOAP implementation​

Structure

Supported operations

Using the GET operation

Using the QUERY operation

Using the UPDATE operation

SOAP implementation