Elastic Workload Protector API

authentication_token

Operations about authentication_tokens

POST /api/v1/authentication_token
Requests
Body
{
  "account_id": "Hello, world!",
  "email": "Hello, world!",
  "password": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "account id"
    },
    "email": {
      "type": "string",
      "description": "email"
    },
    "password": {
      "type": "string",
      "description": "password"
    }
  },
  "required": [
    "account_id",
    "email",
    "password"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401

Login via email and password

Schema
{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "description": "Linked with a user"
    },
    "account_id": {
      "type": "string",
      "description": "Linked with an account"
    },
    "role": {
      "type": "string"
    },
    "access_token": {
      "type": "string",
      "description": "Access token of the role"
    }
  },
  "description": "Login via email and password"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Login via email and password
POST/api/v1/authentication_token

Login via email and password


servers

Operations about servers

POST /api/v1/servers/quick_scan
Requests
Body
{
  "quickscan[ip_address]": "Hello, world!",
  "quickscan[worker]": "Hello, world!",
  "quickscan[ack_scan]": true,
  "quickscan[execution_date]": "Hello, world!",
  "quickscan[scan_type]": "Hello, world!",
  "quickscan[scan_policy][timeout]": 1,
  "quickscan[scan_policy][aggressivity]": 1,
  "quickscan[scan_policy][intrusiveness]": true,
  "quickscan[scan_policy][active_web_crawling]": true,
  "quickscan[scan_policy][ssh_scan]": 1,
  "quickscan[scan_policy][nmap_command]": "Hello, world!",
  "quickscan[scan_policy][credential][clear_vm_smb_user]": "Hello, world!",
  "quickscan[scan_policy][credential][clear_vm_smb_passwd]": "Hello, world!",
  "quickscan[scan_policy][credential][clear_vm_ssh_user]": "Hello, world!",
  "quickscan[scan_policy][credential][clear_vm_ssh_key]": "Hello, world!",
  "quickscan[scan_policy][credential][authtype]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_url_login_page]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_credential_parameters_key_login]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_credential_parameters_value_login]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_credential_parameters_key_password]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_credential_parameters_value_password]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_credential_parameters_key_extra]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_credential_parameters_value_extra]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_url_check]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_url_check_keyword]": "Hello, world!",
  "quickscan[scan_policy][credential][web_form_logout]": "Hello, world!",
  "quickscan[scan_policy][credential][web_http_login]": "Hello, world!",
  "quickscan[scan_policy][credential][web_http_password]": "Hello, world!",
  "quickscan[scan_policy][credential][web_http_url_check]": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "quickscan[ip_address]": {
      "type": "string",
      "description": "IP Address (or DNS name)"
    },
    "quickscan[worker]": {
      "type": "string",
      "description": "Worker ID"
    },
    "quickscan[ack_scan]": {
      "type": "boolean",
      "default": true
    },
    "quickscan[execution_date]": {
      "type": "string",
      "default": "04/30/2018 14:56",
      "description": "Date for execution"
    },
    "quickscan[scan_type]": {
      "type": "string",
      "default": "single_scan"
    },
    "quickscan[scan_policy][timeout]": {
      "type": "number",
      "default": 7200
    },
    "quickscan[scan_policy][aggressivity]": {
      "type": "number",
      "default": 2
    },
    "quickscan[scan_policy][intrusiveness]": {
      "type": "boolean",
      "default": true
    },
    "quickscan[scan_policy][active_web_crawling]": {
      "type": "boolean",
      "default": true
    },
    "quickscan[scan_policy][ssh_scan]": {
      "type": "number",
      "default": 22
    },
    "quickscan[scan_policy][nmap_command]": {
      "type": "string"
    },
    "quickscan[scan_policy][credential][clear_vm_smb_user]": {
      "type": "string",
      "description": "(Windows) Samba login"
    },
    "quickscan[scan_policy][credential][clear_vm_smb_passwd]": {
      "type": "string",
      "description": "(Windows) Samba password"
    },
    "quickscan[scan_policy][credential][clear_vm_ssh_user]": {
      "type": "string",
      "description": "(Linux) SSH user"
    },
    "quickscan[scan_policy][credential][clear_vm_ssh_key]": {
      "type": "string",
      "description": "(Linux) SSH Private Key"
    },
    "quickscan[scan_policy][credential][authtype]": {
      "type": "string",
      "default": "form",
      "description": "Type of web authentication : http or form"
    },
    "quickscan[scan_policy][credential][web_form_url_login_page]": {
      "type": "string",
      "description": "(form) URL of login page"
    },
    "quickscan[scan_policy][credential][web_form_credential_parameters_key_login]": {
      "type": "string",
      "description": "(form) Webform User Input Name"
    },
    "quickscan[scan_policy][credential][web_form_credential_parameters_value_login]": {
      "type": "string",
      "description": "(form) Webform User Input Value"
    },
    "quickscan[scan_policy][credential][web_form_credential_parameters_key_password]": {
      "type": "string",
      "description": "(form) Webform Password Input Name"
    },
    "quickscan[scan_policy][credential][web_form_credential_parameters_value_password]": {
      "type": "string",
      "description": "(form) Webform Password Input Value"
    },
    "quickscan[scan_policy][credential][web_form_credential_parameters_key_extra]": {
      "type": "string",
      "description": "(form) Webform Extra Field Name"
    },
    "quickscan[scan_policy][credential][web_form_credential_parameters_value_extra]": {
      "type": "string",
      "description": "(form) Webform Extra Field Value"
    },
    "quickscan[scan_policy][credential][web_form_url_check]": {
      "type": "string",
      "description": "(form) URL for checking"
    },
    "quickscan[scan_policy][credential][web_form_url_check_keyword]": {
      "type": "string",
      "description": "(form) URL check keywords"
    },
    "quickscan[scan_policy][credential][web_form_logout]": {
      "type": "string",
      "description": "(form) Logout string"
    },
    "quickscan[scan_policy][credential][web_http_login]": {
      "type": "string",
      "description": "(http) Login"
    },
    "quickscan[scan_policy][credential][web_http_password]": {
      "type": "string",
      "description": "(http) Password"
    },
    "quickscan[scan_policy][credential][web_http_url_check]": {
      "type": "string",
      "description": "(http) URL check"
    }
  },
  "required": [
    "quickscan[ip_address]",
    "quickscan[worker]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401

Launch a QuickScan on a new server for audit account

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Launch a QuickScan on a new server for audit account
POST/api/v1/servers/quick_scan

Launch a QuickScan on a new server for audit account


POST /api/v1/servers/unmonitor_servers
Requests
Body
{
  "servers[worker_id]": [],
  "servers[value]": []
}
Schema
{
  "type": "object",
  "properties": {
    "servers[worker_id]": {
      "type": "array",
      "description": "Id of worker targeted (empty will target current machine)\n\n+"
    },
    "servers[value]": {
      "type": "array",
      "description": "servers id list\n\n+"
    }
  },
  "required": [
    "servers[worker_id]",
    "servers[value]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201

Un-Monitor servers

Un-Monitor servers
POST/api/v1/servers/unmonitor_servers

Un-Monitor servers


POST /api/v1/servers/monitor_servers
Requests
Body
{
  "servers[worker_id]": [],
  "servers[value]": []
}
Schema
{
  "type": "object",
  "properties": {
    "servers[worker_id]": {
      "type": "array",
      "description": "Id of worker targeted (empty will target current machine)\n\n+"
    },
    "servers[value]": {
      "type": "array",
      "description": "servers id list\n\n+"
    }
  },
  "required": [
    "servers[worker_id]",
    "servers[value]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201

Monitor servers

Monitor servers
POST/api/v1/servers/monitor_servers

Monitor servers


GET /api/v1/servers
Requests
Body
{
  "tags[server]": [],
  "tags[firewall]": [],
  "tags[provider]": [],
  "tags[subnet]": [],
  "tags[provider_type]": [],
  "tags[custom]": []
}
Schema
{
  "type": "object",
  "properties": {
    "tags[server]": {
      "type": "array",
      "description": "ID of servers\n\n+"
    },
    "tags[firewall]": {
      "type": "array",
      "description": "ID of firewalls\n\n+"
    },
    "tags[provider]": {
      "type": "array",
      "description": "ID of provider\n\n+"
    },
    "tags[subnet]": {
      "type": "array",
      "description": "ID of subnet\n\n+"
    },
    "tags[provider_type]": {
      "type": "array",
      "description": "Provider type\n\n+"
    },
    "tags[custom]": {
      "type": "array",
      "description": "Name of custom tags\n\n+"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401

List active servers of authenticated user

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

List active servers of authenticated user
GET/api/v1/servers

List active servers of authenticated user

URI Parameters
unmonitored
string (required) 

If show the unmonitored instances


POST /api/v1/servers/id/unignore
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Unignore Server

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

Unignore Server
POST/api/v1/servers/{id}/unignore

Unignore Server

URI Parameters
id
number (required) 

POST /api/v1/servers/id/ignore
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Ignore Server

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

Ignore Server
POST/api/v1/servers/{id}/ignore

Ignore Server

URI Parameters
id
number (required) 

POST /api/v1/servers/id/unmonitor
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401403404417

unmonitor a server(ID)

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Monitoring license required

Server not found

Already not monitored

unmonitor a server(ID)
POST/api/v1/servers/{id}/unmonitor

unmonitor a server(ID)

URI Parameters
id
number (required) 

POST /api/v1/servers/id/monitor
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401403404417

monitor a server(ID)

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Monitoring license required

Server not found

Already monitored

monitor a server(ID)
POST/api/v1/servers/{id}/monitor

monitor a server(ID)

URI Parameters
id
number (required) 

GET /api/v1/servers/id/alerts
Responses200401404

get all Server’s alerts

Schema
{
  "type": "object",
  "properties": {
    "level": {
      "type": "integer",
      "format": "int32",
      "description": "Rate criticity from 0 to 2, where 0 is good and 2 critical (-1 is unknown)"
    },
    "last_update": {
      "type": "string",
      "format": "date-time",
      "description": "Last time the alert has been seen"
    },
    "message": {
      "type": "string",
      "description": "Description of the alert"
    },
    "monitor_definition_id": {
      "type": "string",
      "description": "ID of Monitor raising the alert"
    },
    "monitor_name": {
      "type": "string",
      "description": "Monitor name"
    }
  },
  "description": "Firewall Policy's alerts"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

get all Server's alerts
GET/api/v1/servers/{id}/alerts

get all Server’s alerts

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/servers/id/risks
Requests
Body
{
  "type": [
    "Hello, world!"
  ]
}
Schema
{
  "type": "object",
  "properties": {
    "type": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "risk type"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404

Get Server’s active risk

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server Not Found

Get Server's active risk
GET/api/v1/servers/{id}/risks

Get Server’s active risk

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/servers/id/subnets
Responses200401404

get all subnets of a server(ID)

Schema
{
  "type": "object",
  "properties": {
    "cidr_block": {
      "type": "string",
      "description": "IP range of the subnet"
    },
    "name": {
      "type": "string",
      "description": "Name of the Subnet"
    },
    "uuid": {
      "type": "string",
      "description": "UUID of the Subnet"
    },
    "vpc_id": {
      "type": "string",
      "description": "VPC ID linked to the Subnet"
    }
  },
  "description": "Get Subnets"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

get all subnets of a server(ID)
GET/api/v1/servers/{id}/subnets

get all subnets of a server(ID)

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/servers/id/firewall_policies
Responses200401404

get all firewall policies of a server(ID)

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the Firewall Policy"
    },
    "sgid": {
      "type": "string",
      "description": "UUID of the Firewall Policy"
    },
    "id": {
      "type": "string",
      "description": "ID of the Firewall Policy"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    }
  },
  "description": "Ignore Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

get all firewall policies of a server(ID)
GET/api/v1/servers/{id}/firewall_policies

get all firewall policies of a server(ID)

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/servers/id/provider
Responses200401404

Get Infrastructure provider linked of a given ID sever

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name given to the provider"
    },
    "id": {
      "type": "string",
      "description": "Provider ID"
    },
    "api_endpoint": {
      "type": "string",
      "description": "End-point of the provider (API access)"
    },
    "account_id": {
      "type": "string",
      "description": "Account linked to the provider"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "type": {
      "type": "string",
      "description": "Type of provider"
    }
  },
  "description": "Get Infrastructure provider linked"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

Get Infrastructure provider linked of a given ID sever
GET/api/v1/servers/{id}/provider

Get Infrastructure provider linked of a given ID sever

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/servers/id
Responses200401404

Get a server with ID

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

Get a server with ID
GET/api/v1/servers/{id}

Get a server with ID

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/servers/id/reports/last
Responses200401404

Get last Scan Report of Server

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the Scanning Report"
    },
    "result": {
      "type": "string",
      "description": "Error status of Scanning Report"
    },
    "instance_id": {
      "type": "string",
      "description": "Server ID linked to the Scanning Report"
    },
    "scan_started_at": {
      "type": "string",
      "format": "date-time",
      "description": "Scan started at"
    },
    "nr_vulnerabilities": {
      "type": "object",
      "description": "Number of vulnerabilities in the report"
    },
    "vulnerabilities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Vulnerability ID"
          },
          "scanning_report_id": {
            "type": "string",
            "description": "Linked scanning report"
          },
          "name": {
            "type": "string",
            "description": "Name of the vulnerability"
          }
        },
        "description": "List of all vulnerabilities of a Server"
      },
      "description": "Array of Vulnerabilities"
    }
  },
  "description": "Get Specific report"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

Get last Scan Report of Server
GET/api/v1/servers/{id}/reports/last

Get last Scan Report of Server

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/servers/id/reports
Requests
Body
{
  "tags[server]": [],
  "tags[firewall]": [],
  "tags[provider]": [],
  "tags[subnet]": [],
  "tags[provider_type]": [],
  "tags[custom]": []
}
Schema
{
  "type": "object",
  "properties": {
    "tags[server]": {
      "type": "array",
      "description": "ID of servers\n\n+"
    },
    "tags[firewall]": {
      "type": "array",
      "description": "ID of firewalls\n\n+"
    },
    "tags[provider]": {
      "type": "array",
      "description": "ID of provider\n\n+"
    },
    "tags[subnet]": {
      "type": "array",
      "description": "ID of subnet\n\n+"
    },
    "tags[provider_type]": {
      "type": "array",
      "description": "Provider type\n\n+"
    },
    "tags[custom]": {
      "type": "array",
      "description": "Name of custom tags\n\n+"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404

get all Scan Reports of a Server

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the Scanning Report"
    },
    "result": {
      "type": "string",
      "description": "Error status of Scanning Report"
    },
    "instance_id": {
      "type": "string",
      "description": "Server ID linked to the Scanning Report"
    },
    "scan_started_at": {
      "type": "string",
      "format": "date-time",
      "description": "Scan started at"
    },
    "nr_vulnerabilities": {
      "type": "object",
      "description": "Number of vulnerabilities in the report"
    },
    "vulnerabilities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Vulnerability ID"
          },
          "scanning_report_id": {
            "type": "string",
            "description": "Linked scanning report"
          },
          "name": {
            "type": "string",
            "description": "Name of the vulnerability"
          }
        },
        "description": "List of all vulnerabilities of a Server"
      },
      "description": "Array of Vulnerabilities"
    }
  },
  "description": "Get Specific report"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

