Summary
Run Compliance Reports (Node)
Description
Begin a compliance report run for a Golden Config tree node.
Route
No Northbound API Available
Roles
admin
apiread
Parameters
DetailsExampleSchema
| Name |
Type |
Required |
Description |
| treeId |
string |
yes |
- |
| version |
string |
yes |
- |
| nodePath |
string |
yes |
- |
| variables |
object |
no |
- |
| grading |
object |
no |
- |
Copied to Clipboard
{
"treeId": "5c35355dbebaa82eaf8113f0",
"version": "draft-v4",
"nodePath": "base/US East/Atlanta",
"variables": [
{
"name": "variable name",
"type": "regex",
"value": "variable value"
},
{
"name": "variable name",
"type": "literal",
"value": "variable value"
},
{
"name": "variable name",
"type": "regex",
"value": "variable value"
},
{
"name": "variable name",
"type": "regex",
"value": "variable value"
}
],
"grading": {
"weights": {
"error": -28626653.813471228,
"warning": 3912951.9941110164,
"info": 34758293.194405615
}
}
}
Copied to Clipboard
{
"type": "object",
"properties": {
"treeId": {
"title": "treeId",
"$ref": "common#/definitions/mongoObjectId"
},
"version": {
"title": "version",
"$ref": "goldenConfigData#/definitions/goldenConfigTreeVersionName"
},
"nodePath": {
"title": "nodePath",
"$ref": "goldenConfigData#/definitions/goldenConfigNodePath"
},
"variables": {
"title": "variables",
"$ref": "goldenConfigData#/definitions/goldenConfigVariables"
},
"grading": {
"title": "grading",
"$ref": "goldenConfigData#/definitions/reportGradingOptions"
}
},
"required": [
"treeId",
"version",
"nodePath"
],
"additionalProperties": false
}
Return
DetailsExampleSchema
| Name |
Type |
Description |
| runComplianceBatchResult |
object |
- |
Copied to Clipboard
{
"status": 202,
"message": "compliance batch ${batchId} started",
"batchId": "5c35355dbebaa82eaf8113f0",
"reports": [
{
"reportId": "5c35355dbebaa82eaf8113f0",
"device": "xr9kv-atl",
"score": 19.77552959228557,
"grade": "review"
},
{
"reportId": "5c35355dbebaa82eaf8113f0",
"device": "xr9kv-atl",
"score": 86.70037021641119,
"grade": "fail"
},
{
"reportId": "5c35355dbebaa82eaf8113f0",
"device": "xr9kv-atl",
"score": 84.59061008971011,
"grade": "pass"
},
{
"reportId": "5c35355dbebaa82eaf8113f0",
"device": "xr9kv-atl",
"score": 38.84665937308283,
"grade": "review"
},
{
"reportId": "5c35355dbebaa82eaf8113f0",
"device": "xr9kv-atl",
"score": 90.53101384403759,
"grade": "pass"
}
]
}
Copied to Clipboard
{
"title": "runComplianceBatchResult",
"type": "object",
"properties": {
"status": {
"type": "integer",
"const": 202
},
"message": {
"type": "string",
"examples": [
"compliance batch ${batchId} started"
]
},
"batchId": {
"$ref": "common#/definitions/mongoObjectId"
},
"reports": {
"type": "array",
"items": {
"type": "object",
"properties": {
"reportId": {
"$ref": "common#/definitions/mongoObjectId"
},
"device": {
"$ref": "deviceData#/definitions/deviceName"
},
"score": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"grade": {
"type": "string",
"examples": [
"pass",
"fail",
"review"
]
}
}
}
}
}
}
