Summary
Get graded compliance reports for a node.
Description
Get a set of graded and scored compliance reports for a node.
Route
POST /configuration_manager/compliance_reports/grade
Roles
admin
apiwrite
Parameters
DetailsExampleSchema
Name |
Type |
Required |
Description |
treeId |
string |
yes |
- |
version |
string |
yes |
- |
options |
object |
yes |
- |
Copied to Clipboard
{
"treeId": "5c35355dbebaa82eaf8113f0",
"version": "draft-v4",
"options": {
"weights": {
"error": 24566822.831929296,
"warning": -53724980.31358784,
"info": -28661948.465382993
},
"nodePath": "base/US East"
}
}
Copied to Clipboard
{
"type": "object",
"properties": {
"treeId": {
"title": "treeId",
"$ref": "common#/definitions/mongoObjectId"
},
"version": {
"title": "version",
"$ref": "goldenConfigData#/definitions/goldenConfigTreeVersionName"
},
"options": {
"title": "options",
"allOf": [
{
"$ref": "goldenConfigData#/definitions/reportGradingOptions"
},
{
"type": "object",
"properties": {
"nodePath": {
"title": "nodePath",
"$ref": "goldenConfigData#/definitions/goldenConfigNodePath"
}
}
}
]
}
},
"required": [
"treeId",
"version",
"options"
],
"additionalProperties": false
}
Return
DetailsExampleSchema
Name |
Type |
Description |
graded_compliance_reports |
object |
- |
Copied to Clipboard
[
{
"grade": "pass",
"total": 3195357,
"devices": [
"xr9kv-atl",
"xr9kv-atl",
"xr9kv-atl",
"xr9kv-atl",
"xr9kv-atl"
],
"records": [
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -36621500.29892337,
"grade": "pass"
}
]
},
{
"grade": "pass",
"total": 86008137,
"devices": [
"xr9kv-atl",
"xr9kv-atl",
"xr9kv-atl",
"xr9kv-atl",
"xr9kv-atl"
],
"records": [
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base/US East",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": 41710999.9474912,
"grade": "fail"
}
]
},
{
"grade": "pass",
"total": 31023204,
"devices": [
"xr9kv-atl",
"xr9kv-atl",
"xr9kv-atl"
],
"records": [
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": 89919961.69479197,
"grade": "review"
}
]
},
{
"grade": "pass",
"total": 15078012,
"devices": [
"xr9kv-atl"
],
"records": [
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": 42425280.2310622,
"grade": "pass"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base/US East",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -42820595.40594769,
"grade": "pass"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": 58369706.14566746,
"grade": "pass"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base/US East/Atlanta",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -44242976.52598455,
"grade": "review"
}
]
},
{
"grade": "fail",
"total": 52916431,
"devices": [
"xr9kv-atl",
"xr9kv-atl"
],
"records": [
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base/US East",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -82064333.56354466,
"grade": "pass"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base/US East/Atlanta",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -91450692.91972163,
"grade": "fail"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": 35661733.44704872,
"grade": "fail"
}
]
}
]
Copied to Clipboard
{
"title": "graded_compliance_reports",
"type": "array",
"items": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"examples": [
"pass",
"review",
"fail"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"devices": {
"type": "array",
"items": {
"$ref": "deviceData#/definitions/deviceName"
}
},
"records": {
"type": "array",
"items": {
"type": "object",
"properties": {
"deviceName": {
"$ref": "deviceData#/definitions/deviceName"
},
"reportId": {
"$ref": "common#/definitions/mongoObjectId"
},
"nodePath": {
"title": "nodePath",
"$ref": "goldenConfigData#/definitions/goldenConfigNodePath"
},
"timestamp": {
"$ref": "common#/definitions/timestamp"
},
"score": {
"type": "number"
},
"grade": {
"type": "string",
"examples": [
"pass",
"review",
"fail"
]
}
}
}
}
}
}
}