Modify Syslog Server Address

Modifies the address or port of the syslog server. This is used if there are network changes that cause these addresses to change, to migrate from IP addresses to DNS hostnames, or to fix incorrect configurations.

Request syntax

PATCH /v1/notification/syslog/servers/{address} {"address": <address>, "port": <port>}Modifies the address or port of the syslog server. This is used if there are network changes that cause these addresses to change, to migrate from IP addresses to DNS hostnames (or vice versa), or to fix incorrect configurations.


Path parameters

address (string)

The current unique address of the syslog server for this library. This can be either an IPv4 address or DNS hostname, and must match the address used when the server was registered.

Request body parameters

address (string, optional)

The new IPv4 address or DNS hostname of the Syslog server. You can change from an IP address to a DNS hostname or from a DNS hostname to an IP address. The new address must be resolvable and accessible from the library.

port (number, optional)

the new port number of the syslog server.

Examples

Example changing an IPv4 address to a different IPv4 address:

> PATCH /v1/notification/syslog/servers/192.168.0.10 {"address":"192.168.0.14"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0

Example migrating from an IPv4 address to a DNS hostname:

> PATCH /v1/notification/syslog/servers/192.168.0.10 {"address":"syslog.example.com"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0

Example changing a DNS hostname and port:

> PATCH /v1/notification/syslog/servers/syslog.example.com {"address":"syslog-backup.example.com", "port":6514}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0