REST-S-REQUEST to the RestTestLuaService with a
path ending in
requests that a new Test Run be initiated, consisting of one or more Lua instances.
REST-S-RESPONSE response in the case of failure is a
500 status code with a
text/plain error message body.
The attributes of the test run are supplied as follows:
The query args from the
? component of the URI are extracted into a table.
If a query arg is repeated, the final value is used.
The complete list of query args is passed to each Lua script instance.
In addition, the following query args have a special interpretation.
This must be a unique run ID. It cannot refer to any current or recent Test Run.
The run ID is used for subsequent polling for run completion.
The run ID is used as the script key for the management API and for the
SCRIPT_KEY global variable.
Specifies the request trace level for the test run.
0 = None,
1 = Debug,
2 = Dump,
3 = Spam.
load_details is also enabled, this is used for the trace level of subsequent instances.
If tracel level
0 (None) is specified for the first instance, it will be treated as
(Default = trace/match level
1 (Debug) is used for the first instance only).
Requests that instances beyond the first instance for the run should also have trace/match enabled.
(Default = tracing/matching enabled only for first instance in a run).
Silently apply TCAP pre-arranged end to unclosed
srp.scp transactions at the end of each instance.
(Default = silently close SRP/SRP transactions).
single (one instance),
load (bounded by backlog) or
linear (bounded by
rate and backlog).
Total number of Test Instances to execute.
Not used for
Maximum backlog of Test Instances in progress.
Not used for
Target rate of Test Instances started per second.
Used only for
Various query args
scp.dgt_digits, etc. are not
processed directly by the RestTesterLuaService, but are commonly used by TCAP test scripts for the purpose
of constructing the SCCP Destination Routing Address for delivering TCAP to the SCP node.
Refer to the TCAP Lua Agent API for details.
The REST response in the case of success is a
200 status code with
application/json content type.
The JSON object represented in the content body is:
This indicates success.