1 of 1

MaxScale 21.06 Listener Resource

A listener resource represents a listener of a service in MaxScale. All listeners point to a service in MaxScale.

Listener Resource
- Resource Operations

Resource Operations

Get a listener

Get a single listener. The :name in the URI must be the name of a listener in MaxScale.

Response

Status: 200 OK

Get all listeners

Get all listeners.

Response

Status: 200 OK

Create a new listener

Creates a new listener. The request body must define the following fields.

data.id
Name of the listener
data.type

The following is the minimal required JSON object for defining a new listener.

Refer to the for a full list of listener parameters.

Response

Listener is created:

Status: 204 No Content

Update a listener

The request body must be a JSON object which represents a set of new definitions for the listener.

All parameters marked as modifiable at runtime can be modified. Currently, all TLS/SSL parameters and the connection_init_sql_file and sql_mode parameters can be modified at runtime.

Parameters that affect the network address or the port the listener listens on cannot be modified at runtime. To modify these parameters, recreate the listener.

Response

Listener is modified:

Status: 204 No Content

Destroy a listener

The :name must be a valid listener name. When a listener is destroyed, the network port it listens on is available for reuse.

Response

Listener is destroyed:

Status: 204 No Content

Listener cannot be deleted:

Status: 403 Forbidden

Stop a listener

Stops a started listener. When a listener is stopped, new connections are no longer accepted and are queued until the listener is started again.

Parameters

This endpoint supports the following parameters:

force=yes
Close all existing connections that were created through this listener.

Response

Listener is stopped:

Status: 204 No Content

Start a listener

Starts a stopped listener.

Response

Listener is started:

Status: 204 No Content

_{This page is licensed: CC BY-SA / Gnu FDL}

MaxScale 21.06 Listener Resource

A listener resource represents a listener of a service in MaxScale. All listeners point to a service in MaxScale.

Listener Resource
- Resource Operations

Resource Operations

Get a listener

Get a single listener. The :name in the URI must be the name of a listener in MaxScale.

Response

Status: 200 OK

Get all listeners

Get all listeners.

Response

Status: 200 OK

Create a new listener

Creates a new listener. The request body must define the following fields.

data.id
Name of the listener
data.type

The following is the minimal required JSON object for defining a new listener.

Refer to the for a full list of listener parameters.

Response

Listener is created:

Status: 204 No Content

Update a listener

The request body must be a JSON object which represents a set of new definitions for the listener.

All parameters marked as modifiable at runtime can be modified. Currently, all TLS/SSL parameters and the connection_init_sql_file and sql_mode parameters can be modified at runtime.

Parameters that affect the network address or the port the listener listens on cannot be modified at runtime. To modify these parameters, recreate the listener.

Response

Listener is modified:

Status: 204 No Content

Destroy a listener

The :name must be a valid listener name. When a listener is destroyed, the network port it listens on is available for reuse.

Response

Listener is destroyed:

Status: 204 No Content

Listener cannot be deleted:

Status: 403 Forbidden

Stop a listener

Stops a started listener. When a listener is stopped, new connections are no longer accepted and are queued until the listener is started again.

Parameters

This endpoint supports the following parameters:

force=yes
Close all existing connections that were created through this listener.

Response

Listener is stopped:

Status: 204 No Content

Start a listener

Starts a stopped listener.

Response

Listener is started:

Status: 204 No Content

_{This page is licensed: CC BY-SA / Gnu FDL}

{
    "data": [
        {
            "attributes": {
                "parameters": {
                    "address": "::",
                    "authenticator": null,
                    "authenticator_options": null,
                    "connection_init_sql_file": null,
                    "port": 4008,
                    "protocol": "MariaDBProtocol",
                    "service": "Read-Connection-Router",
                    "socket": null,
                    "sql_mode": "default",
                    "ssl": false,
                    "ssl_ca_cert": null,
                    "ssl_cert": null,
                    "ssl_cert_verify_depth": 9,
                    "ssl_cipher": null,
                    "ssl_crl": null,
                    "ssl_key": null,
                    "ssl_verify_peer_certificate": false,
                    "ssl_verify_peer_host": false,
                    "ssl_version": "MAX",
                    "type": "listener",
                    "user_mapping_file": null
                },
                "source": {
                    "file": "/etc/maxscale.cnf",
                    "type": "static"
                },
                "state": "Running"
            },
            "id": "Read-Connection-Listener",
            "relationships": {
                "services": {
                    "data": [
                        {
                            "id": "Read-Connection-Router",
                            "type": "services"
                        }
                    ],
                    "links": {
                        "related": "http://localhost:8989/v1/services/",
                        "self": "http://localhost:8989/v1/listeners/Read-Connection-Listener/relationships/services/"
                    }
                }
            },
            "type": "listeners"
        },
        {
            "attributes": {
                "parameters": {
                    "address": "::",
                    "authenticator": null,
                    "authenticator_options": null,
                    "connection_init_sql_file": null,
                    "port": 4006,
                    "protocol": "MariaDBProtocol",
                    "service": "RW-Split-Router",
                    "socket": null,
                    "sql_mode": "default",
                    "ssl": false,
                    "ssl_ca_cert": null,
                    "ssl_cert": null,
                    "ssl_cert_verify_depth": 9,
                    "ssl_cipher": null,
                    "ssl_crl": null,
                    "ssl_key": null,
                    "ssl_verify_peer_certificate": false,
                    "ssl_verify_peer_host": false,
                    "ssl_version": "MAX",
                    "type": "listener",
                    "user_mapping_file": null
                },
                "source": {
                    "file": "/etc/maxscale.cnf",
                    "type": "static"
                },
                "state": "Running"
            },
            "id": "RW-Split-Listener",
            "relationships": {
                "services": {
                    "data": [
                        {
                            "id": "RW-Split-Router",
                            "type": "services"
                        }
                    ],
                    "links": {
                        "related": "http://localhost:8989/v1/services/",
                        "self": "http://localhost:8989/v1/listeners/RW-Split-Listener/relationships/services/"
                    }
                }
            },
            "type": "listeners"
        }
    ],
    "links": {
        "self": "http://localhost:8989/v1/listeners/"
    }
}

