| Table of Contents |
|---|
| minLevel | 2 |
|---|
| maxLevel | 2 |
|---|
| type | flat |
|---|
|
Overview
Check the list of available endpoints and methods to manage the output configuration configuratin of your relays:
Endpoints and methods | Description |
|---|
/relays{name}/output see below | Get the output configuration of a specific relay. |
/relays{name}/output see below | Edit the output configuration of a specific relay. |
Endpoints and methods
GET/relays/{name}/output
Get the output configuration of a specific relay.
| Expand |
|---|
|
Path parametersAdd the following path parameters as part of the endpoint: Parameter | Type | Description |
|---|
name required
| string
| Enter the name of the relay that contains the output configuration you want to retrieve. |
Find below a request example: | Code Block |
|---|
https://api-us.devo.com/maduro/relays/myRelay/output |
|
| Expand |
|---|
|
Code | Description | Message |
|---|
200 | Successful response. Relay output configuration retrieved. | | Code Block |
|---|
{
"memoryBufferSize": 134217728,
"diskBufferSize": 134217728,
"socketTimeout": 0,
"socketBufferSize": 204800,
"socketKeepAlive": true,
"compression": "none"
} |
| 400 | Bad request. The specific error will be shown in the message. | | Code Block |
|---|
{
"error": {
"code": 12,
"message": "Invalid signature validation"
}
} |
| 403 | Forbidden request. | | 404 | Relay not found. | | Code Block |
|---|
{
"code": 1100,
"cid": "0fedf299de8d",
"msg": "Relay 'test' not found",
"context": {
"name": "test"
}
} |
| 405 | Method not allowed. | | Code Block |
|---|
{
"code": 405,
"cid": "f9f67dba12c6",
"msg": "HTTP 405 Method Not Allowed (path: relays)",
"context": null
} |
|
|
PUT/relays/{name}/output
Edit the output configuration of a specific relay.
| Expand |
|---|
|
Path parametersAdd the following path parameters as part of the endpoint: Parameter | Type | Description |
|---|
name required
| string
| Enter the name of the relay that contains the output configuration you want to update. |
Request bodyThe request JSON body must include an object with the following key-value pairs: Parameter | Type | Description |
|---|
memoryBufferSize required
| number
| Memory buffer size in bytes. The minimum value is 128 MB, and the maximum value is 1024 TB. The default value is 128 MB. | diskBufferSize required
| number
| Disk buffer size in bytes. The minimum value is 128 MB, and the maximum value is 1024 TB. The default value is 128 MB. | socketTimeout required
| integer
| Socket timeout in seconds. The minimum and default value is 0. | socketBufferSize required
| integer
| Socket buffer size in bytes. The minimum value is 128 kB, and the maximum value is 4096 kB. The default is 200 kB. | socketKeepAlive required
| boolean
| Set this option to true if you want to receive a signal to check that the output socket is operating properly. | compression required
| string
| Choose the required compression type between gzip and none. The default value is none. |
Find below a request example: | Code Block |
|---|
https://api-us.devo.com/maduro/relays/myRelay/output |
| Code Block |
|---|
{
"memoryBufferSize": 134217728,
"diskBufferSize": 134217728,
"socketTimeout": 0,
"socketBufferSize": 204800,
"socketKeepAlive": true,
"compression": "none"
} |
|
...
