Get all Labels
Using labels is the method by which devices are grouped in the Ivanti EPMM database. Labels can be used for applying policies or performing other management tasks on multiple devices. An administrator can create labels in addition to a default set supplied in Ivanti EPMM. This API lists all labels, whether or not they are in use.
Example:
https://<Ivanti EPMM>/api/v1/dm/labels
URI: https:///api/v1/dm/labels | All labels in the database are returned. |
|---|---|
Http Method: | GET |
Format: | xml, json |
| |
| |
Response Status Code: | |
‘404 – No Data Found’ | There is no data. |
‘200 – OK’ | Data is present and the response is returned. |
Response: | |
< deviceManagementWebServiceResponse > | |
<messages> | |
<message>1 Label (s) returned</message> | Status message. A label count is shown if the method execution is successful. A descriptive error message is shown if the method execution failed. |
</messages> | |
<labels> | |
| |
<label id=”-3”> | Internal database ID. Negative numbers correspond to the default labels. Positive numbers correspond to labels that Ivanti EPMM administrator added. |
| |
<name>iOS</name> | Label name. |
<description>Label for all iOS devices.</description> | Label description. |
<staticLabel>false</staticLabel> | Static labels are system created labels. False indicates a dynamic label. Devices which satisfy the criteria specified in <searchCriteria> are automatically added to this label. True indicates a static label, which has no <searchCriteria> Devices are manually assigned to static labels. |
<query> "common.platform"="iOS" AND "common.retired"=false </query> | |
<deviceCount>3</deviceCount> | The number of devices currently assigned to the label. |
<isESSearch>116</isESSearch> | |
<label> | |
</labels> | |
< /deviceManagementWebServiceResponse> | |
| |
