Update polling status
/apiplatform/gatewaynode/v1/config/poller
Updates the polling status (active
or inactive
) and the polling interval, in milliseconds, for this node.
Users requesting this resource must be assigned the Gateway Manager role for the logical gateway this node is registered to.
Request
- application/json
object
-
state:
string
The poller's state.
active
means polling is active;inactive
means polling is inactive.
object
-
pollingInterval(optional):
string
The polling time interval, in milliseconds.
Response
- application/json
- text/plain
204 Response
400 Response
object
-
detail(optional):
string
Detailed error message.
-
errorCode(optional):
string
Application-specific error code.
-
errorDetails(optional):
array errorDetails
Additional errors.
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error.
-
status(optional):
string
HTTP status code.
-
title:
string
Summary error message.
-
type:
string
Error type.
array
-
Array of:
object Error
Error Definition.
401 Response
object
-
detail(optional):
string
Detailed error message.
-
errorCode(optional):
string
Application-specific error code.
-
errorDetails(optional):
array errorDetails
Additional errors.
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error.
-
status(optional):
string
HTTP status code.
-
title:
string
Summary error message.
-
type:
string
Error type.
array
-
Array of:
object Error
Error Definition.
403 Response
object
-
detail(optional):
string
Detailed error message.
-
errorCode(optional):
string
Application-specific error code.
-
errorDetails(optional):
array errorDetails
Additional errors.
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error.
-
status(optional):
string
HTTP status code.
-
title:
string
Summary error message.
-
type:
string
Error type.
array
-
Array of:
object Error
Error Definition.
500 Response
object
-
detail(optional):
string
Detailed error message.
-
errorCode(optional):
string
Application-specific error code.
-
errorDetails(optional):
array errorDetails
Additional errors.
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error.
-
status(optional):
string
HTTP status code.
-
title:
string
Summary error message.
-
type:
string
Error type.
array
-
Array of:
object Error
Error Definition.
503 Response
object
-
detail(optional):
string
Detailed error message.
-
errorCode(optional):
string
Application-specific error code.
-
errorDetails(optional):
array errorDetails
Additional errors.
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error.
-
status(optional):
string
HTTP status code.
-
title:
string
Summary error message.
-
type:
string
Error type.
array
-
Array of:
object Error
Error Definition.
Examples
The following example shows how to update the polling status of a gateway node by submitting a PUT request on the REST resource using cURL. For more information about cURL, see Use cURL
curl -i -X PUT
-H "Authorization: Bearer access_token
-H "Content-Type: application/json"
-d @pollconfig.json
https://example.com/apiplatform/gatewaynode/v1/config/poller
Example of Response Header
The following shows an example of the response header.
HTTP/1.1 204 No Content Date: Fri, 30 Dec 2016 18:37:35 GMT
Example of Request Body
The following example shows a request body (included with the request above in a file named pollconfig.json
) that changes the node polling interval to 10 seconds. The format for the pollingInterval
attribute is <time interval> <unit>
. For example, 10 seconds.
{ "state": "active", "pollingInterval": "10 seconds" }