createDeviceGroupRemote Operation

Using createDeviceGroupRemote operation you can add a new device group to a managed TIBCO LogLogic® Appliance from a Management Station.

Request Parameters

authToken, applianceIP, deviceGroupName, description, groupType, enabled, deviceNames

For more information about each common request parameter, see Common Request Parameters.

Response

deviceGroupResponse (see deviceGroupResponse Type)

Example

To add (on remote Appliance 1.2.20.100) a global device group named Cisco ASA Devices, with a description of Cisco ASA Description, including log sources 10.1.2.3 and CiscoASA1, and enabling the group: 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dev="DeviceGroupService">
   <soapenv:Header/>
   <soapenv:Body>
      <dev:createDeviceGroupRemote>
         <dev:authToken>admin/admin123</dev:authToken>
         <dev:applianceIP>1.2.20.100</dev:applianceIP>
         <dev:deviceGroupName>Cisco ASA Device</dev:deviceGroupName>
         <dev:description>Cisco ASA Device</dev:description>
         <dev:groupType>global</dev:groupType>
         <dev:enabled>yes</dev:enabled>
         <dev:deviceNames>10.1.2.3,CiscoASA1</dev:deviceNames>
      </dev:createDeviceGroupRemote>
   </soapenv:Body>
</soapenv:Envelope>

SOAP response for createDeviceGroupRemote Operation: 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:createDeviceGroupRemoteResponse xmlns:ns="DeviceGroupService">
         <ns:return xsi:type="ax211:DeviceGroupResponse" xmlns:ax211="http://devicegroup.services.logapp.loglogic.com/xsd" xmlns:ax212="http://services.logapp.loglogic.com/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <ax212:authToken xsi:nil="true"/>
            <ax212:resultCount>1</ax212:resultCount>
            <ax212:statusCode>2000</ax212:statusCode>
            <ax212:statusMessage>Successful</ax212:statusMessage>
            <ax212:summaryOnly>false</ax212:summaryOnly>
            <ax211:resultSet xsi:type="ax211:DeviceGroupDetail">
               <ax211:description>test</ax211:description>
               <ax211:deviceGroupName>66.36_local_dg1</ax211:deviceGroupName>
               <ax211:devices>10.114.66.36/::ffff:10.114.66.36_logapp</ax211:devices>
               <ax211:devices>10.114.66.36/::ffff:200.100.100.200_General</ax211:devices>
               <ax211:devices>10.114.66.36/::ffff:200.100.100.201_General</ax211:devices>
               <ax211:enabled>disabled</ax211:enabled>
               <ax211:groupType>global</ax211:groupType>
            </ax211:resultSet>
         </ns:return>
      </ns:createDeviceGroupRemoteResponse>
   </soapenv:Body>
</soapenv:Envelope>

If the devices are the remote appliance, the device name can be appliance_ip/deviceName, for example: 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dev="DeviceGroupService">
   <soapenv:Header/>
   <soapenv:Body>
      <dev:createDeviceGroupRemote>
         <!--Optional:-->
         <dev:authToken>admin/admin123</dev:authToken>
         <!--Optional:-->
         <dev:applianceIP>10.114.66.36</dev:applianceIP>
         <!--Optional:-->
         <dev:deviceGroupName>66.36_local_dg1</dev:deviceGroupName>
         <!--Optional:-->
         <dev:description>test</dev:description>
         <!--Optional:-->
         <dev:groupType>global</dev:groupType>
         <!--Optional:-->
         <dev:enabled>no</dev:enabled>
         <!--Optional:-->
         <dev:deviceNames>10.114.66.36/::ffff:10.114.66.36_logapp,10.114.66.36/::ffff:200.100.100.200_General,10.114.66.36/::ffff:200.100.100.201_General</dev:deviceNames>
      </dev:createDeviceGroupRemote>
   </soapenv:Body>
</soapenv:Envelope>