get all Scan Reports of a Server
GET/api/v1/servers/{id}/reports

get all Scan Reports of a Server

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/servers/id/vulnerabilities/active
Responses200401404

List of active vulnerabilities of Server

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Vulnerability ID"
    },
    "scanning_report_id": {
      "type": "string",
      "description": "Linked scanning report"
    },
    "name": {
      "type": "string",
      "description": "Name of the vulnerability"
    }
  },
  "description": "List of all vulnerabilities of a Server"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

List of active vulnerabilities of Server
GET/api/v1/servers/{id}/vulnerabilities/active

List of active vulnerabilities of Server

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/servers/id/vulnerabilities
Responses200401404

List of all vulnerabilities of a Server

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Vulnerability ID"
    },
    "scanning_report_id": {
      "type": "string",
      "description": "Linked scanning report"
    },
    "name": {
      "type": "string",
      "description": "Name of the vulnerability"
    }
  },
  "description": "List of all vulnerabilities of a Server"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Server not found

List of all vulnerabilities of a Server
GET/api/v1/servers/{id}/vulnerabilities

List of all vulnerabilities of a Server

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

POST /api/v1/servers/id/scan/stop
Requests
Body
{
  "get_report": true,
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "get_report": {
      "type": "boolean",
      "default": true,
      "description": "If getting the stopped report"
    },
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201

Stop running scan

Stop running scan
POST/api/v1/servers/{id}/scan/stop

Stop running scan

URI Parameters
id
number (required) 

POST /api/v1/servers/id/scan/start
Requests
Body
{
  "eva": true,
  "date": "Hello, world!",
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "eva": {
      "type": "boolean",
      "description": "eva enabled"
    },
    "date": {
      "type": "string",
      "description": "Scheduled scan"
    },
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401403404

Scan a server

Schema
{
  "type": "object",
  "properties": {
    "status_desc": {
      "type": "string",
      "description": "Current step of scanning"
    },
    "progression": {
      "type": "string",
      "description": "Scan progression"
    },
    "scheduled": {
      "type": "string",
      "format": "date-time",
      "description": "Next scheduled scan"
    },
    "instance_id": {
      "type": "string",
      "description": "Instance ID scanned"
    }
  },
  "description": "Scan a server"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Scan deactivated for this server

Server not found

Scan a server
POST/api/v1/servers/{id}/scan/start

Scan a server

URI Parameters
id
number (required) 

GET /api/v1/servers/id/monitor_definitions
Responses200401

Get Server’s monitor definitions

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "firewall_policy_id": {
      "type": "string",
      "description": "Linked firewall"
    },
    "subnet_id": {
      "type": "string",
      "description": "Linked subnet"
    },
    "server_id": {
      "type": "string",
      "description": "Linked server"
    },
    "parent_monitor_id": {
      "type": "string",
      "description": "Parent monitor definition"
    },
    "provider_id": {
      "type": "string",
      "description": "Linked provider"
    },
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Designated port"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get Monitor Definition associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Server's monitor definitions
GET/api/v1/servers/{id}/monitor_definitions

Get Server’s monitor definitions

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

PATCH /api/v1/servers/id/monitor_definitions/monitor_id
Requests
Body
{
  "activate_monitor": true,
  "activate_alert": true,
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "activate_monitor": {
      "type": "boolean",
      "description": "activate monitor"
    },
    "activate_alert": {
      "type": "boolean",
      "description": "activate event"
    },
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404417

Update Monitor Definition associated to the server

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "firewall_policy_id": {
      "type": "string",
      "description": "Linked firewall"
    },
    "subnet_id": {
      "type": "string",
      "description": "Linked subnet"
    },
    "server_id": {
      "type": "string",
      "description": "Linked server"
    },
    "parent_monitor_id": {
      "type": "string",
      "description": "Parent monitor definition"
    },
    "provider_id": {
      "type": "string",
      "description": "Linked provider"
    },
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Designated port"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get Monitor Definition associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Not Found

Wrong parameters

Update Monitor Definition associated to the server
PATCH/api/v1/servers/{id}/monitor_definitions/{monitor_id}

Update Monitor Definition associated to the server

URI Parameters
id
number (required) 
monitor_id
number (required) 

GET /api/v1/servers/id/monitor_definitions/monitor_id?worker_id=
Responses200401

Get Monitor Definition associated to the server

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "firewall_policy_id": {
      "type": "string",
      "description": "Linked firewall"
    },
    "subnet_id": {
      "type": "string",
      "description": "Linked subnet"
    },
    "server_id": {
      "type": "string",
      "description": "Linked server"
    },
    "parent_monitor_id": {
      "type": "string",
      "description": "Parent monitor definition"
    },
    "provider_id": {
      "type": "string",
      "description": "Linked provider"
    },
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Designated port"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get Monitor Definition associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Monitor Definition associated to the server
GET/api/v1/servers/{id}/monitor_definitions/{monitor_id}{?worker_id}

Get Monitor Definition associated to the server

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 
monitor_id
number (required) 

GET /api/v1/servers/id/monitor_definitions/monitor_id/status
Responses200401

Get Monitor Definition check value associated to the server

Schema
{
  "type": "object",
  "properties": {
    "output": {
      "type": "string",
      "description": "Value of the check"
    },
    "current_state": {
      "type": "integer",
      "format": "int32",
      "description": "Criticity of the status"
    },
    "date": {
      "type": "string",
      "format": "date-time",
      "description": "Check time"
    }
  },
  "description": "Get Monitor Definition check value associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Monitor Definition check value associated to the server
GET/api/v1/servers/{id}/monitor_definitions/{monitor_id}/status

Get Monitor Definition check value associated to the server

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 
monitor_id
number (required) 

POST /api/v1/servers/id/scan_policy
Requests
Body
{
  "policy_name": "Hello, world!",
  "worker_id": "Hello, world!",
  "scan_policy_attributes[timeout]": 1,
  "scan_policy_attributes[aggressivity]": 1,
  "scan_policy_attributes[intrusiveness]": true,
  "scan_policy_attributes[active_web_crawling]": true,
  "scan_policy_attributes[ssh_scan]": 1,
  "scan_policy_attributes[nmap_command]": "Hello, world!",
  "scan_policy_attributes[credential][clear_vm_smb_user]": "Hello, world!",
  "scan_policy_attributes[credential][clear_vm_smb_passwd]": "Hello, world!",
  "scan_policy_attributes[credential][clear_vm_ssh_user]": "Hello, world!",
  "scan_policy_attributes[credential][clear_vm_ssh_key]": "Hello, world!",
  "scan_policy_attributes[credential][authtype]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_url_login_page]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_credential_parameters_key_login]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_credential_parameters_value_login]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_credential_parameters_key_password]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_credential_parameters_value_password]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_credential_parameters_key_extra]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_credential_parameters_value_extra]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_url_check]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_url_check_keyword]": "Hello, world!",
  "scan_policy_attributes[credential][web_form_logout]": "Hello, world!",
  "scan_policy_attributes[credential][web_http_login]": "Hello, world!",
  "scan_policy_attributes[credential][web_http_password]": "Hello, world!",
  "scan_policy_attributes[credential][web_http_url_check]": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "policy_name": {
      "type": "string",
      "description": "Policy name"
    },
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    },
    "scan_policy_attributes[timeout]": {
      "type": "number",
      "default": 7200
    },
    "scan_policy_attributes[aggressivity]": {
      "type": "number",
      "default": 2
    },
    "scan_policy_attributes[intrusiveness]": {
      "type": "boolean",
      "default": true
    },
    "scan_policy_attributes[active_web_crawling]": {
      "type": "boolean",
      "default": true
    },
    "scan_policy_attributes[ssh_scan]": {
      "type": "number",
      "default": 22
    },
    "scan_policy_attributes[nmap_command]": {
      "type": "string"
    },
    "scan_policy_attributes[credential][clear_vm_smb_user]": {
      "type": "string",
      "description": "(Windows) Samba login"
    },
    "scan_policy_attributes[credential][clear_vm_smb_passwd]": {
      "type": "string",
      "description": "(Windows) Samba password"
    },
    "scan_policy_attributes[credential][clear_vm_ssh_user]": {
      "type": "string",
      "description": "(Linux) SSH user"
    },
    "scan_policy_attributes[credential][clear_vm_ssh_key]": {
      "type": "string",
      "description": "(Linux) SSH Private Key"
    },
    "scan_policy_attributes[credential][authtype]": {
      "type": "string",
      "default": "form",
      "description": "Type of web authentication : http or form"
    },
    "scan_policy_attributes[credential][web_form_url_login_page]": {
      "type": "string",
      "description": "(form) URL of login page"
    },
    "scan_policy_attributes[credential][web_form_credential_parameters_key_login]": {
      "type": "string",
      "description": "(form) Webform User Input Name"
    },
    "scan_policy_attributes[credential][web_form_credential_parameters_value_login]": {
      "type": "string",
      "description": "(form) Webform User Input Value"
    },
    "scan_policy_attributes[credential][web_form_credential_parameters_key_password]": {
      "type": "string",
      "description": "(form) Webform Password Input Name"
    },
    "scan_policy_attributes[credential][web_form_credential_parameters_value_password]": {
      "type": "string",
      "description": "(form) Webform Password Input Value"
    },
    "scan_policy_attributes[credential][web_form_credential_parameters_key_extra]": {
      "type": "string",
      "description": "(form) Webform Extra Field Name"
    },
    "scan_policy_attributes[credential][web_form_credential_parameters_value_extra]": {
      "type": "string",
      "description": "(form) Webform Extra Field Value"
    },
    "scan_policy_attributes[credential][web_form_url_check]": {
      "type": "string",
      "description": "(form) URL for checking"
    },
    "scan_policy_attributes[credential][web_form_url_check_keyword]": {
      "type": "string",
      "description": "(form) URL check keywords"
    },
    "scan_policy_attributes[credential][web_form_logout]": {
      "type": "string",
      "description": "(form) Logout string"
    },
    "scan_policy_attributes[credential][web_http_login]": {
      "type": "string",
      "description": "(http) Login"
    },
    "scan_policy_attributes[credential][web_http_password]": {
      "type": "string",
      "description": "(http) Password"
    },
    "scan_policy_attributes[credential][web_http_url_check]": {
      "type": "string",
      "description": "(http) URL check"
    }
  },
  "required": [
    "policy_name"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401

update Server’s scan policy

Schema
{
  "type": "object",
  "properties": {
    "policy_name": {
      "type": "string",
      "description": "Name of the policy"
    },
    "id": {
      "type": "string",
      "description": "Scan Policy ID ID"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the attribute"
        },
        "value": {
          "type": "string",
          "description": "Value of the attribute"
        }
      }
    }
  },
  "description": "Get Server's scan policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

update Server's scan policy
POST/api/v1/servers/{id}/scan_policy

update Server’s scan policy

URI Parameters
id
number (required) 

GET /api/v1/servers/id/scan_policy?worker_id=
Responses200401

Get Server’s scan policy

Schema
{
  "type": "object",
  "properties": {
    "policy_name": {
      "type": "string",
      "description": "Name of the policy"
    },
    "id": {
      "type": "string",
      "description": "Scan Policy ID ID"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the attribute"
        },
        "value": {
          "type": "string",
          "description": "Value of the attribute"
        }
      }
    }
  },
  "description": "Get Server's scan policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Server's scan policy
GET/api/v1/servers/{id}/scan_policy{?worker_id}

Get Server’s scan policy

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

account

Operations about accounts

GET /api/v1/account/exists
Responses200

Exists account

Exists account
GET/api/v1/account/exists

Exists account

URI Parameters
email
string (required) 

email


POST /api/v1/account
Requests
Body
{
  "account[email]": "Hello, world!",
  "account[full_name]": "Hello, world!",
  "account[name]": "Hello, world!",
  "account[accept_terms]": true,
  "account[timezone]": "Hello, world!",
  "account[telephone]": "Hello, world!",
  "account[license_type]": "Hello, world!",
  "account[company]": "Hello, world!",
  "account[ldap_account]": true,
  "account[password]": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "account[email]": {
      "type": "string",
      "description": "email"
    },
    "account[full_name]": {
      "type": "string",
      "description": "full name"
    },
    "account[name]": {
      "type": "string",
      "description": "name"
    },
    "account[accept_terms]": {
      "type": "boolean",
      "description": "terms and conditions"
    },
    "account[timezone]": {
      "type": "string",
      "description": "Timezone"
    },
    "account[telephone]": {
      "type": "string",
      "description": "telephone"
    },
    "account[license_type]": {
      "type": "string",
      "default": "monitoring",
      "description": "Audit or Monitoring account"
    },
    "account[company]": {
      "type": "string",
      "description": "company"
    },
    "account[ldap_account]": {
      "type": "boolean",
      "description": "ldap account"
    },
    "account[password]": {
      "type": "string",
      "description": "password"
    }
  },
  "required": [
    "account[email]",
    "account[full_name]",
    "account[name]",
    "account[accept_terms]",
    "account[timezone]",
    "account[password]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401403417

Create accounts

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the account"
    },
    "email": {
      "type": "string",
      "description": "Mail of the account"
    },
    "license_type": {
      "type": "string",
      "description": "State if the account is a Monitoring one or an Audit one"
    },
    "suspended": {
      "type": "string",
      "description": "Suspend state of account"
    }
  },
  "description": "Get account"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Public sign-up is disabled

Bad parameters

Schema
{
  "type": "object",
  "properties": {
    "errors": {
      "type": "object",
      "description": "Wrong parameters"
    }
  },
  "description": "Create accounts"
}

Create accounts
POST/api/v1/account

Create accounts


DELETE /api/v1/account/id/remove_user
Responses204401404

Remove user assignement to account (admin only)

Schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email linked to the user"
    },
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "full_name": {
      "type": "string",
      "description": "User's full name"
    }
  },
  "description": "Get specific user"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Remove user assignement to account (admin only)
