Asterisk-13-ManagerAction_Filter_29394770.html 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <title>Asterisk Project : Asterisk 13 ManagerAction_Filter</title>
  5. <link rel="stylesheet" href="styles/site.css" type="text/css" />
  6. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. </head>
  8. <body class="theme-default aui-theme-default">
  9. <div id="page">
  10. <div id="main" class="aui-page-panel">
  11. <div id="main-header">
  12. <div id="breadcrumb-section">
  13. <ol id="breadcrumbs">
  14. <li class="first">
  15. <span><a href="index.html">Asterisk Project</a></span>
  16. </li>
  17. <li>
  18. <span><a href="Asterisk-13-Command-Reference_29394274.html">Asterisk 13 Command Reference</a></span>
  19. </li>
  20. <li>
  21. <span><a href="Asterisk-13-AMI-Actions_29394279.html">Asterisk 13 AMI Actions</a></span>
  22. </li>
  23. </ol>
  24. </div>
  25. <h1 id="title-heading" class="pagetitle">
  26. <span id="title-text">
  27. Asterisk Project : Asterisk 13 ManagerAction_Filter
  28. </span>
  29. </h1>
  30. </div>
  31. <div id="content" class="view">
  32. <div class="page-metadata">
  33. Created by <span class='author'> wikibot</span> on Aug 08, 2014
  34. </div>
  35. <div id="main-content" class="wiki-content group">
  36. <h1 id="Asterisk13ManagerAction_Filter-Filter">Filter</h1>
  37. <h3 id="Asterisk13ManagerAction_Filter-Synopsis">Synopsis</h3>
  38. <p>Dynamically add filters for the current manager session.</p>
  39. <h3 id="Asterisk13ManagerAction_Filter-Description">Description</h3>
  40. <p>The filters added are only used for the current session. Once the connection is closed the filters are removed.</p>
  41. <p>This comand requires the system permission because this command can be used to create filters that may bypass filters defined in manager.conf</p>
  42. <h3 id="Asterisk13ManagerAction_Filter-Syntax">Syntax</h3>
  43. <div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
  44. <pre>Action: Filter
  45. ActionID: &lt;value&gt;
  46. Operation: &lt;value&gt;
  47. Filter: &lt;value&gt;
  48. </pre>
  49. </div></div>
  50. <h5 id="Asterisk13ManagerAction_Filter-Arguments">Arguments</h5>
  51. <ul>
  52. <li><code>ActionID</code> - ActionID for this transaction. Will be returned.</li>
  53. <li><code>Operation</code>
  54. <ul>
  55. <li><code>Add</code> - Add a filter.</li>
  56. </ul>
  57. </li>
  58. <li><code>Filter</code> - Filters can be whitelist or blacklist<br />
  59. Example whitelist filter: &quot;Event: Newchannel&quot;<br />
  60. Example blacklist filter: &quot;!Channel: DAHDI.*&quot;<br />
  61. This filter option is used to whitelist or blacklist events per user to be reported with regular expressions and are allowed if both the regex matches and the user has read access as defined in manager.conf. Filters are assumed to be for whitelisting unless preceeded by an exclamation point, which marks it as being black. Evaluation of the filters is as follows:</li>
  62. </ul>
  63. <ul class="alternate">
  64. <li>If no filters are configured all events are reported as normal.</li>
  65. <li>If there are white filters only: implied black all filter processed first, then white filters.</li>
  66. <li>If there are black filters only: implied white all filter processed first, then black filters.</li>
  67. <li>If there are both white and black filters: implied black all filter processed first, then white filters, and lastly black filters.</li>
  68. </ul>
  69. <h3 id="Asterisk13ManagerAction_Filter-SeeAlso">See Also</h3>
  70. <h3 id="Asterisk13ManagerAction_Filter-ImportVersion">Import Version</h3>
  71. <p>This documentation was imported from Asterisk Version SVN-branch-13-r420538</p>
  72. </div>
  73. </div> </div>
  74. <div id="footer">
  75. <section class="footer-body">
  76. <p>Document generated by Confluence on Aug 11, 2014 13:39</p>
  77. </section>
  78. </div>
  79. </div> </body>
  80. </html>