{
    "data": [
        {
            "attributes": {
                "parameters": {
                    "address": "::",
                    "authenticator": null,
                    "authenticator_options": null,
                    "connection_init_sql_file": null,
                    "port": 4008,
                    "protocol": "MariaDBProtocol",
                    "service": "Read-Connection-Router",
                    "socket": null,
                    "sql_mode": "default",
                    "ssl": false,
                    "ssl_ca_cert": null,
                    "ssl_cert": null,
                    "ssl_cert_verify_depth": 9,
                    "ssl_cipher": null,
                    "ssl_crl": null,
                    "ssl_key": null,
                    "ssl_verify_peer_certificate": false,
                    "ssl_verify_peer_host": false,
                    "ssl_version": "MAX",
                    "type": "listener",
                    "user_mapping_file": null
                },
                "source": {
                    "file": "/etc/maxscale.cnf",
                    "type": "static"
                },
                "state": "Running"
            },
            "id": "Read-Connection-Listener",
            "relationships": {
                "services": {
                    "data": [
                        {
                            "id": "Read-Connection-Router",
                            "type": "services"
                        }
                    ],
                    "links": {
                        "related": "http://localhost:8989/v1/services/",
                        "self": "http://localhost:8989/v1/listeners/Read-Connection-Listener/relationships/services/"
                    }
                }
            },
            "type": "listeners"
        },
        {
            "attributes": {
                "parameters": {
                    "address": "::",
                    "authenticator": null,
                    "authenticator_options": null,
                    "connection_init_sql_file": null,
                    "port": 4006,
                    "protocol": "MariaDBProtocol",
                    "service": "RW-Split-Router",
                    "socket": null,
                    "sql_mode": "default",
                    "ssl": false,
                    "ssl_ca_cert": null,
                    "ssl_cert": null,
                    "ssl_cert_verify_depth": 9,
                    "ssl_cipher": null,
                    "ssl_crl": null,
                    "ssl_key": null,
                    "ssl_verify_peer_certificate": false,
                    "ssl_verify_peer_host": false,
                    "ssl_version": "MAX",
                    "type": "listener",
                    "user_mapping_file": null
                },
                "source": {
                    "file": "/etc/maxscale.cnf",
                    "type": "static"
                },
                "state": "Running"
            },
            "id": "RW-Split-Listener",
            "relationships": {
                "services": {
                    "data": [
                        {
                            "id": "RW-Split-Router",
                            "type": "services"
                        }
                    ],
                    "links": {
                        "related": "http://localhost:8989/v1/services/",
                        "self": "http://localhost:8989/v1/listeners/RW-Split-Listener/relationships/services/"
                    }
                }
            },
            "type": "listeners"
        }
    ],
    "links": {
        "self": "http://localhost:8989/v1/listeners/"
    }
}

MaxScale 21.06 Listener Resource

hashtagResource Operations

hashtagGet a listener

hashtagGet all listeners

hashtagCreate a new listener

hashtagUpdate a listener

hashtagDestroy a listener

hashtagStop a listener

hashtagStart a listener

MaxScale 21.06 Listener Resource

hashtagResource Operations

hashtagGet a listener

hashtagGet all listeners

hashtagCreate a new listener

hashtagUpdate a listener

hashtagDestroy a listener

hashtagStop a listener

hashtagStart a listener

Resource Operations

Get a listener

Get all listeners

Create a new listener

Update a listener

Destroy a listener

Stop a listener

Start a listener

Resource Operations

Get a listener

Get all listeners

Create a new listener

Update a listener

Destroy a listener

Stop a listener

Start a listener