DELETE/api/v1/account/{id}/remove_user

Remove user assignement to account (admin only)

URI Parameters
user_id
string (required) 

user id

id
number (required) 

POST /api/v1/account/id/assign_workers
Requests
Body
{
  "worker_ids": []
}
Schema
{
  "type": "object",
  "properties": {
    "worker_ids": {
      "type": "array",
      "description": "worker list of ids\n\n+"
    }
  },
  "required": [
    "worker_ids"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Assign workers to account (admin only)

Schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email linked to the user"
    },
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "full_name": {
      "type": "string",
      "description": "User's full name"
    }
  },
  "description": "Get specific user"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Assign workers to account (admin only)
POST/api/v1/account/{id}/assign_workers

Assign workers to account (admin only)

URI Parameters
id
number (required) 

GET /api/v1/account/id/assigned_workers
Responses200401404

List workers to account (admin only)

Schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email linked to the user"
    },
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "full_name": {
      "type": "string",
      "description": "User's full name"
    }
  },
  "description": "Get specific user"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

List workers to account (admin only)
GET/api/v1/account/{id}/assigned_workers

List workers to account (admin only)

URI Parameters
id
number (required) 

POST /api/v1/account/id/add_user
Requests
Body
{
  "user_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "description": "user id"
    }
  },
  "required": [
    "user_id"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Assign user to account (admin only)

Schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email linked to the user"
    },
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "full_name": {
      "type": "string",
      "description": "User's full name"
    }
  },
  "description": "Get specific user"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Assign user to account (admin only)
POST/api/v1/account/{id}/add_user

Assign user to account (admin only)

URI Parameters
id
number (required) 

DELETE /api/v1/account/id
Responses204401404

Delete Account

Unauthorized

Account not found

Delete Account
DELETE/api/v1/account/{id}

Delete Account

URI Parameters
id
number (required) 

PATCH /api/v1/account/id
Requests
Body
{
  "account[full_name]": "Hello, world!",
  "account[timezone]": "Hello, world!",
  "account[telephone]": "Hello, world!",
  "account[company]": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "account[full_name]": {
      "type": "string",
      "description": "full name"
    },
    "account[timezone]": {
      "type": "string",
      "description": "Timezone"
    },
    "account[telephone]": {
      "type": "string",
      "description": "telephone"
    },
    "account[company]": {
      "type": "string",
      "description": "company"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404417

Edit account

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the account"
    },
    "email": {
      "type": "string",
      "description": "Mail of the account"
    },
    "license_type": {
      "type": "string",
      "description": "State if the account is a Monitoring one or an Audit one"
    },
    "suspended": {
      "type": "string",
      "description": "Suspend state of account"
    }
  },
  "description": "Get account"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Wrong parameters

Edit account
PATCH/api/v1/account/{id}

Edit account

URI Parameters
id
number (required) 

GET /api/v1/account/id
Responses200401404

Get account

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the account"
    },
    "email": {
      "type": "string",
      "description": "Mail of the account"
    },
    "license_type": {
      "type": "string",
      "description": "State if the account is a Monitoring one or an Audit one"
    },
    "suspended": {
      "type": "string",
      "description": "Suspend state of account"
    }
  },
  "description": "Get account"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Get account
GET/api/v1/account/{id}

Get account

URI Parameters
id
number (required) 

POST /api/v1/account/id/unsuspend
Responses201401404

Unsuspend account

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the account"
    },
    "email": {
      "type": "string",
      "description": "Mail of the account"
    },
    "license_type": {
      "type": "string",
      "description": "State if the account is a Monitoring one or an Audit one"
    },
    "suspended": {
      "type": "string",
      "description": "Suspend state of account"
    }
  },
  "description": "Get account"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Unsuspend account
POST/api/v1/account/{id}/unsuspend

Unsuspend account

URI Parameters
id
number (required) 

POST /api/v1/account/id/suspend
Responses201401403404

Suspend account

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the account"
    },
    "email": {
      "type": "string",
      "description": "Mail of the account"
    },
    "license_type": {
      "type": "string",
      "description": "State if the account is a Monitoring one or an Audit one"
    },
    "suspended": {
      "type": "string",
      "description": "Suspend state of account"
    }
  },
  "description": "Get account"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Can’t suspend Admin

Account not found

Suspend account
POST/api/v1/account/{id}/suspend

Suspend account

URI Parameters
id
number (required) 

GET /api/v1/account/id/users
Responses200401404

Get list of users

Schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email linked to the user"
    },
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "full_name": {
      "type": "string",
      "description": "User's full name"
    }
  },
  "description": "Get specific user"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Get list of users
GET/api/v1/account/{id}/users

Get list of users

URI Parameters
id
number (required) 

users

Operations about users

