Create Syslog Server (v2.1)
POST/v2.1/api/tenants/:tenant_id/sites/:site_id/elements/:element_id/syslogservers
Create a syslog server.
Request
Path Parameters
ID of the tenant.
ID of the site.
ID of the element.
- application/json
Body
Details of the Syslog Server
The description of the syslog server. Max characters = 1024.
Enables export flow logs to the Syslog server.
The Syslog server field is enabled to enable the syslog server.
The ID of the Syslog server.
The Syslog server name. Max characters = 128.
The protocol type (TCP, or UDP, or TLS). The default protocol is UDP.
The Syslog server IP address.
The Syslog server port number. The default port is 514 for TCP or UDP and 6514 for TLS.
The Severity Level from a severity level of critical, major, or minor.
The source interface for the Syslog server. If no value is entered for this field, then the controller port is considered as the default source interface.
A information field that can be added to identify the event multicast RP config. Maximum 10 unique tags of length 1024 each are allowed.
Responses
- 200
- 400
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
The description of the syslog server. Max characters = 1024.
Enables export flow logs to the Syslog server.
The Syslog server field is enabled to enable the syslog server.
The ID of the Syslog server.
The Syslog server name. Max characters = 128.
The protocol type (TCP, or UDP, or TLS). The default protocol is UDP.
The Syslog server IP address.
The Syslog server port number. The default port is 514 for TCP or UDP and 6514 for TLS.
The Severity Level from a severity level of critical, major, or minor.
The source interface for the Syslog server. If no value is entered for this field, then the controller port is considered as the default source interface.
A information field that can be added to identify the event multicast RP config. Maximum 10 unique tags of length 1024 each are allowed.
{
"enable_flow_logging": true,
"enabled": true,
"id": "string",
"name": "string",
"protocol": "string",
"server_ip": "string",
"server_port": 0,
"severity_level": "string",
"source_interface": "string",
"tags": [
"string"
]
}
Bad Request
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
_error ErrorResponse[]
The error code.
The error message.
{
"_error": [
{
"code": "string",
"message": "string"
}
]
}
{
"value": {
"_error": [
{
"code": "INVALID_JSON_EXTRA_ATTRIBUTE"
},
{
"code": "ELEMENT_NOT_FOUND"
},
{
"code": "ELEMENT_NOT_BOUND"
},
{
"code": "SYSLOGSERVER_CONFIG_EXCEEDS_LIMIT"
},
{
"code": "SYSLOGSERVER_CONFIG_SERVER_IP_MISSING"
},
{
"code": "SYSLOGSERVER_CONFIG_INVALID_RANGE"
},
{
"code": "SYSLOGSERVER_CONFIG_INVALID_PROTOCOL"
},
{
"code": "SYSLOGSERVER_CONFIG_NOT_SUPPORTED"
},
{
"code": "SYSLOGSERVER_CONFIG_FLOW_LOGGING_NOT_SUPPORTED"
},
{
"code": "SYSLOGSERVER_CONFIG_REQD_SOURCE_INTERFACE"
}
]
}
}