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*

TrueSight Orchestration Content 24.3