POST /api/v1/users/create
Requests
Body
{
  "user[ldap_user]": true,
  "user[email]": "Hello, world!",
  "user[password]": "Hello, world!",
  "user[name]": "Hello, world!",
  "user[full_name]": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "user[ldap_user]": {
      "type": "boolean",
      "description": "Is a LDAP user ?"
    },
    "user[email]": {
      "type": "string",
      "description": "email"
    },
    "user[password]": {
      "type": "string",
      "description": "password"
    },
    "user[name]": {
      "type": "string",
      "description": "name"
    },
    "user[full_name]": {
      "type": "string",
      "description": "full name"
    }
  },
  "required": [
    "user[ldap_user]",
    "user[email]",
    "user[password]",
    "user[name]",
    "user[full_name]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404417

Create user for account

Schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email linked to the user"
    },
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "full_name": {
      "type": "string",
      "description": "User's full name"
    }
  },
  "description": "Get specific user"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Wrong parameters

Create user for account
POST/api/v1/users/create

Create user for account


GET /api/v1/users
Responses200401

Get list of all users

Schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email linked to the user"
    },
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "full_name": {
      "type": "string",
      "description": "User's full name"
    }
  },
  "description": "Get specific user"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get list of all users
GET/api/v1/users

Get list of all users


DELETE /api/v1/users/id/access_token?account_id=
Responses204

Delete access token

Delete access token
DELETE/api/v1/users/{id}/access_token{?account_id}

Delete access token

URI Parameters
account_id
string (required) 

account id

id
number (required) 

GET /api/v1/users/id/access_token?account_id=
Responses200

Get access token

Get access token
GET/api/v1/users/{id}/access_token{?account_id}

Get access token

URI Parameters
account_id
string (required) 

account id

id
number (required) 

POST /api/v1/users/id/access_token
Requests
Body
{
  "account_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "account id"
    }
  },
  "required": [
    "account_id"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201

Create access token

Create access token
POST/api/v1/users/{id}/access_token

Create access token

URI Parameters
id
number (required) 

DELETE /api/v1/users/id/remove_account
Responses204

Remove account assignement (admin only)

Remove account assignement (admin only)
DELETE/api/v1/users/{id}/remove_account

Remove account assignement (admin only)

URI Parameters
account_id
string (required) 

account id

id
number (required) 

POST /api/v1/users/id/add_account
Requests
Body
{
  "account_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "account id"
    }
  },
  "required": [
    "account_id"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404417

Assign account to authentificated user(admin only)

Schema
{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "description": "Linked with a user"
    },
    "account_id": {
      "type": "string",
      "description": "Linked with an account"
    },
    "role": {
      "type": "string"
    }
  },
  "description": "Get all roles"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Wrong parameters

Assign account to authentificated user(admin only)
POST/api/v1/users/{id}/add_account

Assign account to authentificated user(admin only)

URI Parameters
id
number (required) 

DELETE /api/v1/users/id
Responses204401404

Delete user

Schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email linked to the user"
    },
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "full_name": {
      "type": "string",
      "description": "User's full name"
    }
  },
  "description": "Get specific user"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

User not found

Delete user
DELETE/api/v1/users/{id}

Delete user

URI Parameters
id
number (required) 

GET /api/v1/users/id
Responses200401404

Get specific user

Schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "email linked to the user"
    },
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "full_name": {
      "type": "string",
      "description": "User's full name"
    }
  },
  "description": "Get specific user"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

User not found

Get specific user
GET/api/v1/users/{id}

Get specific user

URI Parameters
id
number (required) 

licence

Operations about licences

