Asterisk: The Future of Telephony, 2nd Edition

Name

UpdateConfig — Updates a config file

Dynamically updates an Asterisk configuration file.

Parameters

SrcFilename

[required] The filename of the configuration file from which to read the current information.

DstFilename

[required] The filename of the configuration file to be written.

Reload

[optional] Specifies whether or not a reload should take place after the configuration update, or the name of a specific module that should be reloaded.

Action-XXXXXX

[required] An action to take. Can be one of NewCat, RenameCat, DelCat, Update, Delete, or Append.

Cat-XXXXXX

[required] The name of the category to operate on.

Var-XXXXXX

[optional] The name of the variable to operate on.

Value-XXXXXX

[optional] The value of the variable to operate on.

Match-XXXXXX

[optional] If set, an extra parameter that must be matched on the line.

ActionID

[optional] An identifier that can be used to identify the response to this action.

Privilege

config, all

Example

Action: UpdateConfig
SrcFilename: sip.conf
DstFilename: test.conf
Action-000000: update
Cat-000000: linksys
Var-000000: mailbox
Value-000000: 101@lab

Response: Success

Notes

Note that the first set of parameters should be numbered 000000, the second 000001, and so on. This allows you to update many different configuration values at the same time. It should also be noted that the Asterisk GUI uses this its primary mechanism for updating the configuration of Asterisk.