POST /compliancePolicies/persistedResult
Use this method to unassign compliance policies that are assigned to one or more specific devices.
This method unassigns one or more compliance policies that are assigned to specific devices, updates the persisted result on the disk drive, and caches in memory that is related to this policies and devices.
Authentication
Authentication with username and password is required.
Request URL
POST https://{management_server_IP}/compliancePolicies/persistedResult
Query parameters
None
Request body
| Attributes | Required / Optional | Type | Description | ||
|---|---|---|---|---|---|
| unassign | Required | Array of objects | List of managed devices for which you want to retrieve compare results | ||
| uuid | Required | String | Unique ID of the managed device | ||
The following example unassigns the compliance policy from the device with UUID C156CA72D6E811E48F0F6EAE8B4BDB07.
{
"unassign":[{
"uuid":"C156CA72D6E811E48F0F6EAE8B4BDB07"
}]
}
Response codes
| Code | Description | Comments |
|---|---|---|
| 200 | OK | The request completed successfully. |
| 400 | Bad Request | A query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body. |
| 403 | Forbidden | The orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request. |
| 409 | Conflict | There is a conflict with the current state of the resource. A descriptive error message is returned in the response body. |
| 500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
Response body
| Attributes | Type | Description | ||
|---|---|---|---|---|
| failedCount | Integer | Number of failed unassignments | ||
| failedDevices | Array of objects | Information about devices with failed compliance | ||
| originalPolicy | String | ID of the original compliance policy | ||
| uuid | String | Device UUID | ||
| successCount | Integer | Number of successful unassignments | ||
| unassignCount | Integer | Number of unassignment requests | ||
| success | String | Results of the request. This can be one of the following values.
| ||
| messages | Array of objects | Information about one or more messages | ||
| explanation | String | Additional information to clarify the reason for the message | ||
| id | String | Message identifier of a returned message | ||
| recovery | Array of objects | Recovery information | ||
| text | String | User actions that can be taken to recover from the event | ||
| URL | String | Link to the help system for more information, if available | ||
| text | String | Message text associated with the message identifier | ||
| originalPolicy | String | ID of the compliance policy that was unassigned | ||
| uuid | String | Device UUID | ||
The following example is returned if the request is successful.
{
"failedCount": 0,
"failedDevices": [],
"unassignCount": 29,
"successCount": 27,
"messages": [{
"explanation": "",
"id": "FQXHMUP2000I",
"recovery": [],
"text": "The command completed successfully."
"originalPolicy": "v2.2.0-2018-10-26-SystemX-Switch-DEV"
"uuid": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}]
}
Give documentation feedback