POST /api/v1/licence/grant
Requests
Body
{
  "license[account_id]": "Hello, world!",
  "license[tokens]": 1,
  "license[until]": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "license[account_id]": {
      "type": "string",
      "description": "account id"
    },
    "license[tokens]": {
      "type": "number",
      "description": "number of tokens"
    },
    "license[until]": {
      "type": "string",
      "description": "expiry date"
    }
  },
  "required": [
    "license[account_id]",
    "license[tokens]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201400401404

Grant tokens to accounts

Schema
{
  "type": "object",
  "properties": {
    "monitoring_tokens": {
      "type": "integer",
      "format": "int32",
      "description": "Number of monitoring tokens granted by the licence"
    },
    "audit_tokens": {
      "type": "integer",
      "format": "int32",
      "description": "Number of auditoring token granted by the licence"
    },
    "begin_date": {
      "type": "string",
      "format": "date-time",
      "description": "Beginning date of the licence"
    },
    "duration": {
      "type": "integer",
      "format": "int32",
      "description": "Duration of the licence (in days)"
    },
    "remaining_tokens": {
      "type": "object",
      "description": "Remaining tokens to be allocated"
    }
  },
  "description": "Get ED licence"
}

Wrong repartition

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Account not found

Grant tokens to accounts
POST/api/v1/licence/grant

Grant tokens to accounts


POST /api/v1/licence/add
Requests
Body
{
  "shadow": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "shadow": {
      "type": "string",
      "description": "Elastic Workload Protector license"
    }
  },
  "required": [
    "shadow"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401417

Add licence

Schema
{
  "type": "object",
  "properties": {
    "monitoring_tokens": {
      "type": "integer",
      "format": "int32",
      "description": "Number of monitoring tokens granted by the licence"
    },
    "audit_tokens": {
      "type": "integer",
      "format": "int32",
      "description": "Number of auditoring token granted by the licence"
    },
    "begin_date": {
      "type": "string",
      "format": "date-time",
      "description": "Beginning date of the licence"
    },
    "duration": {
      "type": "integer",
      "format": "int32",
      "description": "Duration of the licence (in days)"
    },
    "remaining_tokens": {
      "type": "object",
      "description": "Remaining tokens to be allocated"
    }
  },
  "description": "Get ED licence"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Wrong license

Add licence
POST/api/v1/licence/add

Add licence


GET /api/v1/licence/mine
Responses200401

Get Account licence

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the account"
    },
    "email": {
      "type": "string",
      "description": "Mail of the account"
    },
    "license_type": {
      "type": "string",
      "description": "State if the account is a Monitoring one or an Audit one"
    },
    "suspended": {
      "type": "string",
      "description": "Suspend state of account"
    },
    "expiry_date": {
      "type": "string",
      "format": "date",
      "description": "Expiry date of tokens allocated to account"
    },
    "tokens": {
      "type": "integer",
      "format": "int32",
      "description": "Number of tokens granted to the account"
    },
    "remaining": {
      "type": "integer",
      "format": "int32",
      "description": "Number of remaining granted tokens for the account"
    },
    "type": {
      "type": "string",
      "description": "Account license type"
    }
  },
  "description": "Get Account licence"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Account licence
GET/api/v1/licence/mine

Get Account licence


GET /api/v1/licence
Responses200401

Get ED licence

Schema
{
  "type": "object",
  "properties": {
    "monitoring_tokens": {
      "type": "integer",
      "format": "int32",
      "description": "Number of monitoring tokens granted by the licence"
    },
    "audit_tokens": {
      "type": "integer",
      "format": "int32",
      "description": "Number of auditoring token granted by the licence"
    },
    "begin_date": {
      "type": "string",
      "format": "date-time",
      "description": "Beginning date of the licence"
    },
    "duration": {
      "type": "integer",
      "format": "int32",
      "description": "Duration of the licence (in days)"
    },
    "remaining_tokens": {
      "type": "object",
      "description": "Remaining tokens to be allocated"
    }
  },
  "description": "Get ED licence"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get ED licence
GET/api/v1/licence

Get ED licence


providers

Operations about providers

POST /api/v1/providers
Requests
Body
{
  "provider[network][name]": "Hello, world!",
  "provider[network][cidr_block]": "Hello, world!",
  "provider[network][nmap_options]": "Hello, world!",
  "provider[network][nmap_advanced_options]": "Hello, world!",
  "provider[ec2][name]": "Hello, world!",
  "provider[ec2][ec2_access_id]": "Hello, world!",
  "provider[ec2][ec2_access_key]": "Hello, world!",
  "provider[ec2][regions]": [],
  "provider[vsphere][name]": "Hello, world!",
  "provider[vsphere][vsphere_endpoint]": "Hello, world!",
  "provider[vsphere][vsphere_username]": "Hello, world!",
  "provider[vsphere][vsphere_password]": "Hello, world!",
  "provider[azure][name]": "Hello, world!",
  "provider[azure][azure_tenant]": "Hello, world!",
  "provider[azure][azure_client_id]": "Hello, world!",
  "provider[azure][azure_client_secret]": "Hello, world!",
  "provider[hyperv][name]": "Hello, world!",
  "provider[hyperv][hyperv_address]": "Hello, world!",
  "provider[hyperv][hyperv_username]": "Hello, world!",
  "provider[hyperv][hyperv_password]": "Hello, world!",
  "provider[cloudstack][name]": "Hello, world!",
  "provider[cloudstack][cloudstack_api_key]": "Hello, world!",
  "provider[cloudstack][cloudstack_secret_access]": "Hello, world!",
  "provider[cloudstack][cloudstack_endpoint]": "Hello, world!",
  "provider[worker_id]": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "provider[network][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[network][cidr_block]": {
      "type": "string",
      "description": "cidr block"
    },
    "provider[network][nmap_options]": {
      "type": "string",
      "description": "scan mode"
    },
    "provider[network][nmap_advanced_options]": {
      "type": "string",
      "description": "nmap custom options (advanced)"
    },
    "provider[ec2][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[ec2][ec2_access_id]": {
      "type": "string",
      "description": "Access key"
    },
    "provider[ec2][ec2_access_key]": {
      "type": "string",
      "description": "Scret access key"
    },
    "provider[ec2][regions]": {
      "type": "array",
      "description": "+"
    },
    "provider[vsphere][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[vsphere][vsphere_endpoint]": {
      "type": "string",
      "description": "API Endpoint"
    },
    "provider[vsphere][vsphere_username]": {
      "type": "string",
      "description": "username"
    },
    "provider[vsphere][vsphere_password]": {
      "type": "string",
      "description": "password"
    },
    "provider[azure][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[azure][azure_tenant]": {
      "type": "string",
      "description": "Tenant of Azure Account"
    },
    "provider[azure][azure_client_id]": {
      "type": "string",
      "description": "Client id of ewp app"
    },
    "provider[azure][azure_client_secret]": {
      "type": "string",
      "description": "Client secret of ewp app"
    },
    "provider[hyperv][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[hyperv][hyperv_address]": {
      "type": "string",
      "description": "Hyper-V Address"
    },
    "provider[hyperv][hyperv_username]": {
      "type": "string",
      "description": "Username"
    },
    "provider[hyperv][hyperv_password]": {
      "type": "string",
      "description": "Password"
    },
    "provider[cloudstack][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[cloudstack][cloudstack_api_key]": {
      "type": "string",
      "description": "Api Key"
    },
    "provider[cloudstack][cloudstack_secret_access]": {
      "type": "string",
      "description": "Secret Access Key"
    },
    "provider[cloudstack][cloudstack_endpoint]": {
      "type": "string",
      "description": "API Endpoint"
    },
    "provider[worker_id]": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "required": [
    "provider[network][name]",
    "provider[network][cidr_block]",
    "provider[network][nmap_options]",
    "provider[ec2][name]",
    "provider[ec2][ec2_access_id]",
    "provider[ec2][ec2_access_key]",
    "provider[ec2][regions]",
    "provider[vsphere][name]",
    "provider[vsphere][vsphere_endpoint]",
    "provider[vsphere][vsphere_username]",
    "provider[vsphere][vsphere_password]",
    "provider[azure][name]",
    "provider[azure][azure_tenant]",
    "provider[azure][azure_client_id]",
    "provider[azure][azure_client_secret]",
    "provider[hyperv][name]",
    "provider[hyperv][hyperv_address]",
    "provider[hyperv][hyperv_username]",
    "provider[hyperv][hyperv_password]",
    "provider[cloudstack][name]",
    "provider[cloudstack][cloudstack_api_key]",
    "provider[cloudstack][cloudstack_secret_access]",
    "provider[cloudstack][cloudstack_endpoint]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401417

Creates provider

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name given to the provider"
    },
    "id": {
      "type": "string",
      "description": "Provider ID"
    },
    "api_endpoint": {
      "type": "string",
      "description": "End-point of the provider (API access)"
    },
    "account_id": {
      "type": "string",
      "description": "Account linked to the provider"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "type": {
      "type": "string",
      "description": "Type of provider"
    }
  },
  "description": "Get Infrastructure provider linked"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Wrong parameters

Creates provider
POST/api/v1/providers

Creates provider


GET /api/v1/providers
Responses200401

List providers of authenticated user

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name given to the provider"
    },
    "id": {
      "type": "string",
      "description": "Provider ID"
    },
    "api_endpoint": {
      "type": "string",
      "description": "End-point of the provider (API access)"
    },
    "account_id": {
      "type": "string",
      "description": "Account linked to the provider"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "type": {
      "type": "string",
      "description": "Type of provider"
    }
  },
  "description": "Get Infrastructure provider linked"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

List providers of authenticated user
GET/api/v1/providers

List providers of authenticated user


GET /api/v1/providers/id/subnets
Requests
Body
{
  "tags[server]": [],
  "tags[firewall]": [],
  "tags[provider]": [],
  "tags[subnet]": [],
  "tags[provider_type]": [],
  "tags[custom]": []
}
Schema
{
  "type": "object",
  "properties": {
    "tags[server]": {
      "type": "array",
      "description": "ID of servers\n\n+"
    },
    "tags[firewall]": {
      "type": "array",
      "description": "ID of firewalls\n\n+"
    },
    "tags[provider]": {
      "type": "array",
      "description": "ID of provider\n\n+"
    },
    "tags[subnet]": {
      "type": "array",
      "description": "ID of subnet\n\n+"
    },
    "tags[provider_type]": {
      "type": "array",
      "description": "Provider type\n\n+"
    },
    "tags[custom]": {
      "type": "array",
      "description": "Name of custom tags\n\n+"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404

Get Subnets

Schema
{
  "type": "object",
  "properties": {
    "cidr_block": {
      "type": "string",
      "description": "IP range of the subnet"
    },
    "name": {
      "type": "string",
      "description": "Name of the Subnet"
    },
    "uuid": {
      "type": "string",
      "description": "UUID of the Subnet"
    },
    "vpc_id": {
      "type": "string",
      "description": "VPC ID linked to the Subnet"
    }
  },
  "description": "Get Subnets"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Get Subnets
GET/api/v1/providers/{id}/subnets

Get Subnets

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/providers/id/servers
Requests
Body
{
  "tags[server]": [],
  "tags[firewall]": [],
  "tags[provider]": [],
  "tags[subnet]": [],
  "tags[provider_type]": [],
  "tags[custom]": []
}
Schema
{
  "type": "object",
  "properties": {
    "tags[server]": {
      "type": "array",
      "description": "ID of servers\n\n+"
    },
    "tags[firewall]": {
      "type": "array",
      "description": "ID of firewalls\n\n+"
    },
    "tags[provider]": {
      "type": "array",
      "description": "ID of provider\n\n+"
    },
    "tags[subnet]": {
      "type": "array",
      "description": "ID of subnet\n\n+"
    },
    "tags[provider_type]": {
      "type": "array",
      "description": "Provider type\n\n+"
    },
    "tags[custom]": {
      "type": "array",
      "description": "Name of custom tags\n\n+"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404

Get Servers

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Get Servers
GET/api/v1/providers/{id}/servers

Get Servers

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/providers/id/firewall_policies
Requests
Body
{
  "tags[server]": [],
  "tags[firewall]": [],
  "tags[provider]": [],
  "tags[subnet]": [],
  "tags[provider_type]": [],
  "tags[custom]": []
}
Schema
{
  "type": "object",
  "properties": {
    "tags[server]": {
      "type": "array",
      "description": "ID of servers\n\n+"
    },
    "tags[firewall]": {
      "type": "array",
      "description": "ID of firewalls\n\n+"
    },
    "tags[provider]": {
      "type": "array",
      "description": "ID of provider\n\n+"
    },
    "tags[subnet]": {
      "type": "array",
      "description": "ID of subnet\n\n+"
    },
    "tags[provider_type]": {
      "type": "array",
      "description": "Provider type\n\n+"
    },
    "tags[custom]": {
      "type": "array",
      "description": "Name of custom tags\n\n+"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404

Get Firewall Policies

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the Firewall Policy"
    },
    "sgid": {
      "type": "string",
      "description": "UUID of the Firewall Policy"
    },
    "id": {
      "type": "string",
      "description": "ID of the Firewall Policy"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    }
  },
  "description": "Ignore Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Get Firewall Policies
GET/api/v1/providers/{id}/firewall_policies

Get Firewall Policies

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/providers/id?worker_id=
Responses200401404

Get provider

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name given to the provider"
    },
    "id": {
      "type": "string",
      "description": "Provider ID"
    },
    "api_endpoint": {
      "type": "string",
      "description": "End-point of the provider (API access)"
    },
    "account_id": {
      "type": "string",
      "description": "Account linked to the provider"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "type": {
      "type": "string",
      "description": "Type of provider"
    }
  },
  "description": "Get Infrastructure provider linked"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Get provider
GET/api/v1/providers/{id}{?worker_id}

Get provider

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

PATCH /api/v1/providers/id
Requests
Body
{
  "provider[ec2][name]": "Hello, world!",
  "provider[ec2][ec2_access_id]": "Hello, world!",
  "provider[ec2][ec2_access_key]": "Hello, world!",
  "provider[ec2][regions]": [],
  "provider[network][name]": "Hello, world!",
  "provider[network][cidr_block]": "Hello, world!",
  "provider[network][nmap_options]": "Hello, world!",
  "provider[network][nmap_advanced_options]": "Hello, world!",
  "provider[vsphere][name]": "Hello, world!",
  "provider[vsphere][vsphere_endpoint]": "Hello, world!",
  "provider[vsphere][vsphere_username]": "Hello, world!",
  "provider[vsphere][vsphere_password]": "Hello, world!",
  "provider[azure][name]": "Hello, world!",
  "provider[azure][azure_tenant]": "Hello, world!",
  "provider[azure][azure_client_id]": "Hello, world!",
  "provider[azure][azure_client_secret]": "Hello, world!",
  "provider[hyperv][name]": "Hello, world!",
  "provider[hyperv][hyperv_address]": "Hello, world!",
  "provider[hyperv][hyperv_username]": "Hello, world!",
  "provider[hyperv][hyperv_password]": "Hello, world!",
  "provider[cloudstack][name]": "Hello, world!",
  "provider[cloudstack][cloudstack_api_key]": "Hello, world!",
  "provider[cloudstack][cloudstack_secret_access]": "Hello, world!",
  "provider[cloudstack][cloudstack_endpoint]": "Hello, world!",
  "provider[worker_id]": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "provider[ec2][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[ec2][ec2_access_id]": {
      "type": "string",
      "description": "Access key"
    },
    "provider[ec2][ec2_access_key]": {
      "type": "string",
      "description": "Scret access key"
    },
    "provider[ec2][regions]": {
      "type": "array",
      "description": "+"
    },
    "provider[network][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[network][cidr_block]": {
      "type": "string",
      "description": "cidr block"
    },
    "provider[network][nmap_options]": {
      "type": "string",
      "description": "scan mode"
    },
    "provider[network][nmap_advanced_options]": {
      "type": "string",
      "description": "nmap custom options (advanced)"
    },
    "provider[vsphere][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[vsphere][vsphere_endpoint]": {
      "type": "string",
      "description": "API Endpoint"
    },
    "provider[vsphere][vsphere_username]": {
      "type": "string",
      "description": "username"
    },
    "provider[vsphere][vsphere_password]": {
      "type": "string",
      "description": "password"
    },
    "provider[azure][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[azure][azure_tenant]": {
      "type": "string",
      "description": "Tenant of the Azure account"
    },
    "provider[azure][azure_client_id]": {
      "type": "string",
      "description": "Client id of ewp app"
    },
    "provider[azure][azure_client_secret]": {
      "type": "string",
      "description": "Client secret of ewp app"
    },
    "provider[hyperv][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[hyperv][hyperv_address]": {
      "type": "string",
      "description": "Hyper-V Address"
    },
    "provider[hyperv][hyperv_username]": {
      "type": "string",
      "description": "Username"
    },
    "provider[hyperv][hyperv_password]": {
      "type": "string",
      "description": "Password"
    },
    "provider[cloudstack][name]": {
      "type": "string",
      "description": "name"
    },
    "provider[cloudstack][cloudstack_api_key]": {
      "type": "string",
      "description": "Api Key"
    },
    "provider[cloudstack][cloudstack_secret_access]": {
      "type": "string",
      "description": "Secret Access Key"
    },
    "provider[cloudstack][cloudstack_endpoint]": {
      "type": "string",
      "description": "API Endpoint"
    },
    "provider[worker_id]": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404417

Update provider

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name given to the provider"
    },
    "id": {
      "type": "string",
      "description": "Provider ID"
    },
    "api_endpoint": {
      "type": "string",
      "description": "End-point of the provider (API access)"
    },
    "account_id": {
      "type": "string",
      "description": "Account linked to the provider"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "type": {
      "type": "string",
      "description": "Type of provider"
    }
  },
  "description": "Get Infrastructure provider linked"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Not Found

Wrong parameters

Update provider
PATCH/api/v1/providers/{id}

Update provider

URI Parameters
id
number (required) 

GET /api/v1/providers/id/discover
Responses200401404

Poll provider

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Poll provider
GET/api/v1/providers/{id}/discover

Poll provider

URI Parameters
id
number (required) 

POST /api/v1/providers/id/unignore
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Unignore CP

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name given to the provider"
    },
    "id": {
      "type": "string",
      "description": "Provider ID"
    },
    "api_endpoint": {
      "type": "string",
      "description": "End-point of the provider (API access)"
    },
    "account_id": {
      "type": "string",
      "description": "Account linked to the provider"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "type": {
      "type": "string",
      "description": "Type of provider"
    }
  },
  "description": "Get Infrastructure provider linked"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Unignore CP
POST/api/v1/providers/{id}/unignore

Unignore CP

URI Parameters
id
number (required) 

POST /api/v1/providers/id/ignore
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Ignore CP

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name given to the provider"
    },
    "id": {
      "type": "string",
      "description": "Provider ID"
    },
    "api_endpoint": {
      "type": "string",
      "description": "End-point of the provider (API access)"
    },
    "account_id": {
      "type": "string",
      "description": "Account linked to the provider"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "type": {
      "type": "string",
      "description": "Type of provider"
    }
  },
  "description": "Get Infrastructure provider linked"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Ignore CP
POST/api/v1/providers/{id}/ignore

Ignore CP

URI Parameters
id
number (required) 

GET /api/v1/providers/id/alerts
Responses200401404

Get alerts of provider

Schema
{
  "type": "object",
  "properties": {
    "level": {
      "type": "integer",
      "format": "int32",
      "description": "Rate criticity from 0 to 2, where 0 is good and 2 critical (-1 is unknown)"
    },
    "last_update": {
      "type": "string",
      "format": "date-time",
      "description": "Last time the alert has been seen"
    },
    "message": {
      "type": "string",
      "description": "Description of the alert"
    },
    "monitor_definition_id": {
      "type": "string",
      "description": "ID of Monitor raising the alert"
    },
    "monitor_name": {
      "type": "string",
      "description": "Monitor name"
    }
  },
  "description": "Firewall Policy's alerts"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Get alerts of provider
GET/api/v1/providers/{id}/alerts

Get alerts of provider

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

POST /api/v1/providers/id/unmonitor
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Unmonitor servers of provider

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Unmonitor servers of provider
POST/api/v1/providers/{id}/unmonitor

Unmonitor servers of provider

URI Parameters
id
number (required) 

POST /api/v1/providers/id/monitor
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Monitor servers of provider

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not found

Monitor servers of provider
POST/api/v1/providers/{id}/monitor

Monitor servers of provider

URI Parameters
id
number (required) 

GET /api/v1/providers/id/risks
Responses200401404

Get Provider’s active risk

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Provider not Found

Get Provider's active risk
GET/api/v1/providers/{id}/risks

Get Provider’s active risk

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/providers/id/monitor_definitions
Responses200401

Get Provider’s monitor_definitions

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "firewall_policy_id": {
      "type": "string",
      "description": "Linked firewall"
    },
    "subnet_id": {
      "type": "string",
      "description": "Linked subnet"
    },
    "server_id": {
      "type": "string",
      "description": "Linked server"
    },
    "parent_monitor_id": {
      "type": "string",
      "description": "Parent monitor definition"
    },
    "provider_id": {
      "type": "string",
      "description": "Linked provider"
    },
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Designated port"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get Monitor Definition associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Provider's monitor_definitions
GET/api/v1/providers/{id}/monitor_definitions

Get Provider’s monitor_definitions

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

PATCH /api/v1/providers/id/monitor_definitions/monitor_id
Requests
Body
{
  "activate_monitor": true,
  "activate_alert": true,
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "activate_monitor": {
      "type": "boolean",
      "description": "activate monitor"
    },
    "activate_alert": {
      "type": "boolean",
      "description": "activate event"
    },
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404417

Update Monitor Definition associated to the provider

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "firewall_policy_id": {
      "type": "string",
      "description": "Linked firewall"
    },
    "subnet_id": {
      "type": "string",
      "description": "Linked subnet"
    },
    "server_id": {
      "type": "string",
      "description": "Linked server"
    },
    "parent_monitor_id": {
      "type": "string",
      "description": "Parent monitor definition"
    },
    "provider_id": {
      "type": "string",
      "description": "Linked provider"
    },
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Designated port"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get Monitor Definition associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Not Found

Wrong parameters

Update Monitor Definition associated to the provider
PATCH/api/v1/providers/{id}/monitor_definitions/{monitor_id}

Update Monitor Definition associated to the provider

URI Parameters
id
number (required) 
monitor_id
number (required) 

GET /api/v1/providers/id/monitor_definitions/monitor_id
Responses200401

Get Monitor Definition associated to the provider

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "firewall_policy_id": {
      "type": "string",
      "description": "Linked firewall"
    },
    "subnet_id": {
      "type": "string",
      "description": "Linked subnet"
    },
    "server_id": {
      "type": "string",
      "description": "Linked server"
    },
    "parent_monitor_id": {
      "type": "string",
      "description": "Parent monitor definition"
    },
    "provider_id": {
      "type": "string",
      "description": "Linked provider"
    },
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Designated port"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get Monitor Definition associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Monitor Definition associated to the provider
GET/api/v1/providers/{id}/monitor_definitions/{monitor_id}

Get Monitor Definition associated to the provider

URI Parameters
id
number (required) 
monitor_id
number (required) 

GET /api/v1/providers/id/monitor_definitions/monitor_id/status
Responses200401

Get Monitor Definition check value associated to the provider

Schema
{
  "type": "object",
  "properties": {
    "output": {
      "type": "string",
      "description": "Value of the check"
    },
    "current_state": {
      "type": "integer",
      "format": "int32",
      "description": "Criticity of the status"
    },
    "date": {
      "type": "string",
      "format": "date-time",
      "description": "Check time"
    }
  },
  "description": "Get Monitor Definition check value associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Monitor Definition check value associated to the provider
GET/api/v1/providers/{id}/monitor_definitions/{monitor_id}/status

Get Monitor Definition check value associated to the provider

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 
monitor_id
number (required) 

firewall_policies

Operations about firewall_policies

GET /api/v1/firewall_policies
Responses200401

List firewall policies of authenticated user

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the Firewall Policy"
    },
    "sgid": {
      "type": "string",
      "description": "UUID of the Firewall Policy"
    },
    "id": {
      "type": "string",
      "description": "ID of the Firewall Policy"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    }
  },
  "description": "Ignore Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

List firewall policies of authenticated user
GET/api/v1/firewall_policies

List firewall policies of authenticated user

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)


GET /api/v1/firewall_policies/id/servers
Requests
Body
{
  "tags[server]": [],
  "tags[firewall]": [],
  "tags[provider]": [],
  "tags[subnet]": [],
  "tags[provider_type]": [],
  "tags[custom]": []
}
Schema
{
  "type": "object",
  "properties": {
    "tags[server]": {
      "type": "array",
      "description": "ID of servers\n\n+"
    },
    "tags[firewall]": {
      "type": "array",
      "description": "ID of firewalls\n\n+"
    },
    "tags[provider]": {
      "type": "array",
      "description": "ID of provider\n\n+"
    },
    "tags[subnet]": {
      "type": "array",
      "description": "ID of subnet\n\n+"
    },
    "tags[provider_type]": {
      "type": "array",
      "description": "Provider type\n\n+"
    },
    "tags[custom]": {
      "type": "array",
      "description": "Name of custom tags\n\n+"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404

Get servers from firewall policy

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Firewall Policy not found

Get servers from firewall policy
GET/api/v1/firewall_policies/{id}/servers

Get servers from firewall policy

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/firewall_policies/id/permissions
Responses200401404

Get permission from firewall policy

Schema
{
  "type": "object",
  "properties": {
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Permission port"
    },
    "protocol": {
      "type": "string",
      "description": "Protocol used for the permission"
    },
    "dest_port": {
      "type": "integer",
      "format": "int32",
      "description": "Range of ports (starting at port to dest_port)"
    },
    "acl": {
      "type": "string",
      "description": "IP range where permission works"
    },
    "accessing_sg_id": {
      "type": "string",
      "description": "Security Group (provider) ID concerned by the permission"
    },
    "egress": {
      "type": "boolean",
      "description": "States whether the permission allow incoming/outgoing traffic"
    }
  },
  "description": "Get permission from firewall policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Firewall Policy not found

Get permission from firewall policy
GET/api/v1/firewall_policies/{id}/permissions

Get permission from firewall policy

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/firewall_policies/id
Responses200401404

Get a firewall policy

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the Firewall Policy"
    },
    "sgid": {
      "type": "string",
      "description": "UUID of the Firewall Policy"
    },
    "id": {
      "type": "string",
      "description": "ID of the Firewall Policy"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    }
  },
  "description": "Ignore Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Firewall Policy not found

Get a firewall policy
GET/api/v1/firewall_policies/{id}

Get a firewall policy

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/firewall_policies/id/provider
Responses200401404

Get Infrastructure provider linked

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name given to the provider"
    },
    "id": {
      "type": "string",
      "description": "Provider ID"
    },
    "api_endpoint": {
      "type": "string",
      "description": "End-point of the provider (API access)"
    },
    "account_id": {
      "type": "string",
      "description": "Account linked to the provider"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "type": {
      "type": "string",
      "description": "Type of provider"
    }
  },
  "description": "Get Infrastructure provider linked"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Firewall Policy not found

Get Infrastructure provider linked
GET/api/v1/firewall_policies/{id}/provider

Get Infrastructure provider linked

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

POST /api/v1/firewall_policies/id/unignore
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Unignore Firewall Policy

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the Firewall Policy"
    },
    "sgid": {
      "type": "string",
      "description": "UUID of the Firewall Policy"
    },
    "id": {
      "type": "string",
      "description": "ID of the Firewall Policy"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    }
  },
  "description": "Ignore Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Firewall Policy not found

Unignore Firewall Policy
POST/api/v1/firewall_policies/{id}/unignore

Unignore Firewall Policy

URI Parameters
id
number (required) 

POST /api/v1/firewall_policies/id/ignore
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401404

Ignore Firewall Policy

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the Firewall Policy"
    },
    "sgid": {
      "type": "string",
      "description": "UUID of the Firewall Policy"
    },
    "id": {
      "type": "string",
      "description": "ID of the Firewall Policy"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    }
  },
  "description": "Ignore Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Firewall Policy not found

Ignore Firewall Policy
POST/api/v1/firewall_policies/{id}/ignore

Ignore Firewall Policy

URI Parameters
id
number (required) 

GET /api/v1/firewall_policies/id/alerts
Responses200401404

Firewall Policy’s alerts

Schema
{
  "type": "object",
  "properties": {
    "level": {
      "type": "integer",
      "format": "int32",
      "description": "Rate criticity from 0 to 2, where 0 is good and 2 critical (-1 is unknown)"
    },
    "last_update": {
      "type": "string",
      "format": "date-time",
      "description": "Last time the alert has been seen"
    },
    "message": {
      "type": "string",
      "description": "Description of the alert"
    },
    "monitor_definition_id": {
      "type": "string",
      "description": "ID of Monitor raising the alert"
    },
    "monitor_name": {
      "type": "string",
      "description": "Monitor name"
    }
  },
  "description": "Firewall Policy's alerts"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Firewall Policy not found

Firewall Policy's alerts
GET/api/v1/firewall_policies/{id}/alerts

Firewall Policy’s alerts

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

POST /api/v1/firewall_policies/id/unmonitor
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401403404

Unmonitor servers of firewall policy

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Monitoring License Required

Firewall Policy not found

Unmonitor servers of firewall policy
POST/api/v1/firewall_policies/{id}/unmonitor

Unmonitor servers of firewall policy

URI Parameters
id
number (required) 

POST /api/v1/firewall_policies/id/monitor
Requests
Body
{
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401403404

Monitor servers of Firewall Policy

Schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the server"
    },
    "ip_address": {
      "type": "string",
      "description": "IP address of the server"
    },
    "id": {
      "type": "string",
      "description": "ID of the server"
    },
    "viid": {
      "type": "string",
      "description": "UUID of the server - retrieved from provider API"
    },
    "provider_id": {
      "type": "string",
      "description": "Provider ID"
    },
    "monitored": {
      "type": "boolean",
      "description": "Token allocated to the server"
    },
    "ignore": {
      "type": "boolean",
      "description": "State of ignored flag"
    },
    "status": {
      "type": "string",
      "description": "Running status of server"
    }
  },
  "description": "Monitor servers of Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Monitoring License Required

Firewall Policy not found

Monitor servers of Firewall Policy
POST/api/v1/firewall_policies/{id}/monitor

Monitor servers of Firewall Policy

URI Parameters
id
number (required) 

GET /api/v1/firewall_policies/id/monitor_definitions
Responses200401

Get Firewall Policy’s monitor_definitions

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "firewall_policy_id": {
      "type": "string",
      "description": "Linked firewall"
    },
    "subnet_id": {
      "type": "string",
      "description": "Linked subnet"
    },
    "server_id": {
      "type": "string",
      "description": "Linked server"
    },
    "parent_monitor_id": {
      "type": "string",
      "description": "Parent monitor definition"
    },
    "provider_id": {
      "type": "string",
      "description": "Linked provider"
    },
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Designated port"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get Monitor Definition associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Firewall Policy's monitor_definitions
GET/api/v1/firewall_policies/{id}/monitor_definitions

Get Firewall Policy’s monitor_definitions

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

PATCH /api/v1/firewall_policies/id/monitor_definitions/monitor_id
Requests
Body
{
  "activate_monitor": true,
  "activate_alert": true,
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "activate_monitor": {
      "type": "boolean",
      "description": "activate monitor"
    },
    "activate_alert": {
      "type": "boolean",
      "description": "activate event"
    },
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404417

Update Monitor Definition associated to the Firewall Policy

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "firewall_policy_id": {
      "type": "string",
      "description": "Linked firewall"
    },
    "subnet_id": {
      "type": "string",
      "description": "Linked subnet"
    },
    "server_id": {
      "type": "string",
      "description": "Linked server"
    },
    "parent_monitor_id": {
      "type": "string",
      "description": "Parent monitor definition"
    },
    "provider_id": {
      "type": "string",
      "description": "Linked provider"
    },
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Designated port"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get Monitor Definition associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Not Found

Wrong parameters

Update Monitor Definition associated to the Firewall Policy
PATCH/api/v1/firewall_policies/{id}/monitor_definitions/{monitor_id}

Update Monitor Definition associated to the Firewall Policy

URI Parameters
id
number (required) 
monitor_id
number (required) 

GET /api/v1/firewall_policies/id/monitor_definitions/monitor_id?worker_id=
Responses200401

Get Monitor Definition associated to the Firewall Policy

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "firewall_policy_id": {
      "type": "string",
      "description": "Linked firewall"
    },
    "subnet_id": {
      "type": "string",
      "description": "Linked subnet"
    },
    "server_id": {
      "type": "string",
      "description": "Linked server"
    },
    "parent_monitor_id": {
      "type": "string",
      "description": "Parent monitor definition"
    },
    "provider_id": {
      "type": "string",
      "description": "Linked provider"
    },
    "port": {
      "type": "integer",
      "format": "int32",
      "description": "Designated port"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get Monitor Definition associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Monitor Definition associated to the Firewall Policy
GET/api/v1/firewall_policies/{id}/monitor_definitions/{monitor_id}{?worker_id}

Get Monitor Definition associated to the Firewall Policy

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 
monitor_id
number (required) 

GET /api/v1/firewall_policies/id/monitor_definitions/monitor_id/status
Responses200401

Get Monitor Definition check value associated to the Firewall Policy

Schema
{
  "type": "object",
  "properties": {
    "output": {
      "type": "string",
      "description": "Value of the check"
    },
    "current_state": {
      "type": "integer",
      "format": "int32",
      "description": "Criticity of the status"
    },
    "date": {
      "type": "string",
      "format": "date-time",
      "description": "Check time"
    }
  },
  "description": "Get Monitor Definition check value associated to the Firewall Policy"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get Monitor Definition check value associated to the Firewall Policy
GET/api/v1/firewall_policies/{id}/monitor_definitions/{monitor_id}/status

Get Monitor Definition check value associated to the Firewall Policy

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 
monitor_id
number (required) 

risks

Operations about risks

GET /api/v1/risks
Requests
Body
{
  "scanning_reports_id": [],
  "type": [
    "Hello, world!"
  ]
}
Schema
{
  "type": "object",
  "properties": {
    "scanning_reports_id": {
      "type": "array",
      "description": "reports id\n\n+"
    },
    "type": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "risk type"
    }
  },
  "required": [
    "scanning_reports_id"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401404

Risk for Specific Reports

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Scanning Reports not found

Risk for Specific Reports
GET/api/v1/risks

Risk for Specific Reports

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)


reports

Operations about reports

GET /api/v1/reports
Requests
Body
{
  "tags[server]": [],
  "tags[firewall]": [],
  "tags[provider]": [],
  "tags[subnet]": [],
  "tags[provider_type]": [],
  "tags[custom]": []
}
Schema
{
  "type": "object",
  "properties": {
    "tags[server]": {
      "type": "array",
      "description": "ID of servers\n\n+"
    },
    "tags[firewall]": {
      "type": "array",
      "description": "ID of firewalls\n\n+"
    },
    "tags[provider]": {
      "type": "array",
      "description": "ID of provider\n\n+"
    },
    "tags[subnet]": {
      "type": "array",
      "description": "ID of subnet\n\n+"
    },
    "tags[provider_type]": {
      "type": "array",
      "description": "Provider type\n\n+"
    },
    "tags[custom]": {
      "type": "array",
      "description": "Name of custom tags\n\n+"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401

Get all reports

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the Scanning Report"
    },
    "result": {
      "type": "string",
      "description": "Error status of Scanning Report"
    },
    "instance_id": {
      "type": "string",
      "description": "Server ID linked to the Scanning Report"
    },
    "scan_started_at": {
      "type": "string",
      "format": "date-time",
      "description": "Scan started at"
    },
    "nr_vulnerabilities": {
      "type": "object",
      "description": "Number of vulnerabilities in the report"
    },
    "vulnerabilities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Vulnerability ID"
          },
          "scanning_report_id": {
            "type": "string",
            "description": "Linked scanning report"
          },
          "name": {
            "type": "string",
            "description": "Name of the vulnerability"
          }
        },
        "description": "List of all vulnerabilities of a Server"
      },
      "description": "Array of Vulnerabilities"
    }
  },
  "description": "Get Specific report"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get all reports
GET/api/v1/reports

Get all reports


GET /api/v1/reports/id/pdf
Responses200401404

Download report

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the Scanning Report"
    },
    "result": {
      "type": "string",
      "description": "Error status of Scanning Report"
    },
    "instance_id": {
      "type": "string",
      "description": "Server ID linked to the Scanning Report"
    },
    "scan_started_at": {
      "type": "string",
      "format": "date-time",
      "description": "Scan started at"
    },
    "nr_vulnerabilities": {
      "type": "object",
      "description": "Number of vulnerabilities in the report"
    },
    "vulnerabilities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Vulnerability ID"
          },
          "scanning_report_id": {
            "type": "string",
            "description": "Linked scanning report"
          },
          "name": {
            "type": "string",
            "description": "Name of the vulnerability"
          }
        },
        "description": "List of all vulnerabilities of a Server"
      },
      "description": "Array of Vulnerabilities"
    }
  },
  "description": "Get Specific report"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Report not Found

