11.2.2. List and Set Proxy Configuration

Tungsten proxy configuration is divided into several categories. All categories can be listed using:

GET 'https://127.0.0.1:8096/api/v8/connector/configurations/'

For example:

GET 'https://127.0.0.1:8096/api/v8/connector/configurations/extra'

will return the product version and paths to the key and trust stores, wrapped inside a TungstenPropertiesPayload:

{
    "payloadType": "TungstenPropertiesPayload",
    "payloadVersion": "1",
    "payload": {
        "TungstenVersion": "Tungsten Clustering 8.0.0",
        "javax.net.ssl.trustStore": "../../tungsten-connector/conf/tungsten_truststore.ts",
        "javax.net.ssl.keyStore": "../../tungsten-connector/conf/tungsten_keystore.jks"
    }
}

Changing a configuration value is done through a PUT call with the value passed as a JSON payload:

PUT 'https://c1:8096/api/v8/connector/configurations/connector/items/sslCapable' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{ 
  "value" : "true" 
}'

It is also possible to list a given configuration variable. The output will be contained in a ConfigurationItemsPayload, which is basically an array of item/current-value strings, for example:

GET /api/v8/connector/configurations/connector/items/useSmartScale
{
    "payloadType": "ConfigurationItemsPayload",
    "payloadVersion": "1",
    "payload": [
        {
            "item": "useSmartScale",
            "currentValue": false
        }
    ]
}

Note that the same call accepts wildcards with the percent (%) sign, escaped as %25. For example, listing all connector timeouts can be done through the call:

GET /api/v8/connector/configurations/connector/items/%25timeout%25
{
    "payloadType": "ConfigurationItemsPayload",
    "payloadVersion": "1",
    "payload": [
        {
            "item": "bridgeServerToClientForcedCloseTimeout",
            "currentValue": 50
        },
        {
            "item": "connectTimeout",
            "currentValue": 10
        },
        {
            "item": "connection.close.idle.timeout",
            "currentValue": 24999000
        },
        {
            "item": "connection.keepAlive.timeout",
            "currentValue": 30000
        },
        {
            "item": "gatewayConnectTimeoutMs",
            "currentValue": 5000
        },
        {
            "item": "readCommandRetryTimeoutMs",
            "currentValue": 10000
        },
        {
            "item": "server.port.binding.timeout",
            "currentValue": 60
        },
        {
            "item": "waitForDisconnectTimeout",
            "currentValue": 5
        },
        {
            "item": "waitIfUnavailableTimeout",
            "currentValue": 0
        }
    ]
}