{ "openapi": "3.0.0", "info": { "title": "Equipment service", "description": "Service that works with different equipment such as switches", "version": "3.0.0" }, "servers": [ { "url": "https://example.com/api/eservice/v3" } ], "tags": [ { "name": "equipment", "description": "equipment" }, { "name": "pdu", "description": "pdu" }, { "name": "switch", "description": "Switch" }, { "name": "grafana", "description": "Grafana" }, { "name": "statistic", "description": "Statistic" }, { "name": "report", "description": "Report" }, { "name": "ipmi", "description": "IPMI" }, { "name": "ups", "description": "ups" }, { "name": "vpu", "description": "VPU" }, { "name": "custom_equipment", "description": "Custom equipment" } ], "paths": { "/supported_switch": { "get": { "operationId": "supported_switch", "responses": { "200": { "description": "Supported device handlers received", "content": { "application/json": { "schema": { "type": "array", "description": "List of supported device handlers", "items": { "type": "object", "properties": { "handler": { "description": "Device type", "type": "string", "example": "cisco_snmp" }, "name": { "type": "string", "description": "Handler name" }, "protocol": { "description": "Protocols for device management", "type": "array", "items": { "type": "string" } }, "features": { "description": "Features is provided by the device", "type": "array", "items": { "type": "string", "enum": [ "port_aggregation", "collect_mac" ] } } } } } } } }, "default": { "description": "Supported device handlers not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "List of supported device handlers", "tags": [ "switch" ] } }, "/supported_pdu": { "get": { "operationId": "supported_pdu", "responses": { "200": { "description": "Supported device handlers received", "content": { "application/json": { "schema": { "type": "array", "description": "List of supported device handlers", "items": { "type": "object", "properties": { "handler": { "description": "Device type", "type": "string", "example": "cisco_snmp" }, "name": { "type": "string", "description": "Handler name" }, "protocol": { "description": "Protocols for device management", "type": "array", "items": { "type": "string" } }, "features": { "description": "Features is provided by the device", "type": "array", "items": { "type": "string", "enum": [ "port_aggregation", "collect_mac" ] } } } } } } } }, "default": { "description": "Supported device handlers not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "List of supported device handlers", "tags": [ "pdu" ] } }, "/supported_ups": { "get": { "operationId": "supported_ups", "responses": { "200": { "description": "Supported device handlers received", "content": { "application/json": { "schema": { "type": "array", "description": "List of supported device handlers", "items": { "type": "object", "properties": { "handler": { "description": "Device type", "type": "string", "example": "cisco_snmp" }, "name": { "type": "string", "description": "Handler name" }, "protocol": { "description": "Protocols for device management", "type": "array", "items": { "type": "string" } }, "features": { "description": "Features is provided by the device", "type": "array", "items": { "type": "string", "enum": [ "port_aggregation", "collect_mac" ] } } } } } } } }, "default": { "description": "Supported device handlers not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "List of supported device handlers", "tags": [ "ups" ] } }, "/supported_vpu": { "get": { "operationId": "supported_vpu", "responses": { "200": { "description": "Supported device handlers for VPU received", "content": { "application/json": { "schema": { "type": "array", "description": "List of supported device handlers", "items": { "type": "object", "properties": { "handler": { "description": "Device type", "type": "string", "example": "cisco_snmp" }, "name": { "type": "string", "description": "Handler name" }, "protocol": { "description": "Protocols for device management", "type": "array", "items": { "type": "string" } }, "features": { "description": "Features is provided by the device", "type": "array", "items": { "type": "string", "enum": [ "port_aggregation", "collect_mac" ] } } } } } } } }, "default": { "description": "Supported device handlers not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "List of supported device handlers for VPU module", "tags": [ "vpu" ] } }, "/supported_ipmi": { "get": { "operationId": "supported_ipmi", "responses": { "200": { "description": "Supported device handlers for IPMI received", "content": { "application/json": { "schema": { "type": "array", "description": "List of supported device handlers", "items": { "type": "object", "properties": { "handler": { "description": "Device type", "type": "string", "example": "cisco_snmp" }, "name": { "type": "string", "description": "Handler name" }, "protocol": { "description": "Protocols for device management", "type": "array", "items": { "type": "string" } }, "features": { "description": "Features is provided by the device", "type": "array", "items": { "type": "string", "enum": [ "port_aggregation", "collect_mac" ] } } } } } } } }, "default": { "description": "Supported device handlers not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "List of supported device handlers for IPMI module", "tags": [ "ipmi" ] } }, "/validate": { "post": { "operationId": "validate", "requestBody": { "content": { "application/json": { "schema": { "oneOf": [ { "additionalProperties": true, "type": "object", "required": [ "device", "connection_params" ], "properties": { "device": { "type": "string", "description": "Type of the device" }, "connection_params": { "additionalProperties": false, "type": "object", "properties": { "snmp_params": { "oneOf": [ { "required": [ "hostname", "version", "community" ], "description": "SNMP connection parameters", "type": "object", "properties": { "hostname": { "description": "Equipment address", "type": "string", "format": "ipv4", "example": "127.0.0.1" }, "version": { "description": "SNMP version", "type": "string", "enum": [ "snmp_v1", "snmp_v2c", "snmp_v3" ] }, "community": { "description": "The equipment community", "type": "string" } } }, { "required": [ "hostname", "version", "security_username", "security_level" ], "description": "SNMP connection parameters", "type": "object", "properties": { "hostname": { "description": "Equipment address", "type": "string", "format": "ipv4", "example": "127.0.0.1" }, "version": { "description": "SNMP version", "type": "string", "enum": [ "snmp_v1", "snmp_v2c", "snmp_v3" ] }, "security_username": { "description": "Username for SNMP access", "type": "string", "minLength": 1, "example": "root", "pattern": "^[^ ]" }, "security_level": { "description": "Authentication level", "type": "string", "enum": [ "no_auth_or_privacy", "auth_without_privacy", "auth_with_privacy" ] }, "auth_protocol": { "description": "Authentication protocol", "type": "string", "enum": [ "MD5", "SHA" ] }, "auth_password": { "description": "Authentication protocol pass phrase", "type": "string" }, "privacy_protocol": { "description": "Privacy protocol", "type": "string", "enum": [ "DES", "AES" ] }, "privacy_password": { "description": "Privacy protocol pass phrase", "type": "string" } } } ] } }, "required": [ "snmp_params" ] } } }, { "additionalProperties": true, "type": "object", "properties": { "device": { "type": "string", "description": "The device SSH params" }, "ssh_params": { "required": [ "ip", "ssh_port", "ssh_user" ], "type": "object", "description": "SSH params for connection", "properties": { "ip": { "type": "string", "description": "The equipment IP address", "example": "127.0.0.1", "format": "ipv4" }, "ssh_port": { "type": "integer", "description": "SSH port", "example": 22, "maximum": 65535, "minimum": 1 }, "ssh_user": { "type": "string", "description": "SSH user", "example": "root" } } } }, "required": [ "device", "ssh_params" ] }, { "additionalProperties": true, "type": "object", "properties": { "device": { "type": "string", "description": "The device SNMP params" }, "snmp_params": { "oneOf": [ { "required": [ "hostname", "version", "community" ], "description": "SNMP connection parameters", "type": "object", "properties": { "hostname": { "description": "Equipment address", "type": "string", "format": "ipv4", "example": "127.0.0.1" }, "version": { "description": "SNMP version", "type": "string", "enum": [ "snmp_v1", "snmp_v2c", "snmp_v3" ] }, "community": { "description": "The equipment community", "type": "string" } } }, { "required": [ "hostname", "version", "security_username", "security_level" ], "description": "SNMP connection parameters", "type": "object", "properties": { "hostname": { "description": "Equipment address", "type": "string", "format": "ipv4", "example": "127.0.0.1" }, "version": { "description": "SNMP version", "type": "string", "enum": [ "snmp_v1", "snmp_v2c", "snmp_v3" ] }, "security_username": { "description": "Username for SNMP access", "type": "string", "minLength": 1, "example": "root", "pattern": "^[^ ]" }, "security_level": { "description": "Authentication level", "type": "string", "enum": [ "no_auth_or_privacy", "auth_without_privacy", "auth_with_privacy" ] }, "auth_protocol": { "description": "Authentication protocol", "type": "string", "enum": [ "MD5", "SHA" ] }, "auth_password": { "description": "Authentication protocol pass phrase", "type": "string" }, "privacy_protocol": { "description": "Privacy protocol", "type": "string", "enum": [ "DES", "AES" ] }, "privacy_password": { "description": "Privacy protocol pass phrase", "type": "string" } } } ] } }, "required": [ "device", "snmp_params" ] }, { "description": "NETCONF connection parameters", "type": "object", "additionalProperties": true, "required": [ "device", "netconf_params" ], "properties": { "device": { "type": "string", "description": "The device eAPI params" }, "netconf_params": { "type": "object", "additionalProperties": true, "required": [ "username", "password" ], "properties": { "username": { "description": "Username", "type": "string" }, "password": { "description": "Password", "type": "string" }, "port": { "description": "NETCONF access ports", "example": 830, "maximum": 65535, "minimum": 1, "type": "integer" }, "device_params": { "description": "NETCONF device parameters", "type": "object", "properties": { "name": { "description": "OS name", "type": "string", "enum": [ "junos" ], "default": "junos" } } } } } } }, { "additionalProperties": true, "type": "object", "properties": { "device": { "type": "string", "description": "The device eAPI params" }, "eapi_params": { "required": [ "username", "password" ], "type": "object", "description": "eAPI params for connection", "properties": { "username": { "description": "Username", "type": "string" }, "password": { "description": "Password", "type": "string" } } } }, "required": [ "device", "eapi_params" ] }, { "additionalProperties": true, "type": "object", "properties": { "device": { "type": "string", "description": "The device NxApi params" }, "nxapi_params": { "required": [ "username", "password", "port", "protocol" ], "type": "object", "description": "eAPI params for connection", "properties": { "username": { "description": "Username", "type": "string" }, "password": { "description": "Password", "type": "string" }, "port": { "description": "NxApi access ports", "example": 8181, "maximum": 65535, "minimum": 1, "type": "integer" }, "protocol": { "description": "Protocol (http/https)", "type": "string", "enum": [ "http", "https" ] } } } }, "required": [ "device", "nxapi_params" ] }, { "additionalProperties": true, "type": "object", "properties": { "device": { "type": "string", "description": "The device RouterOS API params" }, "mikrotik_params": { "required": [ "username", "password", "port", "ssl" ], "type": "object", "description": "RouterOS API params for connection", "properties": { "username": { "description": "Username", "type": "string" }, "password": { "description": "Password", "type": "string" }, "port": { "description": "RouterOS API access ports", "example": 8728, "maximum": 65535, "minimum": 1, "type": "integer" }, "ssl": { "description": "SSL usage", "type": "boolean" } } } }, "required": [ "device", "mikrotik_params" ] }, { "additionalProperties": true, "type": "object", "properties": { "device": { "type": "string", "description": "The device custom protocol" }, "custom_params": { "description": "Custom protocol connection parameters", "type": "object" } }, "required": [ "device", "custom_params" ] }, { "additionalProperties": true, "type": "object", "properties": { "device": { "type": "string", "description": "The device http params" }, "http_params": { "required": [ "username", "password", "hostname", "ssl", "port" ], "type": "object", "description": "Http params for connection", "properties": { "username": { "description": "Username", "type": "string" }, "password": { "description": "Password", "type": "string" }, "hostname": { "type": "string", "description": "The equipment IP address", "example": "127.0.0.1", "format": "ipv4" }, "ssl": { "description": "SSL usage", "type": "boolean" }, "port": { "description": "Http service port", "type": "integer" } } } }, "required": [ "device", "http_params" ] } ] } } } }, "responses": { "200": { "description": "Successfully validated", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "description": "Validation result", "example": "ok" } }, "type": "object" } } } }, "default": { "description": "Validation error", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "Equipment protocol validation", "tags": [ "equipment" ] } }, "/flow/report": { "post": { "operationId": "report", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "type": "object", "properties": { "date_from": { "type": "string", "description": "Start date for searching NetFlow data", "example": "2020-07-01 00:37:40" }, "date_to": { "type": "string", "description": "End date for searching NetFlow data", "example": "2020-07-01 00:37:40" }, "src_ip": { "oneOf": [ { "format": "ipv4", "type": "string" }, { "format": "ipv6", "type": "string" } ], "description": "Ipv4 source address. If the field is not passed, all available addresses are considered.", "example": "127.0.0.1" }, "dst_ip": { "oneOf": [ { "format": "ipv4", "type": "string" }, { "format": "ipv6", "type": "string" } ], "description": "Ipv4 destination address. If the field is not passed, all available addresses are considered.", "example": "127.0.0.1" }, "src_port": { "type": "integer", "minimum": 1, "maximum": 65535, "description": "Source port. If the field is not passed, all available ports are considered.", "example": 8080 }, "dst_port": { "type": "integer", "minimum": 1, "maximum": 65535, "description": "Destination port. If the field is not passed, all available ports are considered.", "example": 8080 }, "report_type": { "type": "string", "description": "Output format of report.", "enum": [ "csv" ] } }, "required": [ "date_from", "date_to" ] } } } }, "responses": { "200": { "description": "Generated successfully", "content": { "application/json": { "schema": { "properties": { "id": { "type": "integer", "description": "The report identifier", "example": 1 } }, "type": "object" } } } }, "default": { "description": "Report generation error", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "Building a NetFlow report", "tags": [ "report" ] }, "get": { "operationId": "reports_get", "responses": { "200": { "description": "List of reports", "content": { "application/json": { "schema": { "properties": { "list": { "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The report identifier" }, "name": { "type": "string", "description": "The report unique name to identify it in filesystem" }, "date_from": { "type": "string", "description": "Start date for searching NetFlow data" }, "date_to": { "type": "string", "description": "End date for searching NetFlow data" }, "src_ip": { "type": "string", "description": "Ipv4 source address. If the field is not passed, all available addresses are considered." }, "dst_ip": { "type": "string", "description": "Ipv4 destination address. If the field is not passed, all available addresses are considered." }, "src_port": { "type": "integer", "description": "Source port. If the field is not passed, all available ports are considered." }, "dst_port": { "type": "integer", "description": "Destination port. If the field is not passed, all available ports are considered." }, "report_type": { "type": "string", "description": "Output format of report." }, "status": { "type": "string", "description": "Report generation status." }, "status_info": { "type": "object", "enum": [ "csv" ], "description": "Report generation detailed information." } } }, "type": "array" } }, "type": "object" } } } }, "default": { "description": "Reports query error", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "List of reports", "tags": [ "report" ] } }, "/flow/report/{report_id}": { "delete": { "operationId": "report_id_delete", "parameters": [ { "description": "Report unique identifier", "in": "path", "name": "report_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Report has been deleted successfully", "content": { "application/json": { "schema": { "properties": { "id": { "type": "integer" } }, "type": "object" } } } }, "default": { "description": "Error deleting report", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "Delete report", "tags": [ "report" ] } }, "/flow/report/{report_id}/download": { "get": { "operationId": "report_id_download", "parameters": [ { "description": "Report unique identifier", "in": "path", "name": "report_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Report file", "content": { "application/csv": { "schema": { "type": "string", "format": "binary" } } } }, "default": { "description": "Report download error", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "Download generated report", "tags": [ "report" ] } }, "/instance/{instance_id}/dashboards": { "get": { "deprecated": true, "operationId": "instance_id_dashboards", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The Grafana dashboards for instance has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "array", "description": "List of Grafana dashboards", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The dashboard identifier" }, "uid": { "type": "string", "description": "The dashboard unique identifier in Grafana" }, "title": { "type": "string", "description": "The dashboard title" }, "tags": { "type": "array", "description": "The dashboard tags", "items": { "type": "string" } }, "panels": { "type": "array", "description": "The dashboard panels", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The panel identifier" }, "url": { "type": "string", "description": "The panel url" } } } } } } } } } } } }, "default": { "description": "There is no Grafana dashboards for requested instance", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "List of grafana dashboards", "tags": [ "grafana" ] } }, "/dashboards": { "get": { "operationId": "dashboards", "responses": { "200": { "description": "The Grafana dashboards has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "array", "description": "List of Grafana dashboards", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The dashboard identifier" }, "uid": { "type": "string", "description": "The dashboard unique identifier in Grafana" }, "title": { "type": "string", "description": "The dashboard title" }, "tags": { "type": "array", "description": "The dashboard tags", "items": { "type": "string" } }, "panels": { "type": "array", "description": "The dashboard panels", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The panel identifier" }, "url": { "type": "string", "description": "The panel url" } } } } } } } } } } } }, "default": { "description": "There are no Grafana dashboards", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "List of grafana dashboards", "tags": [ "grafana" ] } }, "/ipmi/{ipmi_id}/sensor_value": { "post": { "operationId": "ipmi_id_sensor_value_post", "parameters": [ { "description": "The BMC unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Getting The BMC sensors values task has been started", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "ok" } } } } } }, "default": { "description": "Failed to start receiving BMC sensors values task", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The ipmi sensors values", "tags": [ "ipmi" ] }, "get": { "operationId": "ipmi_id_sensor_value", "parameters": [ { "description": "The ipmi unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The ipmi sensors values has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "ipmi_id": { "type": "integer", "example": 10, "description": "The BMC identifier" }, "update_time": { "type": "string", "example": "2021-11-22T23:38:46", "description": "The time of last BMC sensors update", "nullable": true }, "sensors_info": { "type": "array", "description": "The IPMI sensors info in JSON format", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "Sensor name" }, "value": { "type": "string", "description": "Sensor value" }, "measure": { "type": "string", "description": "Sensor measure" }, "status": { "type": "string", "description": "Sensor status" } } } } } } } } }, "default": { "description": "Error receiving values of ipmi sensors", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The ipmi sensors values", "tags": [ "ipmi" ] } }, "/ipmi/{ipmi_id}/update_sensor_values": { "post": { "operationId": "ipmi_id_update_sensor_values_post", "parameters": [ { "description": "The BMC unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "sensors_info": { "type": "object", "description": "The BMC new sensor info" } } } } } }, "responses": { "200": { "description": "Updating The BMC sensors values task has been done", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "ok" } } } } } }, "default": { "description": "Failed to update BMC sensors values", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "Update the ipmi sensors values", "tags": [ "ipmi" ] } }, "/ipmi/{ipmi_id}/log": { "get": { "operationId": "ipmi_id_log", "parameters": [ { "description": "The ipmi unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } }, { "description": "The ipmi log output format", "in": "query", "name": "log_format", "schema": { "type": "string", "default": "text", "enum": [ "text", "json" ] }, "allowReserved": true } ], "responses": { "200": { "description": "The ipmi logs has been received", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "log": { "type": "string", "description": "The IPMI logs" } } }, { "type": "object", "properties": { "list": { "type": "array", "description": "The IPMI log records", "items": { "type": "object", "description": "The IPMI log one record", "properties": { "id": { "type": "string", "description": "The IPMI log record ID" }, "date_time": { "type": "string", "description": "The IPMI log record created time" }, "message": { "type": "string", "description": "The IPMI log message" }, "severity": { "type": "string", "description": "The IPMI log severity" } } } }, "size": { "type": "integer", "description": "The IPMI log records count" }, "last_notify": { "type": "integer", "description": "Stub", "default": 0 } } } ] } } } }, "default": { "description": "Error receiving ipmi logs", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The ipmi logs", "tags": [ "ipmi" ] } }, "/ipmi/{ipmi_id}/fru": { "post": { "operationId": "ipmi_id_fru_post", "parameters": [ { "description": "The BMC unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Getting The BMC FRU info task has been started", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "ok" } } } } } }, "default": { "description": "Failed to start receiving BMC FRU task", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The ipmi sensors values", "tags": [ "ipmi" ] }, "get": { "operationId": "ipmi_id_fru", "parameters": [ { "description": "The ipmi unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The ipmi fru info has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "result": { "type": "object", "description": "The IPMI fru info", "properties": { "ipmi_id": { "type": "integer", "example": 10, "description": "The BMC identifier" }, "status": { "type": "string", "example": "ok", "description": "FRU information update status" }, "status_info": { "type": "object", "description": "Status additional info" }, "update_time": { "type": "string", "example": "2021-11-22T23:38:46", "description": "The time of last BMC FRU update", "nullable": true }, "device": { "description": "Device info", "type": "object", "properties": { "name": { "description": "Device name", "type": "string", "example": "Builtin FRU Device" }, "id": { "description": "Device id", "type": "string", "example": 4 } } }, "chassis": { "description": "Chassis info", "type": "object", "properties": { "type": { "description": "Chassis type", "type": "string", "example": "Expansion Chassis" }, "part_number": { "description": "Chassis Part Number", "type": "string", "example": "68-5999-02" }, "serial": { "description": "Chassis Serial Number", "type": "string", "example": "GOX1586GKKU" }, "extra": { "description": "Chassis extra info", "type": "string", "example": "Cisco Systems Inc" } } }, "board": { "description": "Board info", "type": "object", "properties": { "manufacture_date": { "description": "Board manufacture date", "type": "string", "example": "Mon Aug 18 09:13:00 1997" }, "manufacture": { "description": "Board manufacture", "type": "string", "example": "Cisco Systems Inc" }, "part_number": { "description": "Board part number", "type": "string", "example": "55-14658-09" }, "serial": { "description": "Board serial", "type": "string", "example": "JGU1457J555" }, "product": { "description": "Board product", "type": "string", "example": "UCSB-MLOM-PT-01" } } }, "product": { "description": "Product info", "type": "object", "properties": { "name": { "description": "Product Name", "type": "string", "example": "VEGMAN_S320_Server" }, "manufacture": { "description": "Product Model", "type": "string", "example": "YADRO" }, "model": { "description": "Product Manufacturer", "type": "string", "example": "VEGMAN S320 Server" }, "part_number": { "description": "Product Part Number", "type": "string", "example": "ASYUEG68599A" }, "version": { "description": "Product Version", "type": "string", "example": "Unknown" }, "serial": { "description": "Product Serial", "type": "string", "example": 834588243 }, "assert_tag": { "description": "Product Asset Tag", "type": "string", "example": "TISserver" } } }, "firmware": { "description": "Firmware versions info", "type": "object", "properties": { "bios": { "description": "BIOS version", "type": "string", "example": "1.4-ge8ed40" }, "bmc": { "description": "BMC version", "type": "string", "example": "v1.4rc43e3b" } } } } } } } } } }, "default": { "description": "Error receiving ipmi fru info", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The ipmi fru info", "tags": [ "ipmi" ] } }, "/ipmi/{ipmi_id}/info": { "post": { "operationId": "ipmi_id_info_post", "parameters": [ { "description": "The BMC unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "model": { "type": "string", "description": "Model of the BMC" } } } } } }, "responses": { "200": { "description": "Update BMC info is succesful", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "ok" } } } } } }, "default": { "description": "Failed to update BMC info", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The BMC extra info", "tags": [ "ipmi" ] } }, "/ipmi/model": { "get": { "operationId": "ipmi_model", "responses": { "200": { "description": "The list of BMC models", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } } } } }, "default": { "description": "Error receiving BMC models list", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The BMC models list", "tags": [ "ipmi" ] } }, "/instance/{instance_id}/server/{server_id}/statistic": { "get": { "deprecated": true, "operationId": "instance_id_server_id_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "sum_volume_rx": { "type": "string", "description": "The total sum of received traffic for the period in bytes" }, "sum_volume_tx": { "type": "string", "description": "The total sum of transmitted traffic for the period" }, "avg_load_rx": { "type": "string", "description": "The average of received load for the period" }, "avg_load_tx": { "type": "string", "description": "The average of transmitted load for the period" }, "sum_volume_rx_converted": { "type": "string", "description": "The formatted total sum of received traffic for the period" }, "sum_volume_tx_converted": { "type": "string", "description": "The formatted total sum of transmitted traffic for the period" }, "avg_load_rx_converted": { "type": "string", "description": "The formatted average of received load for the period" }, "avg_load_tx_converted": { "type": "string", "description": "The formatted average of transmitted load for the period" }, "max_burstable_rx": { "type": "integer", "description": "The burstable of received load" }, "max_burstable_tx": { "type": "integer", "description": "The burstable of transmitted load" } } } } } }, "default": { "description": "Server statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server statistic", "tags": [ "statistic" ] } }, "/instance/{instance_id}/server/{server_id}/netflow_statistic": { "get": { "deprecated": true, "operationId": "instance_id_server_id_netflow_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server netflow statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "sum_volume_rx": { "type": "string", "description": "The total sum of received traffic for the period in bytes" }, "sum_volume_tx": { "type": "string", "description": "The total sum of transmitted traffic for the period" }, "avg_load_rx": { "type": "string", "description": "The average of received load for the period" }, "avg_load_tx": { "type": "string", "description": "The average of transmitted load for the period" }, "sum_volume_rx_converted": { "type": "string", "description": "The formatted total sum of received traffic for the period" }, "sum_volume_tx_converted": { "type": "string", "description": "The formatted total sum of transmitted traffic for the period" }, "avg_load_rx_converted": { "type": "string", "description": "The formatted average of received load for the period" }, "avg_load_tx_converted": { "type": "string", "description": "The formatted average of transmitted load for the period" }, "max_burstable_rx": { "type": "integer", "description": "The burstable of received load" }, "max_burstable_tx": { "type": "integer", "description": "The burstable of transmitted load" } } } } } }, "default": { "description": "Server netflow statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server netflow statistic", "tags": [ "statistic" ] } }, "/instance/{instance_id}/server/{server_id}/raw_netflow_statistic": { "get": { "deprecated": true, "operationId": "instance_id_server_id_raw_netflow_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server raw netflow statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_rx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received traffic for the period" }, "metric_tx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted traffic for the period" }, "metric_rx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received load for the period" }, "metric_tx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted load for the period" } } } } } }, "default": { "description": "Server raw netflow statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server raw netflow statistic", "tags": [ "statistic" ] } }, "/instance/{instance_id}/server/{server_id}/ip/{ip_address}/raw_netflow_statistic": { "get": { "deprecated": true, "operationId": "instance_id_server_id_ip_address_raw_netflow_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } }, { "description": "The IP unique address", "in": "path", "name": "ip_address", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The server raw netflow statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_rx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received traffic for the period" }, "metric_tx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted traffic for the period" }, "metric_rx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received load for the period" }, "metric_tx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted load for the period" } } } } } }, "default": { "description": "Server raw netflow statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server raw netflow statistic", "tags": [ "statistic" ] } }, "/instance/{instance_id}/server/{server_id}/port/{port_id}/statistic": { "get": { "deprecated": true, "operationId": "instance_id_server_id_port_id_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } }, { "description": "The port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "sum_volume_rx": { "type": "string", "description": "The total sum of received traffic for the period in bytes" }, "sum_volume_tx": { "type": "string", "description": "The total sum of transmitted traffic for the period" }, "avg_load_rx": { "type": "string", "description": "The average of received load for the period" }, "avg_load_tx": { "type": "string", "description": "The average of transmitted load for the period" }, "sum_volume_rx_converted": { "type": "string", "description": "The formatted total sum of received traffic for the period" }, "sum_volume_tx_converted": { "type": "string", "description": "The formatted total sum of transmitted traffic for the period" }, "avg_load_rx_converted": { "type": "string", "description": "The formatted average of received load for the period" }, "avg_load_tx_converted": { "type": "string", "description": "The formatted average of transmitted load for the period" }, "max_burstable_rx": { "type": "integer", "description": "The burstable of received load" }, "max_burstable_tx": { "type": "integer", "description": "The burstable of transmitted load" } } } } } }, "default": { "description": "Server statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server statistic", "tags": [ "statistic" ] } }, "/instance/{instance_id}/server/{server_id}/raw_statistic": { "get": { "deprecated": true, "operationId": "instance_id_server_id_raw_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_rx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received traffic for the period" }, "metric_tx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted traffic for the period" }, "metric_rx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received load for the period" }, "metric_tx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted load for the period" } } } } } }, "default": { "description": "Server raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server raw statistic", "tags": [ "statistic" ] } }, "/instance/{instance_id}/server/{server_id}/port/{port_id}/raw_statistic": { "get": { "deprecated": true, "operationId": "instance_id_server_id_port_id_raw_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } }, { "description": "The port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_rx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received traffic for the period" }, "metric_tx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted traffic for the period" }, "metric_rx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received load for the period" }, "metric_tx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted load for the period" } } } } } }, "default": { "description": "Server raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server raw statistic", "tags": [ "statistic" ] } }, "/instance/{instance_id}/pdu/{pdu_id}/raw_statistic": { "get": { "deprecated": true, "operationId": "instance_id_pdu_id_raw_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The PDU raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_consumption": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The PDU consumption values by timestamp" }, "metric_phase": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The PDU phase load by timestamp" } } } } } }, "default": { "description": "PDU raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The PDU raw statistic", "tags": [ "statistic" ] } }, "/instance/{instance_id}/pdu/{pdu_id}/phase/{phase_id}/raw_statistic": { "get": { "deprecated": true, "operationId": "instance_id_pdu_id_phase_id_raw_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } }, { "description": "The PDU phase unique identifier", "in": "path", "name": "phase_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The PDU raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_consumption": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The PDU consumption values by timestamp" }, "metric_phase": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The PDU phase load by timestamp" } } } } } }, "default": { "description": "PDU raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The PDU raw statistic", "tags": [ "statistic" ] } }, "/instance/{instance_id}/ups/{ups_id}/raw_statistic": { "get": { "deprecated": true, "operationId": "instance_id_ups_id_raw_statistic", "parameters": [ { "description": "The instance unique identifier", "in": "path", "name": "instance_id", "required": false, "schema": { "type": "integer" } }, { "description": "The UPS unique identifier", "in": "path", "name": "ups_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The UPS raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_load_percentage": { "type": "array", "items": { "type": "array", "items": { "type": "integer" } }, "description": "The UPS load percentage values by timestamp" }, "metric_charge_time": { "type": "array", "items": { "type": "array", "items": { "type": "integer" } }, "description": "The UPS charge time values by timestamp" }, "metric_input_power": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The UPS input power values by timestamp" }, "metric_output_power": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The UPS output power values by timestamp" } } } } } }, "default": { "description": "UPS raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The UPS raw statistic", "tags": [ "statistic" ] } }, "/server/{server_id}/statistic": { "get": { "operationId": "server_id_statistic", "parameters": [ { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "sum_volume_rx": { "type": "string", "description": "The total sum of received traffic for the period in bytes" }, "sum_volume_tx": { "type": "string", "description": "The total sum of transmitted traffic for the period" }, "avg_load_rx": { "type": "string", "description": "The average of received load for the period" }, "avg_load_tx": { "type": "string", "description": "The average of transmitted load for the period" }, "sum_volume_rx_converted": { "type": "string", "description": "The formatted total sum of received traffic for the period" }, "sum_volume_tx_converted": { "type": "string", "description": "The formatted total sum of transmitted traffic for the period" }, "avg_load_rx_converted": { "type": "string", "description": "The formatted average of received load for the period" }, "avg_load_tx_converted": { "type": "string", "description": "The formatted average of transmitted load for the period" }, "max_burstable_rx": { "type": "integer", "description": "The burstable of received load" }, "max_burstable_tx": { "type": "integer", "description": "The burstable of transmitted load" } } } } } }, "default": { "description": "Server statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server statistic", "tags": [ "statistic" ] } }, "/server/{server_id}/netflow_statistic": { "get": { "operationId": "server_id_netflow_statistic", "parameters": [ { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server netflow statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "sum_volume_rx": { "type": "string", "description": "The total sum of received traffic for the period in bytes" }, "sum_volume_tx": { "type": "string", "description": "The total sum of transmitted traffic for the period" }, "avg_load_rx": { "type": "string", "description": "The average of received load for the period" }, "avg_load_tx": { "type": "string", "description": "The average of transmitted load for the period" }, "sum_volume_rx_converted": { "type": "string", "description": "The formatted total sum of received traffic for the period" }, "sum_volume_tx_converted": { "type": "string", "description": "The formatted total sum of transmitted traffic for the period" }, "avg_load_rx_converted": { "type": "string", "description": "The formatted average of received load for the period" }, "avg_load_tx_converted": { "type": "string", "description": "The formatted average of transmitted load for the period" }, "max_burstable_rx": { "type": "integer", "description": "The burstable of received load" }, "max_burstable_tx": { "type": "integer", "description": "The burstable of transmitted load" } } } } } }, "default": { "description": "Server netflow statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server netflow statistic", "tags": [ "statistic" ] } }, "/server/{server_id}/raw_netflow_statistic": { "get": { "operationId": "server_id_raw_netflow_statistic", "parameters": [ { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server raw netflow statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_rx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received traffic for the period" }, "metric_tx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted traffic for the period" }, "metric_rx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received load for the period" }, "metric_tx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted load for the period" } } } } } }, "default": { "description": "Server raw netflow statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server raw netflow statistic", "tags": [ "statistic" ] } }, "/server/{server_id}/ip/{ip_address}/raw_netflow_statistic": { "get": { "operationId": "server_id_ip_address_raw_netflow_statistic", "parameters": [ { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } }, { "description": "The IP unique address", "in": "path", "name": "ip_address", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The server raw netflow statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_rx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received traffic for the period" }, "metric_tx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted traffic for the period" }, "metric_rx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received load for the period" }, "metric_tx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted load for the period" } } } } } }, "default": { "description": "Server raw netflow statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server raw netflow statistic", "tags": [ "statistic" ] } }, "/server/{server_id}/port/{port_id}/statistic": { "get": { "operationId": "server_id_port_id_statistic", "parameters": [ { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } }, { "description": "The port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "sum_volume_rx": { "type": "string", "description": "The total sum of received traffic for the period in bytes" }, "sum_volume_tx": { "type": "string", "description": "The total sum of transmitted traffic for the period" }, "avg_load_rx": { "type": "string", "description": "The average of received load for the period" }, "avg_load_tx": { "type": "string", "description": "The average of transmitted load for the period" }, "sum_volume_rx_converted": { "type": "string", "description": "The formatted total sum of received traffic for the period" }, "sum_volume_tx_converted": { "type": "string", "description": "The formatted total sum of transmitted traffic for the period" }, "avg_load_rx_converted": { "type": "string", "description": "The formatted average of received load for the period" }, "avg_load_tx_converted": { "type": "string", "description": "The formatted average of transmitted load for the period" }, "max_burstable_rx": { "type": "integer", "description": "The burstable of received load" }, "max_burstable_tx": { "type": "integer", "description": "The burstable of transmitted load" } } } } } }, "default": { "description": "Server statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server statistic", "tags": [ "statistic" ] } }, "/server/{server_id}/raw_statistic": { "get": { "operationId": "server_id_raw_statistic", "parameters": [ { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_rx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received traffic for the period" }, "metric_tx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted traffic for the period" }, "metric_rx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received load for the period" }, "metric_tx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted load for the period" } } } } } }, "default": { "description": "Server raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server raw statistic", "tags": [ "statistic" ] } }, "/server/{server_id}/port/{port_id}/raw_statistic": { "get": { "operationId": "server_id_port_id_raw_statistic", "parameters": [ { "description": "The server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } }, { "description": "The port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The server raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_rx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received traffic for the period" }, "metric_tx_volume": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted traffic for the period" }, "metric_rx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total received load for the period" }, "metric_tx_load": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The total transmitted load for the period" } } } } } }, "default": { "description": "Server raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The server raw statistic", "tags": [ "statistic" ] } }, "/pdu/{pdu_id}/raw_statistic": { "get": { "operationId": "pdu_id_raw_statistic", "parameters": [ { "description": "The PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The PDU raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_consumption": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The PDU consumption values by timestamp" }, "metric_phase": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The PDU phase load by timestamp" } } } } } }, "default": { "description": "PDU raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The PDU raw statistic", "tags": [ "statistic" ] } }, "/pdu/{pdu_id}/phase/{phase_id}/raw_statistic": { "get": { "operationId": "pdu_id_phase_id_raw_statistic", "parameters": [ { "description": "The PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } }, { "description": "The PDU phase unique identifier", "in": "path", "name": "phase_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The PDU raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_consumption": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The PDU consumption values by timestamp" }, "metric_phase": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The PDU phase load by timestamp" } } } } } }, "default": { "description": "PDU raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The PDU raw statistic", "tags": [ "statistic" ] } }, "/ups/{ups_id}/raw_statistic": { "get": { "operationId": "ups_id_raw_statistic", "parameters": [ { "description": "The UPS unique identifier", "in": "path", "name": "ups_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The UPS raw statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "metric_load_percentage": { "type": "array", "items": { "type": "array", "items": { "type": "integer" } }, "description": "The UPS load percentage values by timestamp" }, "metric_charge_time": { "type": "array", "items": { "type": "array", "items": { "type": "integer" } }, "description": "The UPS charge time values by timestamp" }, "metric_input_power": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The UPS input power values by timestamp" }, "metric_output_power": { "type": "array", "items": { "type": "array", "items": { "format": "float", "type": "number" } }, "description": "The UPS output power values by timestamp" } } } } } }, "default": { "description": "UPS raw statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The UPS raw statistic", "tags": [ "statistic" ] } }, "/switch/{switch_id}/port/{port_id}/statistic": { "get": { "operationId": "switch_id_port_id_statistic", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } }, { "description": "The port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The switch statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "sum_volume_rx": { "type": "integer", "description": "The total sum of received traffic for the period in bytes" }, "sum_volume_tx": { "type": "integer", "description": "The total sum of transmitted traffic for the period" }, "avg_load_rx": { "type": "integer", "description": "The average of received load for the period" }, "avg_load_tx": { "type": "integer", "description": "The average of transmitted load for the period" }, "sum_volume_rx_converted": { "type": "string", "description": "The formatted total sum of received traffic for the period" }, "sum_volume_tx_converted": { "type": "string", "description": "The formatted total sum of transmitted traffic for the period" }, "avg_load_rx_converted": { "type": "string", "description": "The formatted average of received load for the period" }, "avg_load_tx_converted": { "type": "string", "description": "The formatted average of transmitted load for the period" }, "max_burstable_rx": { "type": "integer", "description": "The burstable of received load" }, "max_burstable_tx": { "type": "integer", "description": "The burstable of transmitted load" } } } } } }, "default": { "description": "Switch statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The switch statistic", "tags": [ "statistic" ] } }, "/switch/{switch_id}/statistic": { "get": { "operationId": "switch_id_statistic", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The switch statistic has been received", "content": { "application/json": { "schema": { "type": "object", "properties": { "sum_volume_rx": { "type": "integer", "description": "The total sum of received traffic for the period in bytes" }, "sum_volume_tx": { "type": "integer", "description": "The total sum of transmitted traffic for the period" }, "avg_load_rx": { "type": "integer", "description": "The average of received load for the period" }, "avg_load_tx": { "type": "integer", "description": "The average of transmitted load for the period" }, "sum_volume_rx_converted": { "type": "string", "description": "The formatted total sum of received traffic for the period" }, "sum_volume_tx_converted": { "type": "string", "description": "The formatted total sum of transmitted traffic for the period" }, "avg_load_rx_converted": { "type": "string", "description": "The formatted average of received load for the period" }, "avg_load_tx_converted": { "type": "string", "description": "The formatted average of transmitted load for the period" }, "max_burstable_rx": { "type": "integer", "description": "The burstable of received load" }, "max_burstable_tx": { "type": "integer", "description": "The burstable of transmitted load" } } } } } }, "default": { "description": "Switch statistic not found", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } }, "summary": "The switch statistic", "tags": [ "statistic" ] } }, "/custom_equipment": { "post": { "operationId": "custom_equipment_post", "summary": "Create custom equipment handler", "tags": [ "custom_equipment" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "handler", "protocol", "device_type" ], "properties": { "name": { "type": "string", "description": "The human readable custom equipment handler name", "example": "Custom Cisco Catalyst" }, "handler": { "type": "string", "description": "The internal handler name for DCImanager", "example": "custom_cisco_catalyst", "pattern": "^\\w+$" }, "device_type": { "type": "string", "description": "The equipment handler type", "example": "switch", "enum": [ "switch", "pdu", "vpu" ] }, "protocol": { "type": "array", "description": "The protocol of your handler", "minItems": 1, "maxItems": 1, "items": { "type": "string", "enum": [ "snmp", "nxapi", "eapi", "netconf", "routerosapi", "custom" ], "example": "snmp" } }, "features": { "type": "array", "description": "The features, available in your handlers", "example": [ "collect_mac" ], "default": [], "items": { "type": "string", "description": "port_aggregation available for switch handler. statistic_per_port - for PDU handlers. collect_mac - available for switch handler which can collect info about mac address on port", "enum": [ "port_aggregation", "statistic_per_port", "collect_mac" ] } } } } } } }, "responses": { "200": { "description": "The custom equipment handler has been successfully created", "content": { "application/json": { "schema": { "properties": { "id": { "type": "integer" } }, "type": "object" } } } }, "default": { "description": "Error creating custom equipment handler", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } } }, "get": { "operationId": "custom_equipment_get", "summary": "List custom equipment handlers", "tags": [ "custom_equipment" ], "responses": { "200": { "description": "Got list of equipment handlers", "content": { "application/json": { "schema": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The equipment handler ID", "example": 1 }, "name": { "type": "string", "description": "The human readable custom equipment handler name", "example": "Custom Cisco Catalyst" }, "device_type": { "type": "string", "description": "The equipment handler type", "example": "switch", "enum": [ "switch", "pdu", "ups", "vpu", "ipmi" ] }, "version": { "type": "string", "description": "The equipment handler version", "example": "2021.08.1629980241282" }, "update_time": { "type": "string", "description": "The equipment handler create or update time", "example": "2021-08-26T12:17:21" }, "handler": { "type": "string", "description": "The internal handler name for DCImanager", "example": "custom_cisco_catalyst" }, "handler_import": { "type": "string", "description": "The relative python handler path to you custom handler inside your archive", "example": "custom_cisco_catalyst.main" }, "protocol": { "type": "array", "description": "The protocol of your handler", "minItems": 1, "maxItems": 1, "items": { "type": "string", "enum": [ "snmp", "nxapi", "eapi", "netconf", "routerosapi", "custom" ], "example": "snmp" } }, "features": { "type": "array", "description": "The features, available in your handlers", "example": [], "default": [], "items": { "type": "string", "description": "port_aggregation available for switch handler. statistic_per_port - for PDU handlers. collect_mac - available for switch handler which can collect info about mac address on port", "enum": [ "port_aggregation", "statistic_per_port", "collect_mac" ] } } } } } } } } } }, "default": { "description": "Error getting list of custom equipment handlers", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } } } }, "/custom_equipment/{custom_equipment_id}": { "post": { "operationId": "custom_equipment_id_post", "summary": "Edit custom equipment handler", "tags": [ "custom_equipment" ], "parameters": [ { "description": "The custom equipment handler identifier or internal name", "in": "path", "name": "custom_equipment_id", "required": true, "schema": { "oneOf": [ { "type": "integer" }, { "type": "string" } ] } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The human readable custom equipment handler name", "example": "Custom Cisco Catalyst" }, "features": { "type": "array", "description": "The features, available in your handlers", "example": [ "collect_mac" ], "items": { "type": "string", "description": "port_aggregation available for switch handler. statistic_per_port - for PDU handlers. collect_mac - available for switch handler which can collect info about mac address on port", "enum": [ "port_aggregation", "statistic_per_port", "collect_mac" ] } } } } } } }, "responses": { "200": { "description": "The custom equipment handler has been successfully edited", "content": { "application/json": { "schema": { "properties": { "id": { "type": "integer" } }, "type": "object" } } } }, "default": { "description": "Error editing custom equipment handler", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } } }, "delete": { "operationId": "custom_equipment_id_delete", "summary": "Remove custom equipment handler", "tags": [ "custom_equipment" ], "parameters": [ { "description": "The custom equipment handler identifier", "in": "path", "name": "custom_equipment_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The custom equipment handler has been successfully removed", "content": { "application/json": { "schema": { "properties": { "id": { "type": "integer" } }, "type": "object" } } } }, "default": { "description": "Error removing custom equipment handler", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } } }, "get": { "operationId": "custom_equipment_id_get", "summary": "Getting the custom equipment handler", "tags": [ "custom_equipment" ], "parameters": [ { "description": "The custom equipment handler identifier", "in": "path", "name": "custom_equipment_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Got the custom equipment handler", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "description": "The equipment handler ID", "example": 1 }, "name": { "type": "string", "description": "The human readable custom equipment handler name", "example": "Custom Cisco Catalyst" }, "device_type": { "type": "string", "description": "The equipment handler type", "example": "switch", "enum": [ "switch", "pdu", "ups", "vpu", "ipmi" ] }, "version": { "type": "string", "description": "The equipment handler version", "example": "2021.08.1629980241282" }, "update_time": { "type": "string", "description": "The equipment handler create or update time", "example": "2021-08-26T12:17:21" }, "handler": { "type": "string", "description": "The internal handler name for DCImanager", "example": "custom_cisco_catalyst" }, "handler_import": { "type": "string", "description": "The relative python handler path to you custom handler inside your archive", "example": "custom_cisco_catalyst.main" }, "protocol": { "type": "array", "description": "The protocol of your handler", "minItems": 1, "maxItems": 1, "items": { "type": "string", "enum": [ "snmp", "nxapi", "eapi", "netconf", "routerosapi", "custom" ], "example": "snmp" } }, "features": { "type": "array", "description": "The features, available in your handlers", "example": [], "default": [], "items": { "type": "string", "description": "port_aggregation available for switch handler. statistic_per_port - for PDU handlers. collect_mac - available for switch handler which can collect info about mac address on port", "enum": [ "port_aggregation", "statistic_per_port", "collect_mac" ] } } } } } } }, "default": { "description": "Error getting custom equipment handler", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } } } }, "/custom_equipment/{custom_equipment_id}/content": { "post": { "operationId": "custom_equipment_id_content_post", "summary": "Update custom equipment handler content", "tags": [ "custom_equipment" ], "parameters": [ { "description": "The custom equipment handler identifier or internal name", "in": "path", "name": "custom_equipment_id", "required": true, "schema": { "oneOf": [ { "type": "integer" }, { "type": "string" } ] } } ], "responses": { "200": { "description": "The custom equipment handler content has been successfully updated", "content": { "application/json": { "schema": { "properties": { "id": { "type": "integer" } }, "type": "object" } } } }, "default": { "description": "Error updating custom equipment handler content", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } } }, "get": { "operationId": "custom_equipment_id_content_get", "summary": "Getting the custom equipment handler content", "tags": [ "custom_equipment" ], "parameters": [ { "description": "The custom equipment handler identifier", "in": "path", "name": "custom_equipment_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Got the custom equipment handler content", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "description": "The equipment handler archive in \"tar.gz\" format" } } } }, "default": { "description": "Error getting custom equipment handler content", "content": { "application/json": { "schema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" } } } } } } } } }