Download report
GET/api/v1/reports/{id}/pdf

Download report

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

DELETE /api/v1/reports/id?worker_id=
Responses204401404

Delete report

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the Scanning Report"
    },
    "result": {
      "type": "string",
      "description": "Error status of Scanning Report"
    },
    "instance_id": {
      "type": "string",
      "description": "Server ID linked to the Scanning Report"
    },
    "scan_started_at": {
      "type": "string",
      "format": "date-time",
      "description": "Scan started at"
    },
    "nr_vulnerabilities": {
      "type": "object",
      "description": "Number of vulnerabilities in the report"
    },
    "vulnerabilities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Vulnerability ID"
          },
          "scanning_report_id": {
            "type": "string",
            "description": "Linked scanning report"
          },
          "name": {
            "type": "string",
            "description": "Name of the vulnerability"
          }
        },
        "description": "List of all vulnerabilities of a Server"
      },
      "description": "Array of Vulnerabilities"
    }
  },
  "description": "Get Specific report"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Report not Found

Delete report
DELETE/api/v1/reports/{id}{?worker_id}

Delete report

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/reports/id?worker_id=
Responses200401404

Get Specific report

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the Scanning Report"
    },
    "result": {
      "type": "string",
      "description": "Error status of Scanning Report"
    },
    "instance_id": {
      "type": "string",
      "description": "Server ID linked to the Scanning Report"
    },
    "scan_started_at": {
      "type": "string",
      "format": "date-time",
      "description": "Scan started at"
    },
    "nr_vulnerabilities": {
      "type": "object",
      "description": "Number of vulnerabilities in the report"
    },
    "vulnerabilities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Vulnerability ID"
          },
          "scanning_report_id": {
            "type": "string",
            "description": "Linked scanning report"
          },
          "name": {
            "type": "string",
            "description": "Name of the vulnerability"
          }
        },
        "description": "List of all vulnerabilities of a Server"
      },
      "description": "Array of Vulnerabilities"
    }
  },
  "description": "Get Specific report"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Report not Found

