Delete operation for the Airwatch adapter


The Delete operation deletes the specified device or a group of devices. 

The following table describes the input elements for the Delete operation.

Adapter request elements for the Delete 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 devices to be deleted

Example: https://qa7.airwatchqa.com/api/v1/system/groups/{id}/delete

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-file> 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 the 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 Delete operation:

Sample adapter request for the Delete operation

 <request-data>
 <air-watch-adapter-request>
   <http-method>DELETE</http-method>
   <url>https://qa7.airwatchqa.com/api/v1/system/groups/9645/delete</url>
   <certificate-name />
   <certificate-password />
   <tenant-code />
   <install-certificate />
   <allow-unsigned-certificate />
   <passphrase />
 </air-watch-adapter-request>
</request-data>

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

Sample adapter response for the Delete 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>
   <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>Tue, 27 Aug 2013 06:22:20 GMT</Date>
   <Content-Length>0</Content-Length>
 </header-lines>
 <message-body>
   <non-xml-data-response></non-xml-data-response>
 </message-body>
</air-watch-adapter-response>

 

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