Get Data operation for the Airwatch adapter


The Get Data operation retrieves data in a format that you specify, and from a specified URL.

The following table describes the adapter request elements for the Get Data operation

Elements for the Get Data operation

Element

Definition

Required

<adapter-name>

Specifies the name of the adapter to use for this process

Default value: AirWatchAdapter

No

<url>

Specifies the URL defining the location of the content to be obtained

Default value: none

Yes

<certificate-name>

Specifies the fully qualified path where the certificate file is placed

No

<certificate-password>

Specifies the password that corresponds to the <certificate-password> element

No

<tenant-code>

Specifies the tenant code that needs to be added to the header of the HTTP request

No

<install-certificate>

Specifies whether to install certificates automatically

Valid values: true, false (default)

No

<allow-unsigned-certificate>

Specify whether to allow unsigned certificates from trusted zones

Valid values: true, false (default)

No

<passphrase>

Specifies the Java Standard Trust Keystore passphrase 

Default value: changeit

No

The following figure illustrates a sample adapter request for the Get Data operation:

Sample adapter request for the Get Data operation


<air-watch-adapter-request>
     <http-method>GET</http-method>
     <url>https://qa7.airwatchqa.com/api/v1/system/groups/4671</url>
     <certificate-name>C:\Temp\CN=5257-mohan.p12</certificate-name>
     <certificate-password>password</certificate-password>
     <tenant-code>1FC5H4JAAAG5A4SQAMQA</tenant-code>
     <install-certificate>true</install-certificate>
     <allow-unsigned-certificate>false</allow-unsigned-certificate>
     <passphrase>changeit</passphrase>
</air-watch-adapter-request>

The following figure illustrates the adapter response for the sample request:

Sample adapter response for the Get Data operation

<air-watch-adapter-response>
 <metadata>
   <status>success</status>
 </metadata>
 <status-line>
   <code>200</code>
   <reason>OK</reason>
 </status-line>
 <header-lines>
   <Cache-Control>private</Cache-Control>
   <Content-Length>531</Content-Length>
   <Content-Type>application/xml; charset=utf-8</Content-Type>
   <Server>Microsoft-IIS/7.5</Server>
   <X-AspNet-Version>4.0.30319</X-AspNet-Version>
   <X-MDM-Powered-By>AirWatch @ www.air-watch.com</X-MDM-Powered-By>
   <Date>Mon, 22 Apr 2013 16:06:13 GMT</Date>
 </header-lines>
 <message-body>
   <LocationGroup xmlns="http://www.air-watch.com/servicemodel/resources" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <Id xmlns="">4671</Id>
     <Name>Mohan</Name>
     <GroupId>mohan</GroupId>
     <LocationGroupType>BusinessSegment</LocationGroupType>
     <Country>United States</Country>
     <Locale>English (United States)</Locale>
     <CreatedOn>8/30/2012 9:56:13 AM</CreatedOn>
     <LgLevel>0</LgLevel>
     <Users>3</Users>
     <Admins>6</Admins>
     <Devices>0</Devices>
   </LocationGroup>
 </message-body>
</air-watch-adapter-response>

 

 

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*