send_aci_action
The send_aci_action
method sends a query to an ACI server. This method takes the action parameters as a table instead of the full action as a string, as with send_aci_command
. This avoids issues with parameter values containing an ampersand (&).
Syntax
send_aci_action( host, port, action [, parameters] [, timeout] [, retries] [, sslParameters] )
Arguments
Argument | Description |
---|---|
host
|
(string) The ACI host to send the query to. |
port
|
(number) The port to send the query to. |
action
|
(string) The action to perform (for example, query ). |
parameters
|
(table) A Lua table containing the action parameters, for example, { param1="value1", param2="value2" } |
timeout
|
(number) The number of milliseconds to wait before timing out. The default is 3000. |
retries
|
(number) The number of times to retry if the request fails. The default is 3. |
sslParameters
|
(table) A Lua table containing the SSL settings. |
Returns
(String). Returns the XML response as a string. If required, you can call parse_xml
on the string to return a LuaXmlDocument
. If the request fails, it returns nil.
Example
send_aci_action( "localhost", 9000, "query" , {text = "*", print = "all"} );