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": "v2",
"options": {
"weights": {
"error": 45030350.58522853,
"warning": 92515768.01121631,
"info": 10500925.022083148
},
"nodePath": "base/US East/Atlanta"
}
}
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": "fail",
"total": 1579450,
"devices": [
"xr9kv-atl",
"xr9kv-atl"
],
"records": [
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base/US East/Atlanta",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -39051259.757831104,
"grade": "review"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base/US East/Atlanta",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": 33759078.06707592,
"grade": "review"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base/US East/Atlanta",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": 50361194.86447498,
"grade": "review"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base/US East/Atlanta",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -28811343.6790379,
"grade": "pass"
}
]
},
{
"grade": "review",
"total": 30064781,
"devices": [
"xr9kv-atl",
"xr9kv-atl"
],
"records": [
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -34767975.95777112,
"grade": "fail"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": 6780347.534168512,
"grade": "fail"
},
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -61933421.93487279,
"grade": "review"
}
]
},
{
"grade": "review",
"total": 11619718,
"devices": [
"xr9kv-atl"
],
"records": [
{
"deviceName": "xr9kv-atl",
"reportId": "5c35355dbebaa82eaf8113f0",
"nodePath": "base",
"timestamp": "2019-04-12T14:42:47.958Z",
"score": -11526264.868529618,
"grade": "review"
}
]
}
]
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"
]
}
}
}
}
}
}
}