Get Specific report
GET/api/v1/reports/{id}{?worker_id}

Get Specific report

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

admin

Operations about admins

POST /api/v1/admin/account
Requests
Body
{
  "account[email]": "Hello, world!",
  "account[full_name]": "Hello, world!",
  "account[name]": "Hello, world!",
  "account[accept_terms]": true,
  "account[timezone]": "Hello, world!",
  "account[password]": "Hello, world!",
  "account[telephone]": "Hello, world!",
  "account[company]": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "account[email]": {
      "type": "string",
      "description": "email"
    },
    "account[full_name]": {
      "type": "string",
      "description": "full name"
    },
    "account[name]": {
      "type": "string",
      "description": "name"
    },
    "account[accept_terms]": {
      "type": "boolean",
      "description": "terms and conditions"
    },
    "account[timezone]": {
      "type": "string",
      "description": "Timezone"
    },
    "account[password]": {
      "type": "string",
      "description": "password"
    },
    "account[telephone]": {
      "type": "string",
      "description": "telephone"
    },
    "account[company]": {
      "type": "string",
      "description": "company"
    }
  },
  "required": [
    "account[email]",
    "account[full_name]",
    "account[name]",
    "account[accept_terms]",
    "account[timezone]",
    "account[password]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201

Create Admin Account

Create Admin Account
POST/api/v1/admin/account

Create Admin Account


GET /api/v1/admin/accounts
Responses200

List all accounts

List all accounts
GET/api/v1/admin/accounts

List all accounts


POST /api/v1/admin/worker
Requests
Body
{
  "uuid": "Hello, world!",
  "manager_ip": "Hello, world!",
  "max_parallel_scan": 1
}
Schema
{
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "UUID for the worker"
    },
    "manager_ip": {
      "type": "string",
      "description": "IP Address of Manager"
    },
    "max_parallel_scan": {
      "type": "number",
      "description": "Number of parallel scan"
    }
  },
  "required": [
    "uuid",
    "manager_ip",
    "max_parallel_scan"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201

Put Elastic Workload Protector in slave mode

Put Elastic Workload Protector in slave mode
POST/api/v1/admin/worker

Put Elastic Workload Protector in slave mode


POST /api/v1/admin/settings/ldap
Requests
Body
{
  "activate": true,
  "account_id": 1,
  "settings[host]": "Hello, world!",
  "settings[port]": 1,
  "settings[base]": "Hello, world!",
  "settings[attribute]": "Hello, world!",
  "settings[match_attribute]": "Hello, world!",
  "settings[ssl]": true
}
Schema
{
  "type": "object",
  "properties": {
    "activate": {
      "type": "boolean",
      "description": "Activate LDAP authentication"
    },
    "account_id": {
      "type": "number",
      "description": "Id for current account"
    },
    "settings[host]": {
      "type": "string",
      "description": "FQDN or IP"
    },
    "settings[port]": {
      "type": "number",
      "description": "LDAP port number"
    },
    "settings[base]": {
      "type": "string",
      "description": "LDAP base"
    },
    "settings[attribute]": {
      "type": "string",
      "description": "LDAP attribute to authenticate against (cn, sAMAccountName...)"
    },
    "settings[match_attribute]": {
      "type": "string",
      "description": "Attribute to retrieve from account to identify user (mail...)"
    },
    "settings[ssl]": {
      "type": "boolean",
      "description": "Activate or not SSL"
    }
  },
  "required": [
    "activate",
    "account_id",
    "settings[host]",
    "settings[port]",
    "settings[base]",
    "settings[attribute]",
    "settings[match_attribute]",
    "settings[ssl]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201

Activate LDAP authentication

Activate LDAP authentication
POST/api/v1/admin/settings/ldap

Activate LDAP authentication


roles

Operations about roles

DELETE /api/v1/roles
Requests
Body
{
  "role[role]": []
}
Schema
{
  "type": "object",
  "properties": {
    "role[role]": {
      "type": "array",
      "description": "+"
    }
  },
  "required": [
    "role[role]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses204401417

Delete a role (deleting reader delete all roles)

Unauthorized

Bad parameters

Delete a role (deleting reader delete all roles)
DELETE/api/v1/roles

Delete a role (deleting reader delete all roles)


POST /api/v1/roles
Requests
Body
{
  "role[user_id]": "Hello, world!",
  "role[account_id]": "Hello, world!",
  "role[role]": []
}
Schema
{
  "type": "object",
  "properties": {
    "role[user_id]": {
      "type": "string",
      "description": "user id"
    },
    "role[account_id]": {
      "type": "string",
      "description": "account id"
    },
    "role[role]": {
      "type": "array",
      "description": "+"
    }
  },
  "required": [
    "role[user_id]",
    "role[account_id]",
    "role[role]"
  ],
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses201401403417

Create role (adding a role automatically add reader too)

Schema
{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "description": "Linked with a user"
    },
    "account_id": {
      "type": "string",
      "description": "Linked with an account"
    },
    "role": {
      "type": "string"
    }
  },
  "description": "Get all roles"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Public sign-up is disabled

Bad parameters

Schema
{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "description": "Linked with a user"
    },
    "account_id": {
      "type": "string",
      "description": "Linked with an account"
    },
    "role": {
      "type": "string"
    }
  },
  "description": "Get all roles"
}

Create role (adding a role automatically add reader too)
POST/api/v1/roles

Create role (adding a role automatically add reader too)


GET /api/v1/roles
Responses200401

Get all roles

Schema
{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "description": "Linked with a user"
    },
    "account_id": {
      "type": "string",
      "description": "Linked with an account"
    },
    "role": {
      "type": "string"
    }
  },
  "description": "Get all roles"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get all roles
GET/api/v1/roles

Get all roles


workload_analytics

Operations about workload_analytics

GET /api/v1/workload_analytics/config
Responses200401

List workload analytics configuration

Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the monitor definition"
    },
    "monitor_type": {
      "type": "string",
      "description": "Type of monitor"
    },
    "activated": {
      "type": "boolean",
      "description": "Monitor activation"
    },
    "ignore": {
      "type": "boolean",
      "description": "Monitor ignore status"
    },
    "monitor_display_name": {
      "type": "string",
      "description": "Name of analytic"
    }
  },
  "description": "List workload analytics configuration"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

