Description

Update the configuration properties in conf/openedge.properties for agents for an ABL application.

HTTP Operation

PUT

URI

//host_name:port/oemanager/applications/ABL_app_name/agents/properties 
{"prop_name"=value[, "prop_name"=value[,...]]}
"prop_name"=value[, prop_name"=value[,...]]
Set one or more properties expressed as name/value pairs in a comma-separated list. See the /conf/openedge.properties.README file for a description of properties and their possible values.

Media type

application/vnd.progress+json

Response codes

200 Success
500 Unexpected Server Error

Command-line example

curl -X PUT -u username:password -v http://localhost:16680/oemanager/applications/oepas1/agents/properties
-d {"collectMetrics":0} -H "Content-Type: application/vnd.progress+json"

ABL HTTP client example

using Progress.Json.ObjectModel.*.
define variable resp as OpenEdge.Net.HTTP.IHttpResponse.
define variable jsonData as JsonObject.

jsonData = new Progress.Json.ObjectModel.JsonObject().
jsonData:Add('collectMetrics',  '0').
resp = OpenEdge.Net.HTTP.ClientBuilder:Build():Client
   :Execute(OpenEdge.Net.HTTP.RequestBuilder
      :Put('http://localhost:16680/oemanager/applications/oepas1/agents/properties', jsonData)
      :ContentType('application/vnd.progress+json') 
      :UsingCredentials(new OpenEdge.Net.HTTP.Credentials('', 'username', 'password'))
      :Request
   ).

Request body example

{"collectMetrics":0}

Response body example

On success:

{
   "operation":"SET AGENT PROPERTIES",
   "outcome":"SUCCESS",
   "result":"",
   "errmsg":"",
   "versionStr":"v12.1.0 ( 2019-08-07 )",
   "versionNo":1
}

On failure:

{
   "operation":"SET AGENT PROPERTIES",
   "outcome":"FAILURE",
   "result":"",
   "errmsg":"Invalid property name: \"propname\". (PRPMsg009)",
   "versionStr":"v12.1.0 ( 2019-08-07 )",
   "versionNo":1
}