List workload analytics configuration
GET/api/v1/workload_analytics/config

List workload analytics configuration

URI Parameters
asset_id
string (required) 

Id of asset

worker_id
string (required) 

Id of worker targeted (empty will target current machine)

asset_type
string (required) 

Type of asset, possible value host, group, subnet…


GET /api/v1/workload_analytics
Responses200401

List workload analytics

Schema
{
  "type": "object",
  "properties": {
    "monitor_definition": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "ID of the monitor definition"
        },
        "monitor_type": {
          "type": "string",
          "description": "Type of monitor"
        },
        "activated": {
          "type": "boolean",
          "description": "Monitor activation"
        },
        "firewall_policy_id": {
          "type": "string",
          "description": "Linked firewall"
        },
        "subnet_id": {
          "type": "string",
          "description": "Linked subnet"
        },
        "server_id": {
          "type": "string",
          "description": "Linked server"
        },
        "parent_monitor_id": {
          "type": "string",
          "description": "Parent monitor definition"
        },
        "provider_id": {
          "type": "string",
          "description": "Linked provider"
        },
        "port": {
          "type": "integer",
          "format": "int32",
          "description": "Designated port"
        },
        "attributes": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Attribute name"
            },
            "value": {
              "type": "string",
              "description": "Attribute value"
            }
          }
        }
      },
      "description": "Get Monitor Definition associated to the Firewall Policy"
    },
    "monitorable": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "ID of asset"
        },
        "name": {
          "type": "string",
          "description": "Name"
        },
        "type": {
          "type": "string",
          "description": "Type of asset"
        },
        "worker_id": {
          "type": "string",
          "description": "Worker ID"
        },
        "status": {
          "type": "object",
          "properties": {
            "output": {
              "type": "string",
              "description": "Value of the check"
            },
            "current_state": {
              "type": "integer",
              "format": "int32",
              "description": "Criticity of the status"
            },
            "date": {
              "type": "string",
              "format": "date-time",
              "description": "Check time"
            }
          },
          "description": "Get Monitor Definition check value associated to the Firewall Policy"
        }
      }
    },
    "status": {
      "type": "object",
      "properties": {
        "output": {
          "type": "string",
          "description": "Value of the check"
        },
        "current_state": {
          "type": "integer",
          "format": "int32",
          "description": "Criticity of the status"
        },
        "date": {
          "type": "string",
          "format": "date-time",
          "description": "Check time"
        }
      },
      "description": "Get Monitor Definition check value associated to the Firewall Policy"
    }
  },
  "description": "List workload analytics"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

List workload analytics
GET/api/v1/workload_analytics

List workload analytics


PATCH /api/v1/workload_analytics/id/config
Requests
Body
{
  "activate_monitor": true,
  "activate_alert": true,
  "worker_id": "Hello, world!"
}
Schema
{
  "type": "object",
  "properties": {
    "activate_monitor": {
      "type": "boolean",
      "description": "activate monitor"
    },
    "activate_alert": {
      "type": "boolean",
      "description": "activate event"
    },
    "worker_id": {
      "type": "string",
      "description": "Id of worker targeted (empty will target current machine)"
    }
  },
  "$schema": "http://json-schema.org/draft-04/schema#"
}
Responses200401

Update workload analytic configuration

Schema
{
  "type": "object",
  "properties": {
    "monitor_definition": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "ID of the monitor definition"
        },
        "monitor_type": {
          "type": "string",
          "description": "Type of monitor"
        },
        "activated": {
          "type": "boolean",
          "description": "Monitor activation"
        },
        "firewall_policy_id": {
          "type": "string",
          "description": "Linked firewall"
        },
        "subnet_id": {
          "type": "string",
          "description": "Linked subnet"
        },
        "server_id": {
          "type": "string",
          "description": "Linked server"
        },
        "parent_monitor_id": {
          "type": "string",
          "description": "Parent monitor definition"
        },
        "provider_id": {
          "type": "string",
          "description": "Linked provider"
        },
        "port": {
          "type": "integer",
          "format": "int32",
          "description": "Designated port"
        },
        "attributes": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Attribute name"
            },
            "value": {
              "type": "string",
              "description": "Attribute value"
            }
          }
        }
      },
      "description": "Get Monitor Definition associated to the Firewall Policy"
    },
    "event_definition": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Event name"
        },
        "activated": {
          "type": "boolean",
          "description": "Event activation"
        },
        "attributes": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Attribute name"
            },
            "value": {
              "type": "string",
              "description": "Attribute value"
            }
          }
        }
      }
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get workload analytic configuration"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Update workload analytic configuration
PATCH/api/v1/workload_analytics/{id}/config

Update workload analytic configuration

URI Parameters
id
number (required) 

GET /api/v1/workload_analytics/id/config?worker_id=
Responses200401

Get workload analytic configuration

Schema
{
  "type": "object",
  "properties": {
    "monitor_definition": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "ID of the monitor definition"
        },
        "monitor_type": {
          "type": "string",
          "description": "Type of monitor"
        },
        "activated": {
          "type": "boolean",
          "description": "Monitor activation"
        },
        "firewall_policy_id": {
          "type": "string",
          "description": "Linked firewall"
        },
        "subnet_id": {
          "type": "string",
          "description": "Linked subnet"
        },
        "server_id": {
          "type": "string",
          "description": "Linked server"
        },
        "parent_monitor_id": {
          "type": "string",
          "description": "Parent monitor definition"
        },
        "provider_id": {
          "type": "string",
          "description": "Linked provider"
        },
        "port": {
          "type": "integer",
          "format": "int32",
          "description": "Designated port"
        },
        "attributes": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Attribute name"
            },
            "value": {
              "type": "string",
              "description": "Attribute value"
            }
          }
        }
      },
      "description": "Get Monitor Definition associated to the Firewall Policy"
    },
    "event_definition": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Event name"
        },
        "activated": {
          "type": "boolean",
          "description": "Event activation"
        },
        "attributes": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Attribute name"
            },
            "value": {
              "type": "string",
              "description": "Attribute value"
            }
          }
        }
      }
    },
    "attributes": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Attribute name"
        },
        "value": {
          "type": "string",
          "description": "Attribute value"
        }
      }
    }
  },
  "description": "Get workload analytic configuration"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get workload analytic configuration
GET/api/v1/workload_analytics/{id}/config{?worker_id}

Get workload analytic configuration

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required) 

GET /api/v1/workload_analytics/id
Responses200401

Get workload analytic details

Schema
{
  "type": "object",
  "properties": {
    "monitor_definition": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "ID of the monitor definition"
        },
        "monitor_type": {
          "type": "string",
          "description": "Type of monitor"
        },
        "activated": {
          "type": "boolean",
          "description": "Monitor activation"
        },
        "firewall_policy_id": {
          "type": "string",
          "description": "Linked firewall"
        },
        "subnet_id": {
          "type": "string",
          "description": "Linked subnet"
        },
        "server_id": {
          "type": "string",
          "description": "Linked server"
        },
        "parent_monitor_id": {
          "type": "string",
          "description": "Parent monitor definition"
        },
        "provider_id": {
          "type": "string",
          "description": "Linked provider"
        },
        "port": {
          "type": "integer",
          "format": "int32",
          "description": "Designated port"
        },
        "attributes": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Attribute name"
            },
            "value": {
              "type": "string",
              "description": "Attribute value"
            }
          }
        }
      },
      "description": "Get Monitor Definition associated to the Firewall Policy"
    },
    "concernet_assets": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "ID of asset"
        },
        "get_display_no_img": {
          "type": "string",
          "description": "Display name"
        },
        "type": {
          "type": "string",
          "description": "Type of asset"
        },
        "sgid": {
          "type": "string",
          "description": "SGID"
        }
      }
    }
  },
  "description": "Get workload analytic details"
}

Unauthorized

Schema
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Error message"
    },
    "error": {
      "type": "integer",
      "format": "int32",
      "description": "Error code"
    }
  },
  "description": "Get workload analytic details"
}

Get workload analytic details
GET/api/v1/workload_analytics/{id}

Get workload analytic details

URI Parameters
worker_id
string (required) 

Id of worker targeted (empty will target current machine)

id
number (required)