]> git.proxmox.com Git - pmg-docs.git/blame - api-viewer/apidata.js
update api schema
[pmg-docs.git] / api-viewer / apidata.js
CommitLineData
410dc2c9
DM
1var pmgapi = [
2 {
3 "children" : [
4 {
5 "children" : [
d7cd791b
DM
6 {
7 "info" : {
8 "GET" : {
9 "description" : "Returns the rule database digest. This is used internally for cluster synchronization.",
10 "method" : "GET",
11 "name" : "ruledb_digest",
12 "parameters" : {
13 "additionalProperties" : 0
14 },
732d76e1
DM
15 "permissions" : {
16 "check" : [
17 "admin",
18 "audit"
19 ]
20 },
d7cd791b
DM
21 "returns" : {
22 "type" : "string"
23 }
24 }
25 },
26 "leaf" : 1,
27 "path" : "/config/ruledb/digest",
28 "text" : "digest"
29 },
410dc2c9 30 {
f245a28c
DM
31 "children" : [
32 {
33 "children" : [
34 {
35 "info" : {
36 "GET" : {
37 "description" : "Get common rule properties.",
38 "method" : "GET",
39 "name" : "config",
40 "parameters" : {
41 "additionalProperties" : 0,
42 "properties" : {
43 "id" : {
44 "description" : "Rule ID.",
45 "type" : "integer",
46 "typetext" : "<integer>"
47 }
48 }
49 },
732d76e1
DM
50 "permissions" : {
51 "check" : [
52 "admin",
53 "audit"
54 ]
55 },
f245a28c
DM
56 "proxyto" : "master",
57 "returns" : {
58 "properties" : {
59 "active" : {
60 "type" : "boolean"
61 },
62 "direction" : {
63 "type" : "integer"
64 },
65 "id" : {
66 "type" : "integer"
67 },
68 "name" : {
69 "type" : "string"
70 },
71 "priority" : {
72 "type" : "integer"
73 }
74 },
75 "type" : "object"
76 }
77 },
78 "PUT" : {
79 "description" : "Set rule properties.",
80 "method" : "PUT",
81 "name" : "update_config",
82 "parameters" : {
83 "additionalProperties" : 0,
84 "properties" : {
85 "active" : {
86 "description" : "Flag to activate rule.",
87 "optional" : 1,
88 "type" : "boolean",
89 "typetext" : "<boolean>"
90 },
91 "direction" : {
92 "description" : "Rule direction. Value `0` matches incomming mails, value `1` matches outgoing mails, and value `2` matches both directions.",
93 "maximum" : 2,
94 "minimum" : 0,
95 "optional" : 1,
96 "type" : "integer",
97 "typetext" : "<integer> (0 - 2)"
98 },
99 "id" : {
100 "description" : "Rule ID.",
101 "type" : "integer",
102 "typetext" : "<integer>"
103 },
104 "name" : {
105 "description" : "Rule name",
106 "optional" : 1,
107 "type" : "string",
108 "typetext" : "<string>"
109 },
110 "priority" : {
111 "description" : "Rule priotity.",
112 "maximum" : 100,
113 "minimum" : 0,
114 "optional" : 1,
115 "type" : "integer",
116 "typetext" : "<integer> (0 - 100)"
117 }
118 }
119 },
732d76e1
DM
120 "permissions" : {
121 "check" : [
122 "admin"
123 ]
124 },
f245a28c
DM
125 "protected" : 1,
126 "proxyto" : "master",
127 "returns" : {
128 "type" : "null"
129 }
130 }
131 },
132 "leaf" : 1,
133 "path" : "/config/ruledb/rules/{id}/config",
134 "text" : "config"
135 },
136 {
137 "children" : [
138 {
139 "info" : {
140 "DELETE" : {
141 "description" : "Delete group from 'from' list.",
142 "method" : "DELETE",
143 "name" : "delete_from_group",
144 "parameters" : {
145 "additionalProperties" : 0,
146 "properties" : {
147 "id" : {
148 "description" : "Rule ID.",
149 "type" : "integer",
150 "typetext" : "<integer>"
151 },
152 "ogroup" : {
153 "description" : "Groups ID.",
154 "type" : "integer",
155 "typetext" : "<integer>"
156 }
157 }
158 },
732d76e1
DM
159 "permissions" : {
160 "check" : [
161 "admin"
162 ]
163 },
f245a28c
DM
164 "protected" : 1,
165 "proxyto" : "master",
166 "returns" : {
167 "type" : "null"
168 }
169 }
170 },
171 "leaf" : 1,
172 "path" : "/config/ruledb/rules/{id}/from/{ogroup}",
173 "text" : "{ogroup}"
174 }
175 ],
176 "info" : {
177 "GET" : {
178 "description" : "Get 'from' group list.",
179 "method" : "GET",
180 "name" : "from",
181 "parameters" : {
182 "additionalProperties" : 0,
183 "properties" : {
184 "id" : {
185 "description" : "Rule ID.",
186 "type" : "integer",
187 "typetext" : "<integer>"
188 }
189 }
190 },
732d76e1
DM
191 "permissions" : {
192 "check" : [
193 "admin",
194 "audit"
195 ]
196 },
f245a28c
DM
197 "proxyto" : "master",
198 "returns" : {
199 "items" : {
200 "properties" : {
201 "id" : {
202 "type" : "integer"
203 }
204 },
205 "type" : "object"
206 },
207 "type" : "array"
208 }
209 },
210 "POST" : {
211 "description" : "Add group to 'from' list.",
212 "method" : "POST",
213 "name" : "add_from_group",
214 "parameters" : {
215 "additionalProperties" : 0,
216 "properties" : {
217 "id" : {
218 "description" : "Rule ID.",
219 "type" : "integer",
220 "typetext" : "<integer>"
221 },
222 "ogroup" : {
223 "description" : "Groups ID.",
224 "type" : "integer",
225 "typetext" : "<integer>"
226 }
227 }
228 },
732d76e1
DM
229 "permissions" : {
230 "check" : [
231 "admin"
232 ]
233 },
f245a28c
DM
234 "protected" : 1,
235 "proxyto" : "master",
236 "returns" : {
237 "type" : "null"
238 }
239 }
240 },
241 "leaf" : 0,
242 "path" : "/config/ruledb/rules/{id}/from",
243 "text" : "from"
244 },
245 {
246 "children" : [
247 {
248 "info" : {
249 "DELETE" : {
250 "description" : "Delete group from 'to' list.",
251 "method" : "DELETE",
252 "name" : "delete_to_group",
253 "parameters" : {
254 "additionalProperties" : 0,
255 "properties" : {
256 "id" : {
257 "description" : "Rule ID.",
258 "type" : "integer",
259 "typetext" : "<integer>"
260 },
261 "ogroup" : {
262 "description" : "Groups ID.",
263 "type" : "integer",
264 "typetext" : "<integer>"
265 }
266 }
267 },
732d76e1
DM
268 "permissions" : {
269 "check" : [
270 "admin"
271 ]
272 },
f245a28c
DM
273 "protected" : 1,
274 "proxyto" : "master",
275 "returns" : {
276 "type" : "null"
277 }
278 }
279 },
280 "leaf" : 1,
281 "path" : "/config/ruledb/rules/{id}/to/{ogroup}",
282 "text" : "{ogroup}"
283 }
284 ],
285 "info" : {
286 "GET" : {
287 "description" : "Get 'to' group list.",
288 "method" : "GET",
289 "name" : "to",
290 "parameters" : {
291 "additionalProperties" : 0,
292 "properties" : {
293 "id" : {
294 "description" : "Rule ID.",
295 "type" : "integer",
296 "typetext" : "<integer>"
297 }
298 }
299 },
732d76e1
DM
300 "permissions" : {
301 "check" : [
302 "admin",
303 "audit"
304 ]
305 },
f245a28c
DM
306 "proxyto" : "master",
307 "returns" : {
308 "items" : {
309 "properties" : {
310 "id" : {
311 "type" : "integer"
312 }
313 },
314 "type" : "object"
315 },
316 "type" : "array"
317 }
318 },
319 "POST" : {
320 "description" : "Add group to 'to' list.",
321 "method" : "POST",
322 "name" : "add_to_group",
323 "parameters" : {
324 "additionalProperties" : 0,
325 "properties" : {
326 "id" : {
327 "description" : "Rule ID.",
328 "type" : "integer",
329 "typetext" : "<integer>"
330 },
331 "ogroup" : {
332 "description" : "Groups ID.",
333 "type" : "integer",
334 "typetext" : "<integer>"
335 }
336 }
337 },
732d76e1
DM
338 "permissions" : {
339 "check" : [
340 "admin"
341 ]
342 },
f245a28c
DM
343 "protected" : 1,
344 "proxyto" : "master",
345 "returns" : {
346 "type" : "null"
347 }
348 }
349 },
350 "leaf" : 0,
351 "path" : "/config/ruledb/rules/{id}/to",
352 "text" : "to"
353 },
354 {
355 "children" : [
356 {
357 "info" : {
358 "DELETE" : {
359 "description" : "Delete group from 'when' list.",
360 "method" : "DELETE",
361 "name" : "delete_when_group",
362 "parameters" : {
363 "additionalProperties" : 0,
364 "properties" : {
365 "id" : {
366 "description" : "Rule ID.",
367 "type" : "integer",
368 "typetext" : "<integer>"
369 },
370 "ogroup" : {
371 "description" : "Groups ID.",
372 "type" : "integer",
373 "typetext" : "<integer>"
374 }
375 }
376 },
732d76e1
DM
377 "permissions" : {
378 "check" : [
379 "admin"
380 ]
381 },
f245a28c
DM
382 "protected" : 1,
383 "proxyto" : "master",
384 "returns" : {
385 "type" : "null"
386 }
387 }
388 },
389 "leaf" : 1,
390 "path" : "/config/ruledb/rules/{id}/when/{ogroup}",
391 "text" : "{ogroup}"
392 }
393 ],
394 "info" : {
395 "GET" : {
396 "description" : "Get 'when' group list.",
397 "method" : "GET",
398 "name" : "when",
399 "parameters" : {
400 "additionalProperties" : 0,
401 "properties" : {
402 "id" : {
403 "description" : "Rule ID.",
404 "type" : "integer",
405 "typetext" : "<integer>"
406 }
407 }
408 },
732d76e1
DM
409 "permissions" : {
410 "check" : [
411 "admin",
412 "audit"
413 ]
414 },
f245a28c
DM
415 "proxyto" : "master",
416 "returns" : {
417 "items" : {
418 "properties" : {
419 "id" : {
420 "type" : "integer"
421 }
422 },
423 "type" : "object"
424 },
425 "type" : "array"
426 }
427 },
428 "POST" : {
429 "description" : "Add group to 'when' list.",
430 "method" : "POST",
431 "name" : "add_when_group",
432 "parameters" : {
433 "additionalProperties" : 0,
434 "properties" : {
435 "id" : {
436 "description" : "Rule ID.",
437 "type" : "integer",
438 "typetext" : "<integer>"
439 },
440 "ogroup" : {
441 "description" : "Groups ID.",
442 "type" : "integer",
443 "typetext" : "<integer>"
444 }
445 }
446 },
732d76e1
DM
447 "permissions" : {
448 "check" : [
449 "admin"
450 ]
451 },
f245a28c
DM
452 "protected" : 1,
453 "proxyto" : "master",
454 "returns" : {
455 "type" : "null"
456 }
457 }
458 },
459 "leaf" : 0,
460 "path" : "/config/ruledb/rules/{id}/when",
461 "text" : "when"
462 },
463 {
464 "children" : [
465 {
466 "info" : {
467 "DELETE" : {
468 "description" : "Delete group from 'what' list.",
469 "method" : "DELETE",
470 "name" : "delete_what_group",
471 "parameters" : {
472 "additionalProperties" : 0,
473 "properties" : {
474 "id" : {
475 "description" : "Rule ID.",
476 "type" : "integer",
477 "typetext" : "<integer>"
478 },
479 "ogroup" : {
480 "description" : "Groups ID.",
481 "type" : "integer",
482 "typetext" : "<integer>"
483 }
484 }
485 },
732d76e1
DM
486 "permissions" : {
487 "check" : [
488 "admin"
489 ]
490 },
f245a28c
DM
491 "protected" : 1,
492 "proxyto" : "master",
493 "returns" : {
494 "type" : "null"
495 }
496 }
497 },
498 "leaf" : 1,
499 "path" : "/config/ruledb/rules/{id}/what/{ogroup}",
500 "text" : "{ogroup}"
501 }
502 ],
503 "info" : {
504 "GET" : {
505 "description" : "Get 'what' group list.",
506 "method" : "GET",
507 "name" : "what",
508 "parameters" : {
509 "additionalProperties" : 0,
510 "properties" : {
511 "id" : {
512 "description" : "Rule ID.",
513 "type" : "integer",
514 "typetext" : "<integer>"
515 }
516 }
517 },
732d76e1
DM
518 "permissions" : {
519 "check" : [
520 "admin",
521 "audit"
522 ]
523 },
f245a28c
DM
524 "proxyto" : "master",
525 "returns" : {
526 "items" : {
527 "properties" : {
528 "id" : {
529 "type" : "integer"
530 }
531 },
532 "type" : "object"
533 },
534 "type" : "array"
535 }
536 },
537 "POST" : {
538 "description" : "Add group to 'what' list.",
539 "method" : "POST",
540 "name" : "add_what_group",
541 "parameters" : {
542 "additionalProperties" : 0,
543 "properties" : {
544 "id" : {
545 "description" : "Rule ID.",
546 "type" : "integer",
547 "typetext" : "<integer>"
548 },
549 "ogroup" : {
550 "description" : "Groups ID.",
551 "type" : "integer",
552 "typetext" : "<integer>"
553 }
554 }
555 },
732d76e1
DM
556 "permissions" : {
557 "check" : [
558 "admin"
559 ]
560 },
f245a28c
DM
561 "protected" : 1,
562 "proxyto" : "master",
563 "returns" : {
564 "type" : "null"
565 }
566 }
567 },
568 "leaf" : 0,
569 "path" : "/config/ruledb/rules/{id}/what",
570 "text" : "what"
571 },
572 {
573 "children" : [
574 {
575 "info" : {
576 "DELETE" : {
577 "description" : "Delete group from 'action' list.",
578 "method" : "DELETE",
579 "name" : "delete_action_group",
580 "parameters" : {
581 "additionalProperties" : 0,
582 "properties" : {
583 "id" : {
584 "description" : "Rule ID.",
585 "type" : "integer",
586 "typetext" : "<integer>"
587 },
588 "ogroup" : {
589 "description" : "Groups ID.",
590 "type" : "integer",
591 "typetext" : "<integer>"
592 }
593 }
594 },
732d76e1
DM
595 "permissions" : {
596 "check" : [
597 "admin"
598 ]
599 },
f245a28c
DM
600 "protected" : 1,
601 "proxyto" : "master",
602 "returns" : {
603 "type" : "null"
604 }
605 }
606 },
607 "leaf" : 1,
608 "path" : "/config/ruledb/rules/{id}/action/{ogroup}",
609 "text" : "{ogroup}"
610 }
611 ],
612 "info" : {
613 "GET" : {
614 "description" : "Get 'action' group list.",
615 "method" : "GET",
616 "name" : "action",
617 "parameters" : {
618 "additionalProperties" : 0,
619 "properties" : {
620 "id" : {
621 "description" : "Rule ID.",
622 "type" : "integer",
623 "typetext" : "<integer>"
624 }
625 }
626 },
732d76e1
DM
627 "permissions" : {
628 "check" : [
629 "admin",
630 "audit"
631 ]
632 },
f245a28c
DM
633 "proxyto" : "master",
634 "returns" : {
635 "items" : {
636 "properties" : {
637 "id" : {
638 "type" : "integer"
639 }
640 },
641 "type" : "object"
642 },
643 "type" : "array"
644 }
645 },
646 "POST" : {
647 "description" : "Add group to 'action' list.",
648 "method" : "POST",
649 "name" : "add_action_group",
650 "parameters" : {
651 "additionalProperties" : 0,
652 "properties" : {
653 "id" : {
654 "description" : "Rule ID.",
655 "type" : "integer",
656 "typetext" : "<integer>"
657 },
658 "ogroup" : {
659 "description" : "Groups ID.",
660 "type" : "integer",
661 "typetext" : "<integer>"
662 }
663 }
664 },
732d76e1
DM
665 "permissions" : {
666 "check" : [
667 "admin"
668 ]
669 },
f245a28c
DM
670 "protected" : 1,
671 "proxyto" : "master",
672 "returns" : {
673 "type" : "null"
674 }
675 }
676 },
677 "leaf" : 0,
678 "path" : "/config/ruledb/rules/{id}/action",
679 "text" : "action"
680 }
681 ],
682 "info" : {
683 "DELETE" : {
684 "description" : "Delete rule.",
685 "method" : "DELETE",
686 "name" : "delete_rule",
687 "parameters" : {
688 "additionalProperties" : 0,
689 "properties" : {
690 "id" : {
691 "description" : "Rule ID.",
692 "type" : "integer",
693 "typetext" : "<integer>"
694 }
695 }
696 },
732d76e1
DM
697 "permissions" : {
698 "check" : [
699 "admin"
700 ]
701 },
d7cd791b
DM
702 "protected" : 1,
703 "proxyto" : "master",
f245a28c
DM
704 "returns" : {
705 "type" : "null"
706 }
707 },
708 "GET" : {
709 "description" : "Directory index.",
710 "method" : "GET",
711 "name" : "index",
712 "parameters" : {
713 "additionalProperties" : 0,
714 "properties" : {
715 "id" : {
716 "description" : "Rule ID.",
717 "type" : "integer",
718 "typetext" : "<integer>"
719 }
720 }
721 },
732d76e1
DM
722 "permissions" : {
723 "check" : [
724 "admin",
725 "audit"
726 ]
727 },
f245a28c
DM
728 "returns" : {
729 "items" : {
730 "properties" : {
731 "subdir" : {
732 "type" : "string"
733 }
734 },
735 "type" : "object"
736 },
737 "links" : [
738 {
739 "href" : "{subdir}",
740 "rel" : "child"
741 }
742 ],
743 "type" : "array"
744 }
745 }
746 },
747 "leaf" : 0,
748 "path" : "/config/ruledb/rules/{id}",
749 "text" : "{id}"
750 }
751 ],
752 "info" : {
753 "GET" : {
754 "description" : "Get list of rules.",
755 "method" : "GET",
756 "name" : "list_rules",
757 "parameters" : {
758 "additionalProperties" : 0
759 },
732d76e1
DM
760 "permissions" : {
761 "check" : [
762 "admin",
763 "audit"
764 ]
765 },
f245a28c
DM
766 "proxyto" : "master",
767 "returns" : {
768 "items" : {
769 "properties" : {
770 "id" : {
771 "type" : "integer"
772 }
773 },
774 "type" : "object"
775 },
776 "links" : [
777 {
778 "href" : "{id}",
779 "rel" : "child"
780 }
781 ],
782 "type" : "array"
783 }
784 },
785 "POST" : {
786 "description" : "Create new rule.",
787 "method" : "POST",
788 "name" : "create_rule",
789 "parameters" : {
790 "additionalProperties" : 0,
791 "properties" : {
792 "active" : {
793 "description" : "Flag to activate rule.",
794 "optional" : 1,
795 "type" : "boolean",
796 "typetext" : "<boolean>"
797 },
798 "direction" : {
799 "description" : "Rule direction. Value `0` matches incomming mails, value `1` matches outgoing mails, and value `2` matches both directions.",
800 "maximum" : 2,
801 "minimum" : 0,
802 "optional" : 1,
803 "type" : "integer",
804 "typetext" : "<integer> (0 - 2)"
805 },
806 "name" : {
807 "description" : "Rule name",
808 "type" : "string",
809 "typetext" : "<string>"
810 },
811 "priority" : {
812 "description" : "Rule priotity.",
813 "maximum" : 100,
814 "minimum" : 0,
815 "type" : "integer",
816 "typetext" : "<integer> (0 - 100)"
817 }
818 }
819 },
732d76e1
DM
820 "permissions" : {
821 "check" : [
822 "admin"
823 ]
824 },
f245a28c
DM
825 "protected" : 1,
826 "proxyto" : "master",
827 "returns" : {
828 "type" : "integer"
829 }
830 }
831 },
832 "leaf" : 0,
833 "path" : "/config/ruledb/rules",
834 "text" : "rules"
835 },
836 {
837 "children" : [
838 {
839 "children" : [
840 {
841 "info" : {
842 "DELETE" : {
843 "description" : "Delete 'actions' object.",
844 "method" : "DELETE",
845 "name" : "delete_action",
846 "parameters" : {
847 "additionalProperties" : 0,
848 "properties" : {
849 "id" : {
850 "description" : "Action Object ID.",
851 "pattern" : "\\d+_\\d+",
852 "type" : "string"
853 }
854 }
855 },
732d76e1
DM
856 "permissions" : {
857 "check" : [
858 "admin"
859 ]
860 },
d7cd791b
DM
861 "protected" : 1,
862 "proxyto" : "master",
f245a28c
DM
863 "returns" : {
864 "type" : "null"
865 }
866 }
867 },
868 "leaf" : 1,
869 "path" : "/config/ruledb/action/objects/{id}",
870 "text" : "{id}"
871 }
872 ],
873 "info" : {
874 "GET" : {
875 "description" : "List 'actions' objects.",
876 "method" : "GET",
877 "name" : "list_actions",
878 "parameters" : {
879 "additionalProperties" : 0
880 },
732d76e1
DM
881 "permissions" : {
882 "check" : [
883 "admin",
884 "audit"
885 ]
886 },
d7cd791b 887 "proxyto" : "master",
f245a28c
DM
888 "returns" : {
889 "items" : {
890 "properties" : {
891 "id" : {
892 "description" : "Action Object ID.",
893 "pattern" : "\\d+_\\d+",
894 "type" : "string"
895 }
896 },
897 "type" : "object"
898 },
899 "links" : [
900 {
901 "href" : "{id}",
902 "rel" : "child"
903 }
904 ],
905 "type" : "array"
906 }
907 }
908 },
909 "leaf" : 0,
910 "path" : "/config/ruledb/action/objects",
911 "text" : "objects"
912 },
913 {
914 "children" : [
915 {
916 "info" : {
917 "GET" : {
918 "description" : "Read 'BCC' object settings.",
919 "method" : "GET",
920 "name" : "read_bcc",
921 "parameters" : {
922 "additionalProperties" : 0,
923 "properties" : {
924 "id" : {
925 "description" : "Action Object ID.",
926 "pattern" : "\\d+_\\d+",
927 "type" : "string"
928 }
929 }
930 },
732d76e1
DM
931 "permissions" : {
932 "check" : [
933 "admin",
934 "audit"
935 ]
936 },
f245a28c
DM
937 "proxyto" : "master",
938 "returns" : {
939 "properties" : {
940 "id" : {
941 "type" : "string"
942 }
943 },
944 "type" : "object"
945 }
946 },
947 "PUT" : {
948 "description" : "Update 'BCC' object.",
949 "method" : "PUT",
950 "name" : "update_bcc",
951 "parameters" : {
952 "additionalProperties" : 0,
953 "properties" : {
954 "id" : {
955 "description" : "Action Object ID.",
956 "pattern" : "\\d+_\\d+",
957 "type" : "string"
958 },
959 "info" : {
960 "description" : "Informational comment.",
961 "maxLength" : 255,
962 "optional" : 1,
963 "type" : "string",
964 "typetext" : "<string>"
965 },
966 "name" : {
967 "description" : "Action name.",
968 "maxLength" : 255,
969 "optional" : 1,
970 "type" : "string",
971 "typetext" : "<string>"
972 },
973 "original" : {
974 "default" : 1,
975 "description" : "Send the original, unmodified mail.",
976 "optional" : 1,
977 "type" : "boolean",
978 "typetext" : "<boolean>"
979 },
980 "target" : {
981 "description" : "Send a Blind Carbon Copy to this email address.",
982 "format" : "email",
983 "type" : "string",
984 "typetext" : "<string>"
985 }
986 }
987 },
732d76e1
DM
988 "permissions" : {
989 "check" : [
990 "admin"
991 ]
992 },
d7cd791b 993 "protected" : 1,
f245a28c
DM
994 "proxyto" : "master",
995 "returns" : {
996 "type" : "null"
997 }
998 }
999 },
1000 "leaf" : 1,
1001 "path" : "/config/ruledb/action/bcc/{id}",
1002 "text" : "{id}"
1003 }
1004 ],
1005 "info" : {
1006 "POST" : {
1007 "description" : "Create 'BCC' object.",
1008 "method" : "POST",
1009 "name" : "bcc",
1010 "parameters" : {
1011 "additionalProperties" : 0,
1012 "properties" : {
1013 "info" : {
1014 "description" : "Informational comment.",
1015 "maxLength" : 255,
1016 "optional" : 1,
1017 "type" : "string",
1018 "typetext" : "<string>"
1019 },
1020 "name" : {
1021 "description" : "Action name.",
1022 "maxLength" : 255,
1023 "type" : "string",
1024 "typetext" : "<string>"
1025 },
1026 "original" : {
1027 "default" : 1,
1028 "description" : "Send the original, unmodified mail.",
1029 "optional" : 1,
1030 "type" : "boolean",
1031 "typetext" : "<boolean>"
1032 },
1033 "target" : {
1034 "description" : "Send a Blind Carbon Copy to this email address.",
1035 "format" : "email",
1036 "type" : "string",
1037 "typetext" : "<string>"
1038 }
1039 }
1040 },
732d76e1
DM
1041 "permissions" : {
1042 "check" : [
1043 "admin"
1044 ]
1045 },
d7cd791b 1046 "protected" : 1,
f245a28c
DM
1047 "proxyto" : "master",
1048 "returns" : {
1049 "description" : "The object ID.",
1050 "type" : "string"
1051 }
1052 }
1053 },
1054 "leaf" : 0,
1055 "path" : "/config/ruledb/action/bcc",
1056 "text" : "bcc"
732d76e1 1057 },
f245a28c
DM
1058 {
1059 "children" : [
1060 {
1061 "info" : {
1062 "GET" : {
732d76e1 1063 "description" : "Read 'Header Attribute' object settings.",
f245a28c 1064 "method" : "GET",
732d76e1 1065 "name" : "read_field",
f245a28c
DM
1066 "parameters" : {
1067 "additionalProperties" : 0,
1068 "properties" : {
732d76e1
DM
1069 "id" : {
1070 "description" : "Action Object ID.",
1071 "pattern" : "\\d+_\\d+",
1072 "type" : "string"
f245a28c
DM
1073 }
1074 }
1075 },
732d76e1
DM
1076 "permissions" : {
1077 "check" : [
1078 "admin",
1079 "audit"
1080 ]
1081 },
f245a28c
DM
1082 "proxyto" : "master",
1083 "returns" : {
1084 "properties" : {
1085 "id" : {
f245a28c
DM
1086 "type" : "string"
1087 }
1088 },
1089 "type" : "object"
1090 }
1091 },
1092 "PUT" : {
732d76e1 1093 "description" : "Update 'Header Attribute' object.",
f245a28c 1094 "method" : "PUT",
732d76e1 1095 "name" : "update_field",
f245a28c
DM
1096 "parameters" : {
1097 "additionalProperties" : 0,
1098 "properties" : {
732d76e1
DM
1099 "field" : {
1100 "description" : "The Field",
1101 "maxLength" : 1024,
1102 "pattern" : "[0-9a-zA-Z\\/\\\\[\\]\\+\\-\\.\\*\\_]+",
1103 "type" : "string"
1104 },
1105 "id" : {
1106 "description" : "Action Object ID.",
1107 "pattern" : "\\d+_\\d+",
1108 "type" : "string"
1109 },
f245a28c
DM
1110 "info" : {
1111 "description" : "Informational comment.",
1112 "maxLength" : 255,
1113 "optional" : 1,
1114 "type" : "string",
1115 "typetext" : "<string>"
1116 },
1117 "name" : {
732d76e1 1118 "description" : "Action name.",
f245a28c
DM
1119 "maxLength" : 255,
1120 "optional" : 1,
1121 "type" : "string",
1122 "typetext" : "<string>"
1123 },
732d76e1
DM
1124 "value" : {
1125 "description" : "The Value",
1126 "maxLength" : 1024,
4a46ced6
DM
1127 "type" : "string",
1128 "typetext" : "<string>"
f245a28c
DM
1129 }
1130 }
1131 },
732d76e1
DM
1132 "permissions" : {
1133 "check" : [
1134 "admin"
1135 ]
1136 },
d7cd791b 1137 "protected" : 1,
f245a28c
DM
1138 "proxyto" : "master",
1139 "returns" : {
1140 "type" : "null"
1141 }
1142 }
1143 },
1144 "leaf" : 1,
732d76e1
DM
1145 "path" : "/config/ruledb/action/field/{id}",
1146 "text" : "{id}"
1147 }
1148 ],
1149 "info" : {
1150 "POST" : {
1151 "description" : "Create 'Header Attribute' object.",
1152 "method" : "POST",
1153 "name" : "field",
1154 "parameters" : {
1155 "additionalProperties" : 0,
1156 "properties" : {
1157 "field" : {
1158 "description" : "The Field",
1159 "maxLength" : 1024,
1160 "pattern" : "[0-9a-zA-Z\\/\\\\[\\]\\+\\-\\.\\*\\_]+",
1161 "type" : "string"
1162 },
f245a28c 1163 "info" : {
732d76e1
DM
1164 "description" : "Informational comment.",
1165 "maxLength" : 255,
1166 "optional" : 1,
1167 "type" : "string",
1168 "typetext" : "<string>"
1169 },
1170 "name" : {
1171 "description" : "Action name.",
1172 "maxLength" : 255,
1173 "type" : "string",
1174 "typetext" : "<string>"
1175 },
1176 "value" : {
1177 "description" : "The Value",
1178 "maxLength" : 1024,
4a46ced6
DM
1179 "type" : "string",
1180 "typetext" : "<string>"
732d76e1
DM
1181 }
1182 }
1183 },
1184 "permissions" : {
1185 "check" : [
1186 "admin"
1187 ]
1188 },
1189 "protected" : 1,
1190 "proxyto" : "master",
1191 "returns" : {
1192 "description" : "The object ID.",
1193 "type" : "string"
1194 }
1195 }
1196 },
1197 "leaf" : 0,
1198 "path" : "/config/ruledb/action/field",
1199 "text" : "field"
1200 },
1201 {
1202 "children" : [
1203 {
1204 "info" : {
1205 "GET" : {
1206 "description" : "Read 'Notification' object settings.",
1207 "method" : "GET",
1208 "name" : "read_notification",
1209 "parameters" : {
1210 "additionalProperties" : 0,
1211 "properties" : {
1212 "id" : {
1213 "description" : "Action Object ID.",
1214 "pattern" : "\\d+_\\d+",
1215 "type" : "string"
1216 }
1217 }
1218 },
1219 "permissions" : {
1220 "check" : [
1221 "admin",
1222 "audit"
1223 ]
1224 },
1225 "proxyto" : "master",
1226 "returns" : {
1227 "properties" : {
1228 "id" : {
1229 "type" : "string"
1230 }
1231 },
1232 "type" : "object"
1233 }
1234 },
1235 "PUT" : {
1236 "description" : "Update 'Notification' object.",
1237 "method" : "PUT",
1238 "name" : "update_notification",
1239 "parameters" : {
1240 "additionalProperties" : 0,
1241 "properties" : {
1242 "attach" : {
1243 "default" : 0,
1244 "description" : "Attach original E-Mail",
1245 "optional" : 1,
1246 "type" : "boolean",
1247 "typetext" : "<boolean>"
1248 },
1249 "body" : {
1250 "description" : "The Notification Body",
1251 "maxLength" : 2048,
1252 "type" : "string",
1253 "typetext" : "<string>"
1254 },
1255 "id" : {
1256 "description" : "Action Object ID.",
1257 "pattern" : "\\d+_\\d+",
1258 "type" : "string"
1259 },
1260 "info" : {
1261 "description" : "Informational comment.",
1262 "maxLength" : 255,
1263 "optional" : 1,
1264 "type" : "string",
1265 "typetext" : "<string>"
1266 },
1267 "name" : {
1268 "description" : "Action name.",
1269 "maxLength" : 255,
1270 "optional" : 1,
1271 "type" : "string",
1272 "typetext" : "<string>"
1273 },
1274 "subject" : {
1275 "description" : "The Notification subject",
1276 "maxLength" : 100,
1277 "type" : "string",
1278 "typetext" : "<string>"
1279 },
1280 "to" : {
1281 "description" : "The Receiver E-Mail address",
1282 "maxLength" : 200,
1283 "type" : "string",
1284 "typetext" : "<string>"
1285 }
1286 }
1287 },
1288 "permissions" : {
1289 "check" : [
1290 "admin"
1291 ]
1292 },
1293 "protected" : 1,
1294 "proxyto" : "master",
1295 "returns" : {
1296 "type" : "null"
1297 }
1298 }
1299 },
1300 "leaf" : 1,
1301 "path" : "/config/ruledb/action/notification/{id}",
1302 "text" : "{id}"
1303 }
1304 ],
1305 "info" : {
1306 "POST" : {
1307 "description" : "Create 'Notification' object.",
1308 "method" : "POST",
1309 "name" : "notification",
1310 "parameters" : {
1311 "additionalProperties" : 0,
1312 "properties" : {
1313 "attach" : {
1314 "default" : 0,
1315 "description" : "Attach original E-Mail",
1316 "optional" : 1,
1317 "type" : "boolean",
1318 "typetext" : "<boolean>"
1319 },
1320 "body" : {
1321 "description" : "The Notification Body",
1322 "maxLength" : 2048,
1323 "type" : "string",
1324 "typetext" : "<string>"
1325 },
1326 "info" : {
1327 "description" : "Informational comment.",
1328 "maxLength" : 255,
1329 "optional" : 1,
1330 "type" : "string",
1331 "typetext" : "<string>"
1332 },
1333 "name" : {
1334 "description" : "Action name.",
1335 "maxLength" : 255,
1336 "type" : "string",
1337 "typetext" : "<string>"
1338 },
1339 "subject" : {
1340 "description" : "The Notification subject",
1341 "maxLength" : 100,
1342 "type" : "string",
1343 "typetext" : "<string>"
1344 },
1345 "to" : {
1346 "description" : "The Receiver E-Mail address",
1347 "maxLength" : 200,
1348 "type" : "string",
1349 "typetext" : "<string>"
1350 }
1351 }
1352 },
1353 "permissions" : {
1354 "check" : [
1355 "admin"
1356 ]
1357 },
1358 "protected" : 1,
1359 "proxyto" : "master",
1360 "returns" : {
1361 "description" : "The object ID.",
1362 "type" : "string"
1363 }
1364 }
1365 },
1366 "leaf" : 0,
1367 "path" : "/config/ruledb/action/notification",
1368 "text" : "notification"
1369 },
1370 {
1371 "children" : [
1372 {
1373 "info" : {
1374 "GET" : {
1375 "description" : "Read 'Disclaimer' object settings.",
1376 "method" : "GET",
1377 "name" : "read_disclaimer",
1378 "parameters" : {
1379 "additionalProperties" : 0,
1380 "properties" : {
1381 "id" : {
1382 "description" : "Action Object ID.",
1383 "pattern" : "\\d+_\\d+",
1384 "type" : "string"
1385 }
1386 }
1387 },
1388 "permissions" : {
1389 "check" : [
1390 "admin",
1391 "audit"
1392 ]
1393 },
1394 "proxyto" : "master",
1395 "returns" : {
1396 "properties" : {
1397 "id" : {
1398 "type" : "string"
1399 }
1400 },
1401 "type" : "object"
1402 }
1403 },
1404 "PUT" : {
1405 "description" : "Update 'Disclaimer' object.",
1406 "method" : "PUT",
1407 "name" : "update_disclaimer",
1408 "parameters" : {
1409 "additionalProperties" : 0,
1410 "properties" : {
1411 "disclaimer" : {
1412 "description" : "The Disclaimer",
1413 "maxLength" : 2048,
1414 "type" : "string",
1415 "typetext" : "<string>"
1416 },
1417 "id" : {
1418 "description" : "Action Object ID.",
1419 "pattern" : "\\d+_\\d+",
1420 "type" : "string"
1421 },
1422 "info" : {
1423 "description" : "Informational comment.",
1424 "maxLength" : 255,
1425 "optional" : 1,
1426 "type" : "string",
1427 "typetext" : "<string>"
1428 },
1429 "name" : {
1430 "description" : "Action name.",
1431 "maxLength" : 255,
1432 "optional" : 1,
1433 "type" : "string",
1434 "typetext" : "<string>"
1435 }
1436 }
1437 },
1438 "permissions" : {
1439 "check" : [
1440 "admin"
1441 ]
1442 },
1443 "protected" : 1,
1444 "proxyto" : "master",
1445 "returns" : {
1446 "type" : "null"
1447 }
1448 }
1449 },
1450 "leaf" : 1,
1451 "path" : "/config/ruledb/action/disclaimer/{id}",
1452 "text" : "{id}"
1453 }
1454 ],
1455 "info" : {
1456 "POST" : {
1457 "description" : "Create 'Disclaimer' object.",
1458 "method" : "POST",
1459 "name" : "disclaimer",
1460 "parameters" : {
1461 "additionalProperties" : 0,
1462 "properties" : {
1463 "disclaimer" : {
1464 "description" : "The Disclaimer",
1465 "maxLength" : 2048,
1466 "type" : "string",
1467 "typetext" : "<string>"
1468 },
1469 "info" : {
1470 "description" : "Informational comment.",
1471 "maxLength" : 255,
1472 "optional" : 1,
1473 "type" : "string",
1474 "typetext" : "<string>"
1475 },
1476 "name" : {
1477 "description" : "Action name.",
1478 "maxLength" : 255,
1479 "type" : "string",
1480 "typetext" : "<string>"
1481 }
1482 }
1483 },
1484 "permissions" : {
1485 "check" : [
1486 "admin"
1487 ]
1488 },
1489 "protected" : 1,
1490 "proxyto" : "master",
1491 "returns" : {
1492 "description" : "The object ID.",
1493 "type" : "string"
1494 }
1495 }
1496 },
1497 "leaf" : 0,
1498 "path" : "/config/ruledb/action/disclaimer",
1499 "text" : "disclaimer"
1500 },
1501 {
1502 "children" : [
1503 {
1504 "info" : {
1505 "GET" : {
1506 "description" : "Read 'Remove attachments' object settings.",
1507 "method" : "GET",
1508 "name" : "read_removeattachments",
1509 "parameters" : {
1510 "additionalProperties" : 0,
1511 "properties" : {
1512 "id" : {
1513 "description" : "Action Object ID.",
1514 "pattern" : "\\d+_\\d+",
1515 "type" : "string"
1516 }
1517 }
1518 },
1519 "permissions" : {
1520 "check" : [
1521 "admin",
1522 "audit"
1523 ]
1524 },
1525 "proxyto" : "master",
1526 "returns" : {
1527 "properties" : {
1528 "id" : {
1529 "type" : "string"
1530 }
1531 },
1532 "type" : "object"
1533 }
1534 },
1535 "PUT" : {
1536 "description" : "Update 'Remove attachments' object.",
1537 "method" : "PUT",
1538 "name" : "update_removeattachments",
1539 "parameters" : {
1540 "additionalProperties" : 0,
1541 "properties" : {
1542 "all" : {
1543 "description" : "Remove all attachments",
1544 "optional" : 1,
1545 "type" : "boolean",
1546 "typetext" : "<boolean>"
1547 },
1548 "id" : {
1549 "description" : "Action Object ID.",
1550 "pattern" : "\\d+_\\d+",
1551 "type" : "string"
1552 },
1553 "info" : {
1554 "description" : "Informational comment.",
1555 "maxLength" : 255,
1556 "optional" : 1,
1557 "type" : "string",
1558 "typetext" : "<string>"
1559 },
1560 "name" : {
1561 "description" : "Action name.",
1562 "maxLength" : 255,
1563 "optional" : 1,
1564 "type" : "string",
1565 "typetext" : "<string>"
1566 },
1567 "text" : {
1568 "description" : "The replacement text.",
1569 "maxLength" : 2048,
1570 "type" : "string",
1571 "typetext" : "<string>"
1572 }
1573 }
1574 },
1575 "permissions" : {
1576 "check" : [
1577 "admin"
1578 ]
1579 },
1580 "protected" : 1,
1581 "proxyto" : "master",
1582 "returns" : {
1583 "type" : "null"
1584 }
1585 }
1586 },
1587 "leaf" : 1,
1588 "path" : "/config/ruledb/action/removeattachments/{id}",
1589 "text" : "{id}"
1590 }
1591 ],
1592 "info" : {
1593 "POST" : {
1594 "description" : "Create 'Remove attachments' object.",
1595 "method" : "POST",
1596 "name" : "removeattachments",
1597 "parameters" : {
1598 "additionalProperties" : 0,
1599 "properties" : {
1600 "all" : {
1601 "description" : "Remove all attachments",
1602 "optional" : 1,
1603 "type" : "boolean",
1604 "typetext" : "<boolean>"
1605 },
1606 "info" : {
1607 "description" : "Informational comment.",
1608 "maxLength" : 255,
1609 "optional" : 1,
1610 "type" : "string",
1611 "typetext" : "<string>"
1612 },
1613 "name" : {
1614 "description" : "Action name.",
1615 "maxLength" : 255,
1616 "type" : "string",
1617 "typetext" : "<string>"
1618 },
1619 "text" : {
1620 "description" : "The replacement text.",
1621 "maxLength" : 2048,
1622 "type" : "string",
1623 "typetext" : "<string>"
1624 }
1625 }
1626 },
1627 "permissions" : {
1628 "check" : [
1629 "admin"
1630 ]
1631 },
1632 "protected" : 1,
1633 "proxyto" : "master",
1634 "returns" : {
1635 "description" : "The object ID.",
1636 "type" : "string"
1637 }
1638 }
1639 },
1640 "leaf" : 0,
1641 "path" : "/config/ruledb/action/removeattachments",
1642 "text" : "removeattachments"
1643 }
1644 ],
1645 "info" : {
1646 "GET" : {
1647 "description" : "Directory index.",
1648 "method" : "GET",
1649 "name" : "index",
1650 "parameters" : {
1651 "additionalProperties" : 0
1652 },
1653 "permissions" : {
1654 "check" : [
1655 "admin",
1656 "audit"
1657 ]
1658 },
1659 "returns" : {
1660 "items" : {
1661 "properties" : {
1662 "subdir" : {
1663 "type" : "string"
1664 }
1665 },
1666 "type" : "object"
1667 },
1668 "links" : [
1669 {
1670 "href" : "{subdir}",
1671 "rel" : "child"
1672 }
1673 ],
1674 "type" : "array"
1675 }
1676 }
1677 },
1678 "leaf" : 0,
1679 "path" : "/config/ruledb/action",
1680 "text" : "action"
1681 },
1682 {
1683 "children" : [
1684 {
1685 "children" : [
1686 {
1687 "info" : {
1688 "GET" : {
1689 "description" : "Get 'what' group properties",
1690 "method" : "GET",
1691 "name" : "get_config",
1692 "parameters" : {
1693 "additionalProperties" : 0,
1694 "properties" : {
1695 "ogroup" : {
1696 "description" : "Object Group ID.",
1697 "type" : "integer",
1698 "typetext" : "<integer>"
1699 }
1700 }
1701 },
1702 "permissions" : {
1703 "check" : [
1704 "admin",
1705 "audit"
1706 ]
1707 },
1708 "proxyto" : "master",
1709 "returns" : {
1710 "properties" : {
1711 "id" : {
1712 "type" : "integer"
1713 },
1714 "info" : {
1715 "type" : "string"
1716 },
1717 "name" : {
1718 "type" : "string"
1719 }
1720 },
1721 "type" : "object"
1722 }
1723 },
1724 "PUT" : {
1725 "description" : "Modify 'what' group properties",
1726 "method" : "PUT",
1727 "name" : "set_config",
1728 "parameters" : {
1729 "additionalProperties" : 0,
1730 "properties" : {
1731 "info" : {
1732 "description" : "Informational comment.",
1733 "maxLength" : 255,
1734 "optional" : 1,
1735 "type" : "string",
1736 "typetext" : "<string>"
1737 },
1738 "name" : {
1739 "description" : "Group name.",
1740 "maxLength" : 255,
1741 "optional" : 1,
1742 "type" : "string",
1743 "typetext" : "<string>"
1744 },
1745 "ogroup" : {
1746 "description" : "Object Group ID.",
1747 "type" : "integer",
1748 "typetext" : "<integer>"
1749 }
1750 }
1751 },
1752 "permissions" : {
1753 "check" : [
1754 "admin"
1755 ]
1756 },
1757 "protected" : 1,
1758 "proxyto" : "master",
1759 "returns" : {
1760 "type" : "null"
1761 }
1762 }
1763 },
1764 "leaf" : 1,
1765 "path" : "/config/ruledb/what/{ogroup}/config",
1766 "text" : "config"
1767 },
1768 {
1769 "children" : [
1770 {
1771 "info" : {
1772 "DELETE" : {
1773 "description" : "Remove an object from the 'what' group.",
1774 "method" : "DELETE",
1775 "name" : "delete_object",
1776 "parameters" : {
1777 "additionalProperties" : 0,
1778 "properties" : {
1779 "id" : {
1780 "description" : "Object ID.",
1781 "type" : "integer",
1782 "typetext" : "<integer>"
1783 },
1784 "ogroup" : {
1785 "description" : "Object Group ID.",
1786 "type" : "integer",
1787 "typetext" : "<integer>"
1788 }
1789 }
1790 },
1791 "permissions" : {
1792 "check" : [
1793 "admin"
1794 ]
1795 },
1796 "protected" : 1,
1797 "proxyto" : "master",
f245a28c
DM
1798 "returns" : {
1799 "type" : "null"
1800 }
1801 }
1802 },
1803 "leaf" : 1,
1804 "path" : "/config/ruledb/what/{ogroup}/objects/{id}",
1805 "text" : "{id}"
1806 }
1807 ],
1808 "info" : {
1809 "GET" : {
1810 "description" : "List 'what' group objects.",
1811 "method" : "GET",
1812 "name" : "objects",
1813 "parameters" : {
1814 "additionalProperties" : 0,
1815 "properties" : {
1816 "ogroup" : {
1817 "description" : "Object Group ID.",
1818 "type" : "integer",
1819 "typetext" : "<integer>"
1820 }
1821 }
1822 },
732d76e1
DM
1823 "permissions" : {
1824 "check" : [
1825 "admin",
1826 "audit"
1827 ]
1828 },
f245a28c
DM
1829 "proxyto" : "master",
1830 "returns" : {
1831 "items" : {
1832 "properties" : {
1833 "id" : {
1834 "type" : "integer"
1835 }
1836 },
1837 "type" : "object"
1838 },
1839 "links" : [
1840 {
1841 "href" : "{id}",
1842 "rel" : "child"
1843 }
1844 ],
1845 "type" : "array"
1846 }
1847 }
1848 },
1849 "leaf" : 0,
1850 "path" : "/config/ruledb/what/{ogroup}/objects",
1851 "text" : "objects"
f245a28c 1852 },
9fda36b0
DM
1853 {
1854 "children" : [
1855 {
1856 "info" : {
1857 "GET" : {
1858 "description" : "Read 'ContentType Filter' object settings.",
1859 "method" : "GET",
1860 "name" : "read_contenttype",
1861 "parameters" : {
1862 "additionalProperties" : 0,
1863 "properties" : {
1864 "id" : {
1865 "description" : "Object ID.",
1866 "type" : "integer",
1867 "typetext" : "<integer>"
1868 },
1869 "ogroup" : {
1870 "description" : "Object Groups ID.",
1871 "type" : "integer",
1872 "typetext" : "<integer>"
1873 }
1874 }
1875 },
c061d61d
DM
1876 "permissions" : {
1877 "check" : [
1878 "admin",
1879 "audit"
1880 ]
1881 },
9fda36b0
DM
1882 "proxyto" : "master",
1883 "returns" : {
1884 "properties" : {
1885 "id" : {
1886 "type" : "integer"
1887 }
1888 },
1889 "type" : "object"
1890 }
1891 },
1892 "PUT" : {
1893 "description" : "Update 'ContentType Filter' object.",
1894 "method" : "PUT",
1895 "name" : "update_contenttype",
1896 "parameters" : {
1897 "additionalProperties" : 0,
1898 "properties" : {
1899 "contenttype" : {
1900 "description" : "Content Type",
1901 "maxLength" : 1024,
1902 "pattern" : "[0-9a-zA-Z\\/\\\\[\\]\\+\\-\\.\\*\\_]+",
1903 "type" : "string"
1904 },
1905 "id" : {
1906 "description" : "Object ID.",
1907 "type" : "integer",
1908 "typetext" : "<integer>"
1909 },
1910 "ogroup" : {
1911 "description" : "Object Groups ID.",
1912 "type" : "integer",
1913 "typetext" : "<integer>"
1914 }
1915 }
1916 },
c061d61d
DM
1917 "permissions" : {
1918 "check" : [
1919 "admin"
1920 ]
1921 },
9fda36b0
DM
1922 "protected" : 1,
1923 "proxyto" : "master",
1924 "returns" : {
1925 "type" : "null"
1926 }
f245a28c
DM
1927 }
1928 },
9fda36b0
DM
1929 "leaf" : 1,
1930 "path" : "/config/ruledb/what/{ogroup}/contenttype/{id}",
1931 "text" : "{id}"
eff914dc 1932 }
9fda36b0 1933 ],
f245a28c 1934 "info" : {
9fda36b0
DM
1935 "POST" : {
1936 "description" : "Add 'ContentType Filter' object.",
1937 "method" : "POST",
1938 "name" : "contenttype",
f245a28c
DM
1939 "parameters" : {
1940 "additionalProperties" : 0,
1941 "properties" : {
9fda36b0
DM
1942 "contenttype" : {
1943 "description" : "Content Type",
1944 "maxLength" : 1024,
1945 "pattern" : "[0-9a-zA-Z\\/\\\\[\\]\\+\\-\\.\\*\\_]+",
f245a28c 1946 "type" : "string"
f245a28c
DM
1947 },
1948 "ogroup" : {
9fda36b0 1949 "description" : "Object Groups ID.",
f245a28c
DM
1950 "type" : "integer",
1951 "typetext" : "<integer>"
1952 }
1953 }
1954 },
c061d61d
DM
1955 "permissions" : {
1956 "check" : [
1957 "admin"
1958 ]
1959 },
d7cd791b 1960 "protected" : 1,
f245a28c
DM
1961 "proxyto" : "master",
1962 "returns" : {
9fda36b0
DM
1963 "description" : "The object ID.",
1964 "type" : "integer"
f245a28c
DM
1965 }
1966 }
1967 },
9fda36b0
DM
1968 "leaf" : 0,
1969 "path" : "/config/ruledb/what/{ogroup}/contenttype",
1970 "text" : "contenttype"
f245a28c
DM
1971 },
1972 {
1973 "children" : [
1974 {
1975 "info" : {
9fda36b0
DM
1976 "GET" : {
1977 "description" : "Read 'Match Field' object settings.",
1978 "method" : "GET",
1979 "name" : "read_matchfield",
f245a28c
DM
1980 "parameters" : {
1981 "additionalProperties" : 0,
1982 "properties" : {
1983 "id" : {
1984 "description" : "Object ID.",
1985 "type" : "integer",
1986 "typetext" : "<integer>"
1987 },
1988 "ogroup" : {
9fda36b0 1989 "description" : "Object Groups ID.",
f245a28c
DM
1990 "type" : "integer",
1991 "typetext" : "<integer>"
1992 }
1993 }
1994 },
c061d61d
DM
1995 "permissions" : {
1996 "check" : [
1997 "admin",
1998 "audit"
1999 ]
2000 },
f245a28c
DM
2001 "proxyto" : "master",
2002 "returns" : {
9fda36b0
DM
2003 "properties" : {
2004 "id" : {
2005 "type" : "integer"
2006 }
2007 },
2008 "type" : "object"
f245a28c 2009 }
9fda36b0
DM
2010 },
2011 "PUT" : {
2012 "description" : "Update 'Match Field' object.",
2013 "method" : "PUT",
2014 "name" : "update_matchfield",
2015 "parameters" : {
2016 "additionalProperties" : 0,
2017 "properties" : {
2018 "field" : {
2019 "description" : "The Field",
2020 "maxLength" : 1024,
2021 "pattern" : "[0-9a-zA-Z\\/\\\\[\\]\\+\\-\\.\\*\\_]+",
2022 "type" : "string"
2023 },
2024 "id" : {
2025 "description" : "Object ID.",
2026 "type" : "integer",
2027 "typetext" : "<integer>"
2028 },
2029 "ogroup" : {
2030 "description" : "Object Groups ID.",
2031 "type" : "integer",
2032 "typetext" : "<integer>"
2033 },
2034 "value" : {
2035 "description" : "The Value",
2036 "maxLength" : 1024,
4a46ced6
DM
2037 "type" : "string",
2038 "typetext" : "<string>"
9fda36b0
DM
2039 }
2040 }
2041 },
c061d61d
DM
2042 "permissions" : {
2043 "check" : [
2044 "admin"
2045 ]
2046 },
9fda36b0
DM
2047 "protected" : 1,
2048 "proxyto" : "master",
2049 "returns" : {
2050 "type" : "null"
2051 }
2052 }
2053 },
2054 "leaf" : 1,
2055 "path" : "/config/ruledb/what/{ogroup}/matchfield/{id}",
2056 "text" : "{id}"
2057 }
2058 ],
f245a28c 2059 "info" : {
9fda36b0
DM
2060 "POST" : {
2061 "description" : "Add 'Match Field' object.",
2062 "method" : "POST",
2063 "name" : "matchfield",
f245a28c
DM
2064 "parameters" : {
2065 "additionalProperties" : 0,
2066 "properties" : {
9fda36b0
DM
2067 "field" : {
2068 "description" : "The Field",
2069 "maxLength" : 1024,
2070 "pattern" : "[0-9a-zA-Z\\/\\\\[\\]\\+\\-\\.\\*\\_]+",
2071 "type" : "string"
2072 },
f245a28c 2073 "ogroup" : {
9fda36b0 2074 "description" : "Object Groups ID.",
f245a28c
DM
2075 "type" : "integer",
2076 "typetext" : "<integer>"
9fda36b0
DM
2077 },
2078 "value" : {
2079 "description" : "The Value",
2080 "maxLength" : 1024,
4a46ced6
DM
2081 "type" : "string",
2082 "typetext" : "<string>"
f245a28c
DM
2083 }
2084 }
2085 },
c061d61d
DM
2086 "permissions" : {
2087 "check" : [
2088 "admin"
2089 ]
2090 },
9fda36b0 2091 "protected" : 1,
f245a28c
DM
2092 "proxyto" : "master",
2093 "returns" : {
9fda36b0
DM
2094 "description" : "The object ID.",
2095 "type" : "integer"
f245a28c
DM
2096 }
2097 }
2098 },
2099 "leaf" : 0,
9fda36b0
DM
2100 "path" : "/config/ruledb/what/{ogroup}/matchfield",
2101 "text" : "matchfield"
f245a28c
DM
2102 },
2103 {
2104 "children" : [
2105 {
2106 "info" : {
2107 "GET" : {
9fda36b0 2108 "description" : "Read 'Spam Filter' object settings.",
f245a28c 2109 "method" : "GET",
9fda36b0 2110 "name" : "read_spamfilter",
f245a28c
DM
2111 "parameters" : {
2112 "additionalProperties" : 0,
2113 "properties" : {
2114 "id" : {
2115 "description" : "Object ID.",
2116 "type" : "integer",
2117 "typetext" : "<integer>"
2118 },
2119 "ogroup" : {
2120 "description" : "Object Groups ID.",
2121 "type" : "integer",
2122 "typetext" : "<integer>"
2123 }
2124 }
2125 },
c061d61d
DM
2126 "permissions" : {
2127 "check" : [
2128 "admin",
2129 "audit"
2130 ]
2131 },
f245a28c
DM
2132 "proxyto" : "master",
2133 "returns" : {
2134 "properties" : {
2135 "id" : {
2136 "type" : "integer"
2137 }
2138 },
2139 "type" : "object"
2140 }
2141 },
2142 "PUT" : {
9fda36b0 2143 "description" : "Update 'Spam Filter' object.",
f245a28c 2144 "method" : "PUT",
9fda36b0 2145 "name" : "update_spamfilter",
f245a28c
DM
2146 "parameters" : {
2147 "additionalProperties" : 0,
2148 "properties" : {
f245a28c
DM
2149 "id" : {
2150 "description" : "Object ID.",
2151 "type" : "integer",
2152 "typetext" : "<integer>"
2153 },
2154 "ogroup" : {
2155 "description" : "Object Groups ID.",
2156 "type" : "integer",
2157 "typetext" : "<integer>"
2158 },
9fda36b0
DM
2159 "spamlevel" : {
2160 "description" : "Spam Level",
2161 "minimum" : 0,
2162 "type" : "integer",
2163 "typetext" : "<integer> (0 - N)"
f245a28c
DM
2164 }
2165 }
2166 },
c061d61d
DM
2167 "permissions" : {
2168 "check" : [
2169 "admin"
2170 ]
2171 },
a55e94a6 2172 "protected" : 1,
f245a28c
DM
2173 "proxyto" : "master",
2174 "returns" : {
2175 "type" : "null"
2176 }
2177 }
2178 },
2179 "leaf" : 1,
9fda36b0 2180 "path" : "/config/ruledb/what/{ogroup}/spamfilter/{id}",
f245a28c
DM
2181 "text" : "{id}"
2182 }
2183 ],
2184 "info" : {
2185 "POST" : {
9fda36b0 2186 "description" : "Add 'Spam Filter' object.",
f245a28c 2187 "method" : "POST",
9fda36b0 2188 "name" : "spamfilter",
f245a28c
DM
2189 "parameters" : {
2190 "additionalProperties" : 0,
2191 "properties" : {
f245a28c
DM
2192 "ogroup" : {
2193 "description" : "Object Groups ID.",
2194 "type" : "integer",
2195 "typetext" : "<integer>"
2196 },
9fda36b0
DM
2197 "spamlevel" : {
2198 "description" : "Spam Level",
2199 "minimum" : 0,
2200 "type" : "integer",
2201 "typetext" : "<integer> (0 - N)"
f245a28c
DM
2202 }
2203 }
2204 },
c061d61d
DM
2205 "permissions" : {
2206 "check" : [
2207 "admin"
2208 ]
2209 },
a55e94a6 2210 "protected" : 1,
f245a28c
DM
2211 "proxyto" : "master",
2212 "returns" : {
2213 "description" : "The object ID.",
2214 "type" : "integer"
2215 }
2216 }
2217 },
2218 "leaf" : 0,
9fda36b0
DM
2219 "path" : "/config/ruledb/what/{ogroup}/spamfilter",
2220 "text" : "spamfilter"
410dc2c9 2221 },
9fda36b0
DM
2222 {
2223 "children" : [
2224 {
2225 "info" : {
2226 "GET" : {
2227 "description" : "Read 'Archive Filter' object settings.",
2228 "method" : "GET",
2229 "name" : "read_archivefilter",
2230 "parameters" : {
2231 "additionalProperties" : 0,
2232 "properties" : {
2233 "id" : {
2234 "description" : "Object ID.",
2235 "type" : "integer",
2236 "typetext" : "<integer>"
2237 },
2238 "ogroup" : {
2239 "description" : "Object Groups ID.",
2240 "type" : "integer",
2241 "typetext" : "<integer>"
2242 }
2243 }
2244 },
c061d61d
DM
2245 "permissions" : {
2246 "check" : [
2247 "admin",
2248 "audit"
2249 ]
2250 },
9fda36b0
DM
2251 "proxyto" : "master",
2252 "returns" : {
2253 "properties" : {
2254 "id" : {
2255 "type" : "integer"
2256 }
2257 },
2258 "type" : "object"
2259 }
2260 },
2261 "PUT" : {
2262 "description" : "Update 'Archive Filter' object.",
2263 "method" : "PUT",
2264 "name" : "update_archivefilter",
2265 "parameters" : {
2266 "additionalProperties" : 0,
2267 "properties" : {
2268 "contenttype" : {
2269 "description" : "Content Type",
2270 "maxLength" : 1024,
2271 "pattern" : "[0-9a-zA-Z\\/\\\\[\\]\\+\\-\\.\\*\\_]+",
2272 "type" : "string"
2273 },
2274 "id" : {
2275 "description" : "Object ID.",
2276 "type" : "integer",
2277 "typetext" : "<integer>"
2278 },
2279 "ogroup" : {
2280 "description" : "Object Groups ID.",
2281 "type" : "integer",
2282 "typetext" : "<integer>"
2283 }
2284 }
2285 },
c061d61d
DM
2286 "permissions" : {
2287 "check" : [
2288 "admin"
2289 ]
2290 },
9fda36b0
DM
2291 "protected" : 1,
2292 "proxyto" : "master",
2293 "returns" : {
2294 "type" : "null"
2295 }
2296 }
2297 },
2298 "leaf" : 1,
2299 "path" : "/config/ruledb/what/{ogroup}/archivefilter/{id}",
2300 "text" : "{id}"
f245a28c 2301 }
9fda36b0
DM
2302 ],
2303 "info" : {
2304 "POST" : {
2305 "description" : "Add 'Archive Filter' object.",
2306 "method" : "POST",
2307 "name" : "archivefilter",
2308 "parameters" : {
2309 "additionalProperties" : 0,
2310 "properties" : {
2311 "contenttype" : {
2312 "description" : "Content Type",
2313 "maxLength" : 1024,
2314 "pattern" : "[0-9a-zA-Z\\/\\\\[\\]\\+\\-\\.\\*\\_]+",
2315 "type" : "string"
2316 },
2317 "ogroup" : {
2318 "description" : "Object Groups ID.",
2319 "type" : "integer",
2320 "typetext" : "<integer>"
2321 }
f245a28c
DM
2322 }
2323 },
c061d61d
DM
2324 "permissions" : {
2325 "check" : [
2326 "admin"
2327 ]
2328 },
9fda36b0
DM
2329 "protected" : 1,
2330 "proxyto" : "master",
2331 "returns" : {
2332 "description" : "The object ID.",
2333 "type" : "integer"
f245a28c 2334 }
eff914dc
DM
2335 }
2336 },
9fda36b0 2337 "leaf" : 0,
732d76e1
DM
2338 "path" : "/config/ruledb/what/{ogroup}/archivefilter",
2339 "text" : "archivefilter"
2340 },
2341 {
2342 "children" : [
2343 {
2344 "info" : {
2345 "GET" : {
2346 "description" : "Read 'Match Filename' object settings.",
2347 "method" : "GET",
2348 "name" : "read_filenamefilter",
2349 "parameters" : {
2350 "additionalProperties" : 0,
2351 "properties" : {
2352 "id" : {
2353 "description" : "Object ID.",
2354 "type" : "integer",
2355 "typetext" : "<integer>"
2356 },
2357 "ogroup" : {
2358 "description" : "Object Groups ID.",
2359 "type" : "integer",
2360 "typetext" : "<integer>"
2361 }
2362 }
2363 },
c061d61d
DM
2364 "permissions" : {
2365 "check" : [
2366 "admin",
2367 "audit"
2368 ]
2369 },
732d76e1
DM
2370 "proxyto" : "master",
2371 "returns" : {
2372 "properties" : {
2373 "id" : {
2374 "type" : "integer"
2375 }
2376 },
2377 "type" : "object"
2378 }
2379 },
2380 "PUT" : {
2381 "description" : "Update 'Match Filename' object.",
2382 "method" : "PUT",
2383 "name" : "update_filenamefilter",
2384 "parameters" : {
2385 "additionalProperties" : 0,
2386 "properties" : {
2387 "filename" : {
2388 "description" : "Filename filter",
2389 "maxLength" : 1024,
2390 "type" : "string",
2391 "typetext" : "<string>"
2392 },
2393 "id" : {
2394 "description" : "Object ID.",
2395 "type" : "integer",
2396 "typetext" : "<integer>"
2397 },
2398 "ogroup" : {
2399 "description" : "Object Groups ID.",
2400 "type" : "integer",
2401 "typetext" : "<integer>"
2402 }
2403 }
2404 },
c061d61d
DM
2405 "permissions" : {
2406 "check" : [
2407 "admin"
2408 ]
2409 },
732d76e1
DM
2410 "protected" : 1,
2411 "proxyto" : "master",
2412 "returns" : {
2413 "type" : "null"
2414 }
2415 }
2416 },
2417 "leaf" : 1,
2418 "path" : "/config/ruledb/what/{ogroup}/filenamefilter/{id}",
2419 "text" : "{id}"
2420 }
2421 ],
2422 "info" : {
2423 "POST" : {
2424 "description" : "Add 'Match Filename' object.",
2425 "method" : "POST",
2426 "name" : "filenamefilter",
2427 "parameters" : {
2428 "additionalProperties" : 0,
2429 "properties" : {
2430 "filename" : {
2431 "description" : "Filename filter",
2432 "maxLength" : 1024,
2433 "type" : "string",
2434 "typetext" : "<string>"
2435 },
2436 "ogroup" : {
2437 "description" : "Object Groups ID.",
2438 "type" : "integer",
2439 "typetext" : "<integer>"
2440 }
2441 }
2442 },
c061d61d
DM
2443 "permissions" : {
2444 "check" : [
2445 "admin"
2446 ]
2447 },
732d76e1
DM
2448 "protected" : 1,
2449 "proxyto" : "master",
2450 "returns" : {
2451 "description" : "The object ID.",
2452 "type" : "integer"
2453 }
2454 }
2455 },
2456 "leaf" : 0,
2457 "path" : "/config/ruledb/what/{ogroup}/filenamefilter",
2458 "text" : "filenamefilter"
410dc2c9 2459 },
9fda36b0
DM
2460 {
2461 "children" : [
2462 {
2463 "info" : {
2464 "GET" : {
732d76e1 2465 "description" : "Read 'Virus Filter' object settings.",
9fda36b0 2466 "method" : "GET",
732d76e1 2467 "name" : "read_virusfilter",
9fda36b0
DM
2468 "parameters" : {
2469 "additionalProperties" : 0,
2470 "properties" : {
2471 "id" : {
2472 "description" : "Object ID.",
2473 "type" : "integer",
2474 "typetext" : "<integer>"
2475 },
2476 "ogroup" : {
2477 "description" : "Object Groups ID.",
2478 "type" : "integer",
2479 "typetext" : "<integer>"
2480 }
2481 }
2482 },
c061d61d
DM
2483 "permissions" : {
2484 "check" : [
2485 "admin",
2486 "audit"
2487 ]
2488 },
9fda36b0
DM
2489 "proxyto" : "master",
2490 "returns" : {
2491 "properties" : {
2492 "id" : {
2493 "type" : "integer"
2494 }
2495 },
2496 "type" : "object"
2497 }
2498 },
2499 "PUT" : {
732d76e1 2500 "description" : "Update 'Virus Filter' object.",
9fda36b0 2501 "method" : "PUT",
732d76e1 2502 "name" : "update_virusfilter",
9fda36b0
DM
2503 "parameters" : {
2504 "additionalProperties" : 0,
2505 "properties" : {
9fda36b0
DM
2506 "id" : {
2507 "description" : "Object ID.",
2508 "type" : "integer",
2509 "typetext" : "<integer>"
2510 },
2511 "ogroup" : {
2512 "description" : "Object Groups ID.",
2513 "type" : "integer",
2514 "typetext" : "<integer>"
2515 }
2516 }
2517 },
c061d61d
DM
2518 "permissions" : {
2519 "check" : [
2520 "admin"
2521 ]
2522 },
9fda36b0
DM
2523 "protected" : 1,
2524 "proxyto" : "master",
2525 "returns" : {
2526 "type" : "null"
2527 }
2528 }
2529 },
2530 "leaf" : 1,
732d76e1 2531 "path" : "/config/ruledb/what/{ogroup}/virusfilter/{id}",
9fda36b0
DM
2532 "text" : "{id}"
2533 }
2534 ],
2535 "info" : {
2536 "POST" : {
732d76e1 2537 "description" : "Add 'Virus Filter' object.",
9fda36b0 2538 "method" : "POST",
732d76e1 2539 "name" : "virusfilter",
9fda36b0
DM
2540 "parameters" : {
2541 "additionalProperties" : 0,
2542 "properties" : {
9fda36b0
DM
2543 "ogroup" : {
2544 "description" : "Object Groups ID.",
2545 "type" : "integer",
2546 "typetext" : "<integer>"
2547 }
2548 }
2549 },
c061d61d
DM
2550 "permissions" : {
2551 "check" : [
2552 "admin"
2553 ]
2554 },
9fda36b0
DM
2555 "protected" : 1,
2556 "proxyto" : "master",
2557 "returns" : {
2558 "description" : "The object ID.",
2559 "type" : "integer"
2560 }
2561 }
2562 },
2563 "leaf" : 0,
732d76e1
DM
2564 "path" : "/config/ruledb/what/{ogroup}/virusfilter",
2565 "text" : "virusfilter"
9fda36b0
DM
2566 }
2567 ],
2568 "info" : {
2569 "DELETE" : {
2570 "description" : "Delete a 'what' group.",
2571 "method" : "DELETE",
2572 "name" : "delete_{$oclass}_group",
2573 "parameters" : {
2574 "additionalProperties" : 0,
2575 "properties" : {
2576 "ogroup" : {
2577 "description" : "Object Group ID.",
2578 "type" : "integer",
2579 "typetext" : "<integer>"
2580 }
2581 }
2582 },
732d76e1
DM
2583 "permissions" : {
2584 "check" : [
2585 "admin"
2586 ]
2587 },
9fda36b0
DM
2588 "protected" : 1,
2589 "proxyto" : "master",
2590 "returns" : {
2591 "type" : "null"
2592 }
2593 },
2594 "GET" : {
2595 "description" : "Directory index.",
2596 "method" : "GET",
2597 "name" : "index",
2598 "parameters" : {
2599 "additionalProperties" : 0,
2600 "properties" : {
2601 "ogroup" : {
2602 "description" : "Object Group ID.",
2603 "type" : "integer",
2604 "typetext" : "<integer>"
2605 }
2606 }
2607 },
732d76e1
DM
2608 "permissions" : {
2609 "check" : [
2610 "admin",
2611 "audit"
2612 ]
2613 },
9fda36b0
DM
2614 "returns" : {
2615 "items" : {
2616 "properties" : {
2617 "subdir" : {
2618 "type" : "string"
2619 }
2620 },
2621 "type" : "object"
2622 },
2623 "links" : [
2624 {
2625 "href" : "{subdir}",
2626 "rel" : "child"
2627 }
2628 ],
2629 "type" : "array"
2630 }
2631 }
2632 },
2633 "leaf" : 0,
2634 "path" : "/config/ruledb/what/{ogroup}",
2635 "text" : "{ogroup}"
2636 }
2637 ],
2638 "info" : {
2639 "GET" : {
2640 "description" : "Get list of 'what' groups.",
2641 "method" : "GET",
2642 "name" : "list_what_groups",
2643 "parameters" : {
2644 "additionalProperties" : 0
2645 },
732d76e1
DM
2646 "permissions" : {
2647 "check" : [
2648 "admin",
2649 "audit"
2650 ]
2651 },
9fda36b0
DM
2652 "proxyto" : "master",
2653 "returns" : {
2654 "items" : {
2655 "properties" : {
2656 "id" : {
2657 "type" : "integer"
2658 }
2659 },
2660 "type" : "object"
2661 },
2662 "type" : "array"
2663 }
2664 },
2665 "POST" : {
2666 "description" : "Create a new 'what' group.",
eff914dc 2667 "method" : "POST",
9fda36b0 2668 "name" : "create_what_group",
eff914dc
DM
2669 "parameters" : {
2670 "additionalProperties" : 0,
2671 "properties" : {
2672 "info" : {
2673 "description" : "Informational comment.",
2674 "maxLength" : 255,
2675 "optional" : 1,
2676 "type" : "string",
2677 "typetext" : "<string>"
2678 },
2679 "name" : {
2680 "description" : "Group name.",
2681 "maxLength" : 255,
2682 "type" : "string",
2683 "typetext" : "<string>"
2684 }
2685 }
2686 },
732d76e1
DM
2687 "permissions" : {
2688 "check" : [
2689 "admin"
2690 ]
2691 },
eff914dc
DM
2692 "protected" : 1,
2693 "proxyto" : "master",
2694 "returns" : {
2695 "type" : "integer"
2696 }
410dc2c9
DM
2697 }
2698 },
f245a28c 2699 "leaf" : 0,
9fda36b0
DM
2700 "path" : "/config/ruledb/what",
2701 "text" : "what"
410dc2c9
DM
2702 },
2703 {
f245a28c
DM
2704 "children" : [
2705 {
2706 "children" : [
2707 {
eff914dc 2708 "info" : {
f245a28c 2709 "GET" : {
9fda36b0 2710 "description" : "Get 'when' group properties",
f245a28c
DM
2711 "method" : "GET",
2712 "name" : "get_config",
2713 "parameters" : {
2714 "additionalProperties" : 0,
2715 "properties" : {
2716 "ogroup" : {
2717 "description" : "Object Group ID.",
2718 "type" : "integer",
2719 "typetext" : "<integer>"
2720 }
2721 }
2722 },
732d76e1
DM
2723 "permissions" : {
2724 "check" : [
2725 "admin",
2726 "audit"
2727 ]
2728 },
f245a28c
DM
2729 "proxyto" : "master",
2730 "returns" : {
2731 "properties" : {
2732 "id" : {
2733 "type" : "integer"
2734 },
2735 "info" : {
2736 "type" : "string"
2737 },
2738 "name" : {
2739 "type" : "string"
2740 }
2741 },
2742 "type" : "object"
2743 }
2744 },
2745 "PUT" : {
9fda36b0 2746 "description" : "Modify 'when' group properties",
f245a28c
DM
2747 "method" : "PUT",
2748 "name" : "set_config",
2749 "parameters" : {
2750 "additionalProperties" : 0,
2751 "properties" : {
2752 "info" : {
2753 "description" : "Informational comment.",
2754 "maxLength" : 255,
2755 "optional" : 1,
2756 "type" : "string",
2757 "typetext" : "<string>"
2758 },
2759 "name" : {
2760 "description" : "Group name.",
2761 "maxLength" : 255,
2762 "optional" : 1,
2763 "type" : "string",
2764 "typetext" : "<string>"
2765 },
2766 "ogroup" : {
2767 "description" : "Object Group ID.",
2768 "type" : "integer",
2769 "typetext" : "<integer>"
2770 }
2771 }
2772 },
732d76e1
DM
2773 "permissions" : {
2774 "check" : [
2775 "admin"
2776 ]
2777 },
d7cd791b 2778 "protected" : 1,
f245a28c
DM
2779 "proxyto" : "master",
2780 "returns" : {
2781 "type" : "null"
2782 }
2783 }
eff914dc 2784 },
f245a28c 2785 "leaf" : 1,
9fda36b0 2786 "path" : "/config/ruledb/when/{ogroup}/config",
f245a28c
DM
2787 "text" : "config"
2788 },
eff914dc
DM
2789 {
2790 "children" : [
2791 {
2792 "info" : {
2793 "DELETE" : {
9fda36b0 2794 "description" : "Remove an object from the 'when' group.",
eff914dc
DM
2795 "method" : "DELETE",
2796 "name" : "delete_object",
2797 "parameters" : {
2798 "additionalProperties" : 0,
2799 "properties" : {
2800 "id" : {
2801 "description" : "Object ID.",
2802 "type" : "integer",
2803 "typetext" : "<integer>"
2804 },
2805 "ogroup" : {
2806 "description" : "Object Group ID.",
2807 "type" : "integer",
2808 "typetext" : "<integer>"
2809 }
2810 }
2811 },
732d76e1
DM
2812 "permissions" : {
2813 "check" : [
2814 "admin"
2815 ]
2816 },
a55e94a6 2817 "protected" : 1,
eff914dc
DM
2818 "proxyto" : "master",
2819 "returns" : {
2820 "type" : "null"
2821 }
2822 }
2823 },
2824 "leaf" : 1,
9fda36b0 2825 "path" : "/config/ruledb/when/{ogroup}/objects/{id}",
eff914dc
DM
2826 "text" : "{id}"
2827 }
2828 ],
2829 "info" : {
2830 "GET" : {
9fda36b0 2831 "description" : "List 'when' group objects.",
eff914dc
DM
2832 "method" : "GET",
2833 "name" : "objects",
2834 "parameters" : {
2835 "additionalProperties" : 0,
2836 "properties" : {
2837 "ogroup" : {
2838 "description" : "Object Group ID.",
2839 "type" : "integer",
2840 "typetext" : "<integer>"
2841 }
2842 }
2843 },
732d76e1
DM
2844 "permissions" : {
2845 "check" : [
2846 "admin",
2847 "audit"
2848 ]
2849 },
eff914dc
DM
2850 "proxyto" : "master",
2851 "returns" : {
2852 "items" : {
2853 "properties" : {
2854 "id" : {
2855 "type" : "integer"
2856 }
2857 },
2858 "type" : "object"
2859 },
2860 "links" : [
2861 {
2862 "href" : "{id}",
2863 "rel" : "child"
2864 }
2865 ],
2866 "type" : "array"
2867 }
2868 }
2869 },
2870 "leaf" : 0,
9fda36b0 2871 "path" : "/config/ruledb/when/{ogroup}/objects",
eff914dc
DM
2872 "text" : "objects"
2873 },
2874 {
2875 "children" : [
2876 {
2877 "info" : {
2878 "GET" : {
9fda36b0 2879 "description" : "Read 'TimeFrame' object settings.",
eff914dc 2880 "method" : "GET",
9fda36b0 2881 "name" : "read_timeframe",
eff914dc
DM
2882 "parameters" : {
2883 "additionalProperties" : 0,
2884 "properties" : {
2885 "id" : {
2886 "description" : "Object ID.",
2887 "type" : "integer",
2888 "typetext" : "<integer>"
2889 },
2890 "ogroup" : {
2891 "description" : "Object Groups ID.",
2892 "type" : "integer",
2893 "typetext" : "<integer>"
2894 }
2895 }
2896 },
c061d61d
DM
2897 "permissions" : {
2898 "check" : [
2899 "admin",
2900 "audit"
2901 ]
2902 },
eff914dc
DM
2903 "proxyto" : "master",
2904 "returns" : {
2905 "properties" : {
2906 "id" : {
2907 "type" : "integer"
2908 }
2909 },
2910 "type" : "object"
2911 }
2912 },
2913 "PUT" : {
9fda36b0 2914 "description" : "Update 'TimeFrame' object.",
eff914dc 2915 "method" : "PUT",
9fda36b0 2916 "name" : "update_timeframe",
eff914dc
DM
2917 "parameters" : {
2918 "additionalProperties" : 0,
2919 "properties" : {
9fda36b0
DM
2920 "end" : {
2921 "description" : "End time in `H:i` format (00:00).",
2922 "pattern" : "\\d?\\d:\\d?\\d",
2923 "type" : "string"
eff914dc
DM
2924 },
2925 "id" : {
2926 "description" : "Object ID.",
2927 "type" : "integer",
2928 "typetext" : "<integer>"
2929 },
2930 "ogroup" : {
2931 "description" : "Object Groups ID.",
2932 "type" : "integer",
2933 "typetext" : "<integer>"
9fda36b0
DM
2934 },
2935 "start" : {
2936 "description" : "Start time in `H:i` format (00:00).",
2937 "pattern" : "\\d?\\d:\\d?\\d",
2938 "type" : "string"
eff914dc
DM
2939 }
2940 }
2941 },
c061d61d
DM
2942 "permissions" : {
2943 "check" : [
2944 "admin"
2945 ]
2946 },
a55e94a6 2947 "protected" : 1,
eff914dc
DM
2948 "proxyto" : "master",
2949 "returns" : {
2950 "type" : "null"
2951 }
2952 }
2953 },
2954 "leaf" : 1,
9fda36b0 2955 "path" : "/config/ruledb/when/{ogroup}/timeframe/{id}",
eff914dc
DM
2956 "text" : "{id}"
2957 }
2958 ],
2959 "info" : {
2960 "POST" : {
9fda36b0 2961 "description" : "Add 'TimeFrame' object.",
eff914dc 2962 "method" : "POST",
9fda36b0 2963 "name" : "timeframe",
eff914dc
DM
2964 "parameters" : {
2965 "additionalProperties" : 0,
2966 "properties" : {
9fda36b0
DM
2967 "end" : {
2968 "description" : "End time in `H:i` format (00:00).",
2969 "pattern" : "\\d?\\d:\\d?\\d",
2970 "type" : "string"
eff914dc
DM
2971 },
2972 "ogroup" : {
2973 "description" : "Object Groups ID.",
2974 "type" : "integer",
2975 "typetext" : "<integer>"
9fda36b0
DM
2976 },
2977 "start" : {
2978 "description" : "Start time in `H:i` format (00:00).",
2979 "pattern" : "\\d?\\d:\\d?\\d",
2980 "type" : "string"
eff914dc
DM
2981 }
2982 }
2983 },
c061d61d
DM
2984 "permissions" : {
2985 "check" : [
2986 "admin"
2987 ]
2988 },
a55e94a6 2989 "protected" : 1,
eff914dc
DM
2990 "proxyto" : "master",
2991 "returns" : {
2992 "description" : "The object ID.",
2993 "type" : "integer"
2994 }
2995 }
2996 },
2997 "leaf" : 0,
9fda36b0
DM
2998 "path" : "/config/ruledb/when/{ogroup}/timeframe",
2999 "text" : "timeframe"
3000 }
3001 ],
3002 "info" : {
3003 "DELETE" : {
3004 "description" : "Delete a 'when' group.",
3005 "method" : "DELETE",
3006 "name" : "delete_{$oclass}_group",
3007 "parameters" : {
3008 "additionalProperties" : 0,
3009 "properties" : {
3010 "ogroup" : {
3011 "description" : "Object Group ID.",
3012 "type" : "integer",
3013 "typetext" : "<integer>"
3014 }
3015 }
3016 },
732d76e1
DM
3017 "permissions" : {
3018 "check" : [
3019 "admin"
3020 ]
3021 },
9fda36b0
DM
3022 "protected" : 1,
3023 "proxyto" : "master",
3024 "returns" : {
3025 "type" : "null"
3026 }
3027 },
3028 "GET" : {
3029 "description" : "Directory index.",
3030 "method" : "GET",
3031 "name" : "index",
3032 "parameters" : {
3033 "additionalProperties" : 0,
3034 "properties" : {
3035 "ogroup" : {
3036 "description" : "Object Group ID.",
3037 "type" : "integer",
3038 "typetext" : "<integer>"
3039 }
3040 }
3041 },
732d76e1
DM
3042 "permissions" : {
3043 "check" : [
3044 "admin",
3045 "audit"
3046 ]
3047 },
9fda36b0
DM
3048 "returns" : {
3049 "items" : {
3050 "properties" : {
3051 "subdir" : {
3052 "type" : "string"
eff914dc
DM
3053 }
3054 },
9fda36b0
DM
3055 "type" : "object"
3056 },
3057 "links" : [
3058 {
3059 "href" : "{subdir}",
3060 "rel" : "child"
3061 }
3062 ],
3063 "type" : "array"
3064 }
3065 }
3066 },
3067 "leaf" : 0,
3068 "path" : "/config/ruledb/when/{ogroup}",
3069 "text" : "{ogroup}"
3070 }
3071 ],
3072 "info" : {
3073 "GET" : {
3074 "description" : "Get list of 'when' groups.",
3075 "method" : "GET",
3076 "name" : "list_when_groups",
3077 "parameters" : {
3078 "additionalProperties" : 0
3079 },
732d76e1
DM
3080 "permissions" : {
3081 "check" : [
3082 "admin",
3083 "audit"
3084 ]
3085 },
9fda36b0
DM
3086 "proxyto" : "master",
3087 "returns" : {
3088 "items" : {
3089 "properties" : {
3090 "id" : {
3091 "type" : "integer"
eff914dc 3092 }
9fda36b0
DM
3093 },
3094 "type" : "object"
3095 },
3096 "type" : "array"
3097 }
3098 },
3099 "POST" : {
3100 "description" : "Create a new 'when' group.",
3101 "method" : "POST",
3102 "name" : "create_when_group",
3103 "parameters" : {
3104 "additionalProperties" : 0,
3105 "properties" : {
eff914dc 3106 "info" : {
9fda36b0
DM
3107 "description" : "Informational comment.",
3108 "maxLength" : 255,
3109 "optional" : 1,
3110 "type" : "string",
3111 "typetext" : "<string>"
3112 },
3113 "name" : {
3114 "description" : "Group name.",
3115 "maxLength" : 255,
3116 "type" : "string",
3117 "typetext" : "<string>"
3118 }
3119 }
3120 },
732d76e1
DM
3121 "permissions" : {
3122 "check" : [
3123 "admin"
3124 ]
3125 },
9fda36b0
DM
3126 "protected" : 1,
3127 "proxyto" : "master",
3128 "returns" : {
3129 "type" : "integer"
3130 }
3131 }
3132 },
3133 "leaf" : 0,
3134 "path" : "/config/ruledb/when",
3135 "text" : "when"
3136 },
3137 {
3138 "children" : [
3139 {
3140 "children" : [
3141 {
3142 "info" : {
3143 "GET" : {
3144 "description" : "Get 'who' group properties",
3145 "method" : "GET",
3146 "name" : "get_config",
eff914dc
DM
3147 "parameters" : {
3148 "additionalProperties" : 0,
3149 "properties" : {
9fda36b0
DM
3150 "ogroup" : {
3151 "description" : "Object Group ID.",
3152 "type" : "integer",
3153 "typetext" : "<integer>"
3154 }
3155 }
3156 },
732d76e1
DM
3157 "permissions" : {
3158 "check" : [
3159 "admin",
3160 "audit"
3161 ]
3162 },
9fda36b0
DM
3163 "proxyto" : "master",
3164 "returns" : {
3165 "properties" : {
3166 "id" : {
3167 "type" : "integer"
3168 },
3169 "info" : {
3170 "type" : "string"
3171 },
3172 "name" : {
3173 "type" : "string"
3174 }
3175 },
3176 "type" : "object"
3177 }
3178 },
3179 "PUT" : {
3180 "description" : "Modify 'who' group properties",
3181 "method" : "PUT",
3182 "name" : "set_config",
3183 "parameters" : {
3184 "additionalProperties" : 0,
3185 "properties" : {
3186 "info" : {
3187 "description" : "Informational comment.",
3188 "maxLength" : 255,
3189 "optional" : 1,
3190 "type" : "string",
3191 "typetext" : "<string>"
3192 },
3193 "name" : {
3194 "description" : "Group name.",
3195 "maxLength" : 255,
3196 "optional" : 1,
eff914dc
DM
3197 "type" : "string",
3198 "typetext" : "<string>"
3199 },
3200 "ogroup" : {
9fda36b0 3201 "description" : "Object Group ID.",
eff914dc
DM
3202 "type" : "integer",
3203 "typetext" : "<integer>"
3204 }
3205 }
3206 },
732d76e1
DM
3207 "permissions" : {
3208 "check" : [
3209 "admin"
3210 ]
3211 },
a55e94a6 3212 "protected" : 1,
eff914dc
DM
3213 "proxyto" : "master",
3214 "returns" : {
9fda36b0 3215 "type" : "null"
eff914dc
DM
3216 }
3217 }
3218 },
9fda36b0
DM
3219 "leaf" : 1,
3220 "path" : "/config/ruledb/who/{ogroup}/config",
3221 "text" : "config"
eff914dc
DM
3222 },
3223 {
3224 "children" : [
3225 {
3226 "info" : {
9fda36b0
DM
3227 "DELETE" : {
3228 "description" : "Remove an object from the 'who' group.",
3229 "method" : "DELETE",
3230 "name" : "delete_object",
eff914dc
DM
3231 "parameters" : {
3232 "additionalProperties" : 0,
3233 "properties" : {
3234 "id" : {
3235 "description" : "Object ID.",
3236 "type" : "integer",
3237 "typetext" : "<integer>"
3238 },
3239 "ogroup" : {
9fda36b0 3240 "description" : "Object Group ID.",
eff914dc
DM
3241 "type" : "integer",
3242 "typetext" : "<integer>"
3243 }
3244 }
3245 },
732d76e1
DM
3246 "permissions" : {
3247 "check" : [
3248 "admin"
3249 ]
3250 },
9fda36b0 3251 "protected" : 1,
eff914dc
DM
3252 "proxyto" : "master",
3253 "returns" : {
9fda36b0 3254 "type" : "null"
eff914dc
DM
3255 }
3256 }
3257 },
3258 "leaf" : 1,
9fda36b0 3259 "path" : "/config/ruledb/who/{ogroup}/objects/{id}",
eff914dc
DM
3260 "text" : "{id}"
3261 }
3262 ],
3263 "info" : {
9fda36b0
DM
3264 "GET" : {
3265 "description" : "List 'who' group objects.",
3266 "method" : "GET",
3267 "name" : "objects",
eff914dc
DM
3268 "parameters" : {
3269 "additionalProperties" : 0,
3270 "properties" : {
3271 "ogroup" : {
9fda36b0 3272 "description" : "Object Group ID.",
eff914dc
DM
3273 "type" : "integer",
3274 "typetext" : "<integer>"
eff914dc
DM
3275 }
3276 }
3277 },
732d76e1
DM
3278 "permissions" : {
3279 "check" : [
3280 "admin",
3281 "audit"
3282 ]
3283 },
eff914dc
DM
3284 "proxyto" : "master",
3285 "returns" : {
9fda36b0
DM
3286 "items" : {
3287 "properties" : {
3288 "id" : {
3289 "type" : "integer"
3290 }
3291 },
3292 "type" : "object"
3293 },
3294 "links" : [
3295 {
3296 "href" : "{id}",
3297 "rel" : "child"
3298 }
3299 ],
3300 "type" : "array"
eff914dc
DM
3301 }
3302 }
3303 },
3304 "leaf" : 0,
9fda36b0
DM
3305 "path" : "/config/ruledb/who/{ogroup}/objects",
3306 "text" : "objects"
eff914dc
DM
3307 },
3308 {
3309 "children" : [
3310 {
3311 "info" : {
3312 "GET" : {
9fda36b0 3313 "description" : "Read 'Mail address' object settings.",
eff914dc 3314 "method" : "GET",
9fda36b0 3315 "name" : "read_email",
eff914dc
DM
3316 "parameters" : {
3317 "additionalProperties" : 0,
3318 "properties" : {
3319 "id" : {
3320 "description" : "Object ID.",
3321 "type" : "integer",
3322 "typetext" : "<integer>"
3323 },
3324 "ogroup" : {
3325 "description" : "Object Groups ID.",
3326 "type" : "integer",
3327 "typetext" : "<integer>"
3328 }
3329 }
3330 },
c061d61d
DM
3331 "permissions" : {
3332 "check" : [
3333 "admin",
3334 "audit"
3335 ]
3336 },
eff914dc
DM
3337 "proxyto" : "master",
3338 "returns" : {
3339 "properties" : {
3340 "id" : {
3341 "type" : "integer"
3342 }
3343 },
3344 "type" : "object"
3345 }
3346 },
3347 "PUT" : {
9fda36b0 3348 "description" : "Update 'Mail address' object.",
eff914dc 3349 "method" : "PUT",
9fda36b0 3350 "name" : "update_email",
eff914dc
DM
3351 "parameters" : {
3352 "additionalProperties" : 0,
3353 "properties" : {
9fda36b0
DM
3354 "email" : {
3355 "description" : "Email address.",
3356 "format" : "email",
3357 "type" : "string",
3358 "typetext" : "<string>"
3359 },
eff914dc
DM
3360 "id" : {
3361 "description" : "Object ID.",
3362 "type" : "integer",
3363 "typetext" : "<integer>"
3364 },
eff914dc
DM
3365 "ogroup" : {
3366 "description" : "Object Groups ID.",
3367 "type" : "integer",
3368 "typetext" : "<integer>"
3369 }
3370 }
3371 },
c061d61d
DM
3372 "permissions" : {
3373 "check" : [
3374 "admin"
3375 ]
3376 },
a55e94a6 3377 "protected" : 1,
eff914dc
DM
3378 "proxyto" : "master",
3379 "returns" : {
3380 "type" : "null"
3381 }
3382 }
3383 },
3384 "leaf" : 1,
9fda36b0 3385 "path" : "/config/ruledb/who/{ogroup}/email/{id}",
eff914dc
DM
3386 "text" : "{id}"
3387 }
3388 ],
3389 "info" : {
3390 "POST" : {
9fda36b0 3391 "description" : "Add 'Mail address' object.",
eff914dc 3392 "method" : "POST",
9fda36b0 3393 "name" : "email",
eff914dc
DM
3394 "parameters" : {
3395 "additionalProperties" : 0,
3396 "properties" : {
9fda36b0
DM
3397 "email" : {
3398 "description" : "Email address.",
3399 "format" : "email",
eff914dc
DM
3400 "type" : "string",
3401 "typetext" : "<string>"
3402 },
3403 "ogroup" : {
3404 "description" : "Object Groups ID.",
3405 "type" : "integer",
3406 "typetext" : "<integer>"
3407 }
3408 }
3409 },
c061d61d
DM
3410 "permissions" : {
3411 "check" : [
3412 "admin"
3413 ]
3414 },
a55e94a6 3415 "protected" : 1,
eff914dc
DM
3416 "proxyto" : "master",
3417 "returns" : {
3418 "description" : "The object ID.",
3419 "type" : "integer"
3420 }
3421 }
3422 },
3423 "leaf" : 0,
9fda36b0
DM
3424 "path" : "/config/ruledb/who/{ogroup}/email",
3425 "text" : "email"
eff914dc
DM
3426 },
3427 {
3428 "children" : [
3429 {
3430 "info" : {
3431 "GET" : {
9fda36b0 3432 "description" : "Read 'Domain' object settings.",
eff914dc 3433 "method" : "GET",
9fda36b0 3434 "name" : "read_domain",
eff914dc
DM
3435 "parameters" : {
3436 "additionalProperties" : 0,
3437 "properties" : {
3438 "id" : {
3439 "description" : "Object ID.",
3440 "type" : "integer",
3441 "typetext" : "<integer>"
3442 },
3443 "ogroup" : {
3444 "description" : "Object Groups ID.",
3445 "type" : "integer",
3446 "typetext" : "<integer>"
3447 }
3448 }
3449 },
c061d61d
DM
3450 "permissions" : {
3451 "check" : [
3452 "admin",
3453 "audit"
3454 ]
3455 },
eff914dc
DM
3456 "proxyto" : "master",
3457 "returns" : {
3458 "properties" : {
3459 "id" : {
3460 "type" : "integer"
3461 }
3462 },
3463 "type" : "object"
3464 }
3465 },
3466 "PUT" : {
9fda36b0 3467 "description" : "Update 'Domain' object.",
eff914dc 3468 "method" : "PUT",
9fda36b0 3469 "name" : "update_domain",
eff914dc
DM
3470 "parameters" : {
3471 "additionalProperties" : 0,
3472 "properties" : {
9fda36b0
DM
3473 "domain" : {
3474 "description" : "DNS domain name (Sender).",
3475 "format" : "dns-name",
eff914dc
DM
3476 "type" : "string",
3477 "typetext" : "<string>"
3478 },
3479 "id" : {
3480 "description" : "Object ID.",
3481 "type" : "integer",
3482 "typetext" : "<integer>"
3483 },
3484 "ogroup" : {
3485 "description" : "Object Groups ID.",
3486 "type" : "integer",
3487 "typetext" : "<integer>"
3488 }
3489 }
3490 },
c061d61d
DM
3491 "permissions" : {
3492 "check" : [
3493 "admin"
3494 ]
3495 },
a55e94a6 3496 "protected" : 1,
eff914dc
DM
3497 "proxyto" : "master",
3498 "returns" : {
3499 "type" : "null"
3500 }
3501 }
3502 },
3503 "leaf" : 1,
9fda36b0 3504 "path" : "/config/ruledb/who/{ogroup}/domain/{id}",
eff914dc
DM
3505 "text" : "{id}"
3506 }
3507 ],
3508 "info" : {
3509 "POST" : {
9fda36b0 3510 "description" : "Add 'Domain' object.",
eff914dc 3511 "method" : "POST",
9fda36b0 3512 "name" : "domain",
eff914dc
DM
3513 "parameters" : {
3514 "additionalProperties" : 0,
3515 "properties" : {
9fda36b0
DM
3516 "domain" : {
3517 "description" : "DNS domain name (Sender).",
3518 "format" : "dns-name",
eff914dc
DM
3519 "type" : "string",
3520 "typetext" : "<string>"
3521 },
3522 "ogroup" : {
3523 "description" : "Object Groups ID.",
3524 "type" : "integer",
3525 "typetext" : "<integer>"
3526 }
3527 }
3528 },
c061d61d
DM
3529 "permissions" : {
3530 "check" : [
3531 "admin"
3532 ]
3533 },
a55e94a6 3534 "protected" : 1,
eff914dc
DM
3535 "proxyto" : "master",
3536 "returns" : {
3537 "description" : "The object ID.",
3538 "type" : "integer"
3539 }
3540 }
3541 },
3542 "leaf" : 0,
9fda36b0
DM
3543 "path" : "/config/ruledb/who/{ogroup}/domain",
3544 "text" : "domain"
a55e94a6
DM
3545 },
3546 {
3547 "children" : [
3548 {
3549 "info" : {
3550 "GET" : {
9fda36b0 3551 "description" : "Read 'Regular Expression' object settings.",
a55e94a6 3552 "method" : "GET",
9fda36b0 3553 "name" : "read_regex",
a55e94a6
DM
3554 "parameters" : {
3555 "additionalProperties" : 0,
3556 "properties" : {
3557 "id" : {
3558 "description" : "Object ID.",
3559 "type" : "integer",
3560 "typetext" : "<integer>"
3561 },
3562 "ogroup" : {
3563 "description" : "Object Groups ID.",
3564 "type" : "integer",
3565 "typetext" : "<integer>"
3566 }
3567 }
3568 },
c061d61d
DM
3569 "permissions" : {
3570 "check" : [
3571 "admin",
3572 "audit"
3573 ]
3574 },
a55e94a6
DM
3575 "proxyto" : "master",
3576 "returns" : {
3577 "properties" : {
3578 "id" : {
3579 "type" : "integer"
3580 }
3581 },
3582 "type" : "object"
3583 }
3584 },
3585 "PUT" : {
9fda36b0 3586 "description" : "Update 'Regular Expression' object.",
a55e94a6 3587 "method" : "PUT",
9fda36b0 3588 "name" : "update_regex",
a55e94a6
DM
3589 "parameters" : {
3590 "additionalProperties" : 0,
3591 "properties" : {
a55e94a6
DM
3592 "id" : {
3593 "description" : "Object ID.",
3594 "type" : "integer",
3595 "typetext" : "<integer>"
3596 },
a55e94a6
DM
3597 "ogroup" : {
3598 "description" : "Object Groups ID.",
3599 "type" : "integer",
3600 "typetext" : "<integer>"
3601 },
9fda36b0
DM
3602 "regex" : {
3603 "description" : "Email address regular expression.",
3604 "maxLength" : 1024,
a55e94a6
DM
3605 "type" : "string",
3606 "typetext" : "<string>"
3607 }
3608 }
3609 },
c061d61d
DM
3610 "permissions" : {
3611 "check" : [
3612 "admin"
3613 ]
3614 },
a55e94a6
DM
3615 "protected" : 1,
3616 "proxyto" : "master",
3617 "returns" : {
3618 "type" : "null"
3619 }
3620 }
3621 },
3622 "leaf" : 1,
9fda36b0 3623 "path" : "/config/ruledb/who/{ogroup}/regex/{id}",
a55e94a6
DM
3624 "text" : "{id}"
3625 }
3626 ],
3627 "info" : {
3628 "POST" : {
9fda36b0 3629 "description" : "Add 'Regular Expression' object.",
a55e94a6 3630 "method" : "POST",
9fda36b0 3631 "name" : "regex",
a55e94a6
DM
3632 "parameters" : {
3633 "additionalProperties" : 0,
3634 "properties" : {
a55e94a6
DM
3635 "ogroup" : {
3636 "description" : "Object Groups ID.",
3637 "type" : "integer",
3638 "typetext" : "<integer>"
3639 },
9fda36b0
DM
3640 "regex" : {
3641 "description" : "Email address regular expression.",
3642 "maxLength" : 1024,
a55e94a6
DM
3643 "type" : "string",
3644 "typetext" : "<string>"
3645 }
3646 }
3647 },
c061d61d
DM
3648 "permissions" : {
3649 "check" : [
3650 "admin"
3651 ]
3652 },
a55e94a6
DM
3653 "protected" : 1,
3654 "proxyto" : "master",
3655 "returns" : {
3656 "description" : "The object ID.",
3657 "type" : "integer"
3658 }
3659 }
3660 },
3661 "leaf" : 0,
9fda36b0
DM
3662 "path" : "/config/ruledb/who/{ogroup}/regex",
3663 "text" : "regex"
a55e94a6
DM
3664 },
3665 {
3666 "children" : [
3667 {
3668 "info" : {
3669 "GET" : {
9fda36b0 3670 "description" : "Read 'IP Address' object settings.",
a55e94a6 3671 "method" : "GET",
9fda36b0 3672 "name" : "read_ip",
a55e94a6
DM
3673 "parameters" : {
3674 "additionalProperties" : 0,
3675 "properties" : {
3676 "id" : {
3677 "description" : "Object ID.",
3678 "type" : "integer",
3679 "typetext" : "<integer>"
3680 },
3681 "ogroup" : {
3682 "description" : "Object Groups ID.",
3683 "type" : "integer",
3684 "typetext" : "<integer>"
3685 }
3686 }
3687 },
c061d61d
DM
3688 "permissions" : {
3689 "check" : [
3690 "admin",
3691 "audit"
3692 ]
3693 },
a55e94a6
DM
3694 "proxyto" : "master",
3695 "returns" : {
3696 "properties" : {
3697 "id" : {
3698 "type" : "integer"
3699 }
3700 },
3701 "type" : "object"
3702 }
3703 },
3704 "PUT" : {
9fda36b0 3705 "description" : "Update 'IP Address' object.",
a55e94a6 3706 "method" : "PUT",
9fda36b0 3707 "name" : "update_ip",
a55e94a6
DM
3708 "parameters" : {
3709 "additionalProperties" : 0,
3710 "properties" : {
a55e94a6
DM
3711 "id" : {
3712 "description" : "Object ID.",
3713 "type" : "integer",
3714 "typetext" : "<integer>"
3715 },
9fda36b0
DM
3716 "ip" : {
3717 "description" : "IP address",
3718 "format" : "ip",
3719 "type" : "string",
3720 "typetext" : "<string>"
3721 },
a55e94a6
DM
3722 "ogroup" : {
3723 "description" : "Object Groups ID.",
3724 "type" : "integer",
3725 "typetext" : "<integer>"
a55e94a6
DM
3726 }
3727 }
3728 },
c061d61d
DM
3729 "permissions" : {
3730 "check" : [
3731 "admin"
3732 ]
3733 },
a55e94a6
DM
3734 "protected" : 1,
3735 "proxyto" : "master",
3736 "returns" : {
3737 "type" : "null"
3738 }
3739 }
3740 },
3741 "leaf" : 1,
9fda36b0 3742 "path" : "/config/ruledb/who/{ogroup}/ip/{id}",
a55e94a6
DM
3743 "text" : "{id}"
3744 }
3745 ],
3746 "info" : {
3747 "POST" : {
9fda36b0 3748 "description" : "Add 'IP Address' object.",
a55e94a6 3749 "method" : "POST",
9fda36b0 3750 "name" : "ip",
a55e94a6
DM
3751 "parameters" : {
3752 "additionalProperties" : 0,
3753 "properties" : {
9fda36b0
DM
3754 "ip" : {
3755 "description" : "IP address",
3756 "format" : "ip",
a55e94a6
DM
3757 "type" : "string",
3758 "typetext" : "<string>"
3759 },
3760 "ogroup" : {
3761 "description" : "Object Groups ID.",
3762 "type" : "integer",
3763 "typetext" : "<integer>"
a55e94a6
DM
3764 }
3765 }
3766 },
c061d61d
DM
3767 "permissions" : {
3768 "check" : [
3769 "admin"
3770 ]
3771 },
a55e94a6
DM
3772 "protected" : 1,
3773 "proxyto" : "master",
3774 "returns" : {
3775 "description" : "The object ID.",
3776 "type" : "integer"
3777 }
3778 }
3779 },
3780 "leaf" : 0,
9fda36b0
DM
3781 "path" : "/config/ruledb/who/{ogroup}/ip",
3782 "text" : "ip"
eff914dc 3783 },
9fda36b0
DM
3784 {
3785 "children" : [
3786 {
3787 "info" : {
3788 "GET" : {
3789 "description" : "Read 'IP Network' object settings.",
3790 "method" : "GET",
3791 "name" : "read_network",
3792 "parameters" : {
3793 "additionalProperties" : 0,
3794 "properties" : {
3795 "id" : {
3796 "description" : "Object ID.",
3797 "type" : "integer",
3798 "typetext" : "<integer>"
3799 },
3800 "ogroup" : {
3801 "description" : "Object Groups ID.",
3802 "type" : "integer",
3803 "typetext" : "<integer>"
3804 }
3805 }
3806 },
c061d61d
DM
3807 "permissions" : {
3808 "check" : [
3809 "admin",
3810 "audit"
3811 ]
3812 },
9fda36b0
DM
3813 "proxyto" : "master",
3814 "returns" : {
3815 "properties" : {
3816 "id" : {
3817 "type" : "integer"
3818 }
3819 },
3820 "type" : "object"
3821 }
3822 },
3823 "PUT" : {
3824 "description" : "Update 'IP Network' object.",
3825 "method" : "PUT",
3826 "name" : "update_network",
3827 "parameters" : {
3828 "additionalProperties" : 0,
3829 "properties" : {
3830 "cidr" : {
3831 "description" : "Network address in CIDR notation.",
3832 "format" : "CIDR",
3833 "type" : "string",
3834 "typetext" : "<string>"
3835 },
3836 "id" : {
3837 "description" : "Object ID.",
3838 "type" : "integer",
3839 "typetext" : "<integer>"
3840 },
3841 "ogroup" : {
3842 "description" : "Object Groups ID.",
3843 "type" : "integer",
3844 "typetext" : "<integer>"
3845 }
3846 }
3847 },
c061d61d
DM
3848 "permissions" : {
3849 "check" : [
3850 "admin"
3851 ]
3852 },
9fda36b0
DM
3853 "protected" : 1,
3854 "proxyto" : "master",
3855 "returns" : {
3856 "type" : "null"
3857 }
3858 }
3859 },
3860 "leaf" : 1,
3861 "path" : "/config/ruledb/who/{ogroup}/network/{id}",
3862 "text" : "{id}"
eff914dc 3863 }
9fda36b0
DM
3864 ],
3865 "info" : {
3866 "POST" : {
3867 "description" : "Add 'IP Network' object.",
3868 "method" : "POST",
3869 "name" : "network",
3870 "parameters" : {
3871 "additionalProperties" : 0,
3872 "properties" : {
3873 "cidr" : {
3874 "description" : "Network address in CIDR notation.",
3875 "format" : "CIDR",
3876 "type" : "string",
3877 "typetext" : "<string>"
3878 },
3879 "ogroup" : {
3880 "description" : "Object Groups ID.",
3881 "type" : "integer",
3882 "typetext" : "<integer>"
3883 }
eff914dc
DM
3884 }
3885 },
c061d61d
DM
3886 "permissions" : {
3887 "check" : [
3888 "admin"
3889 ]
3890 },
9fda36b0
DM
3891 "protected" : 1,
3892 "proxyto" : "master",
3893 "returns" : {
3894 "description" : "The object ID.",
3895 "type" : "integer"
eff914dc 3896 }
eff914dc
DM
3897 }
3898 },
9fda36b0
DM
3899 "leaf" : 0,
3900 "path" : "/config/ruledb/who/{ogroup}/network",
3901 "text" : "network"
410dc2c9 3902 },
9fda36b0
DM
3903 {
3904 "children" : [
3905 {
3906 "info" : {
3907 "GET" : {
3908 "description" : "Read 'LDAP Group' object settings.",
3909 "method" : "GET",
3910 "name" : "read_ldap",
3911 "parameters" : {
3912 "additionalProperties" : 0,
3913 "properties" : {
3914 "id" : {
3915 "description" : "Object ID.",
3916 "type" : "integer",
3917 "typetext" : "<integer>"
3918 },
3919 "ogroup" : {
3920 "description" : "Object Groups ID.",
3921 "type" : "integer",
3922 "typetext" : "<integer>"
3923 }
3924 }
3925 },
c061d61d
DM
3926 "permissions" : {
3927 "check" : [
3928 "admin",
3929 "audit"
3930 ]
3931 },
9fda36b0
DM
3932 "proxyto" : "master",
3933 "returns" : {
3934 "properties" : {
3935 "id" : {
3936 "type" : "integer"
3937 }
3938 },
3939 "type" : "object"
3940 }
3941 },
3942 "PUT" : {
3943 "description" : "Update 'LDAP Group' object.",
3944 "method" : "PUT",
3945 "name" : "update_ldap",
3946 "parameters" : {
3947 "additionalProperties" : 0,
3948 "properties" : {
3949 "group" : {
3950 "description" : "LDAP Group DN",
3951 "maxLength" : 1024,
3952 "minLength" : 1,
3953 "optional" : 1,
3954 "type" : "string",
3955 "typetext" : "<string>"
3956 },
3957 "id" : {
3958 "description" : "Object ID.",
3959 "type" : "integer",
3960 "typetext" : "<integer>"
3961 },
3962 "mode" : {
3963 "description" : "Operational mode. You can either match 'any' user, match when no such user exists with 'none', or match when the user is member of a specific group.",
3964 "enum" : [
3965 "any",
3966 "none",
3967 "group"
3968 ],
3969 "type" : "string"
3970 },
3971 "ogroup" : {
3972 "description" : "Object Groups ID.",
3973 "type" : "integer",
3974 "typetext" : "<integer>"
3975 },
3976 "profile" : {
3977 "description" : "Profile ID.",
3978 "format" : "pve-configid",
3979 "optional" : 1,
3980 "type" : "string",
3981 "typetext" : "<string>"
3982 }
3983 }
3984 },
c061d61d
DM
3985 "permissions" : {
3986 "check" : [
3987 "admin"
3988 ]
3989 },
9fda36b0
DM
3990 "protected" : 1,
3991 "proxyto" : "master",
3992 "returns" : {
3993 "type" : "null"
3994 }
3995 }
3996 },
3997 "leaf" : 1,
3998 "path" : "/config/ruledb/who/{ogroup}/ldap/{id}",
3999 "text" : "{id}"
4000 }
4001 ],
4002 "info" : {
4003 "POST" : {
4004 "description" : "Add 'LDAP Group' object.",
4005 "method" : "POST",
4006 "name" : "ldap",
4007 "parameters" : {
4008 "additionalProperties" : 0,
4009 "properties" : {
4010 "group" : {
4011 "description" : "LDAP Group DN",
4012 "maxLength" : 1024,
4013 "minLength" : 1,
4014 "optional" : 1,
4015 "type" : "string",
4016 "typetext" : "<string>"
4017 },
4018 "mode" : {
4019 "description" : "Operational mode. You can either match 'any' user, match when no such user exists with 'none', or match when the user is member of a specific group.",
4020 "enum" : [
4021 "any",
4022 "none",
4023 "group"
4024 ],
4025 "type" : "string"
4026 },
4027 "ogroup" : {
4028 "description" : "Object Groups ID.",
4029 "type" : "integer",
4030 "typetext" : "<integer>"
4031 },
4032 "profile" : {
4033 "description" : "Profile ID.",
4034 "format" : "pve-configid",
4035 "optional" : 1,
4036 "type" : "string",
4037 "typetext" : "<string>"
4038 }
4039 }
4040 },
c061d61d
DM
4041 "permissions" : {
4042 "check" : [
4043 "admin"
4044 ]
4045 },
9fda36b0
DM
4046 "protected" : 1,
4047 "proxyto" : "master",
4048 "returns" : {
4049 "description" : "The object ID.",
4050 "type" : "integer"
4051 }
4052 }
4053 },
4054 "leaf" : 0,
4055 "path" : "/config/ruledb/who/{ogroup}/ldap",
4056 "text" : "ldap"
4057 },
4058 {
4059 "children" : [
4060 {
4061 "info" : {
4062 "GET" : {
4063 "description" : "Read 'LDAP User' object settings.",
4064 "method" : "GET",
4065 "name" : "read_ldapuser",
4066 "parameters" : {
4067 "additionalProperties" : 0,
4068 "properties" : {
4069 "id" : {
4070 "description" : "Object ID.",
4071 "type" : "integer",
4072 "typetext" : "<integer>"
4073 },
4074 "ogroup" : {
4075 "description" : "Object Groups ID.",
4076 "type" : "integer",
4077 "typetext" : "<integer>"
4078 }
4079 }
4080 },
c061d61d
DM
4081 "permissions" : {
4082 "check" : [
4083 "admin",
4084 "audit"
4085 ]
4086 },
9fda36b0
DM
4087 "proxyto" : "master",
4088 "returns" : {
4089 "properties" : {
4090 "id" : {
4091 "type" : "integer"
4092 }
4093 },
4094 "type" : "object"
4095 }
4096 },
4097 "PUT" : {
4098 "description" : "Update 'LDAP User' object.",
4099 "method" : "PUT",
4100 "name" : "update_ldapuser",
4101 "parameters" : {
4102 "additionalProperties" : 0,
4103 "properties" : {
4104 "account" : {
4105 "description" : "LDAP user account name.",
4106 "maxLength" : 1024,
4107 "minLength" : 1,
4108 "type" : "string",
4109 "typetext" : "<string>"
4110 },
4111 "id" : {
4112 "description" : "Object ID.",
4113 "type" : "integer",
4114 "typetext" : "<integer>"
4115 },
4116 "ogroup" : {
4117 "description" : "Object Groups ID.",
4118 "type" : "integer",
4119 "typetext" : "<integer>"
4120 },
4121 "profile" : {
4122 "description" : "Profile ID.",
4123 "format" : "pve-configid",
4124 "type" : "string",
4125 "typetext" : "<string>"
4126 }
4127 }
4128 },
c061d61d
DM
4129 "permissions" : {
4130 "check" : [
4131 "admin"
4132 ]
4133 },
9fda36b0
DM
4134 "protected" : 1,
4135 "proxyto" : "master",
4136 "returns" : {
4137 "type" : "null"
4138 }
4139 }
4140 },
4141 "leaf" : 1,
4142 "path" : "/config/ruledb/who/{ogroup}/ldapuser/{id}",
4143 "text" : "{id}"
4144 }
4145 ],
4146 "info" : {
4147 "POST" : {
4148 "description" : "Add 'LDAP User' object.",
4149 "method" : "POST",
4150 "name" : "ldapuser",
4151 "parameters" : {
4152 "additionalProperties" : 0,
4153 "properties" : {
4154 "account" : {
4155 "description" : "LDAP user account name.",
4156 "maxLength" : 1024,
4157 "minLength" : 1,
4158 "type" : "string",
4159 "typetext" : "<string>"
4160 },
4161 "ogroup" : {
4162 "description" : "Object Groups ID.",
4163 "type" : "integer",
4164 "typetext" : "<integer>"
4165 },
4166 "profile" : {
4167 "description" : "Profile ID.",
4168 "format" : "pve-configid",
4169 "type" : "string",
4170 "typetext" : "<string>"
4171 }
4172 }
4173 },
c061d61d
DM
4174 "permissions" : {
4175 "check" : [
4176 "admin"
4177 ]
4178 },
9fda36b0
DM
4179 "protected" : 1,
4180 "proxyto" : "master",
4181 "returns" : {
4182 "description" : "The object ID.",
4183 "type" : "integer"
4184 }
4185 }
4186 },
4187 "leaf" : 0,
4188 "path" : "/config/ruledb/who/{ogroup}/ldapuser",
4189 "text" : "ldapuser"
4190 }
4191 ],
4192 "info" : {
4193 "DELETE" : {
4194 "description" : "Delete a 'who' group.",
4195 "method" : "DELETE",
4196 "name" : "delete_{$oclass}_group",
4197 "parameters" : {
4198 "additionalProperties" : 0,
4199 "properties" : {
4200 "ogroup" : {
4201 "description" : "Object Group ID.",
4202 "type" : "integer",
4203 "typetext" : "<integer>"
4204 }
4205 }
4206 },
732d76e1
DM
4207 "permissions" : {
4208 "check" : [
4209 "admin"
4210 ]
4211 },
9fda36b0
DM
4212 "protected" : 1,
4213 "proxyto" : "master",
4214 "returns" : {
4215 "type" : "null"
4216 }
4217 },
4218 "GET" : {
4219 "description" : "Directory index.",
4220 "method" : "GET",
4221 "name" : "index",
4222 "parameters" : {
4223 "additionalProperties" : 0,
4224 "properties" : {
4225 "ogroup" : {
4226 "description" : "Object Group ID.",
4227 "type" : "integer",
4228 "typetext" : "<integer>"
4229 }
4230 }
4231 },
732d76e1
DM
4232 "permissions" : {
4233 "check" : [
4234 "admin",
4235 "audit"
4236 ]
4237 },
9fda36b0
DM
4238 "returns" : {
4239 "items" : {
4240 "properties" : {
4241 "subdir" : {
4242 "type" : "string"
4243 }
4244 },
4245 "type" : "object"
4246 },
4247 "links" : [
4248 {
4249 "href" : "{subdir}",
4250 "rel" : "child"
4251 }
4252 ],
4253 "type" : "array"
4254 }
4255 }
4256 },
4257 "leaf" : 0,
4258 "path" : "/config/ruledb/who/{ogroup}",
4259 "text" : "{ogroup}"
4260 }
4261 ],
4262 "info" : {
4263 "GET" : {
4264 "description" : "Get list of 'who' groups.",
4265 "method" : "GET",
4266 "name" : "list_who_groups",
4267 "parameters" : {
4268 "additionalProperties" : 0
4269 },
732d76e1
DM
4270 "permissions" : {
4271 "check" : [
4272 "admin",
4273 "audit"
4274 ]
4275 },
9fda36b0
DM
4276 "proxyto" : "master",
4277 "returns" : {
4278 "items" : {
4279 "properties" : {
4280 "id" : {
4281 "type" : "integer"
4282 }
4283 },
4284 "type" : "object"
4285 },
4286 "type" : "array"
4287 }
4288 },
4289 "POST" : {
4290 "description" : "Create a new 'who' group.",
4291 "method" : "POST",
4292 "name" : "create_who_group",
4293 "parameters" : {
4294 "additionalProperties" : 0,
4295 "properties" : {
eff914dc
DM
4296 "info" : {
4297 "description" : "Informational comment.",
4298 "maxLength" : 255,
4299 "optional" : 1,
4300 "type" : "string",
4301 "typetext" : "<string>"
4302 },
4303 "name" : {
4304 "description" : "Group name.",
4305 "maxLength" : 255,
4306 "type" : "string",
4307 "typetext" : "<string>"
4308 }
4309 }
4310 },
732d76e1
DM
4311 "permissions" : {
4312 "check" : [
4313 "admin"
4314 ]
4315 },
eff914dc
DM
4316 "protected" : 1,
4317 "proxyto" : "master",
4318 "returns" : {
4319 "type" : "integer"
4320 }
410dc2c9
DM
4321 }
4322 },
eff914dc 4323 "leaf" : 0,
410dc2c9
DM
4324 "path" : "/config/ruledb/who",
4325 "text" : "who"
4326 }
4327 ],
4328 "info" : {
4329 "GET" : {
4330 "description" : "Directory index.",
4331 "method" : "GET",
4332 "name" : "index",
4333 "parameters" : {
4334 "additionalProperties" : 0
4335 },
732d76e1
DM
4336 "permissions" : {
4337 "check" : [
4338 "admin",
4339 "audit"
4340 ]
4341 },
410dc2c9
DM
4342 "returns" : {
4343 "items" : {
4344 "properties" : {},
4345 "type" : "object"
4346 },
4347 "links" : [
4348 {
4349 "href" : "{name}",
4350 "rel" : "child"
4351 }
4352 ],
4353 "type" : "array"
4354 }
d7cd791b
DM
4355 },
4356 "POST" : {
4357 "description" : "Reset PMG rule database back to factory defaults.",
4358 "method" : "POST",
4359 "name" : "reset_ruledb",
4360 "parameters" : {
4361 "additionalProperties" : 0
4362 },
4a46ced6
DM
4363 "permissions" : {
4364 "check" : [
4365 "admin"
4366 ]
4367 },
d7cd791b
DM
4368 "protected" : 1,
4369 "returns" : {
4370 "type" : "null"
4371 }
410dc2c9
DM
4372 }
4373 },
4374 "leaf" : 0,
4375 "path" : "/config/ruledb",
4376 "text" : "ruledb"
4377 },
4378 {
4379 "children" : [
4380 {
eff914dc
DM
4381 "children" : [
4382 {
4383 "info" : {
4384 "DELETE" : {
4385 "description" : "Remove an object from the SMTP whitelist.",
4386 "method" : "DELETE",
4387 "name" : "delete_object",
4388 "parameters" : {
4389 "additionalProperties" : 0,
4390 "properties" : {
4391 "id" : {
4392 "description" : "Object ID.",
4393 "type" : "integer",
4394 "typetext" : "<integer>"
4395 }
4396 }
4397 },
732d76e1
DM
4398 "permissions" : {
4399 "check" : [
4400 "admin"
4401 ]
4402 },
bb6e6e0d 4403 "protected" : 1,
eff914dc
DM
4404 "proxyto" : "master",
4405 "returns" : {
4406 "type" : "null"
4407 }
4408 }
4409 },
4410 "leaf" : 1,
4411 "path" : "/config/whitelist/objects/{id}",
4412 "text" : "{id}"
4413 }
4414 ],
410dc2c9 4415 "info" : {
eff914dc
DM
4416 "GET" : {
4417 "description" : "Get list of all SMTP whitelist entries.",
4418 "method" : "GET",
4419 "name" : "objects",
4420 "parameters" : {
4421 "additionalProperties" : 0
4422 },
732d76e1
DM
4423 "permissions" : {
4424 "check" : [
4425 "admin",
4426 "audit"
4427 ]
4428 },
eff914dc
DM
4429 "proxyto" : "master",
4430 "returns" : {
4431 "items" : {
4432 "properties" : {
4433 "id" : {
4434 "type" : "integer"
4435 }
4436 },
4437 "type" : "object"
4438 },
4439 "links" : [
4440 {
4441 "href" : "{id}",
4442 "rel" : "child"
4443 }
4444 ],
4445 "type" : "array"
4446 }
4447 }
4448 },
4449 "leaf" : 0,
4450 "path" : "/config/whitelist/objects",
4451 "text" : "objects"
4452 },
4453 {
4454 "children" : [
4455 {
4456 "info" : {
4457 "GET" : {
4458 "description" : "Read 'Mail address' object settings.",
4459 "method" : "GET",
4460 "name" : "read_email",
4461 "parameters" : {
4462 "additionalProperties" : 0,
4463 "properties" : {
4464 "id" : {
4465 "description" : "Object ID.",
4466 "type" : "integer",
4467 "typetext" : "<integer>"
4468 }
4469 }
4470 },
c061d61d
DM
4471 "permissions" : {
4472 "check" : [
4473 "admin",
4474 "audit"
4475 ]
4476 },
eff914dc
DM
4477 "proxyto" : "master",
4478 "returns" : {
4479 "properties" : {
4480 "id" : {
4481 "type" : "integer"
4482 }
4483 },
4484 "type" : "object"
4485 }
4486 },
4487 "PUT" : {
4488 "description" : "Update 'Mail address' object.",
4489 "method" : "PUT",
4490 "name" : "update_email",
4491 "parameters" : {
4492 "additionalProperties" : 0,
4493 "properties" : {
4494 "email" : {
4495 "description" : "Email address.",
4496 "format" : "email",
4497 "type" : "string",
4498 "typetext" : "<string>"
4499 },
4500 "id" : {
4501 "description" : "Object ID.",
4502 "type" : "integer",
4503 "typetext" : "<integer>"
4504 }
4505 }
4506 },
c061d61d
DM
4507 "permissions" : {
4508 "check" : [
4509 "admin"
4510 ]
4511 },
a55e94a6 4512 "protected" : 1,
eff914dc
DM
4513 "proxyto" : "master",
4514 "returns" : {
4515 "type" : "null"
4516 }
4517 }
4518 },
4519 "leaf" : 1,
4520 "path" : "/config/whitelist/email/{id}",
4521 "text" : "{id}"
4522 }
4523 ],
4524 "info" : {
4525 "POST" : {
4526 "description" : "Add 'Mail address' object.",
4527 "method" : "POST",
4528 "name" : "email",
410dc2c9
DM
4529 "parameters" : {
4530 "additionalProperties" : 0,
4531 "properties" : {
eff914dc
DM
4532 "email" : {
4533 "description" : "Email address.",
4534 "format" : "email",
410dc2c9
DM
4535 "type" : "string",
4536 "typetext" : "<string>"
4537 }
4538 }
4539 },
c061d61d
DM
4540 "permissions" : {
4541 "check" : [
4542 "admin"
4543 ]
4544 },
a55e94a6 4545 "protected" : 1,
410dc2c9
DM
4546 "proxyto" : "master",
4547 "returns" : {
eff914dc
DM
4548 "description" : "The object ID.",
4549 "type" : "integer"
410dc2c9 4550 }
eff914dc
DM
4551 }
4552 },
4553 "leaf" : 0,
4554 "path" : "/config/whitelist/email",
4555 "text" : "email"
4556 },
4557 {
4558 "children" : [
4559 {
4560 "info" : {
4561 "GET" : {
4562 "description" : "Read 'Mail address' object settings.",
4563 "method" : "GET",
4564 "name" : "read_receiver",
4565 "parameters" : {
4566 "additionalProperties" : 0,
4567 "properties" : {
4568 "id" : {
4569 "description" : "Object ID.",
4570 "type" : "integer",
4571 "typetext" : "<integer>"
4572 }
4573 }
4574 },
c061d61d
DM
4575 "permissions" : {
4576 "check" : [
4577 "admin",
4578 "audit"
4579 ]
4580 },
eff914dc
DM
4581 "proxyto" : "master",
4582 "returns" : {
4583 "properties" : {
4584 "id" : {
4585 "type" : "integer"
4586 }
4587 },
4588 "type" : "object"
4589 }
4590 },
4591 "PUT" : {
4592 "description" : "Update 'Mail address' object.",
4593 "method" : "PUT",
4594 "name" : "update_receiver",
4595 "parameters" : {
4596 "additionalProperties" : 0,
4597 "properties" : {
4598 "email" : {
4599 "description" : "Email address.",
4600 "format" : "email",
4601 "type" : "string",
4602 "typetext" : "<string>"
4603 },
4604 "id" : {
4605 "description" : "Object ID.",
4606 "type" : "integer",
4607 "typetext" : "<integer>"
4608 }
4609 }
4610 },
c061d61d
DM
4611 "permissions" : {
4612 "check" : [
4613 "admin"
4614 ]
4615 },
a55e94a6 4616 "protected" : 1,
eff914dc
DM
4617 "proxyto" : "master",
4618 "returns" : {
4619 "type" : "null"
4620 }
4621 }
4622 },
4623 "leaf" : 1,
4624 "path" : "/config/whitelist/receiver/{id}",
4625 "text" : "{id}"
4626 }
4627 ],
4628 "info" : {
4629 "POST" : {
4630 "description" : "Add 'Mail address' object.",
4631 "method" : "POST",
4632 "name" : "receiver",
410dc2c9
DM
4633 "parameters" : {
4634 "additionalProperties" : 0,
4635 "properties" : {
eff914dc
DM
4636 "email" : {
4637 "description" : "Email address.",
4638 "format" : "email",
410dc2c9
DM
4639 "type" : "string",
4640 "typetext" : "<string>"
4641 }
4642 }
4643 },
c061d61d
DM
4644 "permissions" : {
4645 "check" : [
4646 "admin"
4647 ]
4648 },
a55e94a6 4649 "protected" : 1,
410dc2c9 4650 "proxyto" : "master",
eff914dc
DM
4651 "returns" : {
4652 "description" : "The object ID.",
4653 "type" : "integer"
4654 }
4655 }
4656 },
4657 "leaf" : 0,
4658 "path" : "/config/whitelist/receiver",
4659 "text" : "receiver"
4660 },
4661 {
4662 "children" : [
4663 {
4664 "info" : {
4665 "GET" : {
4666 "description" : "Read 'Domain' object settings.",
4667 "method" : "GET",
4668 "name" : "read_domain",
4669 "parameters" : {
4670 "additionalProperties" : 0,
4671 "properties" : {
4672 "id" : {
4673 "description" : "Object ID.",
4674 "type" : "integer",
4675 "typetext" : "<integer>"
4676 }
4677 }
4678 },
c061d61d
DM
4679 "permissions" : {
4680 "check" : [
4681 "admin",
4682 "audit"
4683 ]
4684 },
eff914dc
DM
4685 "proxyto" : "master",
4686 "returns" : {
4687 "properties" : {
4688 "id" : {
4689 "type" : "integer"
4690 }
4691 },
4692 "type" : "object"
4693 }
4694 },
4695 "PUT" : {
4696 "description" : "Update 'Domain' object.",
4697 "method" : "PUT",
4698 "name" : "update_domain",
4699 "parameters" : {
4700 "additionalProperties" : 0,
4701 "properties" : {
4702 "domain" : {
4703 "description" : "DNS domain name (Sender).",
4704 "format" : "dns-name",
4705 "type" : "string",
4706 "typetext" : "<string>"
4707 },
4708 "id" : {
4709 "description" : "Object ID.",
4710 "type" : "integer",
4711 "typetext" : "<integer>"
4712 }
4713 }
4714 },
c061d61d
DM
4715 "permissions" : {
4716 "check" : [
4717 "admin"
4718 ]
4719 },
a55e94a6 4720 "protected" : 1,
eff914dc
DM
4721 "proxyto" : "master",
4722 "returns" : {
4723 "type" : "null"
4724 }
4725 }
4726 },
4727 "leaf" : 1,
4728 "path" : "/config/whitelist/domain/{id}",
4729 "text" : "{id}"
4730 }
4731 ],
4732 "info" : {
4733 "POST" : {
4734 "description" : "Add 'Domain' object.",
4735 "method" : "POST",
4736 "name" : "domain",
410dc2c9
DM
4737 "parameters" : {
4738 "additionalProperties" : 0,
4739 "properties" : {
eff914dc
DM
4740 "domain" : {
4741 "description" : "DNS domain name (Sender).",
4742 "format" : "dns-name",
410dc2c9
DM
4743 "type" : "string",
4744 "typetext" : "<string>"
eff914dc
DM
4745 }
4746 }
4747 },
c061d61d
DM
4748 "permissions" : {
4749 "check" : [
4750 "admin"
4751 ]
4752 },
a55e94a6 4753 "protected" : 1,
eff914dc
DM
4754 "proxyto" : "master",
4755 "returns" : {
4756 "description" : "The object ID.",
4757 "type" : "integer"
4758 }
4759 }
4760 },
4761 "leaf" : 0,
4762 "path" : "/config/whitelist/domain",
4763 "text" : "domain"
4764 },
4765 {
4766 "children" : [
4767 {
4768 "info" : {
4769 "GET" : {
4770 "description" : "Read 'Domain' object settings.",
4771 "method" : "GET",
4772 "name" : "read_receiver_domain",
4773 "parameters" : {
4774 "additionalProperties" : 0,
4775 "properties" : {
4776 "id" : {
4777 "description" : "Object ID.",
4778 "type" : "integer",
4779 "typetext" : "<integer>"
4780 }
4781 }
410dc2c9 4782 },
c061d61d
DM
4783 "permissions" : {
4784 "check" : [
4785 "admin",
4786 "audit"
4787 ]
4788 },
eff914dc
DM
4789 "proxyto" : "master",
4790 "returns" : {
4791 "properties" : {
4792 "id" : {
4793 "type" : "integer"
4794 }
4795 },
4796 "type" : "object"
4797 }
4798 },
4799 "PUT" : {
4800 "description" : "Update 'Domain' object.",
4801 "method" : "PUT",
4802 "name" : "update_receiver_domain",
4803 "parameters" : {
4804 "additionalProperties" : 0,
4805 "properties" : {
4806 "domain" : {
4807 "description" : "DNS domain name (Sender).",
4808 "format" : "dns-name",
4809 "type" : "string",
4810 "typetext" : "<string>"
4811 },
4812 "id" : {
4813 "description" : "Object ID.",
4814 "type" : "integer",
4815 "typetext" : "<integer>"
4816 }
4817 }
410dc2c9 4818 },
c061d61d
DM
4819 "permissions" : {
4820 "check" : [
4821 "admin"
4822 ]
4823 },
a55e94a6 4824 "protected" : 1,
eff914dc
DM
4825 "proxyto" : "master",
4826 "returns" : {
4827 "type" : "null"
4828 }
4829 }
4830 },
4831 "leaf" : 1,
4832 "path" : "/config/whitelist/receiver_domain/{id}",
4833 "text" : "{id}"
4834 }
4835 ],
4836 "info" : {
4837 "POST" : {
4838 "description" : "Add 'Domain' object.",
4839 "method" : "POST",
4840 "name" : "receiver_domain",
4841 "parameters" : {
4842 "additionalProperties" : 0,
4843 "properties" : {
4844 "domain" : {
4845 "description" : "DNS domain name (Sender).",
4846 "format" : "dns-name",
410dc2c9
DM
4847 "type" : "string",
4848 "typetext" : "<string>"
eff914dc
DM
4849 }
4850 }
4851 },
c061d61d
DM
4852 "permissions" : {
4853 "check" : [
4854 "admin"
4855 ]
4856 },
a55e94a6 4857 "protected" : 1,
eff914dc
DM
4858 "proxyto" : "master",
4859 "returns" : {
4860 "description" : "The object ID.",
4861 "type" : "integer"
4862 }
4863 }
4864 },
4865 "leaf" : 0,
4866 "path" : "/config/whitelist/receiver_domain",
4867 "text" : "receiver_domain"
4868 },
4869 {
4870 "children" : [
4871 {
4872 "info" : {
4873 "GET" : {
4874 "description" : "Read 'Regular Expression' object settings.",
4875 "method" : "GET",
4876 "name" : "read_regex",
4877 "parameters" : {
4878 "additionalProperties" : 0,
4879 "properties" : {
4880 "id" : {
4881 "description" : "Object ID.",
4882 "type" : "integer",
4883 "typetext" : "<integer>"
4884 }
4885 }
410dc2c9 4886 },
c061d61d
DM
4887 "permissions" : {
4888 "check" : [
4889 "admin",
4890 "audit"
4891 ]
4892 },
eff914dc
DM
4893 "proxyto" : "master",
4894 "returns" : {
4895 "properties" : {
4896 "id" : {
4897 "type" : "integer"
4898 }
4899 },
4900 "type" : "object"
4901 }
4902 },
4903 "PUT" : {
4904 "description" : "Update 'Regular Expression' object.",
4905 "method" : "PUT",
4906 "name" : "update_regex",
4907 "parameters" : {
4908 "additionalProperties" : 0,
4909 "properties" : {
4910 "id" : {
4911 "description" : "Object ID.",
4912 "type" : "integer",
4913 "typetext" : "<integer>"
4914 },
4915 "regex" : {
4916 "description" : "Email address regular expression.",
4917 "maxLength" : 1024,
4918 "type" : "string",
4919 "typetext" : "<string>"
4920 }
4921 }
4922 },
c061d61d
DM
4923 "permissions" : {
4924 "check" : [
4925 "admin"
4926 ]
4927 },
a55e94a6 4928 "protected" : 1,
eff914dc
DM
4929 "proxyto" : "master",
4930 "returns" : {
4931 "type" : "null"
4932 }
4933 }
4934 },
4935 "leaf" : 1,
4936 "path" : "/config/whitelist/regex/{id}",
4937 "text" : "{id}"
4938 }
4939 ],
4940 "info" : {
4941 "POST" : {
4942 "description" : "Add 'Regular Expression' object.",
4943 "method" : "POST",
4944 "name" : "regex",
4945 "parameters" : {
4946 "additionalProperties" : 0,
4947 "properties" : {
4948 "regex" : {
4949 "description" : "Email address regular expression.",
4950 "maxLength" : 1024,
410dc2c9
DM
4951 "type" : "string",
4952 "typetext" : "<string>"
eff914dc
DM
4953 }
4954 }
4955 },
c061d61d
DM
4956 "permissions" : {
4957 "check" : [
4958 "admin"
4959 ]
4960 },
a55e94a6 4961 "protected" : 1,
eff914dc
DM
4962 "proxyto" : "master",
4963 "returns" : {
4964 "description" : "The object ID.",
4965 "type" : "integer"
4966 }
4967 }
4968 },
4969 "leaf" : 0,
4970 "path" : "/config/whitelist/regex",
4971 "text" : "regex"
4972 },
4973 {
4974 "children" : [
4975 {
4976 "info" : {
4977 "GET" : {
4978 "description" : "Read 'Regular Expression' object settings.",
4979 "method" : "GET",
4980 "name" : "read_receiver_regex",
4981 "parameters" : {
4982 "additionalProperties" : 0,
4983 "properties" : {
4984 "id" : {
4985 "description" : "Object ID.",
4986 "type" : "integer",
4987 "typetext" : "<integer>"
4988 }
4989 }
4990 },
c061d61d
DM
4991 "permissions" : {
4992 "check" : [
4993 "admin",
4994 "audit"
4995 ]
4996 },
eff914dc
DM
4997 "proxyto" : "master",
4998 "returns" : {
4999 "properties" : {
5000 "id" : {
5001 "type" : "integer"
5002 }
5003 },
5004 "type" : "object"
5005 }
5006 },
5007 "PUT" : {
5008 "description" : "Update 'Regular Expression' object.",
5009 "method" : "PUT",
5010 "name" : "update_receiver_regex",
5011 "parameters" : {
5012 "additionalProperties" : 0,
5013 "properties" : {
5014 "id" : {
5015 "description" : "Object ID.",
5016 "type" : "integer",
5017 "typetext" : "<integer>"
5018 },
5019 "regex" : {
5020 "description" : "Email address regular expression.",
5021 "maxLength" : 1024,
5022 "type" : "string",
5023 "typetext" : "<string>"
5024 }
5025 }
5026 },
c061d61d
DM
5027 "permissions" : {
5028 "check" : [
5029 "admin"
5030 ]
5031 },
a55e94a6 5032 "protected" : 1,
eff914dc
DM
5033 "proxyto" : "master",
5034 "returns" : {
5035 "type" : "null"
5036 }
5037 }
5038 },
5039 "leaf" : 1,
5040 "path" : "/config/whitelist/receiver_regex/{id}",
5041 "text" : "{id}"
5042 }
5043 ],
5044 "info" : {
5045 "POST" : {
5046 "description" : "Add 'Regular Expression' object.",
5047 "method" : "POST",
5048 "name" : "receiver_regex",
5049 "parameters" : {
5050 "additionalProperties" : 0,
5051 "properties" : {
5052 "regex" : {
5053 "description" : "Email address regular expression.",
5054 "maxLength" : 1024,
5055 "type" : "string",
5056 "typetext" : "<string>"
5057 }
5058 }
5059 },
c061d61d
DM
5060 "permissions" : {
5061 "check" : [
5062 "admin"
5063 ]
5064 },
a55e94a6 5065 "protected" : 1,
eff914dc
DM
5066 "proxyto" : "master",
5067 "returns" : {
5068 "description" : "The object ID.",
5069 "type" : "integer"
5070 }
5071 }
5072 },
5073 "leaf" : 0,
5074 "path" : "/config/whitelist/receiver_regex",
5075 "text" : "receiver_regex"
5076 },
5077 {
5078 "children" : [
5079 {
5080 "info" : {
5081 "GET" : {
5082 "description" : "Read 'IP Address' object settings.",
5083 "method" : "GET",
5084 "name" : "read_ip",
5085 "parameters" : {
5086 "additionalProperties" : 0,
5087 "properties" : {
5088 "id" : {
5089 "description" : "Object ID.",
5090 "type" : "integer",
5091 "typetext" : "<integer>"
5092 }
5093 }
5094 },
c061d61d
DM
5095 "permissions" : {
5096 "check" : [
5097 "admin",
5098 "audit"
5099 ]
5100 },
eff914dc
DM
5101 "proxyto" : "master",
5102 "returns" : {
5103 "properties" : {
5104 "id" : {
5105 "type" : "integer"
5106 }
5107 },
5108 "type" : "object"
5109 }
5110 },
5111 "PUT" : {
5112 "description" : "Update 'IP Address' object.",
5113 "method" : "PUT",
5114 "name" : "update_ip",
5115 "parameters" : {
5116 "additionalProperties" : 0,
5117 "properties" : {
5118 "id" : {
5119 "description" : "Object ID.",
5120 "type" : "integer",
5121 "typetext" : "<integer>"
5122 },
5123 "ip" : {
5124 "description" : "IP address",
5125 "format" : "ip",
5126 "type" : "string",
5127 "typetext" : "<string>"
5128 }
5129 }
5130 },
c061d61d
DM
5131 "permissions" : {
5132 "check" : [
5133 "admin"
5134 ]
5135 },
a55e94a6 5136 "protected" : 1,
eff914dc
DM
5137 "proxyto" : "master",
5138 "returns" : {
5139 "type" : "null"
5140 }
5141 }
5142 },
5143 "leaf" : 1,
5144 "path" : "/config/whitelist/ip/{id}",
5145 "text" : "{id}"
5146 }
5147 ],
5148 "info" : {
5149 "POST" : {
5150 "description" : "Add 'IP Address' object.",
5151 "method" : "POST",
5152 "name" : "ip",
5153 "parameters" : {
5154 "additionalProperties" : 0,
5155 "properties" : {
5156 "ip" : {
5157 "description" : "IP address",
5158 "format" : "ip",
5159 "type" : "string",
5160 "typetext" : "<string>"
5161 }
5162 }
5163 },
c061d61d
DM
5164 "permissions" : {
5165 "check" : [
5166 "admin"
5167 ]
5168 },
a55e94a6 5169 "protected" : 1,
eff914dc
DM
5170 "proxyto" : "master",
5171 "returns" : {
5172 "description" : "The object ID.",
5173 "type" : "integer"
5174 }
5175 }
5176 },
5177 "leaf" : 0,
5178 "path" : "/config/whitelist/ip",
5179 "text" : "ip"
5180 },
5181 {
5182 "children" : [
5183 {
5184 "info" : {
5185 "GET" : {
5186 "description" : "Read 'IP Network' object settings.",
5187 "method" : "GET",
5188 "name" : "read_network",
5189 "parameters" : {
5190 "additionalProperties" : 0,
5191 "properties" : {
5192 "id" : {
5193 "description" : "Object ID.",
5194 "type" : "integer",
5195 "typetext" : "<integer>"
5196 }
5197 }
5198 },
c061d61d
DM
5199 "permissions" : {
5200 "check" : [
5201 "admin",
5202 "audit"
5203 ]
5204 },
eff914dc
DM
5205 "proxyto" : "master",
5206 "returns" : {
5207 "properties" : {
5208 "id" : {
5209 "type" : "integer"
5210 }
5211 },
5212 "type" : "object"
5213 }
5214 },
5215 "PUT" : {
5216 "description" : "Update 'IP Network' object.",
5217 "method" : "PUT",
5218 "name" : "update_network",
5219 "parameters" : {
5220 "additionalProperties" : 0,
5221 "properties" : {
5222 "cidr" : {
5223 "description" : "Network address in CIDR notation.",
5224 "format" : "CIDR",
5225 "type" : "string",
5226 "typetext" : "<string>"
5227 },
5228 "id" : {
5229 "description" : "Object ID.",
5230 "type" : "integer",
5231 "typetext" : "<integer>"
5232 }
5233 }
5234 },
c061d61d
DM
5235 "permissions" : {
5236 "check" : [
5237 "admin"
5238 ]
5239 },
a55e94a6 5240 "protected" : 1,
eff914dc
DM
5241 "proxyto" : "master",
5242 "returns" : {
5243 "type" : "null"
5244 }
5245 }
5246 },
5247 "leaf" : 1,
5248 "path" : "/config/whitelist/network/{id}",
5249 "text" : "{id}"
5250 }
5251 ],
5252 "info" : {
5253 "POST" : {
5254 "description" : "Add 'IP Network' object.",
5255 "method" : "POST",
5256 "name" : "network",
5257 "parameters" : {
5258 "additionalProperties" : 0,
5259 "properties" : {
5260 "cidr" : {
5261 "description" : "Network address in CIDR notation.",
5262 "format" : "CIDR",
5263 "type" : "string",
5264 "typetext" : "<string>"
5265 }
5266 }
5267 },
c061d61d
DM
5268 "permissions" : {
5269 "check" : [
5270 "admin"
5271 ]
5272 },
a55e94a6 5273 "protected" : 1,
eff914dc
DM
5274 "proxyto" : "master",
5275 "returns" : {
5276 "description" : "The object ID.",
5277 "type" : "integer"
5278 }
5279 }
5280 },
5281 "leaf" : 0,
5282 "path" : "/config/whitelist/network",
5283 "text" : "network"
5284 }
5285 ],
5286 "info" : {
5287 "GET" : {
5288 "description" : "Directory index.",
5289 "method" : "GET",
5290 "name" : "index",
5291 "parameters" : {
5292 "additionalProperties" : 0
5293 },
732d76e1
DM
5294 "permissions" : {
5295 "check" : [
5296 "admin",
5297 "audit"
5298 ]
5299 },
eff914dc
DM
5300 "returns" : {
5301 "items" : {
5302 "properties" : {
5303 "subdir" : {
5304 "type" : "string"
5305 }
5306 },
5307 "type" : "object"
5308 },
5309 "links" : [
5310 {
5311 "href" : "{subdir}",
5312 "rel" : "child"
5313 }
5314 ],
5315 "type" : "array"
5316 }
5317 }
5318 },
5319 "leaf" : 0,
5320 "path" : "/config/whitelist",
5321 "text" : "whitelist"
5322 },
5323 {
5324 "children" : [
5325 {
a55e94a6
DM
5326 "children" : [
5327 {
5328 "info" : {
5329 "GET" : {
5330 "description" : "Get LDAP profile configuration.",
5331 "method" : "GET",
5332 "name" : "read_config",
5333 "parameters" : {
5334 "additionalProperties" : 0,
5335 "properties" : {
5336 "profile" : {
5337 "description" : "Profile ID.",
5338 "format" : "pve-configid",
5339 "type" : "string",
5340 "typetext" : "<string>"
5341 }
5342 }
5343 },
5344 "permissions" : {
5345 "check" : [
4a46ced6
DM
5346 "admin",
5347 "audit"
a55e94a6
DM
5348 ]
5349 },
5350 "proxyto" : "master",
5351 "returns" : {}
5352 },
5353 "PUT" : {
5354 "description" : "Update LDAP profile settings.",
5355 "method" : "PUT",
5356 "name" : "update_config",
5357 "parameters" : {
5358 "additionalProperties" : 0,
5359 "properties" : {
5360 "accountattr" : {
732d76e1 5361 "default" : "sAMAccountName, uid",
a55e94a6 5362 "description" : "Account attribute name name.",
274b47fc 5363 "format" : "ldap-simple-attr-list",
a55e94a6 5364 "optional" : 1,
274b47fc
DM
5365 "type" : "string",
5366 "typetext" : "<string>"
a55e94a6
DM
5367 },
5368 "basedn" : {
5369 "description" : "Base domain name.",
5370 "optional" : 1,
5371 "type" : "string",
5372 "typetext" : "<string>"
5373 },
5374 "binddn" : {
5375 "description" : "Bind domain name.",
5376 "optional" : 1,
5377 "type" : "string",
5378 "typetext" : "<string>"
5379 },
5380 "bindpw" : {
5381 "description" : "Bind password.",
5382 "optional" : 1,
5383 "type" : "string",
5384 "typetext" : "<string>"
5385 },
5386 "comment" : {
5387 "description" : "Description.",
5388 "maxLength" : 4096,
5389 "optional" : 1,
5390 "type" : "string",
5391 "typetext" : "<string>"
5392 },
5393 "delete" : {
5394 "description" : "A list of settings you want to delete.",
5395 "format" : "pve-configid-list",
5396 "maxLength" : 4096,
5397 "optional" : 1,
5398 "type" : "string",
5399 "typetext" : "<string>"
5400 },
5401 "digest" : {
5402 "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.",
5403 "maxLength" : 40,
5404 "optional" : 1,
5405 "type" : "string",
5406 "typetext" : "<string>"
5407 },
5408 "disable" : {
5409 "description" : "Flag to disable/deactivate the entry.",
5410 "optional" : 1,
5411 "type" : "boolean",
5412 "typetext" : "<boolean>"
5413 },
5414 "filter" : {
5415 "description" : "LDAP filter.",
5416 "optional" : 1,
5417 "type" : "string",
5418 "typetext" : "<string>"
5419 },
5420 "groupbasedn" : {
5421 "description" : "Base domain name for groups.",
5422 "optional" : 1,
5423 "type" : "string",
5424 "typetext" : "<string>"
5425 },
732d76e1
DM
5426 "groupclass" : {
5427 "default" : "group, univentionGroup, ipausergroup",
5428 "description" : "List of objectclasses for groups.",
274b47fc 5429 "format" : "ldap-simple-attr-list",
732d76e1
DM
5430 "optional" : 1,
5431 "type" : "string",
5432 "typetext" : "<string>"
5433 },
a55e94a6 5434 "mailattr" : {
274b47fc 5435 "default" : "mail, userPrincipalName, proxyAddresses, othermailbox, mailAlternativeAddress",
a55e94a6 5436 "description" : "List of mail attribute names.",
274b47fc 5437 "format" : "ldap-simple-attr-list",
a55e94a6 5438 "optional" : 1,
274b47fc
DM
5439 "type" : "string",
5440 "typetext" : "<string>"
a55e94a6
DM
5441 },
5442 "mode" : {
5443 "default" : "ldap",
5444 "description" : "LDAP protocol mode ('ldap' or 'ldaps').",
5445 "enum" : [
5446 "ldap",
5447 "ldaps"
5448 ],
5449 "optional" : 1,
5450 "type" : "string"
5451 },
5452 "port" : {
5453 "description" : "Specify the port to connect to.",
5454 "maximum" : 65535,
5455 "minimum" : 1,
5456 "optional" : 1,
5457 "type" : "integer",
5458 "typetext" : "<integer> (1 - 65535)"
5459 },
5460 "profile" : {
5461 "description" : "Profile ID.",
5462 "format" : "pve-configid",
5463 "type" : "string",
5464 "typetext" : "<string>"
5465 },
5466 "server1" : {
5467 "description" : "Server address.",
5468 "format" : "address",
5469 "maxLength" : 256,
5470 "optional" : 1,
5471 "type" : "string",
5472 "typetext" : "<string>"
5473 },
5474 "server2" : {
5475 "description" : "Fallback server address. Userd when the first server is not available.",
5476 "format" : "address",
5477 "maxLength" : 256,
5478 "optional" : 1,
5479 "type" : "string",
5480 "typetext" : "<string>"
5481 }
732d76e1
DM
5482 },
5483 "type" : "object"
5484 },
5485 "permissions" : {
5486 "check" : [
5487 "admin"
5488 ]
5489 },
5490 "protected" : 1,
5491 "proxyto" : "master",
5492 "returns" : {
5493 "type" : "null"
5494 }
5495 }
5496 },
5497 "leaf" : 1,
5498 "path" : "/config/ldap/{profile}/config",
5499 "text" : "config"
5500 },
5501 {
5502 "info" : {
5503 "POST" : {
5504 "description" : "Synchronice LDAP users to local database.",
5505 "method" : "POST",
5506 "name" : "sync_profile",
5507 "parameters" : {
5508 "additionalProperties" : 0,
5509 "properties" : {
5510 "profile" : {
5511 "description" : "Profile ID.",
5512 "format" : "pve-configid",
5513 "type" : "string",
5514 "typetext" : "<string>"
5515 }
5516 }
5517 },
5518 "permissions" : {
5519 "check" : [
5520 "admin"
5521 ]
5522 },
5523 "protected" : 1,
5524 "proxyto" : "master",
5525 "returns" : {
5526 "type" : "null"
5527 }
5528 }
5529 },
5530 "leaf" : 1,
5531 "path" : "/config/ldap/{profile}/sync",
5532 "text" : "sync"
5533 },
5534 {
5535 "children" : [
5536 {
5537 "info" : {
5538 "GET" : {
5539 "description" : "Get all email addresses for the specified user.",
5540 "method" : "GET",
5541 "name" : "address_list",
5542 "parameters" : {
5543 "additionalProperties" : 0,
5544 "properties" : {
5545 "email" : {
5546 "description" : "Email address.",
5547 "format" : "email",
5548 "type" : "string",
5549 "typetext" : "<string>"
5550 },
5551 "profile" : {
5552 "description" : "Profile ID.",
5553 "format" : "pve-configid",
5554 "type" : "string",
5555 "typetext" : "<string>"
5556 }
5557 }
5558 },
5559 "permissions" : {
5560 "check" : [
4a46ced6
DM
5561 "admin",
5562 "audit"
732d76e1
DM
5563 ]
5564 },
5565 "protected" : 1,
5566 "proxyto" : "master",
5567 "returns" : {
5568 "items" : {
5569 "properties" : {
5570 "email" : {
5571 "type" : "string"
5572 },
5573 "primary" : {
5574 "type" : "boolean"
5575 }
5576 },
5577 "type" : "object"
5578 },
5579 "type" : "array"
5580 }
5581 }
a55e94a6 5582 },
732d76e1
DM
5583 "leaf" : 1,
5584 "path" : "/config/ldap/{profile}/users/{email}",
5585 "text" : "{email}"
a55e94a6 5586 }
732d76e1 5587 ],
a55e94a6 5588 "info" : {
732d76e1
DM
5589 "GET" : {
5590 "description" : "List LDAP users.",
5591 "method" : "GET",
5592 "name" : "profile_list_users",
a55e94a6
DM
5593 "parameters" : {
5594 "additionalProperties" : 0,
5595 "properties" : {
5596 "profile" : {
5597 "description" : "Profile ID.",
5598 "format" : "pve-configid",
5599 "type" : "string",
5600 "typetext" : "<string>"
5601 }
5602 }
5603 },
5604 "permissions" : {
5605 "check" : [
4a46ced6
DM
5606 "admin",
5607 "audit"
a55e94a6
DM
5608 ]
5609 },
5610 "protected" : 1,
5611 "proxyto" : "master",
5612 "returns" : {
732d76e1
DM
5613 "items" : {
5614 "properties" : {
5615 "account" : {
5616 "type" : "string"
5617 },
5618 "dn" : {
5619 "type" : "string"
5620 },
5621 "pmail" : {
5622 "type" : "string"
5623 }
5624 },
5625 "type" : "object"
5626 },
5627 "links" : [
5628 {
5629 "href" : "{pmail}",
5630 "rel" : "child"
5631 }
5632 ],
5633 "type" : "array"
a55e94a6
DM
5634 }
5635 }
5636 },
732d76e1
DM
5637 "leaf" : 0,
5638 "path" : "/config/ldap/{profile}/users",
5639 "text" : "users"
a55e94a6
DM
5640 },
5641 {
5642 "children" : [
5643 {
5644 "info" : {
5645 "GET" : {
732d76e1 5646 "description" : "List LDAP group members.",
a55e94a6 5647 "method" : "GET",
732d76e1 5648 "name" : "profile_list_group_members",
a55e94a6
DM
5649 "parameters" : {
5650 "additionalProperties" : 0,
5651 "properties" : {
732d76e1
DM
5652 "gid" : {
5653 "description" : "Group ID",
5654 "type" : "number",
5655 "typetext" : "<number>"
a55e94a6
DM
5656 },
5657 "profile" : {
5658 "description" : "Profile ID.",
5659 "format" : "pve-configid",
5660 "type" : "string",
5661 "typetext" : "<string>"
5662 }
5663 }
5664 },
5665 "permissions" : {
5666 "check" : [
4a46ced6
DM
5667 "admin",
5668 "audit"
a55e94a6
DM
5669 ]
5670 },
5671 "protected" : 1,
5672 "proxyto" : "master",
5673 "returns" : {
5674 "items" : {
5675 "properties" : {
732d76e1 5676 "account" : {
a55e94a6
DM
5677 "type" : "string"
5678 },
732d76e1
DM
5679 "dn" : {
5680 "type" : "string"
5681 },
5682 "pmail" : {
5683 "type" : "string"
a55e94a6
DM
5684 }
5685 },
5686 "type" : "object"
5687 },
5688 "type" : "array"
5689 }
5690 }
5691 },
5692 "leaf" : 1,
732d76e1
DM
5693 "path" : "/config/ldap/{profile}/groups/{gid}",
5694 "text" : "{gid}"
a55e94a6
DM
5695 }
5696 ],
5697 "info" : {
5698 "GET" : {
732d76e1 5699 "description" : "List LDAP groups.",
a55e94a6 5700 "method" : "GET",
732d76e1 5701 "name" : "profile_list_groups",
a55e94a6
DM
5702 "parameters" : {
5703 "additionalProperties" : 0,
5704 "properties" : {
5705 "profile" : {
5706 "description" : "Profile ID.",
5707 "format" : "pve-configid",
5708 "type" : "string",
5709 "typetext" : "<string>"
5710 }
5711 }
5712 },
5713 "permissions" : {
5714 "check" : [
4a46ced6
DM
5715 "admin",
5716 "audit"
a55e94a6
DM
5717 ]
5718 },
5719 "protected" : 1,
5720 "proxyto" : "master",
5721 "returns" : {
5722 "items" : {
5723 "properties" : {
a55e94a6
DM
5724 "dn" : {
5725 "type" : "string"
5726 },
732d76e1
DM
5727 "gid" : {
5728 "type" : "number"
a55e94a6
DM
5729 }
5730 },
5731 "type" : "object"
5732 },
732d76e1
DM
5733 "links" : [
5734 {
5735 "href" : "{gid}",
5736 "rel" : "child"
5737 }
5738 ],
a55e94a6
DM
5739 "type" : "array"
5740 }
5741 }
5742 },
732d76e1
DM
5743 "leaf" : 0,
5744 "path" : "/config/ldap/{profile}/groups",
5745 "text" : "groups"
5746 }
5747 ],
5748 "info" : {
5749 "DELETE" : {
5750 "description" : "Delete an LDAP profile",
5751 "method" : "DELETE",
5752 "name" : "delete",
5753 "parameters" : {
5754 "additionalProperties" : 0,
5755 "properties" : {
5756 "profile" : {
5757 "description" : "Profile ID.",
5758 "format" : "pve-configid",
5759 "type" : "string",
5760 "typetext" : "<string>"
5761 }
5762 }
5763 },
5764 "permissions" : {
5765 "check" : [
5766 "admin"
5767 ]
5768 },
5769 "protected" : 1,
5770 "proxyto" : "master",
5771 "returns" : {
5772 "type" : "null"
5773 }
5774 },
5775 "GET" : {
5776 "description" : "Directory index",
5777 "method" : "GET",
5778 "name" : "profile_index",
5779 "parameters" : {
5780 "additionalProperties" : 0,
5781 "properties" : {
5782 "profile" : {
5783 "description" : "Profile ID.",
5784 "format" : "pve-configid",
5785 "type" : "string",
5786 "typetext" : "<string>"
5787 }
5788 }
5789 },
5790 "permissions" : {
5791 "user" : "all"
5792 },
5793 "returns" : {
5794 "items" : {
5795 "properties" : {
5796 "subdir" : {
5797 "type" : "string"
5798 }
5799 },
5800 "type" : "object"
5801 },
5802 "links" : [
5803 {
5804 "href" : "{subdir}",
5805 "rel" : "child"
5806 }
5807 ],
5808 "type" : "array"
5809 }
5810 }
5811 },
5812 "leaf" : 0,
5813 "path" : "/config/ldap/{profile}",
5814 "text" : "{profile}"
5815 }
5816 ],
5817 "info" : {
5818 "GET" : {
5819 "description" : "List configured LDAP profiles.",
5820 "method" : "GET",
5821 "name" : "index",
5822 "parameters" : {
5823 "additionalProperties" : 0
5824 },
5825 "permissions" : {
5826 "check" : [
4a46ced6
DM
5827 "admin",
5828 "audit"
732d76e1
DM
5829 ]
5830 },
5831 "proxyto" : "master",
5832 "returns" : {
5833 "items" : {
5834 "properties" : {
5835 "comment" : {
5836 "optional" : 1,
5837 "type" : "string"
5838 },
5839 "disable" : {
5840 "type" : "boolean"
5841 },
5842 "gcount" : {
5843 "optional" : 1,
5844 "type" : "integer"
5845 },
5846 "mcount" : {
5847 "optional" : 1,
5848 "type" : "integer"
5849 },
5850 "mode" : {
5851 "type" : "string"
5852 },
5853 "profile" : {
5854 "type" : "string"
5855 },
5856 "server1" : {
5857 "type" : "string"
5858 },
5859 "server2" : {
5860 "optional" : 1,
5861 "type" : "string"
5862 },
5863 "ucount" : {
5864 "optional" : 1,
5865 "type" : "integer"
5866 }
5867 },
5868 "type" : "object"
5869 },
5870 "links" : [
5871 {
5872 "href" : "{profile}",
5873 "rel" : "child"
5874 }
5875 ],
5876 "type" : "array"
5877 }
5878 },
5879 "POST" : {
5880 "description" : "Add LDAP profile.",
5881 "method" : "POST",
5882 "name" : "create",
5883 "parameters" : {
5884 "additionalProperties" : 0,
5885 "properties" : {
5886 "accountattr" : {
5887 "default" : "sAMAccountName, uid",
5888 "description" : "Account attribute name name.",
274b47fc 5889 "format" : "ldap-simple-attr-list",
732d76e1 5890 "optional" : 1,
274b47fc
DM
5891 "type" : "string",
5892 "typetext" : "<string>"
732d76e1
DM
5893 },
5894 "basedn" : {
5895 "description" : "Base domain name.",
5896 "optional" : 1,
5897 "type" : "string",
5898 "typetext" : "<string>"
5899 },
5900 "binddn" : {
5901 "description" : "Bind domain name.",
5902 "optional" : 1,
5903 "type" : "string",
5904 "typetext" : "<string>"
5905 },
5906 "bindpw" : {
5907 "description" : "Bind password.",
5908 "optional" : 1,
5909 "type" : "string",
5910 "typetext" : "<string>"
5911 },
5912 "comment" : {
5913 "description" : "Description.",
5914 "maxLength" : 4096,
5915 "optional" : 1,
5916 "type" : "string",
5917 "typetext" : "<string>"
5918 },
5919 "disable" : {
5920 "description" : "Flag to disable/deactivate the entry.",
5921 "optional" : 1,
5922 "type" : "boolean",
5923 "typetext" : "<boolean>"
a55e94a6 5924 },
732d76e1
DM
5925 "filter" : {
5926 "description" : "LDAP filter.",
5927 "optional" : 1,
5928 "type" : "string",
5929 "typetext" : "<string>"
5930 },
5931 "groupbasedn" : {
5932 "description" : "Base domain name for groups.",
5933 "optional" : 1,
5934 "type" : "string",
5935 "typetext" : "<string>"
5936 },
5937 "groupclass" : {
5938 "default" : "group, univentionGroup, ipausergroup",
5939 "description" : "List of objectclasses for groups.",
274b47fc 5940 "format" : "ldap-simple-attr-list",
732d76e1
DM
5941 "optional" : 1,
5942 "type" : "string",
5943 "typetext" : "<string>"
5944 },
5945 "mailattr" : {
274b47fc 5946 "default" : "mail, userPrincipalName, proxyAddresses, othermailbox, mailAlternativeAddress",
732d76e1 5947 "description" : "List of mail attribute names.",
274b47fc 5948 "format" : "ldap-simple-attr-list",
732d76e1 5949 "optional" : 1,
274b47fc
DM
5950 "type" : "string",
5951 "typetext" : "<string>"
732d76e1
DM
5952 },
5953 "mode" : {
5954 "default" : "ldap",
5955 "description" : "LDAP protocol mode ('ldap' or 'ldaps').",
5956 "enum" : [
5957 "ldap",
5958 "ldaps"
5959 ],
5960 "optional" : 1,
5961 "type" : "string"
5962 },
5963 "port" : {
5964 "description" : "Specify the port to connect to.",
5965 "maximum" : 65535,
5966 "minimum" : 1,
5967 "optional" : 1,
5968 "type" : "integer",
5969 "typetext" : "<integer> (1 - 65535)"
5970 },
5971 "profile" : {
5972 "description" : "Profile ID.",
5973 "format" : "pve-configid",
5974 "type" : "string",
5975 "typetext" : "<string>"
5976 },
5977 "server1" : {
5978 "description" : "Server address.",
5979 "format" : "address",
5980 "maxLength" : 256,
5981 "optional" : 0,
5982 "type" : "string",
5983 "typetext" : "<string>"
5984 },
5985 "server2" : {
5986 "description" : "Fallback server address. Userd when the first server is not available.",
5987 "format" : "address",
5988 "maxLength" : 256,
5989 "optional" : 1,
5990 "type" : "string",
5991 "typetext" : "<string>"
5992 }
5993 },
5994 "type" : "object"
5995 },
5996 "permissions" : {
5997 "check" : [
5998 "admin"
5999 ]
6000 },
6001 "protected" : 1,
6002 "proxyto" : "master",
6003 "returns" : {
6004 "type" : "null"
6005 }
6006 }
6007 },
6008 "leaf" : 0,
6009 "path" : "/config/ldap",
6010 "text" : "ldap"
6011 },
6012 {
6013 "children" : [
6014 {
a55e94a6
DM
6015 "info" : {
6016 "DELETE" : {
732d76e1 6017 "description" : "Delete a relay domain",
a55e94a6
DM
6018 "method" : "DELETE",
6019 "name" : "delete",
6020 "parameters" : {
6021 "additionalProperties" : 0,
6022 "properties" : {
732d76e1
DM
6023 "domain" : {
6024 "description" : "Domain name.",
6025 "format" : "dns-name",
eff914dc
DM
6026 "type" : "string",
6027 "typetext" : "<string>"
6028 }
6029 }
6030 },
a55e94a6
DM
6031 "permissions" : {
6032 "check" : [
6033 "admin"
6034 ]
6035 },
eff914dc
DM
6036 "protected" : 1,
6037 "proxyto" : "master",
a55e94a6
DM
6038 "returns" : {
6039 "type" : "null"
6040 }
eff914dc 6041 },
a55e94a6 6042 "GET" : {
732d76e1 6043 "description" : "Read Domain data (comment).",
a55e94a6 6044 "method" : "GET",
732d76e1 6045 "name" : "read",
eff914dc
DM
6046 "parameters" : {
6047 "additionalProperties" : 0,
6048 "properties" : {
732d76e1
DM
6049 "domain" : {
6050 "description" : "Domain name.",
6051 "format" : "dns-name",
eff914dc
DM
6052 "type" : "string",
6053 "typetext" : "<string>"
a55e94a6
DM
6054 }
6055 }
6056 },
6057 "permissions" : {
732d76e1
DM
6058 "check" : [
6059 "admin",
6060 "audit"
6061 ]
a55e94a6 6062 },
732d76e1 6063 "proxyto" : "master",
a55e94a6 6064 "returns" : {
732d76e1
DM
6065 "properties" : {
6066 "comment" : {
6067 "type" : "string"
eff914dc 6068 },
732d76e1
DM
6069 "domain" : {
6070 "type" : "string"
6071 }
eff914dc 6072 },
732d76e1
DM
6073 "type" : "object"
6074 }
6075 },
6076 "PUT" : {
6077 "description" : "Update relay domain data (comment).",
6078 "method" : "PUT",
6079 "name" : "write",
6080 "parameters" : {
6081 "additionalProperties" : 0,
6082 "properties" : {
6083 "comment" : {
6084 "description" : "Comment.",
6085 "type" : "string",
6086 "typetext" : "<string>"
6087 },
6088 "domain" : {
6089 "description" : "Domain name.",
6090 "format" : "dns-name",
6091 "type" : "string",
6092 "typetext" : "<string>"
a55e94a6 6093 }
732d76e1
DM
6094 }
6095 },
6096 "permissions" : {
6097 "check" : [
6098 "admin"
6099 ]
6100 },
6101 "protected" : 1,
6102 "proxyto" : "master",
6103 "returns" : {
6104 "type" : "null"
eff914dc
DM
6105 }
6106 }
6107 },
732d76e1
DM
6108 "leaf" : 1,
6109 "path" : "/config/domains/{domain}",
6110 "text" : "{domain}"
eff914dc
DM
6111 }
6112 ],
6113 "info" : {
6114 "GET" : {
732d76e1 6115 "description" : "List relay domains.",
eff914dc
DM
6116 "method" : "GET",
6117 "name" : "index",
6118 "parameters" : {
6119 "additionalProperties" : 0
6120 },
a55e94a6
DM
6121 "permissions" : {
6122 "check" : [
732d76e1
DM
6123 "admin",
6124 "audit"
a55e94a6
DM
6125 ]
6126 },
eff914dc
DM
6127 "proxyto" : "master",
6128 "returns" : {
6129 "items" : {
6130 "properties" : {
a55e94a6 6131 "comment" : {
eff914dc 6132 "type" : "string"
a55e94a6 6133 },
732d76e1
DM
6134 "domain" : {
6135 "type" : "string"
eff914dc
DM
6136 }
6137 },
6138 "type" : "object"
6139 },
6140 "links" : [
6141 {
732d76e1 6142 "href" : "{domain}",
eff914dc
DM
6143 "rel" : "child"
6144 }
6145 ],
6146 "type" : "array"
6147 }
6148 },
6149 "POST" : {
732d76e1 6150 "description" : "Add relay domain.",
eff914dc
DM
6151 "method" : "POST",
6152 "name" : "create",
6153 "parameters" : {
6154 "additionalProperties" : 0,
6155 "properties" : {
a55e94a6 6156 "comment" : {
732d76e1 6157 "description" : "Comment.",
eff914dc 6158 "optional" : 1,
eff914dc
DM
6159 "type" : "string",
6160 "typetext" : "<string>"
6161 },
732d76e1
DM
6162 "domain" : {
6163 "description" : "Domain name.",
6164 "format" : "dns-name",
eff914dc
DM
6165 "type" : "string",
6166 "typetext" : "<string>"
6167 }
732d76e1 6168 }
eff914dc 6169 },
a55e94a6
DM
6170 "permissions" : {
6171 "check" : [
6172 "admin"
6173 ]
6174 },
eff914dc
DM
6175 "protected" : 1,
6176 "proxyto" : "master",
6177 "returns" : {
6178 "type" : "null"
6179 }
6180 }
6181 },
6182 "leaf" : 0,
732d76e1
DM
6183 "path" : "/config/domains",
6184 "text" : "domains"
eff914dc
DM
6185 },
6186 {
6187 "children" : [
6188 {
6189 "info" : {
6190 "DELETE" : {
732d76e1 6191 "description" : "Delete a fetchmail configuration entry.",
eff914dc
DM
6192 "method" : "DELETE",
6193 "name" : "delete",
6194 "parameters" : {
6195 "additionalProperties" : 0,
6196 "properties" : {
732d76e1
DM
6197 "id" : {
6198 "description" : "Unique ID",
6199 "maxLength" : 16,
6200 "pattern" : "[A-Za-z0-9]+",
6201 "type" : "string"
eff914dc
DM
6202 }
6203 }
6204 },
732d76e1
DM
6205 "permissions" : {
6206 "check" : [
6207 "admin"
6208 ]
6209 },
eff914dc
DM
6210 "protected" : 1,
6211 "proxyto" : "master",
6212 "returns" : {
6213 "type" : "null"
6214 }
6215 },
6216 "GET" : {
732d76e1 6217 "description" : "Read fetchmail user configuration.",
eff914dc
DM
6218 "method" : "GET",
6219 "name" : "read",
6220 "parameters" : {
6221 "additionalProperties" : 0,
6222 "properties" : {
732d76e1
DM
6223 "id" : {
6224 "description" : "Unique ID",
6225 "maxLength" : 16,
6226 "pattern" : "[A-Za-z0-9]+",
6227 "type" : "string"
eff914dc
DM
6228 }
6229 }
6230 },
732d76e1
DM
6231 "permissions" : {
6232 "check" : [
6233 "admin",
6234 "audit"
6235 ]
6236 },
6237 "protected" : 1,
eff914dc
DM
6238 "proxyto" : "master",
6239 "returns" : {
6240 "properties" : {
732d76e1
DM
6241 "enable" : {
6242 "default" : 0,
6243 "description" : "Flag to enable or disable polling.",
6244 "optional" : 1,
6245 "type" : "boolean"
6246 },
6247 "id" : {
6248 "description" : "Unique ID",
6249 "maxLength" : 16,
6250 "pattern" : "[A-Za-z0-9]+",
eff914dc
DM
6251 "type" : "string"
6252 },
732d76e1
DM
6253 "interval" : {
6254 "description" : "Only check this site every <interval> poll cycles. A poll cycle is 5 minutes.",
6255 "maximum" : 2016,
6256 "minimum" : 1,
6257 "optional" : 1,
6258 "type" : "integer"
6259 },
6260 "keep" : {
6261 "default" : 0,
6262 "description" : "Keep retrieved messages on the remote mailserver.",
6263 "optional" : 1,
6264 "type" : "boolean"
6265 },
6266 "pass" : {
6267 "description" : "The password used tfor server login.",
6268 "maxLength" : 64,
6269 "optional" : 1,
6270 "type" : "string"
6271 },
6272 "port" : {
6273 "description" : "Port number.",
6274 "maximum" : 65535,
6275 "minimum" : 1,
6276 "optional" : 1,
6277 "type" : "integer"
6278 },
6279 "protocol" : {
6280 "description" : "Specify the protocol to use when communicating with the remote mailserver",
6281 "enum" : [
6282 "pop3",
6283 "imap"
6284 ],
6285 "optional" : 1,
6286 "type" : "string"
6287 },
6288 "server" : {
6289 "description" : "Server address (IP or DNS name).",
6290 "format" : "address",
6291 "optional" : 1,
6292 "type" : "string"
6293 },
6294 "ssl" : {
6295 "default" : 0,
6296 "description" : "Use SSL.",
6297 "optional" : 1,
6298 "type" : "boolean"
6299 },
6300 "target" : {
6301 "description" : "The target email address (where to deliver fetched mails).",
6302 "maxLength" : 512,
6303 "minLength" : 3,
6304 "optional" : 1,
6305 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
6306 "type" : "string"
6307 },
6308 "user" : {
6309 "description" : "The user identification to be used when logging in to the server",
6310 "maxLength" : 64,
6311 "minLength" : 1,
6312 "optional" : 1,
eff914dc
DM
6313 "type" : "string"
6314 }
6315 },
6316 "type" : "object"
6317 }
6318 },
6319 "PUT" : {
732d76e1 6320 "description" : "Update fetchmail user configuration.",
eff914dc
DM
6321 "method" : "PUT",
6322 "name" : "write",
6323 "parameters" : {
6324 "additionalProperties" : 0,
6325 "properties" : {
732d76e1
DM
6326 "enable" : {
6327 "default" : 0,
6328 "description" : "Flag to enable or disable polling.",
6329 "optional" : 1,
6330 "type" : "boolean",
6331 "typetext" : "<boolean>"
6332 },
6333 "id" : {
6334 "description" : "Unique ID",
6335 "maxLength" : 16,
6336 "pattern" : "[A-Za-z0-9]+",
6337 "type" : "string"
6338 },
6339 "interval" : {
6340 "description" : "Only check this site every <interval> poll cycles. A poll cycle is 5 minutes.",
6341 "maximum" : 2016,
6342 "minimum" : 1,
6343 "optional" : 1,
6344 "type" : "integer",
6345 "typetext" : "<integer> (1 - 2016)"
6346 },
6347 "keep" : {
6348 "default" : 0,
6349 "description" : "Keep retrieved messages on the remote mailserver.",
6350 "optional" : 1,
6351 "type" : "boolean",
6352 "typetext" : "<boolean>"
6353 },
6354 "pass" : {
6355 "description" : "The password used tfor server login.",
6356 "maxLength" : 64,
6357 "optional" : 1,
eff914dc
DM
6358 "type" : "string",
6359 "typetext" : "<string>"
6360 },
732d76e1
DM
6361 "port" : {
6362 "description" : "Port number.",
6363 "maximum" : 65535,
6364 "minimum" : 1,
6365 "optional" : 1,
6366 "type" : "integer",
6367 "typetext" : "<integer> (1 - 65535)"
6368 },
6369 "protocol" : {
6370 "description" : "Specify the protocol to use when communicating with the remote mailserver",
6371 "enum" : [
6372 "pop3",
6373 "imap"
6374 ],
6375 "optional" : 1,
6376 "type" : "string"
6377 },
6378 "server" : {
6379 "description" : "Server address (IP or DNS name).",
6380 "format" : "address",
6381 "optional" : 1,
6382 "type" : "string",
6383 "typetext" : "<string>"
6384 },
6385 "ssl" : {
6386 "default" : 0,
6387 "description" : "Use SSL.",
6388 "optional" : 1,
6389 "type" : "boolean",
6390 "typetext" : "<boolean>"
6391 },
6392 "target" : {
6393 "description" : "The target email address (where to deliver fetched mails).",
6394 "maxLength" : 512,
6395 "minLength" : 3,
6396 "optional" : 1,
6397 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
6398 "type" : "string"
6399 },
6400 "user" : {
6401 "description" : "The user identification to be used when logging in to the server",
6402 "maxLength" : 64,
6403 "minLength" : 1,
6404 "optional" : 1,
eff914dc
DM
6405 "type" : "string",
6406 "typetext" : "<string>"
6407 }
6408 }
6409 },
732d76e1
DM
6410 "permissions" : {
6411 "check" : [
6412 "admin"
6413 ]
6414 },
eff914dc
DM
6415 "protected" : 1,
6416 "proxyto" : "master",
6417 "returns" : {
6418 "type" : "null"
6419 }
6420 }
6421 },
6422 "leaf" : 1,
732d76e1
DM
6423 "path" : "/config/fetchmail/{id}",
6424 "text" : "{id}"
eff914dc
DM
6425 }
6426 ],
6427 "info" : {
6428 "GET" : {
732d76e1 6429 "description" : "List fetchmail users.",
eff914dc
DM
6430 "method" : "GET",
6431 "name" : "index",
6432 "parameters" : {
6433 "additionalProperties" : 0
6434 },
732d76e1
DM
6435 "permissions" : {
6436 "check" : [
6437 "admin",
6438 "audit"
6439 ]
6440 },
6441 "protected" : 1,
eff914dc
DM
6442 "proxyto" : "master",
6443 "returns" : {
6444 "items" : {
6445 "properties" : {
732d76e1
DM
6446 "enable" : {
6447 "default" : 0,
6448 "description" : "Flag to enable or disable polling.",
6449 "optional" : 1,
6450 "type" : "boolean"
6451 },
6452 "id" : {
6453 "description" : "Unique ID",
6454 "maxLength" : 16,
6455 "pattern" : "[A-Za-z0-9]+",
eff914dc
DM
6456 "type" : "string"
6457 },
732d76e1
DM
6458 "interval" : {
6459 "description" : "Only check this site every <interval> poll cycles. A poll cycle is 5 minutes.",
6460 "maximum" : 2016,
6461 "minimum" : 1,
6462 "optional" : 1,
6463 "type" : "integer"
6464 },
6465 "keep" : {
6466 "default" : 0,
6467 "description" : "Keep retrieved messages on the remote mailserver.",
6468 "optional" : 1,
6469 "type" : "boolean"
6470 },
6471 "pass" : {
6472 "description" : "The password used tfor server login.",
6473 "maxLength" : 64,
6474 "optional" : 1,
6475 "type" : "string"
6476 },
6477 "port" : {
6478 "description" : "Port number.",
6479 "maximum" : 65535,
6480 "minimum" : 1,
6481 "optional" : 1,
6482 "type" : "integer"
6483 },
6484 "protocol" : {
6485 "description" : "Specify the protocol to use when communicating with the remote mailserver",
6486 "enum" : [
6487 "pop3",
6488 "imap"
6489 ],
6490 "optional" : 1,
6491 "type" : "string"
6492 },
6493 "server" : {
6494 "description" : "Server address (IP or DNS name).",
6495 "format" : "address",
6496 "optional" : 1,
6497 "type" : "string"
6498 },
6499 "ssl" : {
6500 "default" : 0,
6501 "description" : "Use SSL.",
6502 "optional" : 1,
6503 "type" : "boolean"
6504 },
6505 "target" : {
6506 "description" : "The target email address (where to deliver fetched mails).",
6507 "maxLength" : 512,
6508 "minLength" : 3,
6509 "optional" : 1,
6510 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
6511 "type" : "string"
6512 },
6513 "user" : {
6514 "description" : "The user identification to be used when logging in to the server",
6515 "maxLength" : 64,
6516 "minLength" : 1,
6517 "optional" : 1,
eff914dc
DM
6518 "type" : "string"
6519 }
6520 },
6521 "type" : "object"
6522 },
6523 "links" : [
6524 {
732d76e1 6525 "href" : "{id}",
eff914dc
DM
6526 "rel" : "child"
6527 }
6528 ],
6529 "type" : "array"
6530 }
6531 },
6532 "POST" : {
732d76e1 6533 "description" : "Create fetchmail user configuration.",
eff914dc
DM
6534 "method" : "POST",
6535 "name" : "create",
6536 "parameters" : {
6537 "additionalProperties" : 0,
6538 "properties" : {
732d76e1
DM
6539 "enable" : {
6540 "default" : 0,
6541 "description" : "Flag to enable or disable polling.",
6542 "optional" : 1,
6543 "type" : "boolean",
6544 "typetext" : "<boolean>"
6545 },
6546 "interval" : {
6547 "description" : "Only check this site every <interval> poll cycles. A poll cycle is 5 minutes.",
6548 "maximum" : 2016,
6549 "minimum" : 1,
6550 "optional" : 1,
6551 "type" : "integer",
6552 "typetext" : "<integer> (1 - 2016)"
6553 },
6554 "keep" : {
6555 "default" : 0,
6556 "description" : "Keep retrieved messages on the remote mailserver.",
eff914dc 6557 "optional" : 1,
732d76e1
DM
6558 "type" : "boolean",
6559 "typetext" : "<boolean>"
6560 },
6561 "pass" : {
6562 "description" : "The password used tfor server login.",
6563 "maxLength" : 64,
eff914dc
DM
6564 "type" : "string",
6565 "typetext" : "<string>"
6566 },
732d76e1
DM
6567 "port" : {
6568 "description" : "Port number.",
6569 "maximum" : 65535,
6570 "minimum" : 1,
6571 "optional" : 1,
6572 "type" : "integer",
6573 "typetext" : "<integer> (1 - 65535)"
6574 },
6575 "protocol" : {
6576 "description" : "Specify the protocol to use when communicating with the remote mailserver",
6577 "enum" : [
6578 "pop3",
6579 "imap"
6580 ],
6581 "type" : "string"
6582 },
6583 "server" : {
6584 "description" : "Server address (IP or DNS name).",
6585 "format" : "address",
6586 "type" : "string",
6587 "typetext" : "<string>"
6588 },
6589 "ssl" : {
6590 "default" : 0,
6591 "description" : "Use SSL.",
6592 "optional" : 1,
6593 "type" : "boolean",
6594 "typetext" : "<boolean>"
6595 },
6596 "target" : {
6597 "description" : "The target email address (where to deliver fetched mails).",
6598 "maxLength" : 512,
6599 "minLength" : 3,
6600 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
6601 "type" : "string"
6602 },
6603 "user" : {
6604 "description" : "The user identification to be used when logging in to the server",
6605 "maxLength" : 64,
6606 "minLength" : 1,
eff914dc
DM
6607 "type" : "string",
6608 "typetext" : "<string>"
6609 }
6610 }
6611 },
732d76e1
DM
6612 "permissions" : {
6613 "check" : [
6614 "admin"
6615 ]
6616 },
eff914dc
DM
6617 "protected" : 1,
6618 "proxyto" : "master",
6619 "returns" : {
732d76e1
DM
6620 "description" : "Unique ID",
6621 "maxLength" : 16,
6622 "pattern" : "[A-Za-z0-9]+",
6623 "type" : "string"
eff914dc
DM
6624 }
6625 }
6626 },
6627 "leaf" : 0,
732d76e1
DM
6628 "path" : "/config/fetchmail",
6629 "text" : "fetchmail"
eff914dc
DM
6630 },
6631 {
6632 "children" : [
6633 {
6634 "info" : {
6635 "DELETE" : {
6636 "description" : "Delete a transport map entry",
6637 "method" : "DELETE",
6638 "name" : "delete",
6639 "parameters" : {
6640 "additionalProperties" : 0,
6641 "properties" : {
6642 "domain" : {
6643 "description" : "Domain name.",
6644 "format" : "transport-domain",
6645 "type" : "string",
6646 "typetext" : "<string>"
6647 }
6648 }
6649 },
732d76e1
DM
6650 "permissions" : {
6651 "check" : [
6652 "admin"
6653 ]
6654 },
eff914dc
DM
6655 "protected" : 1,
6656 "proxyto" : "master",
6657 "returns" : {
6658 "type" : "null"
6659 }
6660 },
6661 "GET" : {
6662 "description" : "Read transport map entry.",
6663 "method" : "GET",
6664 "name" : "read",
6665 "parameters" : {
6666 "additionalProperties" : 0,
6667 "properties" : {
6668 "domain" : {
6669 "description" : "Domain name.",
6670 "format" : "transport-domain",
6671 "type" : "string",
6672 "typetext" : "<string>"
6673 }
6674 }
6675 },
732d76e1
DM
6676 "permissions" : {
6677 "check" : [
6678 "admin",
6679 "audit"
6680 ]
6681 },
eff914dc
DM
6682 "proxyto" : "master",
6683 "returns" : {
6684 "properties" : {
6685 "comment" : {
6686 "type" : "string"
6687 },
6688 "domain" : {
6689 "type" : "string"
410dc2c9 6690 },
eff914dc
DM
6691 "host" : {
6692 "type" : "string"
6693 },
6694 "port" : {
6695 "type" : "integer"
6696 },
6697 "use_mx" : {
6698 "type" : "boolean"
6699 }
6700 },
6701 "type" : "object"
6702 }
6703 },
6704 "PUT" : {
6705 "description" : "Update transport map entry.",
6706 "method" : "PUT",
6707 "name" : "write",
6708 "parameters" : {
6709 "additionalProperties" : 0,
6710 "properties" : {
6711 "comment" : {
6712 "description" : "Comment.",
410dc2c9
DM
6713 "optional" : 1,
6714 "type" : "string",
6715 "typetext" : "<string>"
6716 },
eff914dc
DM
6717 "domain" : {
6718 "description" : "Domain name.",
6719 "format" : "transport-domain",
410dc2c9
DM
6720 "type" : "string",
6721 "typetext" : "<string>"
6722 },
eff914dc
DM
6723 "host" : {
6724 "description" : "Target host (name or IP address).",
6725 "format" : "address",
410dc2c9
DM
6726 "optional" : 1,
6727 "type" : "string",
6728 "typetext" : "<string>"
6729 },
410dc2c9 6730 "port" : {
eff914dc 6731 "description" : "SMTP port.",
410dc2c9
DM
6732 "maximum" : 65535,
6733 "minimum" : 1,
6734 "optional" : 1,
6735 "type" : "integer",
6736 "typetext" : "<integer> (1 - 65535)"
6737 },
eff914dc
DM
6738 "use_mx" : {
6739 "description" : "Enable MX lookups.",
410dc2c9 6740 "optional" : 1,
eff914dc
DM
6741 "type" : "boolean",
6742 "typetext" : "<boolean>"
410dc2c9 6743 }
eff914dc 6744 }
410dc2c9 6745 },
732d76e1
DM
6746 "permissions" : {
6747 "check" : [
6748 "admin"
6749 ]
6750 },
410dc2c9
DM
6751 "protected" : 1,
6752 "proxyto" : "master",
6753 "returns" : {
6754 "type" : "null"
6755 }
6756 }
6757 },
6758 "leaf" : 1,
eff914dc
DM
6759 "path" : "/config/transport/{domain}",
6760 "text" : "{domain}"
410dc2c9
DM
6761 }
6762 ],
6763 "info" : {
6764 "GET" : {
eff914dc 6765 "description" : "List transport map entries.",
410dc2c9
DM
6766 "method" : "GET",
6767 "name" : "index",
6768 "parameters" : {
6769 "additionalProperties" : 0
6770 },
732d76e1
DM
6771 "permissions" : {
6772 "check" : [
6773 "admin",
6774 "audit"
6775 ]
6776 },
410dc2c9
DM
6777 "proxyto" : "master",
6778 "returns" : {
6779 "items" : {
6780 "properties" : {
eff914dc 6781 "comment" : {
410dc2c9
DM
6782 "type" : "string"
6783 },
eff914dc 6784 "domain" : {
410dc2c9
DM
6785 "type" : "string"
6786 },
eff914dc 6787 "host" : {
410dc2c9 6788 "type" : "string"
eff914dc
DM
6789 },
6790 "port" : {
6791 "type" : "integer"
6792 },
6793 "use_mx" : {
6794 "type" : "boolean"
410dc2c9
DM
6795 }
6796 },
6797 "type" : "object"
6798 },
6799 "links" : [
6800 {
c061d61d 6801 "href" : "{domain}",
410dc2c9
DM
6802 "rel" : "child"
6803 }
6804 ],
6805 "type" : "array"
6806 }
6807 },
6808 "POST" : {
eff914dc 6809 "description" : "Add transport map entry.",
410dc2c9
DM
6810 "method" : "POST",
6811 "name" : "create",
6812 "parameters" : {
6813 "additionalProperties" : 0,
6814 "properties" : {
eff914dc
DM
6815 "comment" : {
6816 "description" : "Comment.",
410dc2c9
DM
6817 "optional" : 1,
6818 "type" : "string",
6819 "typetext" : "<string>"
6820 },
eff914dc
DM
6821 "domain" : {
6822 "description" : "Domain name.",
6823 "format" : "transport-domain",
410dc2c9
DM
6824 "type" : "string",
6825 "typetext" : "<string>"
6826 },
eff914dc
DM
6827 "host" : {
6828 "description" : "Target host (name or IP address).",
6829 "format" : "address",
410dc2c9
DM
6830 "type" : "string",
6831 "typetext" : "<string>"
6832 },
410dc2c9 6833 "port" : {
eff914dc
DM
6834 "default" : 25,
6835 "description" : "SMTP port.",
410dc2c9
DM
6836 "maximum" : 65535,
6837 "minimum" : 1,
6838 "optional" : 1,
6839 "type" : "integer",
6840 "typetext" : "<integer> (1 - 65535)"
6841 },
eff914dc
DM
6842 "use_mx" : {
6843 "default" : 1,
6844 "description" : "Enable MX lookups.",
410dc2c9 6845 "optional" : 1,
eff914dc
DM
6846 "type" : "boolean",
6847 "typetext" : "<boolean>"
410dc2c9 6848 }
eff914dc 6849 }
410dc2c9 6850 },
732d76e1
DM
6851 "permissions" : {
6852 "check" : [
6853 "admin"
6854 ]
6855 },
410dc2c9
DM
6856 "protected" : 1,
6857 "proxyto" : "master",
6858 "returns" : {
6859 "type" : "null"
6860 }
6861 }
6862 },
6863 "leaf" : 0,
eff914dc
DM
6864 "path" : "/config/transport",
6865 "text" : "transport"
410dc2c9
DM
6866 },
6867 {
6868 "children" : [
6869 {
6870 "info" : {
6871 "DELETE" : {
eff914dc 6872 "description" : "Delete a truster network",
410dc2c9
DM
6873 "method" : "DELETE",
6874 "name" : "delete",
6875 "parameters" : {
6876 "additionalProperties" : 0,
6877 "properties" : {
eff914dc
DM
6878 "cidr" : {
6879 "description" : "IPv4 or IPv6 network in CIDR notation.",
6880 "format" : "CIDR",
6881 "type" : "string",
6882 "typetext" : "<string>"
6883 }
6884 }
6885 },
732d76e1
DM
6886 "permissions" : {
6887 "check" : [
6888 "admin"
6889 ]
6890 },
eff914dc
DM
6891 "protected" : 1,
6892 "proxyto" : "master",
6893 "returns" : {
6894 "type" : "null"
6895 }
6896 },
6897 "GET" : {
6898 "description" : "Read trusted network data (comment).",
6899 "method" : "GET",
6900 "name" : "read",
6901 "parameters" : {
6902 "additionalProperties" : 0,
6903 "properties" : {
6904 "cidr" : {
6905 "description" : "IPv4 or IPv6 network in CIDR notation.",
6906 "format" : "CIDR",
6907 "type" : "string",
6908 "typetext" : "<string>"
6909 }
6910 }
6911 },
732d76e1
DM
6912 "permissions" : {
6913 "check" : [
6914 "admin",
6915 "audit"
6916 ]
6917 },
eff914dc
DM
6918 "proxyto" : "master",
6919 "returns" : {
6920 "properties" : {
6921 "cidr" : {
6922 "type" : "string"
6923 },
6924 "comment" : {
6925 "type" : "string"
6926 }
6927 },
6928 "type" : "object"
6929 }
6930 },
6931 "PUT" : {
6932 "description" : "Update trusted data (comment).",
6933 "method" : "PUT",
6934 "name" : "write",
6935 "parameters" : {
6936 "additionalProperties" : 0,
6937 "properties" : {
6938 "cidr" : {
6939 "description" : "IPv4 or IPv6 network in CIDR notation.",
6940 "type" : "string",
6941 "typetext" : "<string>"
6942 },
6943 "comment" : {
6944 "description" : "Comment.",
410dc2c9
DM
6945 "type" : "string",
6946 "typetext" : "<string>"
6947 }
6948 }
6949 },
732d76e1
DM
6950 "permissions" : {
6951 "check" : [
6952 "admin"
6953 ]
6954 },
410dc2c9
DM
6955 "protected" : 1,
6956 "proxyto" : "master",
6957 "returns" : {
6958 "type" : "null"
6959 }
6960 }
6961 },
6962 "leaf" : 1,
eff914dc
DM
6963 "path" : "/config/mynetworks/{cidr}",
6964 "text" : "{cidr}"
410dc2c9
DM
6965 }
6966 ],
6967 "info" : {
6968 "GET" : {
eff914dc 6969 "description" : "List of trusted networks from where SMTP clients are allowed to relay mail through Proxmox Mail Gateway.",
410dc2c9
DM
6970 "method" : "GET",
6971 "name" : "index",
6972 "parameters" : {
6973 "additionalProperties" : 0
6974 },
732d76e1
DM
6975 "permissions" : {
6976 "check" : [
6977 "admin",
6978 "audit"
6979 ]
6980 },
410dc2c9
DM
6981 "proxyto" : "master",
6982 "returns" : {
6983 "items" : {
6984 "properties" : {
eff914dc 6985 "cidr" : {
410dc2c9
DM
6986 "type" : "string"
6987 }
6988 },
6989 "type" : "object"
6990 },
6991 "links" : [
6992 {
c061d61d 6993 "href" : "{cidr}",
410dc2c9
DM
6994 "rel" : "child"
6995 }
6996 ],
6997 "type" : "array"
6998 }
6999 },
7000 "POST" : {
eff914dc 7001 "description" : "Add a trusted network.",
410dc2c9
DM
7002 "method" : "POST",
7003 "name" : "create",
7004 "parameters" : {
7005 "additionalProperties" : 0,
7006 "properties" : {
eff914dc
DM
7007 "cidr" : {
7008 "description" : "IPv4 or IPv6 network in CIDR notation.",
7009 "format" : "CIDR",
7010 "type" : "string",
7011 "typetext" : "<string>"
7012 },
7013 "comment" : {
7014 "description" : "Comment.",
7015 "optional" : 1,
410dc2c9
DM
7016 "type" : "string",
7017 "typetext" : "<string>"
7018 }
7019 }
7020 },
732d76e1
DM
7021 "permissions" : {
7022 "check" : [
7023 "admin"
7024 ]
7025 },
410dc2c9
DM
7026 "protected" : 1,
7027 "proxyto" : "master",
7028 "returns" : {
7029 "type" : "null"
7030 }
7031 }
7032 },
7033 "leaf" : 0,
eff914dc
DM
7034 "path" : "/config/mynetworks",
7035 "text" : "mynetworks"
410dc2c9
DM
7036 },
7037 {
d7cd791b
DM
7038 "children" : [
7039 {
7040 "info" : {
7041 "GET" : {
7042 "description" : "Cluster node index.",
7043 "method" : "GET",
7044 "name" : "nodes",
7045 "parameters" : {
7046 "additionalProperties" : 0
7047 },
7048 "permissions" : {
7049 "check" : [
bb6e6e0d
DM
7050 "admin",
7051 "qmanager",
7052 "audit"
d7cd791b
DM
7053 ]
7054 },
7055 "returns" : {
7056 "items" : {
7057 "properties" : {
7058 "cid" : {
7059 "type" : "integer"
7060 },
7061 "fingerprint" : {
7062 "type" : "string"
7063 },
7064 "hostrsapubkey" : {
7065 "type" : "string"
7066 },
7067 "ip" : {
7068 "type" : "string"
7069 },
7070 "name" : {
7071 "type" : "string"
7072 },
7073 "rootrsapubkey" : {
7074 "type" : "string"
7075 },
7076 "type" : {
7077 "type" : "string"
7078 }
7079 },
7080 "type" : "object"
7081 },
d7cd791b
DM
7082 "type" : "array"
7083 }
7084 },
7085 "POST" : {
7086 "description" : "Add an node to the cluster config.",
7087 "method" : "POST",
7088 "name" : "add_node",
7089 "parameters" : {
7090 "additionalProperties" : 0,
7091 "properties" : {
7092 "fingerprint" : {
7093 "description" : "SSL certificate fingerprint.",
7094 "optional" : 0,
7095 "pattern" : "^(:?[A-Z0-9][A-Z0-9]:){31}[A-Z0-9][A-Z0-9]$",
7096 "type" : "string"
7097 },
7098 "hostrsapubkey" : {
7099 "description" : "Public SSH RSA key for the host.",
7100 "optional" : 0,
7101 "pattern" : "^[A-Za-z0-9\\.\\/\\+]{200,}$",
7102 "type" : "string"
7103 },
7104 "ip" : {
7105 "description" : "IP address.",
7106 "format" : "ip",
7107 "optional" : 0,
7108 "type" : "string",
7109 "typetext" : "<string>"
7110 },
7111 "maxcid" : {
7112 "description" : "Maximum used cluster node ID (used internally, do not modify).",
7113 "minimum" : 1,
7114 "optional" : 1,
7115 "type" : "integer",
7116 "typetext" : "<integer> (1 - N)"
7117 },
7118 "name" : {
7119 "description" : "Node name.",
7120 "format" : "pve-node",
7121 "optional" : 0,
7122 "type" : "string",
7123 "typetext" : "<string>"
7124 },
7125 "rootrsapubkey" : {
7126 "description" : "Public SSH RSA key for the root user.",
7127 "optional" : 0,
7128 "pattern" : "^[A-Za-z0-9\\.\\/\\+]{200,}$",
7129 "type" : "string"
7130 }
7131 },
7132 "type" : "object"
7133 },
7134 "protected" : 1,
7135 "proxyto" : "master",
7136 "returns" : {
7137 "description" : "Returns the resulting node list.",
7138 "items" : {
7139 "properties" : {
7140 "cid" : {
7141 "type" : "integer"
7142 }
7143 },
7144 "type" : "object"
7145 },
7146 "type" : "array"
7147 }
7148 }
7149 },
7150 "leaf" : 1,
7151 "path" : "/config/cluster/nodes",
7152 "text" : "nodes"
7153 },
7154 {
7155 "info" : {
7156 "GET" : {
7157 "description" : "Cluster node status.",
7158 "method" : "GET",
7159 "name" : "status",
7160 "parameters" : {
bb6e6e0d
DM
7161 "additionalProperties" : 0,
7162 "properties" : {
7163 "list_single_node" : {
7164 "default" : 0,
7165 "description" : "List local node if there is no cluster defined. Please note that RSA keys and fingerprint are not valid in that case.",
7166 "optional" : 1,
7167 "type" : "boolean",
7168 "typetext" : "<boolean>"
7169 }
7170 }
d7cd791b
DM
7171 },
7172 "permissions" : {
7173 "check" : [
bb6e6e0d
DM
7174 "admin",
7175 "qmanager",
7176 "audit"
d7cd791b
DM
7177 ]
7178 },
7179 "returns" : {
7180 "items" : {
7181 "properties" : {
7182 "cid" : {
7183 "type" : "integer"
7184 },
7185 "fingerprint" : {
7186 "type" : "string"
7187 },
7188 "hostrsapubkey" : {
7189 "type" : "string"
7190 },
7191 "ip" : {
7192 "type" : "string"
7193 },
7194 "name" : {
7195 "type" : "string"
7196 },
7197 "rootrsapubkey" : {
7198 "type" : "string"
7199 },
7200 "type" : {
7201 "type" : "string"
7202 }
7203 },
7204 "type" : "object"
7205 },
7206 "links" : [
7207 {
7208 "href" : "{cid}",
7209 "rel" : "child"
7210 }
7211 ],
7212 "type" : "array"
7213 }
7214 }
7215 },
7216 "leaf" : 1,
7217 "path" : "/config/cluster/status",
7218 "text" : "status"
7219 },
7220 {
7221 "info" : {
7222 "POST" : {
7223 "description" : "Create initial cluster config with current node as master.",
7224 "method" : "POST",
7225 "name" : "create",
7226 "parameters" : {
7227 "additionalProperties" : 0
7228 },
7229 "protected" : 1,
7230 "returns" : {
7231 "type" : "string"
7232 }
7233 }
7234 },
7235 "leaf" : 1,
7236 "path" : "/config/cluster/create",
7237 "text" : "create"
7238 },
7239 {
7240 "info" : {
7241 "POST" : {
7242 "description" : "Join local node to an existing cluster.",
7243 "method" : "POST",
7244 "name" : "join",
7245 "parameters" : {
7246 "additionalProperties" : 0,
7247 "properties" : {
7248 "fingerprint" : {
7249 "description" : "SSL certificate fingerprint.",
7250 "pattern" : "^(:?[A-Z0-9][A-Z0-9]:){31}[A-Z0-9][A-Z0-9]$",
7251 "type" : "string"
7252 },
7253 "master_ip" : {
7254 "description" : "IP address.",
7255 "format" : "ip",
7256 "type" : "string",
7257 "typetext" : "<string>"
7258 },
7259 "password" : {
7260 "description" : "Superuser password.",
7261 "maxLength" : 128,
7262 "type" : "string",
7263 "typetext" : "<string>"
7264 }
7265 }
7266 },
7267 "protected" : 1,
7268 "returns" : {
7269 "type" : "string"
7270 }
7271 }
7272 },
7273 "leaf" : 1,
7274 "path" : "/config/cluster/join",
7275 "text" : "join"
7276 }
7277 ],
410dc2c9
DM
7278 "info" : {
7279 "GET" : {
d7cd791b 7280 "description" : "Directory index.",
410dc2c9
DM
7281 "method" : "GET",
7282 "name" : "index",
7283 "parameters" : {
7284 "additionalProperties" : 0
7285 },
d7cd791b
DM
7286 "permissions" : {
7287 "user" : "all"
7288 },
410dc2c9
DM
7289 "returns" : {
7290 "items" : {
d7cd791b 7291 "properties" : {},
410dc2c9
DM
7292 "type" : "object"
7293 },
7294 "links" : [
7295 {
d7cd791b 7296 "href" : "{name}",
410dc2c9
DM
7297 "rel" : "child"
7298 }
7299 ],
7300 "type" : "array"
7301 }
7302 }
7303 },
d7cd791b 7304 "leaf" : 0,
410dc2c9
DM
7305 "path" : "/config/cluster",
7306 "text" : "cluster"
7307 },
9fda36b0
DM
7308 {
7309 "info" : {
7310 "GET" : {
7311 "description" : "Get Mime Types List",
7312 "method" : "GET",
7313 "name" : "index",
7314 "parameters" : {
7315 "additionalProperties" : 0
7316 },
7317 "returns" : {
7318 "items" : {
7319 "properties" : {
7320 "mimetype" : {
7321 "type" : "string"
7322 },
7323 "text" : {
7324 "type" : "string"
7325 }
7326 },
7327 "type" : "object"
7328 },
7329 "type" : "array"
7330 }
7331 }
7332 },
7333 "leaf" : 1,
7334 "path" : "/config/mimetypes",
7335 "text" : "mimetypes"
7336 },
410dc2c9
DM
7337 {
7338 "info" : {
7339 "GET" : {
7340 "description" : "Read admin configuration properties.",
7341 "method" : "GET",
7342 "name" : "read_admin_section",
7343 "parameters" : {
7344 "additionalProperties" : 0
7345 },
732d76e1
DM
7346 "permissions" : {
7347 "check" : [
7348 "admin",
7349 "audit"
7350 ]
7351 },
410dc2c9
DM
7352 "proxyto" : "master",
7353 "returns" : {
7354 "type" : "object"
7355 }
7356 },
7357 "PUT" : {
7358 "description" : "Update admin configuration properties.",
7359 "method" : "PUT",
7360 "name" : "update_admin_section",
7361 "parameters" : {
7362 "additionalProperties" : 0,
7363 "properties" : {
9fda36b0
DM
7364 "advfilter" : {
7365 "default" : 1,
7366 "description" : "Use advanced filters for statistic.",
7367 "optional" : 1,
7368 "type" : "boolean",
7369 "typetext" : "<boolean>"
7370 },
410dc2c9
DM
7371 "dailyreport" : {
7372 "default" : 1,
7373 "description" : "Send daily reports.",
7374 "optional" : 1,
7375 "type" : "boolean",
7376 "typetext" : "<boolean>"
7377 },
7378 "delete" : {
7379 "description" : "A list of settings you want to delete.",
7380 "format" : "pve-configid-list",
7381 "maxLength" : 4096,
7382 "optional" : 1,
7383 "type" : "string",
7384 "typetext" : "<string>"
7385 },
7386 "demo" : {
7387 "default" : 0,
7388 "description" : "Demo mode - do not start SMTP filter.",
7389 "optional" : 1,
7390 "type" : "boolean",
7391 "typetext" : "<boolean>"
7392 },
7393 "digest" : {
7394 "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.",
7395 "maxLength" : 40,
7396 "optional" : 1,
7397 "type" : "string",
7398 "typetext" : "<string>"
7399 },
eff914dc
DM
7400 "email" : {
7401 "default" : "admin@domain.tld",
7402 "description" : "Administrator E-Mail address.",
7403 "format" : "email",
7404 "optional" : 1,
7405 "type" : "string",
7406 "typetext" : "<string>"
7407 },
9fda36b0
DM
7408 "http_proxy" : {
7409 "description" : "Specify external http proxy which is used for downloads (example: 'http://username:password@host:port/')",
410dc2c9 7410 "optional" : 1,
9fda36b0
DM
7411 "pattern" : "http://.*",
7412 "type" : "string"
a55e94a6
DM
7413 },
7414 "statlifetime" : {
7415 "default" : 7,
7416 "description" : "User Statistics Lifetime (days)",
7417 "minimum" : 1,
7418 "optional" : 1,
7419 "type" : "integer",
7420 "typetext" : "<integer> (1 - N)"
410dc2c9
DM
7421 }
7422 },
7423 "type" : "object"
7424 },
732d76e1
DM
7425 "permissions" : {
7426 "check" : [
7427 "admin"
7428 ]
7429 },
410dc2c9
DM
7430 "protected" : 1,
7431 "proxyto" : "master",
7432 "returns" : {
7433 "type" : "null"
7434 }
7435 }
7436 },
7437 "leaf" : 1,
7438 "path" : "/config/admin",
7439 "text" : "admin"
7440 },
7441 {
7442 "info" : {
7443 "GET" : {
7444 "description" : "Read clamav configuration properties.",
7445 "method" : "GET",
7446 "name" : "read_clamav_section",
7447 "parameters" : {
7448 "additionalProperties" : 0
7449 },
732d76e1
DM
7450 "permissions" : {
7451 "check" : [
7452 "admin",
7453 "audit"
7454 ]
7455 },
410dc2c9
DM
7456 "proxyto" : "master",
7457 "returns" : {
7458 "type" : "object"
7459 }
7460 },
7461 "PUT" : {
7462 "description" : "Update clamav configuration properties.",
7463 "method" : "PUT",
7464 "name" : "update_clamav_section",
7465 "parameters" : {
7466 "additionalProperties" : 0,
7467 "properties" : {
7468 "archiveblockencrypted" : {
7469 "default" : 0,
7470 "description" : "Wether to block encrypted archives. Mark encrypted archives as viruses.",
7471 "optional" : 1,
7472 "type" : "boolean",
7473 "typetext" : "<boolean>"
7474 },
7475 "archivemaxfiles" : {
7476 "default" : 1000,
7477 "description" : "Number of files to be scanned within an archive, a document, or any other kind of container. Warning: disabling this limit or setting it too high may result in severe damage to the system.",
7478 "minimum" : 0,
7479 "optional" : 1,
7480 "type" : "integer",
7481 "typetext" : "<integer> (0 - N)"
7482 },
7483 "archivemaxrec" : {
7484 "default" : 5,
7485 "description" : "Nested archives are scanned recursively, e.g. if a ZIP archive contains a TAR file, all files within it will also be scanned. This options specifies how deeply the process should be continued. Warning: setting this limit too high may result in severe damage to the system.",
7486 "minimum" : 1,
7487 "optional" : 1,
7488 "type" : "integer",
7489 "typetext" : "<integer> (1 - N)"
7490 },
7491 "archivemaxsize" : {
7492 "default" : 25000000,
7493 "description" : "Files larger than this limit won't be scanned.",
7494 "minimum" : 1000000,
7495 "optional" : 1,
7496 "type" : "integer",
7497 "typetext" : "<integer> (1000000 - N)"
7498 },
7499 "dbmirror" : {
7500 "default" : "database.clamav.net",
7501 "description" : "ClamAV database mirror server.",
7502 "optional" : 1,
7503 "type" : "string",
7504 "typetext" : "<string>"
7505 },
7506 "delete" : {
7507 "description" : "A list of settings you want to delete.",
7508 "format" : "pve-configid-list",
7509 "maxLength" : 4096,
7510 "optional" : 1,
7511 "type" : "string",
7512 "typetext" : "<string>"
7513 },
7514 "digest" : {
7515 "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.",
7516 "maxLength" : 40,
7517 "optional" : 1,
7518 "type" : "string",
7519 "typetext" : "<string>"
7520 },
7521 "maxcccount" : {
7522 "default" : 0,
7523 "description" : "This option sets the lowest number of Credit Card or Social Security numbers found in a file to generate a detect.",
7524 "minimum" : 0,
7525 "optional" : 1,
7526 "type" : "integer",
7527 "typetext" : "<integer> (0 - N)"
7528 },
7529 "maxscansize" : {
7530 "default" : 100000000,
7531 "description" : "Sets the maximum amount of data to be scanned for each input file.",
7532 "minimum" : 1000000,
7533 "optional" : 1,
7534 "type" : "integer",
7535 "typetext" : "<integer> (1000000 - N)"
f245a28c
DM
7536 },
7537 "safebrowsing" : {
7538 "default" : 1,
7539 "description" : "Enables support for Google Safe Browsing.",
7540 "optional" : 1,
7541 "type" : "boolean",
7542 "typetext" : "<boolean>"
410dc2c9
DM
7543 }
7544 },
7545 "type" : "object"
7546 },
732d76e1
DM
7547 "permissions" : {
7548 "check" : [
7549 "admin"
7550 ]
7551 },
410dc2c9
DM
7552 "protected" : 1,
7553 "proxyto" : "master",
7554 "returns" : {
7555 "type" : "null"
7556 }
7557 }
7558 },
7559 "leaf" : 1,
7560 "path" : "/config/clamav",
7561 "text" : "clamav"
7562 },
7563 {
7564 "info" : {
7565 "GET" : {
7566 "description" : "Read mail configuration properties.",
7567 "method" : "GET",
7568 "name" : "read_mail_section",
7569 "parameters" : {
7570 "additionalProperties" : 0
7571 },
732d76e1
DM
7572 "permissions" : {
7573 "check" : [
7574 "admin",
7575 "audit"
7576 ]
7577 },
410dc2c9
DM
7578 "proxyto" : "master",
7579 "returns" : {
7580 "type" : "object"
7581 }
7582 },
7583 "PUT" : {
7584 "description" : "Update mail configuration properties.",
7585 "method" : "PUT",
7586 "name" : "update_mail_section",
7587 "parameters" : {
7588 "additionalProperties" : 0,
7589 "properties" : {
7590 "banner" : {
7591 "default" : "ESMTP Proxmox",
7592 "description" : "ESMTP banner.",
7593 "maxLength" : 1024,
7594 "optional" : 1,
7595 "type" : "string",
7596 "typetext" : "<string>"
7597 },
7598 "conn_count_limit" : {
7599 "default" : 50,
7600 "description" : "How many simultaneous connections any client is allowed to make to this service. To disable this feature, specify a limit of 0.",
7601 "minimum" : 0,
7602 "optional" : 1,
7603 "type" : "integer",
7604 "typetext" : "<integer> (0 - N)"
7605 },
7606 "conn_rate_limit" : {
7607 "default" : 0,
7608 "description" : "The maximal number of connection attempts any client is allowed to make to this service per minute. To disable this feature, specify a limit of 0.",
7609 "minimum" : 0,
7610 "optional" : 1,
7611 "type" : "integer",
7612 "typetext" : "<integer> (0 - N)"
7613 },
7614 "delete" : {
7615 "description" : "A list of settings you want to delete.",
7616 "format" : "pve-configid-list",
7617 "maxLength" : 4096,
7618 "optional" : 1,
7619 "type" : "string",
7620 "typetext" : "<string>"
7621 },
7622 "digest" : {
7623 "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.",
7624 "maxLength" : 40,
7625 "optional" : 1,
7626 "type" : "string",
7627 "typetext" : "<string>"
7628 },
7629 "dnsbl_sites" : {
7630 "description" : "Optional list of DNS white/blacklist domains (see postscreen_dnsbl_sites parameter).",
274b47fc 7631 "format" : "dnsbl-entry-list",
410dc2c9
DM
7632 "optional" : 1,
7633 "type" : "string",
7634 "typetext" : "<string>"
7635 },
7636 "dwarning" : {
7637 "default" : 4,
7638 "description" : "SMTP delay warning time (in hours).",
7639 "minimum" : 0,
7640 "optional" : 1,
7641 "type" : "integer",
7642 "typetext" : "<integer> (0 - N)"
7643 },
eff914dc 7644 "ext_port" : {
4a46ced6 7645 "default" : 25,
eff914dc
DM
7646 "description" : "SMTP port number for incoming mail (untrusted). This must be a different number than 'int_port'.",
7647 "maximum" : 65535,
7648 "minimum" : 1,
7649 "optional" : 1,
7650 "type" : "integer",
7651 "typetext" : "<integer> (1 - 65535)"
7652 },
410dc2c9
DM
7653 "greylist" : {
7654 "default" : 1,
7655 "description" : "Use Greylisting.",
7656 "optional" : 1,
7657 "type" : "boolean",
7658 "typetext" : "<boolean>"
7659 },
7660 "helotests" : {
7661 "default" : 0,
7662 "description" : "Use SMTP HELO tests.",
7663 "optional" : 1,
7664 "type" : "boolean",
7665 "typetext" : "<boolean>"
7666 },
7667 "hide_received" : {
7668 "default" : 0,
7669 "description" : "Hide received header in outgoing mails.",
7670 "optional" : 1,
7671 "type" : "boolean",
7672 "typetext" : "<boolean>"
7673 },
eff914dc 7674 "int_port" : {
4a46ced6 7675 "default" : 26,
eff914dc
DM
7676 "description" : "SMTP port number for outgoing mail (trusted).",
7677 "maximum" : 65535,
7678 "minimum" : 1,
7679 "optional" : 1,
7680 "type" : "integer",
7681 "typetext" : "<integer> (1 - 65535)"
7682 },
410dc2c9
DM
7683 "max_filters" : {
7684 "default" : 15,
7685 "description" : "Maximum number of pmg-smtp-filter processes.",
7686 "maximum" : 40,
7687 "minimum" : 3,
7688 "optional" : 1,
7689 "type" : "integer",
7690 "typetext" : "<integer> (3 - 40)"
7691 },
7692 "max_policy" : {
7693 "default" : 5,
7694 "description" : "Maximum number of pmgpolicy processes.",
7695 "maximum" : 10,
7696 "minimum" : 2,
7697 "optional" : 1,
7698 "type" : "integer",
7699 "typetext" : "<integer> (2 - 10)"
7700 },
7701 "max_smtpd_in" : {
7702 "default" : 99,
7703 "description" : "Maximum number of SMTP daemon processes (in).",
7704 "maximum" : 100,
7705 "minimum" : 3,
7706 "optional" : 1,
7707 "type" : "integer",
7708 "typetext" : "<integer> (3 - 100)"
7709 },
7710 "max_smtpd_out" : {
7711 "default" : 99,
7712 "description" : "Maximum number of SMTP daemon processes (out).",
7713 "maximum" : 100,
7714 "minimum" : 3,
7715 "optional" : 1,
7716 "type" : "integer",
7717 "typetext" : "<integer> (3 - 100)"
7718 },
7719 "maxsize" : {
7720 "default" : 10485760,
7721 "description" : "Maximum email size. Larger mails are rejected.",
7722 "minimum" : 1024,
7723 "optional" : 1,
7724 "type" : "integer",
7725 "typetext" : "<integer> (1024 - N)"
7726 },
7727 "message_rate_limit" : {
7728 "default" : 0,
7729 "description" : "The maximal number of message delivery requests that any client is allowed to make to this service per minute.To disable this feature, specify a limit of 0.",
7730 "minimum" : 0,
7731 "optional" : 1,
7732 "type" : "integer",
7733 "typetext" : "<integer> (0 - N)"
7734 },
7735 "rejectunknown" : {
7736 "default" : 0,
7737 "description" : "Reject unknown clients.",
7738 "optional" : 1,
7739 "type" : "boolean",
7740 "typetext" : "<boolean>"
7741 },
7742 "rejectunknownsender" : {
7743 "default" : 0,
7744 "description" : "Reject unknown senders.",
7745 "optional" : 1,
7746 "type" : "boolean",
7747 "typetext" : "<boolean>"
7748 },
7749 "relay" : {
7750 "description" : "The default mail delivery transport (incoming mails).",
eff914dc 7751 "format" : "address",
410dc2c9
DM
7752 "optional" : 1,
7753 "type" : "string",
7754 "typetext" : "<string>"
7755 },
7756 "relaynomx" : {
7757 "default" : 0,
7758 "description" : "Disable MX lookups for default relay.",
7759 "optional" : 1,
7760 "type" : "boolean",
7761 "typetext" : "<boolean>"
7762 },
7763 "relayport" : {
7764 "default" : 25,
7765 "description" : "SMTP port number for relay host.",
7766 "maximum" : 65535,
7767 "minimum" : 1,
7768 "optional" : 1,
7769 "type" : "integer",
7770 "typetext" : "<integer> (1 - 65535)"
7771 },
eff914dc
DM
7772 "smarthost" : {
7773 "description" : "When set, all outgoing mails are deliverd to the specified smarthost.",
7774 "format" : "address",
7775 "optional" : 1,
7776 "type" : "string",
7777 "typetext" : "<string>"
7778 },
410dc2c9
DM
7779 "spf" : {
7780 "default" : 1,
7781 "description" : "Use Sender Policy Framework.",
7782 "optional" : 1,
7783 "type" : "boolean",
7784 "typetext" : "<boolean>"
7785 },
7786 "tls" : {
7787 "default" : 0,
eff914dc
DM
7788 "description" : "Enable TLS.",
7789 "optional" : 1,
7790 "type" : "boolean",
7791 "typetext" : "<boolean>"
7792 },
7793 "tlsheader" : {
7794 "default" : 0,
7795 "description" : "Add TLS received header.",
7796 "optional" : 1,
7797 "type" : "boolean",
7798 "typetext" : "<boolean>"
7799 },
7800 "tlslog" : {
7801 "default" : 0,
7802 "description" : "Enable TLS Logging.",
410dc2c9
DM
7803 "optional" : 1,
7804 "type" : "boolean",
7805 "typetext" : "<boolean>"
7806 },
410dc2c9 7807 "verifyreceivers" : {
eff914dc
DM
7808 "description" : "Enable receiver verification. The value spefifies the numerical reply code when the Postfix SMTP server rejects a recipient address.",
7809 "enum" : [
7810 "450",
7811 "550"
7812 ],
410dc2c9 7813 "optional" : 1,
eff914dc 7814 "type" : "string"
410dc2c9
DM
7815 }
7816 },
7817 "type" : "object"
7818 },
732d76e1
DM
7819 "permissions" : {
7820 "check" : [
7821 "admin"
7822 ]
7823 },
410dc2c9
DM
7824 "protected" : 1,
7825 "proxyto" : "master",
7826 "returns" : {
7827 "type" : "null"
7828 }
7829 }
7830 },
7831 "leaf" : 1,
7832 "path" : "/config/mail",
7833 "text" : "mail"
7834 },
7835 {
7836 "info" : {
7837 "GET" : {
7838 "description" : "Read spam configuration properties.",
7839 "method" : "GET",
7840 "name" : "read_spam_section",
7841 "parameters" : {
7842 "additionalProperties" : 0
7843 },
732d76e1
DM
7844 "permissions" : {
7845 "check" : [
7846 "admin",
7847 "audit"
7848 ]
7849 },
410dc2c9
DM
7850 "proxyto" : "master",
7851 "returns" : {
7852 "type" : "object"
7853 }
7854 },
7855 "PUT" : {
7856 "description" : "Update spam configuration properties.",
7857 "method" : "PUT",
7858 "name" : "update_spam_section",
7859 "parameters" : {
7860 "additionalProperties" : 0,
7861 "properties" : {
7862 "bounce_score" : {
7863 "default" : 0,
7864 "description" : "Additional score for bounce mails.",
7865 "maximum" : 1000,
7866 "minimum" : 0,
7867 "optional" : 1,
7868 "type" : "integer",
7869 "typetext" : "<integer> (0 - 1000)"
7870 },
274b47fc
DM
7871 "clamav_heuristic_score" : {
7872 "default" : 3,
7873 "description" : "Score for ClamaAV heuristics (Google Safe Browsing database, PhishingScanURLs, ...).",
7874 "maximum" : 1000,
7875 "minimum" : 0,
7876 "optional" : 1,
7877 "type" : "integer",
7878 "typetext" : "<integer> (0 - 1000)"
7879 },
410dc2c9
DM
7880 "delete" : {
7881 "description" : "A list of settings you want to delete.",
7882 "format" : "pve-configid-list",
7883 "maxLength" : 4096,
7884 "optional" : 1,
7885 "type" : "string",
7886 "typetext" : "<string>"
7887 },
7888 "digest" : {
7889 "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.",
7890 "maxLength" : 40,
7891 "optional" : 1,
7892 "type" : "string",
7893 "typetext" : "<string>"
7894 },
7895 "languages" : {
7896 "default" : "all",
7897 "description" : "This option is used to specify which languages are considered OK for incoming mail.",
7898 "optional" : 1,
7899 "pattern" : "(all|([a-z][a-z])+( ([a-z][a-z])+)*)",
7900 "type" : "string"
7901 },
7902 "maxspamsize" : {
274b47fc 7903 "default" : 262144,
410dc2c9
DM
7904 "description" : "Maximum size of spam messages in bytes.",
7905 "minimum" : 64,
7906 "optional" : 1,
7907 "type" : "integer",
7908 "typetext" : "<integer> (64 - N)"
7909 },
7910 "rbl_checks" : {
7911 "default" : 1,
7912 "description" : "Enable real time blacklists (RBL) checks.",
7913 "optional" : 1,
7914 "type" : "boolean",
7915 "typetext" : "<boolean>"
7916 },
7917 "use_awl" : {
7918 "default" : 1,
7919 "description" : "Use the Auto-Whitelist plugin.",
7920 "optional" : 1,
7921 "type" : "boolean",
7922 "typetext" : "<boolean>"
7923 },
7924 "use_bayes" : {
7925 "default" : 1,
7926 "description" : "Whether to use the naive-Bayesian-style classifier.",
7927 "optional" : 1,
7928 "type" : "boolean",
7929 "typetext" : "<boolean>"
7930 },
410dc2c9
DM
7931 "use_razor" : {
7932 "default" : 1,
7933 "description" : "Whether to use Razor2, if it is available.",
7934 "optional" : 1,
7935 "type" : "boolean",
7936 "typetext" : "<boolean>"
7937 },
7938 "wl_bounce_relays" : {
7939 "description" : "Whitelist legitimate bounce relays.",
7940 "optional" : 1,
7941 "type" : "string",
7942 "typetext" : "<string>"
7943 }
7944 },
7945 "type" : "object"
7946 },
732d76e1
DM
7947 "permissions" : {
7948 "check" : [
7949 "admin"
7950 ]
7951 },
410dc2c9
DM
7952 "protected" : 1,
7953 "proxyto" : "master",
7954 "returns" : {
7955 "type" : "null"
7956 }
7957 }
7958 },
7959 "leaf" : 1,
7960 "path" : "/config/spam",
7961 "text" : "spam"
f245a28c
DM
7962 },
7963 {
7964 "info" : {
7965 "GET" : {
7966 "description" : "Read spamquar configuration properties.",
7967 "method" : "GET",
7968 "name" : "read_spamquar_section",
7969 "parameters" : {
7970 "additionalProperties" : 0
7971 },
732d76e1
DM
7972 "permissions" : {
7973 "check" : [
7974 "admin",
7975 "audit"
7976 ]
7977 },
f245a28c
DM
7978 "proxyto" : "master",
7979 "returns" : {
7980 "type" : "object"
7981 }
7982 },
7983 "PUT" : {
7984 "description" : "Update spamquar configuration properties.",
7985 "method" : "PUT",
7986 "name" : "update_spamquar_section",
7987 "parameters" : {
7988 "additionalProperties" : 0,
7989 "properties" : {
7990 "allowhrefs" : {
7991 "default" : 1,
7992 "description" : "Allow to view hyperlinks.",
7993 "optional" : 1,
7994 "type" : "boolean",
7995 "typetext" : "<boolean>"
7996 },
7997 "authmode" : {
7998 "default" : "ticket",
7999 "description" : "Authentication mode to access the quarantine interface. Mode 'ticket' allows login using tickets sent with the daily spam report. Mode 'ldap' requires to login using an LDAP account. Finally, mode 'ldapticket' allows both ways.",
8000 "enum" : [
8001 "ticket",
8002 "ldap",
8003 "ldapticket"
8004 ],
8005 "optional" : 1,
8006 "type" : "string"
8007 },
8008 "delete" : {
8009 "description" : "A list of settings you want to delete.",
8010 "format" : "pve-configid-list",
8011 "maxLength" : 4096,
8012 "optional" : 1,
8013 "type" : "string",
8014 "typetext" : "<string>"
8015 },
8016 "digest" : {
8017 "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.",
8018 "maxLength" : 40,
8019 "optional" : 1,
8020 "type" : "string",
8021 "typetext" : "<string>"
8022 },
8023 "hostname" : {
8024 "description" : "Quarantine Host. Usefule if you run a Cluster and want users to connect to a specific host.",
8025 "format" : "address",
8026 "optional" : 1,
8027 "type" : "string",
8028 "typetext" : "<string>"
8029 },
8030 "lifetime" : {
8031 "default" : 7,
8032 "description" : "Quarantine life time (days)",
8033 "minimum" : 1,
8034 "optional" : 1,
8035 "type" : "integer",
8036 "typetext" : "<integer> (1 - N)"
8037 },
8038 "mailfrom" : {
8039 "description" : "Text for 'From' header in daily spam report mails.",
8040 "optional" : 1,
8041 "type" : "string",
8042 "typetext" : "<string>"
8043 },
8044 "reportstyle" : {
8045 "default" : "verbose",
8046 "description" : "Spam report style.",
8047 "enum" : [
8048 "none",
8049 "short",
8050 "verbose",
f245a28c
DM
8051 "custom"
8052 ],
8053 "optional" : 1,
8054 "type" : "string"
8055 },
a55e94a6
DM
8056 "viewimages" : {
8057 "default" : 1,
8058 "description" : "Allow to view images.",
8059 "optional" : 1,
8060 "type" : "boolean",
8061 "typetext" : "<boolean>"
8062 }
8063 },
8064 "type" : "object"
8065 },
732d76e1
DM
8066 "permissions" : {
8067 "check" : [
8068 "admin"
8069 ]
8070 },
a55e94a6
DM
8071 "protected" : 1,
8072 "proxyto" : "master",
8073 "returns" : {
8074 "type" : "null"
8075 }
8076 }
8077 },
8078 "leaf" : 1,
8079 "path" : "/config/spamquar",
8080 "text" : "spamquar"
8081 },
8082 {
8083 "info" : {
8084 "GET" : {
8085 "description" : "Read virusquar configuration properties.",
8086 "method" : "GET",
8087 "name" : "read_virusquar_section",
8088 "parameters" : {
8089 "additionalProperties" : 0
8090 },
732d76e1
DM
8091 "permissions" : {
8092 "check" : [
8093 "admin",
8094 "audit"
8095 ]
8096 },
a55e94a6
DM
8097 "proxyto" : "master",
8098 "returns" : {
8099 "type" : "object"
8100 }
8101 },
8102 "PUT" : {
8103 "description" : "Update virusquar configuration properties.",
8104 "method" : "PUT",
8105 "name" : "update_virusquar_section",
8106 "parameters" : {
8107 "additionalProperties" : 0,
8108 "properties" : {
8109 "allowhrefs" : {
8110 "default" : 1,
8111 "description" : "Allow to view hyperlinks.",
8112 "optional" : 1,
8113 "type" : "boolean",
8114 "typetext" : "<boolean>"
8115 },
8116 "delete" : {
8117 "description" : "A list of settings you want to delete.",
8118 "format" : "pve-configid-list",
8119 "maxLength" : 4096,
8120 "optional" : 1,
8121 "type" : "string",
8122 "typetext" : "<string>"
8123 },
8124 "digest" : {
8125 "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.",
8126 "maxLength" : 40,
8127 "optional" : 1,
8128 "type" : "string",
8129 "typetext" : "<string>"
8130 },
8131 "lifetime" : {
8132 "default" : 7,
8133 "description" : "Quarantine life time (days)",
8134 "minimum" : 1,
8135 "optional" : 1,
8136 "type" : "integer",
8137 "typetext" : "<integer> (1 - N)"
8138 },
8139 "viewimages" : {
8140 "default" : 1,
8141 "description" : "Allow to view images.",
8142 "optional" : 1,
8143 "type" : "boolean",
8144 "typetext" : "<boolean>"
8145 }
8146 },
8147 "type" : "object"
8148 },
732d76e1
DM
8149 "permissions" : {
8150 "check" : [
8151 "admin"
8152 ]
8153 },
a55e94a6
DM
8154 "protected" : 1,
8155 "proxyto" : "master",
8156 "returns" : {
8157 "type" : "null"
8158 }
8159 }
8160 },
8161 "leaf" : 1,
8162 "path" : "/config/virusquar",
8163 "text" : "virusquar"
9fda36b0
DM
8164 },
8165 {
8166 "info" : {
8167 "POST" : {
8168 "description" : "Test Regex",
8169 "method" : "POST",
8170 "name" : "regextest",
8171 "parameters" : {
8172 "additionalProperties" : 0,
8173 "properties" : {
8174 "regex" : {
8175 "description" : "The Regex to test",
8176 "maxLength" : 1024,
8177 "type" : "string",
8178 "typetext" : "<string>"
8179 },
8180 "text" : {
8181 "description" : "The String to test",
8182 "maxLength" : 1024,
8183 "type" : "string",
8184 "typetext" : "<string>"
8185 }
8186 }
8187 },
8188 "permissions" : {
8189 "check" : [
8190 "admin",
8191 "qmanager",
8192 "audit"
8193 ]
8194 },
8195 "protected" : 0,
8196 "returns" : {
8197 "type" : "number"
8198 }
8199 }
8200 },
8201 "leaf" : 1,
8202 "path" : "/config/regextest",
8203 "text" : "regextest"
a55e94a6
DM
8204 }
8205 ],
8206 "info" : {
8207 "GET" : {
8208 "description" : "Directory index.",
8209 "method" : "GET",
8210 "name" : "index",
8211 "parameters" : {
8212 "additionalProperties" : 0
8213 },
8214 "returns" : {
8215 "items" : {
8216 "properties" : {
8217 "section" : {
8218 "type" : "string"
8219 }
8220 },
8221 "type" : "object"
8222 },
8223 "links" : [
8224 {
8225 "href" : "{section}",
8226 "rel" : "child"
8227 }
8228 ],
8229 "type" : "array"
8230 }
8231 }
8232 },
8233 "leaf" : 0,
8234 "path" : "/config",
8235 "text" : "config"
8236 },
8237 {
8238 "children" : [
8239 {
8240 "children" : [
8241 {
8242 "children" : [
8243 {
8244 "info" : {
8245 "GET" : {
8246 "description" : "Print Postfix queue domain and age distribution.",
8247 "method" : "GET",
8248 "name" : "qshape",
8249 "parameters" : {
8250 "additionalProperties" : 0,
8251 "properties" : {
8252 "node" : {
8253 "description" : "The cluster node name.",
8254 "format" : "pve-node",
8255 "type" : "string",
8256 "typetext" : "<string>"
8257 },
8258 "queue" : {
8259 "default" : "deferred",
8260 "description" : "Postfix queue name.",
8261 "enum" : [
8262 "deferred",
8263 "active",
8264 "incoming",
8265 "hold"
8266 ],
8267 "optional" : 1,
8268 "type" : "string"
8269 }
8270 }
8271 },
8272 "permissions" : {
8273 "check" : [
732d76e1
DM
8274 "admin",
8275 "audit"
a55e94a6
DM
8276 ]
8277 },
8278 "protected" : 1,
8279 "proxyto" : "node",
8280 "returns" : {
8281 "items" : {
8282 "properties" : {},
8283 "type" : "object"
8284 },
8285 "type" : "array"
8286 }
8287 }
8288 },
8289 "leaf" : 1,
8290 "path" : "/nodes/{node}/postfix/qshape",
8291 "text" : "qshape"
8292 },
8293 {
8294 "children" : [
8295 {
8296 "children" : [
8297 {
8298 "info" : {
8299 "DELETE" : {
8300 "description" : "Delete one message with the named queue ID.",
8301 "method" : "DELETE",
8302 "name" : "delete_queued_mail",
8303 "parameters" : {
8304 "additionalProperties" : 0,
8305 "properties" : {
8306 "node" : {
8307 "description" : "The cluster node name.",
8308 "format" : "pve-node",
8309 "type" : "string",
8310 "typetext" : "<string>"
8311 },
8312 "queue" : {
8313 "description" : "Postfix queue name.",
8314 "enum" : [
8315 "deferred",
8316 "active",
8317 "incoming",
8318 "hold"
8319 ],
8320 "type" : "string"
8321 },
8322 "queue_id" : {
8323 "description" : "The Message queue ID.",
8324 "maxLength" : 20,
8325 "minLength" : 8,
8326 "pattern" : "[a-zA-Z0-9]+",
8327 "type" : "string"
8328 }
8329 }
8330 },
8331 "permissions" : {
8332 "check" : [
8333 "admin"
8334 ]
8335 },
8336 "protected" : 1,
8337 "proxyto" : "node",
8338 "returns" : {
8339 "type" : "null"
8340 }
8341 },
8342 "GET" : {
8343 "description" : "Get the contents of a queued mail.",
8344 "method" : "GET",
8345 "name" : "read_queued_mail",
8346 "parameters" : {
8347 "additionalProperties" : 0,
8348 "properties" : {
8349 "body" : {
8350 "default" : 0,
8351 "description" : "Include body content.",
8352 "optional" : 1,
8353 "type" : "boolean",
8354 "typetext" : "<boolean>"
8355 },
8356 "header" : {
8357 "default" : 1,
8358 "description" : "Show message header content.",
8359 "optional" : 1,
8360 "type" : "boolean",
8361 "typetext" : "<boolean>"
8362 },
8363 "node" : {
8364 "description" : "The cluster node name.",
8365 "format" : "pve-node",
8366 "type" : "string",
8367 "typetext" : "<string>"
8368 },
8369 "queue" : {
8370 "description" : "Postfix queue name.",
8371 "enum" : [
8372 "deferred",
8373 "active",
8374 "incoming",
8375 "hold"
8376 ],
8377 "type" : "string"
8378 },
8379 "queue_id" : {
8380 "description" : "The Message queue ID.",
8381 "maxLength" : 20,
8382 "minLength" : 8,
8383 "pattern" : "[a-zA-Z0-9]+",
8384 "type" : "string"
8385 }
8386 }
8387 },
8388 "permissions" : {
8389 "check" : [
8390 "admin"
8391 ]
8392 },
8393 "protected" : 1,
8394 "proxyto" : "node",
8395 "returns" : {
8396 "type" : "string"
8397 }
8398 },
8399 "POST" : {
8400 "description" : "Schedule immediate delivery of deferred mail with the specified queue ID.",
8401 "method" : "POST",
8402 "name" : "flush_queued_mail",
8403 "parameters" : {
8404 "additionalProperties" : 0,
8405 "properties" : {
8406 "node" : {
8407 "description" : "The cluster node name.",
8408 "format" : "pve-node",
8409 "type" : "string",
8410 "typetext" : "<string>"
8411 },
8412 "queue" : {
8413 "description" : "Postfix queue name.",
8414 "enum" : [
8415 "deferred",
8416 "active",
8417 "incoming",
8418 "hold"
8419 ],
8420 "type" : "string"
8421 },
8422 "queue_id" : {
8423 "description" : "The Message queue ID.",
8424 "maxLength" : 20,
8425 "minLength" : 8,
8426 "pattern" : "[a-zA-Z0-9]+",
8427 "type" : "string"
8428 }
8429 }
8430 },
8431 "permissions" : {
8432 "check" : [
8433 "admin"
8434 ]
8435 },
8436 "protected" : 1,
8437 "proxyto" : "node",
8438 "returns" : {
8439 "type" : "null"
8440 }
8441 }
8442 },
8443 "leaf" : 1,
8444 "path" : "/nodes/{node}/postfix/queue/{queue}/{queue_id}",
8445 "text" : "{queue_id}"
8446 }
8447 ],
8448 "info" : {
8449 "DELETE" : {
8450 "description" : "Delete all mails in the queue.",
8451 "method" : "DELETE",
8452 "name" : "delete_queue",
8453 "parameters" : {
8454 "additionalProperties" : 0,
8455 "properties" : {
8456 "node" : {
8457 "description" : "The cluster node name.",
8458 "format" : "pve-node",
8459 "type" : "string",
8460 "typetext" : "<string>"
8461 },
8462 "queue" : {
8463 "description" : "Postfix queue name.",
8464 "enum" : [
8465 "deferred",
8466 "active",
8467 "incoming",
8468 "hold"
8469 ],
8470 "type" : "string"
8471 }
8472 }
8473 },
8474 "permissions" : {
8475 "check" : [
8476 "admin"
8477 ]
8478 },
8479 "protected" : 1,
8480 "proxyto" : "node",
8481 "returns" : {
8482 "type" : "null"
8483 }
8484 },
8485 "GET" : {
8486 "description" : "List the mail queue for a specific domain.",
8487 "method" : "GET",
8488 "name" : "mailq",
8489 "parameters" : {
8490 "additionalProperties" : 0,
8491 "properties" : {
8492 "filter" : {
8493 "description" : "Filter string.",
8494 "maxLength" : 64,
8495 "optional" : 1,
8496 "type" : "string",
8497 "typetext" : "<string>"
8498 },
8499 "limit" : {
8500 "minimum" : 0,
8501 "optional" : 1,
8502 "type" : "integer",
8503 "typetext" : "<integer> (0 - N)"
8504 },
8505 "node" : {
8506 "description" : "The cluster node name.",
8507 "format" : "pve-node",
8508 "type" : "string",
8509 "typetext" : "<string>"
8510 },
8511 "queue" : {
8512 "description" : "Postfix queue name.",
8513 "enum" : [
8514 "deferred",
8515 "active",
8516 "incoming",
8517 "hold"
8518 ],
8519 "type" : "string"
8520 },
8521 "start" : {
8522 "minimum" : 0,
8523 "optional" : 1,
8524 "type" : "integer",
8525 "typetext" : "<integer> (0 - N)"
8526 }
8527 }
8528 },
8529 "permissions" : {
8530 "check" : [
732d76e1
DM
8531 "admin",
8532 "audit"
a55e94a6
DM
8533 ]
8534 },
8535 "protected" : 1,
8536 "proxyto" : "node",
8537 "returns" : {
8538 "items" : {
8539 "properties" : {},
8540 "type" : "object"
8541 },
8542 "links" : [
8543 {
8544 "href" : "{queue_id}",
8545 "rel" : "child"
8546 }
8547 ],
8548 "type" : "array"
8549 }
8550 }
8551 },
8552 "leaf" : 0,
8553 "path" : "/nodes/{node}/postfix/queue/{queue}",
8554 "text" : "{queue}"
8555 }
8556 ],
8557 "info" : {
9fda36b0
DM
8558 "DELETE" : {
8559 "description" : "Delete all mails in all posfix queues.",
8560 "method" : "DELETE",
8561 "name" : "delete_all_queues",
8562 "parameters" : {
8563 "additionalProperties" : 0,
8564 "properties" : {
8565 "node" : {
8566 "description" : "The cluster node name.",
8567 "format" : "pve-node",
8568 "type" : "string",
8569 "typetext" : "<string>"
8570 }
8571 }
8572 },
8573 "permissions" : {
8574 "check" : [
8575 "admin"
8576 ]
8577 },
8578 "protected" : 1,
8579 "proxyto" : "node",
8580 "returns" : {
8581 "type" : "null"
8582 }
8583 },
a55e94a6
DM
8584 "GET" : {
8585 "description" : "Directory index.",
8586 "method" : "GET",
8587 "name" : "queue_index",
8588 "parameters" : {
8589 "additionalProperties" : 0,
8590 "properties" : {
8591 "node" : {
8592 "description" : "The cluster node name.",
8593 "format" : "pve-node",
8594 "type" : "string",
8595 "typetext" : "<string>"
8596 }
8597 }
8598 },
8599 "permissions" : {
8600 "user" : "all"
8601 },
8602 "returns" : {
8603 "items" : {
8604 "properties" : {},
8605 "type" : "object"
8606 },
8607 "links" : [
8608 {
8609 "href" : "{name}",
8610 "rel" : "child"
8611 }
8612 ],
8613 "type" : "array"
8614 }
8615 }
8616 },
8617 "leaf" : 0,
8618 "path" : "/nodes/{node}/postfix/queue",
8619 "text" : "queue"
f245a28c 8620 },
a55e94a6
DM
8621 {
8622 "info" : {
8623 "POST" : {
8624 "description" : "Flush the queue: attempt to deliver all queued mail.",
8625 "method" : "POST",
8626 "name" : "flush_queues",
8627 "parameters" : {
8628 "additionalProperties" : 0,
8629 "properties" : {
8630 "node" : {
8631 "description" : "The cluster node name.",
8632 "format" : "pve-node",
8633 "type" : "string",
8634 "typetext" : "<string>"
8635 }
8636 }
8637 },
8638 "permissions" : {
8639 "check" : [
8640 "admin"
8641 ]
8642 },
8643 "protected" : 1,
8644 "proxyto" : "node",
8645 "returns" : {
8646 "type" : "null"
8647 }
8648 }
f245a28c 8649 },
a55e94a6
DM
8650 "leaf" : 1,
8651 "path" : "/nodes/{node}/postfix/flush_queues",
8652 "text" : "flush_queues"
8653 },
8654 {
8655 "info" : {
8656 "POST" : {
8657 "description" : "Discards the address verification cache.",
8658 "method" : "POST",
8659 "name" : "discard_verify_cache",
8660 "parameters" : {
8661 "additionalProperties" : 0,
8662 "properties" : {
8663 "node" : {
8664 "description" : "The cluster node name.",
8665 "format" : "pve-node",
8666 "type" : "string",
8667 "typetext" : "<string>"
8668 }
8669 }
8670 },
8671 "permissions" : {
8672 "check" : [
8673 "admin"
8674 ]
8675 },
8676 "protected" : 1,
8677 "proxyto" : "node",
8678 "returns" : {
8679 "type" : "null"
8680 }
8681 }
f245a28c 8682 },
a55e94a6
DM
8683 "leaf" : 1,
8684 "path" : "/nodes/{node}/postfix/discard_verify_cache",
8685 "text" : "discard_verify_cache"
8686 }
8687 ],
8688 "info" : {
8689 "GET" : {
8690 "description" : "Directory index.",
8691 "method" : "GET",
8692 "name" : "index",
8693 "parameters" : {
8694 "additionalProperties" : 0,
8695 "properties" : {
8696 "node" : {
8697 "description" : "The cluster node name.",
8698 "format" : "pve-node",
8699 "type" : "string",
8700 "typetext" : "<string>"
8701 }
8702 }
f245a28c 8703 },
a55e94a6
DM
8704 "permissions" : {
8705 "user" : "all"
f245a28c 8706 },
a55e94a6
DM
8707 "returns" : {
8708 "items" : {
8709 "properties" : {},
8710 "type" : "object"
8711 },
8712 "links" : [
8713 {
8714 "href" : "{name}",
8715 "rel" : "child"
8716 }
8717 ],
8718 "type" : "array"
f245a28c 8719 }
410dc2c9
DM
8720 }
8721 },
a55e94a6
DM
8722 "leaf" : 0,
8723 "path" : "/nodes/{node}/postfix",
8724 "text" : "postfix"
410dc2c9 8725 },
f245a28c
DM
8726 {
8727 "children" : [
8728 {
8729 "info" : {
8730 "GET" : {
8731 "description" : "ClamAV virus database status.",
8732 "method" : "GET",
8733 "name" : "database_status",
8734 "parameters" : {
8735 "additionalProperties" : 0,
8736 "properties" : {
8737 "node" : {
8738 "description" : "The cluster node name.",
8739 "format" : "pve-node",
8740 "type" : "string",
8741 "typetext" : "<string>"
8742 }
8743 }
8744 },
bb6e6e0d
DM
8745 "permissions" : {
8746 "check" : [
8747 "admin",
8748 "audit"
8749 ]
8750 },
8751 "proxyto" : "node",
f245a28c
DM
8752 "returns" : {
8753 "items" : {
8754 "properties" : {
8755 "build_time" : {
8756 "type" : "string"
8757 },
8758 "nsigs" : {
8759 "type" : "integer"
8760 },
8761 "type" : {
8762 "type" : "string"
8763 },
8764 "version" : {
8765 "optional" : 1,
8766 "type" : "string"
8767 }
8768 },
8769 "type" : "object"
8770 },
8771 "type" : "array"
8772 }
8773 },
8774 "POST" : {
8775 "description" : "Update ClamAV virus databases.",
8776 "method" : "POST",
8777 "name" : "update_database",
8778 "parameters" : {
8779 "additionalProperties" : 0,
8780 "properties" : {
8781 "node" : {
8782 "description" : "The cluster node name.",
8783 "format" : "pve-node",
8784 "type" : "string",
8785 "typetext" : "<string>"
8786 }
8787 }
8788 },
bb6e6e0d
DM
8789 "permissions" : {
8790 "check" : [
8791 "admin"
8792 ]
8793 },
f245a28c 8794 "protected" : 1,
bb6e6e0d 8795 "proxyto" : "node",
f245a28c
DM
8796 "returns" : {
8797 "type" : "string"
8798 }
8799 }
8800 },
8801 "leaf" : 1,
8802 "path" : "/nodes/{node}/clamav/database",
8803 "text" : "database"
8804 }
8805 ],
8806 "info" : {
8807 "GET" : {
8808 "description" : "Directory index.",
8809 "method" : "GET",
8810 "name" : "index",
8811 "parameters" : {
8812 "additionalProperties" : 0,
8813 "properties" : {
8814 "node" : {
8815 "description" : "The cluster node name.",
8816 "format" : "pve-node",
8817 "type" : "string",
8818 "typetext" : "<string>"
8819 }
8820 }
8821 },
bb6e6e0d
DM
8822 "permissions" : {
8823 "check" : [
8824 "admin",
8825 "audit"
8826 ]
8827 },
f245a28c
DM
8828 "returns" : {
8829 "items" : {
8830 "properties" : {},
8831 "type" : "object"
8832 },
8833 "links" : [
8834 {
8835 "href" : "{subdir}",
8836 "rel" : "child"
8837 }
8838 ],
8839 "type" : "array"
8840 }
8841 }
8842 },
8843 "leaf" : 0,
8844 "path" : "/nodes/{node}/clamav",
8845 "text" : "clamav"
8846 },
bb6e6e0d
DM
8847 {
8848 "children" : [
8849 {
8850 "info" : {
8851 "GET" : {
8852 "description" : "SpamAssassin rules status.",
8853 "method" : "GET",
8854 "name" : "rules_status",
8855 "parameters" : {
8856 "additionalProperties" : 0,
8857 "properties" : {
8858 "node" : {
8859 "description" : "The cluster node name.",
8860 "format" : "pve-node",
8861 "type" : "string",
8862 "typetext" : "<string>"
8863 }
8864 }
8865 },
8866 "permissions" : {
8867 "check" : [
8868 "admin",
8869 "audit"
8870 ]
8871 },
8872 "proxyto" : "node",
8873 "returns" : {
8874 "items" : {
8875 "properties" : {
8876 "channel" : {
8877 "type" : "string"
8878 },
8879 "last_updated" : {
8880 "optional" : 1,
8881 "type" : "integer"
8882 },
8883 "update_avail" : {
8884 "type" : "boolean"
8885 },
8886 "update_version" : {
8887 "optional" : 1,
8888 "type" : "string"
8889 },
8890 "version" : {
8891 "optional" : 1,
8892 "type" : "string"
8893 }
8894 },
8895 "type" : "object"
8896 },
8897 "type" : "array"
8898 }
8899 },
8900 "POST" : {
8901 "description" : "Update SpamAssassin rules.",
8902 "method" : "POST",
8903 "name" : "update_rules",
8904 "parameters" : {
8905 "additionalProperties" : 0,
8906 "properties" : {
8907 "node" : {
8908 "description" : "The cluster node name.",
8909 "format" : "pve-node",
8910 "type" : "string",
8911 "typetext" : "<string>"
8912 }
8913 }
8914 },
8915 "permissions" : {
8916 "check" : [
8917 "admin"
8918 ]
8919 },
8920 "protected" : 1,
8921 "proxyto" : "node",
8922 "returns" : {
8923 "type" : "string"
8924 }
8925 }
8926 },
8927 "leaf" : 1,
8928 "path" : "/nodes/{node}/spamassassin/rules",
8929 "text" : "rules"
8930 }
8931 ],
8932 "info" : {
8933 "GET" : {
8934 "description" : "Directory index.",
8935 "method" : "GET",
8936 "name" : "index",
8937 "parameters" : {
8938 "additionalProperties" : 0,
8939 "properties" : {
8940 "node" : {
8941 "description" : "The cluster node name.",
8942 "format" : "pve-node",
8943 "type" : "string",
8944 "typetext" : "<string>"
8945 }
8946 }
8947 },
8948 "permissions" : {
8949 "check" : [
8950 "admin",
8951 "audit"
8952 ]
8953 },
8954 "returns" : {
8955 "items" : {
8956 "properties" : {},
8957 "type" : "object"
8958 },
8959 "links" : [
8960 {
8961 "href" : "{subdir}",
8962 "rel" : "child"
8963 }
8964 ],
8965 "type" : "array"
8966 }
8967 }
8968 },
8969 "leaf" : 0,
8970 "path" : "/nodes/{node}/spamassassin",
8971 "text" : "spamassassin"
8972 },
410dc2c9
DM
8973 {
8974 "children" : [
8975 {
8976 "info" : {
8977 "DELETE" : {
8978 "description" : "Delete network device configuration",
8979 "method" : "DELETE",
8980 "name" : "delete_network",
8981 "parameters" : {
8982 "additionalProperties" : 0,
8983 "properties" : {
8984 "iface" : {
8985 "description" : "Network interface name.",
8986 "format" : "pve-iface",
8987 "maxLength" : 20,
8988 "minLength" : 2,
8989 "type" : "string",
8990 "typetext" : "<string>"
8991 },
8992 "node" : {
8993 "description" : "The cluster node name.",
8994 "format" : "pve-node",
8995 "type" : "string",
8996 "typetext" : "<string>"
8997 }
8998 }
8999 },
9000 "protected" : 1,
9001 "proxyto" : "node",
9002 "returns" : {
9003 "type" : "null"
9004 }
9005 },
9006 "GET" : {
9007 "description" : "Read network device configuration",
9008 "method" : "GET",
9009 "name" : "network_config",
9010 "parameters" : {
9011 "additionalProperties" : 0,
9012 "properties" : {
9013 "iface" : {
9014 "description" : "Network interface name.",
9015 "format" : "pve-iface",
9016 "maxLength" : 20,
9017 "minLength" : 2,
9018 "type" : "string",
9019 "typetext" : "<string>"
9020 },
9021 "node" : {
9022 "description" : "The cluster node name.",
9023 "format" : "pve-node",
9024 "type" : "string",
9025 "typetext" : "<string>"
9026 }
9027 }
9028 },
732d76e1
DM
9029 "permissions" : {
9030 "check" : [
9031 "admin",
9032 "audit"
9033 ]
9034 },
410dc2c9
DM
9035 "proxyto" : "node",
9036 "returns" : {
9037 "properties" : {
9038 "method" : {
9039 "type" : "string"
9040 },
9041 "type" : {
9042 "type" : "string"
9043 }
9044 },
9045 "type" : "object"
9046 }
9047 },
9048 "PUT" : {
9049 "description" : "Update network device configuration",
9050 "method" : "PUT",
9051 "name" : "update_network",
9052 "parameters" : {
9053 "additionalProperties" : 0,
9054 "properties" : {
9055 "address" : {
9056 "description" : "IP address.",
9057 "format" : "ipv4",
9058 "optional" : 1,
9059 "requires" : "netmask",
9060 "type" : "string",
9061 "typetext" : "<string>"
9062 },
9063 "address6" : {
9064 "description" : "IP address.",
9065 "format" : "ipv6",
9066 "optional" : 1,
9067 "requires" : "netmask6",
9068 "type" : "string",
9069 "typetext" : "<string>"
9070 },
9071 "autostart" : {
9072 "description" : "Automatically start interface on boot.",
9073 "optional" : 1,
9074 "type" : "boolean",
9075 "typetext" : "<boolean>"
9076 },
9077 "bond_mode" : {
9078 "description" : "Bonding mode.",
9079 "enum" : [
9080 "balance-rr",
9081 "active-backup",
9082 "balance-xor",
9083 "broadcast",
9084 "802.3ad",
9085 "balance-tlb",
9086 "balance-alb",
9087 "balance-slb",
9088 "lacp-balance-slb",
9089 "lacp-balance-tcp"
9090 ],
9091 "optional" : 1,
9092 "type" : "string"
9093 },
9094 "bond_xmit_hash_policy" : {
9095 "description" : "Selects the transmit hash policy to use for slave selection in balance-xor and 802.3ad modes.",
9096 "enum" : [
9097 "layer2",
9098 "layer2+3",
9099 "layer3+4"
9100 ],
9101 "optional" : 1,
9102 "type" : "string"
9103 },
9104 "bridge_ports" : {
9105 "description" : "Specify the iterfaces you want to add to your bridge.",
9106 "format" : "pve-iface-list",
9107 "optional" : 1,
9108 "type" : "string",
9109 "typetext" : "<string>"
9110 },
9111 "bridge_vlan_aware" : {
9112 "description" : "Enable bridge vlan support.",
9113 "optional" : 1,
9114 "type" : "boolean",
9115 "typetext" : "<boolean>"
9116 },
9117 "comments" : {
9118 "description" : "Comments",
9119 "optional" : 1,
9120 "type" : "string",
9121 "typetext" : "<string>"
9122 },
9123 "comments6" : {
9124 "description" : "Comments",
9125 "optional" : 1,
9126 "type" : "string",
9127 "typetext" : "<string>"
9128 },
9129 "delete" : {
9130 "description" : "A list of settings you want to delete.",
9131 "format" : "pve-configid-list",
9132 "optional" : 1,
9133 "type" : "string",
9134 "typetext" : "<string>"
9135 },
9136 "gateway" : {
9137 "description" : "Default gateway address.",
9138 "format" : "ipv4",
9139 "optional" : 1,
9140 "type" : "string",
9141 "typetext" : "<string>"
9142 },
9143 "gateway6" : {
9144 "description" : "Default ipv6 gateway address.",
9145 "format" : "ipv6",
9146 "optional" : 1,
9147 "type" : "string",
9148 "typetext" : "<string>"
9149 },
9150 "iface" : {
9151 "description" : "Network interface name.",
9152 "format" : "pve-iface",
9153 "maxLength" : 20,
9154 "minLength" : 2,
9155 "type" : "string",
9156 "typetext" : "<string>"
9157 },
9158 "netmask" : {
9159 "description" : "Network mask.",
9160 "format" : "ipv4mask",
9161 "optional" : 1,
9162 "requires" : "address",
9163 "type" : "string",
9164 "typetext" : "<string>"
9165 },
9166 "netmask6" : {
9167 "description" : "Network mask.",
9168 "maximum" : 128,
9169 "minimum" : 0,
9170 "optional" : 1,
9171 "requires" : "address6",
9172 "type" : "integer",
9173 "typetext" : "<integer> (0 - 128)"
9174 },
9175 "node" : {
9176 "description" : "The cluster node name.",
9177 "format" : "pve-node",
9178 "type" : "string",
9179 "typetext" : "<string>"
9180 },
9181 "ovs_bonds" : {
9182 "description" : "Specify the interfaces used by the bonding device.",
9183 "format" : "pve-iface-list",
9184 "optional" : 1,
9185 "type" : "string",
9186 "typetext" : "<string>"
9187 },
9188 "ovs_bridge" : {
9189 "description" : "The OVS bridge associated with a OVS port. This is required when you create an OVS port.",
9190 "format" : "pve-iface",
9191 "optional" : 1,
9192 "type" : "string",
9193 "typetext" : "<string>"
9194 },
9195 "ovs_options" : {
9196 "description" : "OVS interface options.",
9197 "maxLength" : 1024,
9198 "optional" : 1,
9199 "type" : "string",
9200 "typetext" : "<string>"
9201 },
9202 "ovs_ports" : {
9203 "description" : "Specify the iterfaces you want to add to your bridge.",
9204 "format" : "pve-iface-list",
9205 "optional" : 1,
9206 "type" : "string",
9207 "typetext" : "<string>"
9208 },
9209 "ovs_tag" : {
9210 "description" : "Specify a VLan tag (used by OVSPort, OVSIntPort, OVSBond)",
9211 "maximum" : 4094,
9212 "minimum" : 1,
9213 "optional" : 1,
9214 "type" : "integer",
9215 "typetext" : "<integer> (1 - 4094)"
9216 },
9217 "slaves" : {
9218 "description" : "Specify the interfaces used by the bonding device.",
9219 "format" : "pve-iface-list",
9220 "optional" : 1,
9221 "type" : "string",
9222 "typetext" : "<string>"
9223 },
9224 "type" : {
9225 "description" : "Network interface type",
9226 "enum" : [
9227 "bridge",
9228 "bond",
9229 "eth",
9230 "alias",
9231 "vlan",
9232 "OVSBridge",
9233 "OVSBond",
9234 "OVSPort",
9235 "OVSIntPort",
9236 "unknown"
9237 ],
9238 "type" : "string"
9239 }
9240 }
9241 },
9242 "protected" : 1,
9243 "proxyto" : "node",
9244 "returns" : {
9245 "type" : "null"
9246 }
9247 }
9248 },
9249 "leaf" : 1,
9250 "path" : "/nodes/{node}/network/{iface}",
9251 "text" : "{iface}"
9252 }
9253 ],
9254 "info" : {
9255 "DELETE" : {
9256 "description" : "Revert network configuration changes.",
9257 "method" : "DELETE",
9258 "name" : "revert_network_changes",
9259 "parameters" : {
9260 "additionalProperties" : 0,
9261 "properties" : {
9262 "node" : {
9263 "description" : "The cluster node name.",
9264 "format" : "pve-node",
9265 "type" : "string",
9266 "typetext" : "<string>"
9267 }
9268 }
9269 },
9270 "protected" : 1,
9271 "proxyto" : "node",
9272 "returns" : {
9273 "type" : "null"
9274 }
9275 },
9276 "GET" : {
9277 "description" : "List available networks",
9278 "method" : "GET",
9279 "name" : "index",
9280 "parameters" : {
9281 "additionalProperties" : 0,
9282 "properties" : {
9283 "node" : {
9284 "description" : "The cluster node name.",
9285 "format" : "pve-node",
9286 "type" : "string",
9287 "typetext" : "<string>"
9288 },
9289 "type" : {
9290 "description" : "Only list specific interface types.",
9291 "enum" : [
9292 "bridge",
9293 "bond",
9294 "eth",
9295 "alias",
9296 "vlan",
9297 "OVSBridge",
9298 "OVSBond",
9299 "OVSPort",
9300 "OVSIntPort",
9301 "any_bridge"
9302 ],
9303 "optional" : 1,
9304 "type" : "string"
9305 }
9306 }
9307 },
732d76e1
DM
9308 "permissions" : {
9309 "check" : [
9310 "admin",
9311 "audit"
9312 ]
9313 },
410dc2c9
DM
9314 "proxyto" : "node",
9315 "returns" : {
9316 "items" : {
9317 "properties" : {},
9318 "type" : "object"
9319 },
9320 "links" : [
9321 {
9322 "href" : "{iface}",
9323 "rel" : "child"
9324 }
9325 ],
9326 "type" : "array"
9327 }
9328 },
9329 "POST" : {
9330 "description" : "Create network device configuration",
9331 "method" : "POST",
9332 "name" : "create_network",
9333 "parameters" : {
9334 "additionalProperties" : 0,
9335 "properties" : {
9336 "address" : {
9337 "description" : "IP address.",
9338 "format" : "ipv4",
9339 "optional" : 1,
9340 "requires" : "netmask",
9341 "type" : "string",
9342 "typetext" : "<string>"
9343 },
9344 "address6" : {
9345 "description" : "IP address.",
9346 "format" : "ipv6",
9347 "optional" : 1,
9348 "requires" : "netmask6",
9349 "type" : "string",
9350 "typetext" : "<string>"
9351 },
9352 "autostart" : {
9353 "description" : "Automatically start interface on boot.",
9354 "optional" : 1,
9355 "type" : "boolean",
9356 "typetext" : "<boolean>"
9357 },
9358 "bond_mode" : {
9359 "description" : "Bonding mode.",
9360 "enum" : [
9361 "balance-rr",
9362 "active-backup",
9363 "balance-xor",
9364 "broadcast",
9365 "802.3ad",
9366 "balance-tlb",
9367 "balance-alb",
9368 "balance-slb",
9369 "lacp-balance-slb",
9370 "lacp-balance-tcp"
9371 ],
9372 "optional" : 1,
9373 "type" : "string"
9374 },
9375 "bond_xmit_hash_policy" : {
9376 "description" : "Selects the transmit hash policy to use for slave selection in balance-xor and 802.3ad modes.",
9377 "enum" : [
9378 "layer2",
9379 "layer2+3",
9380 "layer3+4"
9381 ],
9382 "optional" : 1,
9383 "type" : "string"
9384 },
9385 "bridge_ports" : {
9386 "description" : "Specify the iterfaces you want to add to your bridge.",
9387 "format" : "pve-iface-list",
9388 "optional" : 1,
9389 "type" : "string",
9390 "typetext" : "<string>"
9391 },
9392 "bridge_vlan_aware" : {
9393 "description" : "Enable bridge vlan support.",
9394 "optional" : 1,
9395 "type" : "boolean",
9396 "typetext" : "<boolean>"
9397 },
9398 "comments" : {
9399 "description" : "Comments",
9400 "optional" : 1,
9401 "type" : "string",
9402 "typetext" : "<string>"
9403 },
9404 "comments6" : {
9405 "description" : "Comments",
9406 "optional" : 1,
9407 "type" : "string",
9408 "typetext" : "<string>"
9409 },
9410 "gateway" : {
9411 "description" : "Default gateway address.",
9412 "format" : "ipv4",
9413 "optional" : 1,
9414 "type" : "string",
9415 "typetext" : "<string>"
9416 },
9417 "gateway6" : {
9418 "description" : "Default ipv6 gateway address.",
9419 "format" : "ipv6",
9420 "optional" : 1,
9421 "type" : "string",
9422 "typetext" : "<string>"
9423 },
9424 "iface" : {
9425 "description" : "Network interface name.",
9426 "format" : "pve-iface",
9427 "maxLength" : 20,
9428 "minLength" : 2,
9429 "type" : "string",
9430 "typetext" : "<string>"
9431 },
9432 "netmask" : {
9433 "description" : "Network mask.",
9434 "format" : "ipv4mask",
9435 "optional" : 1,
9436 "requires" : "address",
9437 "type" : "string",
9438 "typetext" : "<string>"
9439 },
9440 "netmask6" : {
9441 "description" : "Network mask.",
9442 "maximum" : 128,
9443 "minimum" : 0,
9444 "optional" : 1,
9445 "requires" : "address6",
9446 "type" : "integer",
9447 "typetext" : "<integer> (0 - 128)"
9448 },
9449 "node" : {
9450 "description" : "The cluster node name.",
9451 "format" : "pve-node",
9452 "type" : "string",
9453 "typetext" : "<string>"
9454 },
9455 "ovs_bonds" : {
9456 "description" : "Specify the interfaces used by the bonding device.",
9457 "format" : "pve-iface-list",
9458 "optional" : 1,
9459 "type" : "string",
9460 "typetext" : "<string>"
9461 },
9462 "ovs_bridge" : {
9463 "description" : "The OVS bridge associated with a OVS port. This is required when you create an OVS port.",
9464 "format" : "pve-iface",
9465 "optional" : 1,
9466 "type" : "string",
9467 "typetext" : "<string>"
9468 },
9469 "ovs_options" : {
9470 "description" : "OVS interface options.",
9471 "maxLength" : 1024,
9472 "optional" : 1,
9473 "type" : "string",
9474 "typetext" : "<string>"
9475 },
9476 "ovs_ports" : {
9477 "description" : "Specify the iterfaces you want to add to your bridge.",
9478 "format" : "pve-iface-list",
9479 "optional" : 1,
9480 "type" : "string",
9481 "typetext" : "<string>"
9482 },
9483 "ovs_tag" : {
9484 "description" : "Specify a VLan tag (used by OVSPort, OVSIntPort, OVSBond)",
9485 "maximum" : 4094,
9486 "minimum" : 1,
9487 "optional" : 1,
9488 "type" : "integer",
9489 "typetext" : "<integer> (1 - 4094)"
9490 },
9491 "slaves" : {
9492 "description" : "Specify the interfaces used by the bonding device.",
9493 "format" : "pve-iface-list",
9494 "optional" : 1,
9495 "type" : "string",
9496 "typetext" : "<string>"
9497 },
9498 "type" : {
9499 "description" : "Network interface type",
9500 "enum" : [
9501 "bridge",
9502 "bond",
9503 "eth",
9504 "alias",
9505 "vlan",
9506 "OVSBridge",
9507 "OVSBond",
9508 "OVSPort",
9509 "OVSIntPort",
9510 "unknown"
9511 ],
9512 "type" : "string"
9513 }
9514 }
9515 },
9516 "protected" : 1,
9517 "proxyto" : "node",
9518 "returns" : {
9519 "type" : "null"
9520 }
9521 }
9522 },
9523 "leaf" : 0,
9524 "path" : "/nodes/{node}/network",
9525 "text" : "network"
9526 },
9527 {
9528 "children" : [
9529 {
9530 "children" : [
9531 {
9532 "info" : {
9533 "GET" : {
9534 "description" : "Read task log.",
9535 "method" : "GET",
9536 "name" : "read_task_log",
9537 "parameters" : {
9538 "additionalProperties" : 0,
9539 "properties" : {
9540 "limit" : {
9541 "minimum" : 0,
9542 "optional" : 1,
9543 "type" : "integer",
9544 "typetext" : "<integer> (0 - N)"
9545 },
9546 "node" : {
9547 "description" : "The cluster node name.",
9548 "format" : "pve-node",
9549 "type" : "string",
9550 "typetext" : "<string>"
9551 },
9552 "start" : {
9553 "minimum" : 0,
9554 "optional" : 1,
9555 "type" : "integer",
9556 "typetext" : "<integer> (0 - N)"
9557 },
9558 "upid" : {
9559 "type" : "string",
9560 "typetext" : "<string>"
9561 }
9562 }
9563 },
732d76e1
DM
9564 "permissions" : {
9565 "check" : [
9566 "admin",
9567 "audit"
9568 ]
9569 },
410dc2c9
DM
9570 "protected" : 1,
9571 "proxyto" : "node",
9572 "returns" : {
9573 "items" : {
9574 "properties" : {
9575 "n" : {
9576 "description" : "Line number",
9577 "type" : "integer"
9578 },
9579 "t" : {
9580 "description" : "Line text",
9581 "type" : "string"
9582 }
9583 },
9584 "type" : "object"
9585 },
9586 "type" : "array"
9587 }
9588 }
9589 },
9590 "leaf" : 1,
9591 "path" : "/nodes/{node}/tasks/{upid}/log",
9592 "text" : "log"
9593 },
9594 {
9595 "info" : {
9596 "GET" : {
9597 "description" : "Read task status.",
9598 "method" : "GET",
9599 "name" : "read_task_status",
9600 "parameters" : {
9601 "additionalProperties" : 0,
9602 "properties" : {
9603 "node" : {
9604 "description" : "The cluster node name.",
9605 "format" : "pve-node",
9606 "type" : "string",
9607 "typetext" : "<string>"
9608 },
9609 "upid" : {
9610 "type" : "string",
9611 "typetext" : "<string>"
9612 }
9613 }
9614 },
732d76e1
DM
9615 "permissions" : {
9616 "check" : [
9617 "admin",
9618 "audit"
9619 ]
9620 },
410dc2c9
DM
9621 "protected" : 1,
9622 "proxyto" : "node",
9623 "returns" : {
9624 "properties" : {
9625 "pid" : {
9626 "type" : "integer"
9627 },
9628 "status" : {
9629 "enum" : [
9630 "running",
9631 "stopped"
9632 ],
9633 "type" : "string"
9634 }
9635 },
9636 "type" : "object"
9637 }
9638 }
9639 },
9640 "leaf" : 1,
9641 "path" : "/nodes/{node}/tasks/{upid}/status",
9642 "text" : "status"
9643 }
9644 ],
9645 "info" : {
9646 "DELETE" : {
9647 "description" : "Stop a task.",
9648 "method" : "DELETE",
9649 "name" : "stop_task",
9650 "parameters" : {
9651 "additionalProperties" : 0,
9652 "properties" : {
9653 "node" : {
9654 "description" : "The cluster node name.",
9655 "format" : "pve-node",
9656 "type" : "string",
9657 "typetext" : "<string>"
9658 },
9659 "upid" : {
9660 "type" : "string",
9661 "typetext" : "<string>"
9662 }
9663 }
9664 },
732d76e1
DM
9665 "permissions" : {
9666 "check" : [
9667 "admin"
9668 ]
9669 },
410dc2c9
DM
9670 "protected" : 1,
9671 "proxyto" : "node",
9672 "returns" : {
9673 "type" : "null"
9674 }
9675 },
9676 "GET" : {
9677 "description" : "",
9678 "method" : "GET",
9679 "name" : "upid_index",
9680 "parameters" : {
9681 "additionalProperties" : 0,
9682 "properties" : {
9683 "node" : {
9684 "description" : "The cluster node name.",
9685 "format" : "pve-node",
9686 "type" : "string",
9687 "typetext" : "<string>"
9688 },
9689 "upid" : {
9690 "type" : "string",
9691 "typetext" : "<string>"
9692 }
9693 }
9694 },
732d76e1
DM
9695 "permissions" : {
9696 "check" : [
9697 "admin",
9698 "audit"
9699 ]
9700 },
410dc2c9
DM
9701 "returns" : {
9702 "items" : {
9703 "properties" : {},
9704 "type" : "object"
9705 },
9706 "links" : [
9707 {
9708 "href" : "{name}",
9709 "rel" : "child"
9710 }
9711 ],
9712 "type" : "array"
9713 }
9714 }
9715 },
9716 "leaf" : 0,
9717 "path" : "/nodes/{node}/tasks/{upid}",
9718 "text" : "{upid}"
9719 }
9720 ],
9721 "info" : {
9722 "GET" : {
9723 "description" : "Read task list for one node (finished tasks).",
9724 "method" : "GET",
9725 "name" : "node_tasks",
9726 "parameters" : {
9727 "additionalProperties" : 0,
9728 "properties" : {
9729 "errors" : {
9730 "optional" : 1,
9731 "type" : "boolean",
9732 "typetext" : "<boolean>"
9733 },
9734 "limit" : {
9735 "minimum" : 0,
9736 "optional" : 1,
9737 "type" : "integer",
9738 "typetext" : "<integer> (0 - N)"
9739 },
9740 "node" : {
9741 "description" : "The cluster node name.",
9742 "format" : "pve-node",
9743 "type" : "string",
9744 "typetext" : "<string>"
9745 },
9746 "start" : {
9747 "minimum" : 0,
9748 "optional" : 1,
9749 "type" : "integer",
9750 "typetext" : "<integer> (0 - N)"
9751 },
9752 "userfilter" : {
9753 "optional" : 1,
9754 "type" : "string",
9755 "typetext" : "<string>"
9756 }
9757 }
9758 },
732d76e1
DM
9759 "permissions" : {
9760 "check" : [
9761 "admin",
9762 "audit"
9763 ]
9764 },
410dc2c9
DM
9765 "proxyto" : "node",
9766 "returns" : {
9767 "items" : {
9768 "properties" : {
9769 "upid" : {
9770 "type" : "string"
9771 }
9772 },
9773 "type" : "object"
9774 },
9775 "links" : [
9776 {
9777 "href" : "{upid}",
9778 "rel" : "child"
9779 }
9780 ],
9781 "type" : "array"
9782 }
9783 }
9784 },
9785 "leaf" : 0,
9786 "path" : "/nodes/{node}/tasks",
9787 "text" : "tasks"
9788 },
9789 {
9790 "children" : [
9791 {
9792 "children" : [
9793 {
9794 "info" : {
9795 "GET" : {
9796 "description" : "Read service properties",
9797 "method" : "GET",
9798 "name" : "service_state",
9799 "parameters" : {
9800 "additionalProperties" : 0,
9801 "properties" : {
9802 "node" : {
9803 "description" : "The cluster node name.",
9804 "format" : "pve-node",
9805 "type" : "string",
9806 "typetext" : "<string>"
9807 },
9808 "service" : {
9809 "description" : "Service ID",
9810 "enum" : [
a55e94a6
DM
9811 "clamav-daemon",
9812 "clamav-freshclam",
732d76e1 9813 "fetchmail",
410dc2c9
DM
9814 "pmgproxy",
9815 "pmgdaemon",
a55e94a6 9816 "pmgpolicy",
410dc2c9 9817 "pmg-smtp-filter",
d7cd791b
DM
9818 "pmgtunnel",
9819 "pmgmirror",
9820 "ssh",
9821 "rsyslog",
410dc2c9 9822 "postfix",
d7cd791b 9823 "postgres",
a55e94a6
DM
9824 "systemd-timesyncd",
9825 "pmg-hourly",
d7cd791b 9826 "pmg-daily",
9fda36b0 9827 "pmgreport",
d7cd791b 9828 "pmgspamreport"
410dc2c9
DM
9829 ],
9830 "type" : "string"
9831 }
9832 }
9833 },
732d76e1
DM
9834 "permissions" : {
9835 "check" : [
9836 "admin",
9837 "audit"
9838 ]
9839 },
410dc2c9
DM
9840 "protected" : 1,
9841 "proxyto" : "node",
9842 "returns" : {
9843 "properties" : {},
9844 "type" : "object"
9845 }
9846 }
9847 },
9848 "leaf" : 1,
9849 "path" : "/nodes/{node}/services/{service}/state",
9850 "text" : "state"
9851 },
9852 {
9853 "info" : {
9854 "POST" : {
9855 "description" : "Start service.",
9856 "method" : "POST",
9857 "name" : "service_start",
9858 "parameters" : {
9859 "additionalProperties" : 0,
9860 "properties" : {
9861 "node" : {
9862 "description" : "The cluster node name.",
9863 "format" : "pve-node",
9864 "type" : "string",
9865 "typetext" : "<string>"
9866 },
9867 "service" : {
9868 "description" : "Service ID",
9869 "enum" : [
a55e94a6
DM
9870 "clamav-daemon",
9871 "clamav-freshclam",
732d76e1 9872 "fetchmail",
410dc2c9
DM
9873 "pmgproxy",
9874 "pmgdaemon",
a55e94a6 9875 "pmgpolicy",
410dc2c9 9876 "pmg-smtp-filter",
d7cd791b
DM
9877 "pmgtunnel",
9878 "pmgmirror",
9879 "ssh",
9880 "rsyslog",
410dc2c9 9881 "postfix",
d7cd791b 9882 "postgres",
a55e94a6
DM
9883 "systemd-timesyncd",
9884 "pmg-hourly",
d7cd791b 9885 "pmg-daily",
9fda36b0 9886 "pmgreport",
d7cd791b 9887 "pmgspamreport"
410dc2c9
DM
9888 ],
9889 "type" : "string"
9890 }
9891 }
9892 },
732d76e1
DM
9893 "permissions" : {
9894 "check" : [
9895 "admin"
9896 ]
9897 },
410dc2c9
DM
9898 "protected" : 1,
9899 "proxyto" : "node",
9900 "returns" : {
9901 "type" : "string"
9902 }
9903 }
9904 },
9905 "leaf" : 1,
9906 "path" : "/nodes/{node}/services/{service}/start",
9907 "text" : "start"
9908 },
9909 {
9910 "info" : {
9911 "POST" : {
9912 "description" : "Stop service.",
9913 "method" : "POST",
9914 "name" : "service_stop",
9915 "parameters" : {
9916 "additionalProperties" : 0,
9917 "properties" : {
9918 "node" : {
9919 "description" : "The cluster node name.",
9920 "format" : "pve-node",
9921 "type" : "string",
9922 "typetext" : "<string>"
9923 },
9924 "service" : {
9925 "description" : "Service ID",
9926 "enum" : [
a55e94a6
DM
9927 "clamav-daemon",
9928 "clamav-freshclam",
732d76e1 9929 "fetchmail",
410dc2c9
DM
9930 "pmgproxy",
9931 "pmgdaemon",
a55e94a6 9932 "pmgpolicy",
410dc2c9 9933 "pmg-smtp-filter",
d7cd791b
DM
9934 "pmgtunnel",
9935 "pmgmirror",
9936 "ssh",
9937 "rsyslog",
410dc2c9 9938 "postfix",
d7cd791b 9939 "postgres",
a55e94a6
DM
9940 "systemd-timesyncd",
9941 "pmg-hourly",
d7cd791b 9942 "pmg-daily",
9fda36b0 9943 "pmgreport",
d7cd791b 9944 "pmgspamreport"
410dc2c9
DM
9945 ],
9946 "type" : "string"
9947 }
9948 }
9949 },
732d76e1
DM
9950 "permissions" : {
9951 "check" : [
9952 "admin"
9953 ]
9954 },
410dc2c9
DM
9955 "protected" : 1,
9956 "proxyto" : "node",
9957 "returns" : {
9958 "type" : "string"
9959 }
9960 }
9961 },
9962 "leaf" : 1,
9963 "path" : "/nodes/{node}/services/{service}/stop",
9964 "text" : "stop"
9965 },
9966 {
9967 "info" : {
9968 "POST" : {
9969 "description" : "Restart service.",
9970 "method" : "POST",
9971 "name" : "service_restart",
9972 "parameters" : {
9973 "additionalProperties" : 0,
9974 "properties" : {
9975 "node" : {
9976 "description" : "The cluster node name.",
9977 "format" : "pve-node",
9978 "type" : "string",
9979 "typetext" : "<string>"
9980 },
9981 "service" : {
9982 "description" : "Service ID",
9983 "enum" : [
a55e94a6
DM
9984 "clamav-daemon",
9985 "clamav-freshclam",
732d76e1 9986 "fetchmail",
410dc2c9
DM
9987 "pmgproxy",
9988 "pmgdaemon",
a55e94a6 9989 "pmgpolicy",
410dc2c9 9990 "pmg-smtp-filter",
d7cd791b
DM
9991 "pmgtunnel",
9992 "pmgmirror",
9993 "ssh",
9994 "rsyslog",
410dc2c9 9995 "postfix",
d7cd791b 9996 "postgres",
a55e94a6
DM
9997 "systemd-timesyncd",
9998 "pmg-hourly",
d7cd791b 9999 "pmg-daily",
9fda36b0 10000 "pmgreport",
d7cd791b 10001 "pmgspamreport"
410dc2c9
DM
10002 ],
10003 "type" : "string"
10004 }
10005 }
10006 },
732d76e1
DM
10007 "permissions" : {
10008 "check" : [
10009 "admin"
10010 ]
10011 },
410dc2c9
DM
10012 "protected" : 1,
10013 "proxyto" : "node",
10014 "returns" : {
10015 "type" : "string"
10016 }
10017 }
10018 },
10019 "leaf" : 1,
10020 "path" : "/nodes/{node}/services/{service}/restart",
10021 "text" : "restart"
10022 },
10023 {
10024 "info" : {
10025 "POST" : {
10026 "description" : "Reload service.",
10027 "method" : "POST",
10028 "name" : "service_reload",
10029 "parameters" : {
10030 "additionalProperties" : 0,
10031 "properties" : {
10032 "node" : {
10033 "description" : "The cluster node name.",
10034 "format" : "pve-node",
10035 "type" : "string",
10036 "typetext" : "<string>"
10037 },
10038 "service" : {
10039 "description" : "Service ID",
10040 "enum" : [
a55e94a6
DM
10041 "clamav-daemon",
10042 "clamav-freshclam",
732d76e1 10043 "fetchmail",
410dc2c9
DM
10044 "pmgproxy",
10045 "pmgdaemon",
a55e94a6 10046 "pmgpolicy",
410dc2c9 10047 "pmg-smtp-filter",
d7cd791b
DM
10048 "pmgtunnel",
10049 "pmgmirror",
10050 "ssh",
10051 "rsyslog",
410dc2c9 10052 "postfix",
d7cd791b 10053 "postgres",
a55e94a6
DM
10054 "systemd-timesyncd",
10055 "pmg-hourly",
d7cd791b 10056 "pmg-daily",
9fda36b0 10057 "pmgreport",
d7cd791b 10058 "pmgspamreport"
410dc2c9
DM
10059 ],
10060 "type" : "string"
10061 }
10062 }
10063 },
732d76e1
DM
10064 "permissions" : {
10065 "check" : [
10066 "admin"
10067 ]
10068 },
410dc2c9
DM
10069 "protected" : 1,
10070 "proxyto" : "node",
10071 "returns" : {
10072 "type" : "string"
10073 }
10074 }
10075 },
10076 "leaf" : 1,
10077 "path" : "/nodes/{node}/services/{service}/reload",
10078 "text" : "reload"
10079 }
10080 ],
10081 "info" : {
10082 "GET" : {
10083 "description" : "Directory index",
10084 "method" : "GET",
10085 "name" : "srvcmdidx",
10086 "parameters" : {
10087 "additionalProperties" : 0,
10088 "properties" : {
10089 "node" : {
10090 "description" : "The cluster node name.",
10091 "format" : "pve-node",
10092 "type" : "string",
10093 "typetext" : "<string>"
10094 },
10095 "service" : {
10096 "description" : "Service ID",
10097 "enum" : [
a55e94a6
DM
10098 "clamav-daemon",
10099 "clamav-freshclam",
732d76e1 10100 "fetchmail",
410dc2c9
DM
10101 "pmgproxy",
10102 "pmgdaemon",
a55e94a6 10103 "pmgpolicy",
410dc2c9 10104 "pmg-smtp-filter",
d7cd791b
DM
10105 "pmgtunnel",
10106 "pmgmirror",
10107 "ssh",
10108 "rsyslog",
410dc2c9 10109 "postfix",
d7cd791b 10110 "postgres",
a55e94a6
DM
10111 "systemd-timesyncd",
10112 "pmg-hourly",
d7cd791b 10113 "pmg-daily",
9fda36b0 10114 "pmgreport",
d7cd791b 10115 "pmgspamreport"
410dc2c9
DM
10116 ],
10117 "type" : "string"
10118 }
10119 }
10120 },
732d76e1
DM
10121 "permissions" : {
10122 "check" : [
10123 "admin",
10124 "audit"
10125 ]
10126 },
410dc2c9
DM
10127 "returns" : {
10128 "items" : {
10129 "properties" : {
10130 "subdir" : {
10131 "type" : "string"
10132 }
10133 },
10134 "type" : "object"
10135 },
10136 "links" : [
10137 {
10138 "href" : "{subdir}",
10139 "rel" : "child"
10140 }
10141 ],
10142 "type" : "array"
10143 }
10144 }
10145 },
9fda36b0
DM
10146 "leaf" : 0,
10147 "path" : "/nodes/{node}/services/{service}",
10148 "text" : "{service}"
10149 }
10150 ],
10151 "info" : {
10152 "GET" : {
10153 "description" : "Service list.",
10154 "method" : "GET",
10155 "name" : "index",
10156 "parameters" : {
10157 "additionalProperties" : 0,
10158 "properties" : {
10159 "node" : {
10160 "description" : "The cluster node name.",
10161 "format" : "pve-node",
10162 "type" : "string",
10163 "typetext" : "<string>"
10164 }
10165 }
10166 },
732d76e1
DM
10167 "permissions" : {
10168 "check" : [
10169 "admin",
10170 "audit"
10171 ]
10172 },
9fda36b0
DM
10173 "protected" : 1,
10174 "proxyto" : "node",
10175 "returns" : {
10176 "items" : {
10177 "properties" : {},
10178 "type" : "object"
10179 },
10180 "links" : [
10181 {
10182 "href" : "{service}",
10183 "rel" : "child"
10184 }
10185 ],
10186 "type" : "array"
10187 }
10188 }
10189 },
10190 "leaf" : 0,
10191 "path" : "/nodes/{node}/services",
10192 "text" : "services"
10193 },
10194 {
10195 "info" : {
10196 "GET" : {
10197 "description" : "Read subscription info.",
10198 "method" : "GET",
10199 "name" : "get",
10200 "parameters" : {
10201 "additionalProperties" : 0,
10202 "properties" : {
10203 "node" : {
10204 "description" : "The cluster node name.",
10205 "format" : "pve-node",
10206 "type" : "string",
10207 "typetext" : "<string>"
10208 }
10209 }
10210 },
10211 "permissions" : {
10212 "check" : [
10213 "admin",
10214 "qmanager",
10215 "audit",
10216 "quser"
10217 ]
10218 },
10219 "proxyto" : "node",
10220 "returns" : {
10221 "type" : "object"
10222 }
732d76e1
DM
10223 },
10224 "POST" : {
10225 "description" : "Update subscription info.",
10226 "method" : "POST",
10227 "name" : "update",
10228 "parameters" : {
10229 "additionalProperties" : 0,
10230 "properties" : {
10231 "force" : {
10232 "default" : 0,
10233 "description" : "Always connect to server, even if we have up to date info inside local cache.",
10234 "optional" : 1,
10235 "type" : "boolean",
10236 "typetext" : "<boolean>"
10237 },
10238 "node" : {
10239 "description" : "The cluster node name.",
10240 "format" : "pve-node",
10241 "type" : "string",
10242 "typetext" : "<string>"
10243 }
10244 }
10245 },
10246 "permissions" : {
10247 "check" : [
10248 "admin"
10249 ]
10250 },
10251 "protected" : 1,
10252 "proxyto" : "node",
10253 "returns" : {
10254 "type" : "null"
10255 }
10256 },
10257 "PUT" : {
10258 "description" : "Set subscription key.",
10259 "method" : "PUT",
10260 "name" : "set",
10261 "parameters" : {
10262 "additionalProperties" : 0,
10263 "properties" : {
10264 "key" : {
10265 "description" : "Proxmox Mail Gateway subscription key",
10266 "maxLength" : 32,
10267 "pattern" : "pmg([cbsp])-[0-9a-f]{10}",
10268 "type" : "string"
10269 },
10270 "node" : {
10271 "description" : "The cluster node name.",
10272 "format" : "pve-node",
10273 "type" : "string",
10274 "typetext" : "<string>"
10275 }
10276 }
10277 },
10278 "protected" : 1,
10279 "proxyto" : "node",
10280 "returns" : {
10281 "type" : "null"
10282 }
9fda36b0
DM
10283 }
10284 },
10285 "leaf" : 1,
10286 "path" : "/nodes/{node}/subscription",
10287 "text" : "subscription"
10288 },
10289 {
10290 "children" : [
10291 {
10292 "info" : {
10293 "GET" : {
10294 "description" : "List available updates.",
10295 "method" : "GET",
10296 "name" : "list_updates",
10297 "parameters" : {
10298 "additionalProperties" : 0,
10299 "properties" : {
10300 "node" : {
10301 "description" : "The cluster node name.",
10302 "format" : "pve-node",
10303 "type" : "string",
10304 "typetext" : "<string>"
10305 }
10306 }
10307 },
732d76e1
DM
10308 "permissions" : {
10309 "check" : [
10310 "admin",
10311 "audit"
10312 ]
10313 },
9fda36b0
DM
10314 "protected" : 1,
10315 "proxyto" : "node",
10316 "returns" : {
10317 "items" : {
10318 "properties" : {},
10319 "type" : "object"
10320 },
10321 "type" : "array"
10322 }
10323 },
10324 "POST" : {
10325 "description" : "This is used to resynchronize the package index files from their sources (apt-get update).",
10326 "method" : "POST",
10327 "name" : "update_database",
10328 "parameters" : {
10329 "additionalProperties" : 0,
10330 "properties" : {
10331 "node" : {
10332 "description" : "The cluster node name.",
10333 "format" : "pve-node",
10334 "type" : "string",
10335 "typetext" : "<string>"
10336 },
10337 "notify" : {
10338 "default" : 0,
10339 "description" : "Send notification mail about new packages (to email address specified for user 'root@pam').",
10340 "optional" : 1,
10341 "type" : "boolean",
10342 "typetext" : "<boolean>"
10343 },
10344 "quiet" : {
10345 "default" : 0,
10346 "description" : "Only produces output suitable for logging, omitting progress indicators.",
10347 "optional" : 1,
10348 "type" : "boolean",
10349 "typetext" : "<boolean>"
10350 }
10351 }
10352 },
732d76e1
DM
10353 "permissions" : {
10354 "check" : [
10355 "admin"
10356 ]
10357 },
9fda36b0
DM
10358 "protected" : 1,
10359 "proxyto" : "node",
10360 "returns" : {
10361 "type" : "string"
10362 }
10363 }
10364 },
10365 "leaf" : 1,
10366 "path" : "/nodes/{node}/apt/update",
10367 "text" : "update"
10368 },
10369 {
10370 "info" : {
10371 "GET" : {
10372 "description" : "Get package changelogs.",
10373 "method" : "GET",
10374 "name" : "changelog",
10375 "parameters" : {
10376 "additionalProperties" : 0,
10377 "properties" : {
10378 "name" : {
10379 "description" : "Package name.",
10380 "type" : "string",
10381 "typetext" : "<string>"
10382 },
10383 "node" : {
10384 "description" : "The cluster node name.",
10385 "format" : "pve-node",
10386 "type" : "string",
10387 "typetext" : "<string>"
10388 },
10389 "version" : {
10390 "description" : "Package version.",
10391 "optional" : 1,
10392 "type" : "string",
10393 "typetext" : "<string>"
10394 }
10395 }
10396 },
732d76e1
DM
10397 "permissions" : {
10398 "check" : [
10399 "admin",
10400 "audit"
10401 ]
10402 },
9fda36b0
DM
10403 "proxyto" : "node",
10404 "returns" : {
10405 "type" : "string"
10406 }
10407 }
10408 },
10409 "leaf" : 1,
10410 "path" : "/nodes/{node}/apt/changelog",
10411 "text" : "changelog"
10412 },
10413 {
10414 "info" : {
10415 "GET" : {
10416 "description" : "Get package information for important Proxmox packages.",
10417 "method" : "GET",
10418 "name" : "versions",
10419 "parameters" : {
10420 "additionalProperties" : 0,
10421 "properties" : {
10422 "node" : {
10423 "description" : "The cluster node name.",
10424 "format" : "pve-node",
10425 "type" : "string",
10426 "typetext" : "<string>"
10427 }
10428 }
10429 },
10430 "permissions" : {
10431 "check" : [
732d76e1
DM
10432 "admin",
10433 "audit"
9fda36b0
DM
10434 ]
10435 },
10436 "proxyto" : "node",
10437 "returns" : {
10438 "items" : {
10439 "properties" : {},
10440 "type" : "object"
10441 },
10442 "type" : "array"
10443 }
10444 }
10445 },
10446 "leaf" : 1,
10447 "path" : "/nodes/{node}/apt/versions",
10448 "text" : "versions"
10449 }
10450 ],
10451 "info" : {
10452 "GET" : {
10453 "description" : "Directory index for apt (Advanced Package Tool).",
10454 "method" : "GET",
10455 "name" : "index",
10456 "parameters" : {
10457 "additionalProperties" : 0,
10458 "properties" : {
10459 "node" : {
10460 "description" : "The cluster node name.",
10461 "format" : "pve-node",
10462 "type" : "string",
10463 "typetext" : "<string>"
10464 }
10465 }
10466 },
10467 "permissions" : {
10468 "user" : "all"
10469 },
10470 "returns" : {
10471 "items" : {
10472 "properties" : {
10473 "id" : {
10474 "type" : "string"
10475 }
10476 },
10477 "type" : "object"
10478 },
10479 "links" : [
10480 {
10481 "href" : "{id}",
10482 "rel" : "child"
10483 }
10484 ],
10485 "type" : "array"
10486 }
10487 }
10488 },
10489 "leaf" : 0,
10490 "path" : "/nodes/{node}/apt",
10491 "text" : "apt"
10492 },
10493 {
10494 "children" : [
10495 {
10496 "info" : {
10497 "GET" : {
10498 "description" : "Get the detailed syslog entries for a specific mail ID.",
10499 "method" : "GET",
10500 "name" : "maillog",
10501 "parameters" : {
10502 "additionalProperties" : 0,
10503 "properties" : {
10504 "endtime" : {
10505 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
10506 "minimum" : 1,
10507 "optional" : 1,
10508 "type" : "integer",
10509 "typetext" : "<integer> (1 - N)"
10510 },
10511 "id" : {
10512 "description" : "Mail ID (as returend by the list API).",
10513 "maxLength" : 64,
10514 "minLength" : 3,
10515 "type" : "string",
10516 "typetext" : "<string>"
10517 },
10518 "node" : {
10519 "description" : "The cluster node name.",
10520 "format" : "pve-node",
10521 "type" : "string",
10522 "typetext" : "<string>"
10523 },
10524 "starttime" : {
10525 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
10526 "minimum" : 0,
10527 "optional" : 1,
10528 "type" : "integer",
10529 "typetext" : "<integer> (0 - N)"
10530 }
10531 }
10532 },
732d76e1
DM
10533 "permissions" : {
10534 "check" : [
10535 "admin",
10536 "audit"
10537 ]
10538 },
9fda36b0
DM
10539 "protected" : 1,
10540 "proxyto" : "node",
10541 "returns" : {
10542 "properties" : {
10543 "client" : {
10544 "description" : "Client address",
10545 "optional" : 1,
10546 "type" : "string"
10547 },
10548 "dstatus" : {
10549 "description" : "Delivery status.",
10550 "maxLength" : 1,
10551 "minLength" : 1,
10552 "type" : "string"
10553 },
10554 "from" : {
10555 "description" : "Sender email address.",
10556 "type" : "string"
10557 },
10558 "id" : {
10559 "description" : "Unique ID.",
10560 "type" : "string"
10561 },
10562 "logs" : {
10563 "items" : {
10564 "type" : "string"
10565 },
10566 "type" : "array"
10567 },
10568 "msgid" : {
10569 "description" : "SMTP message ID.",
10570 "optional" : 1,
10571 "type" : "string"
10572 },
10573 "qid" : {
10574 "description" : "Postfix qmgr ID.",
10575 "optional" : 1,
10576 "type" : "string"
10577 },
10578 "relay" : {
10579 "description" : "ID of relayed mail.",
10580 "optional" : 1,
10581 "type" : "string"
10582 },
10583 "rstatus" : {
10584 "description" : "Delivery status of relayed mail.",
10585 "maxLength" : 1,
10586 "minLength" : 1,
10587 "optional" : 1,
10588 "type" : "string"
10589 },
10590 "size" : {
10591 "description" : "The size of the raw email.",
10592 "optional" : 1,
10593 "type" : "number"
10594 },
10595 "time" : {
10596 "description" : "Delivery timestamp.",
10597 "type" : "integer"
10598 },
10599 "to" : {
10600 "description" : "Receiver email address.",
10601 "type" : "string"
10602 }
10603 },
10604 "type" : "object"
10605 }
10606 }
10607 },
10608 "leaf" : 1,
10609 "path" : "/nodes/{node}/tracker/{id}",
10610 "text" : "{id}"
10611 }
10612 ],
10613 "info" : {
10614 "GET" : {
10615 "description" : "Read mail list.",
10616 "method" : "GET",
10617 "name" : "list_mails",
10618 "parameters" : {
10619 "additionalProperties" : 0,
10620 "properties" : {
10621 "endtime" : {
10622 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
10623 "minimum" : 1,
10624 "optional" : 1,
10625 "type" : "integer",
10626 "typetext" : "<integer> (1 - N)"
10627 },
10628 "from" : {
10629 "description" : "Sender email address filter.",
10630 "maxLength" : 256,
10631 "minLength" : 1,
10632 "optional" : 1,
10633 "type" : "string",
10634 "typetext" : "<string>"
10635 },
10636 "greylist" : {
10637 "default" : 0,
10638 "description" : "Include Greylisted entries.",
10639 "optional" : 1,
10640 "type" : "boolean",
10641 "typetext" : "<boolean>"
10642 },
10643 "ndr" : {
10644 "default" : 0,
10645 "description" : "Include NDRs (non delivery reports).",
10646 "optional" : 1,
10647 "type" : "boolean",
10648 "typetext" : "<boolean>"
10649 },
10650 "node" : {
10651 "description" : "The cluster node name.",
10652 "format" : "pve-node",
10653 "type" : "string",
10654 "typetext" : "<string>"
10655 },
10656 "starttime" : {
10657 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
10658 "minimum" : 0,
10659 "optional" : 1,
10660 "type" : "integer",
10661 "typetext" : "<integer> (0 - N)"
10662 },
10663 "target" : {
10664 "description" : "Receiver email address filter.",
10665 "maxLength" : 256,
10666 "minLength" : 1,
10667 "optional" : 1,
10668 "type" : "string",
10669 "typetext" : "<string>"
10670 },
10671 "xfilter" : {
10672 "description" : "Only include mails containing this filter string.",
10673 "maxLength" : 256,
10674 "minLength" : 1,
10675 "optional" : 1,
10676 "type" : "string",
10677 "typetext" : "<string>"
10678 }
10679 }
10680 },
732d76e1
DM
10681 "permissions" : {
10682 "check" : [
10683 "admin",
10684 "audit"
10685 ]
10686 },
9fda36b0
DM
10687 "protected" : 1,
10688 "proxyto" : "node",
10689 "returns" : {
10690 "items" : {
10691 "properties" : {
10692 "client" : {
10693 "description" : "Client address",
10694 "optional" : 1,
10695 "type" : "string"
10696 },
10697 "dstatus" : {
10698 "description" : "Delivery status.",
10699 "maxLength" : 1,
10700 "minLength" : 1,
10701 "type" : "string"
10702 },
10703 "from" : {
10704 "description" : "Sender email address.",
10705 "type" : "string"
10706 },
10707 "id" : {
10708 "description" : "Unique ID.",
10709 "type" : "string"
10710 },
10711 "msgid" : {
10712 "description" : "SMTP message ID.",
10713 "optional" : 1,
10714 "type" : "string"
10715 },
10716 "qid" : {
10717 "description" : "Postfix qmgr ID.",
10718 "optional" : 1,
10719 "type" : "string"
10720 },
10721 "relay" : {
10722 "description" : "ID of relayed mail.",
10723 "optional" : 1,
10724 "type" : "string"
10725 },
10726 "rstatus" : {
10727 "description" : "Delivery status of relayed mail.",
10728 "maxLength" : 1,
10729 "minLength" : 1,
10730 "optional" : 1,
10731 "type" : "string"
10732 },
10733 "size" : {
10734 "description" : "The size of the raw email.",
10735 "optional" : 1,
10736 "type" : "number"
10737 },
10738 "time" : {
10739 "description" : "Delivery timestamp.",
10740 "type" : "integer"
10741 },
10742 "to" : {
10743 "description" : "Receiver email address.",
10744 "type" : "string"
10745 }
10746 },
10747 "type" : "object"
10748 },
10749 "links" : [
10750 {
10751 "href" : "{id}",
10752 "rel" : "child"
10753 }
10754 ],
10755 "type" : "array"
10756 }
10757 }
10758 },
10759 "leaf" : 0,
10760 "path" : "/nodes/{node}/tracker",
10761 "text" : "tracker"
10762 },
bb6e6e0d
DM
10763 {
10764 "children" : [
10765 {
10766 "info" : {
10767 "DELETE" : {
10768 "description" : "Delete a backup file.",
10769 "method" : "DELETE",
10770 "name" : "delete",
10771 "parameters" : {
10772 "additionalProperties" : 0,
10773 "properties" : {
10774 "filename" : {
10775 "description" : "The backup file name.",
10776 "maxLength" : 256,
10777 "minLength" : 4,
10778 "pattern" : "pmg-backup_[0-9A-Za-z_-]+\\.tgz",
10779 "type" : "string"
10780 },
10781 "node" : {
10782 "description" : "The cluster node name.",
10783 "format" : "pve-node",
10784 "type" : "string",
10785 "typetext" : "<string>"
10786 }
10787 }
10788 },
10789 "permissions" : {
10790 "check" : [
10791 "admin"
10792 ]
10793 },
10794 "protected" : 1,
10795 "proxyto" : "node",
10796 "returns" : {
10797 "type" : "null"
10798 }
10799 },
10800 "GET" : {
10801 "description" : "Download a backup file.",
10802 "download" : 1,
10803 "method" : "GET",
10804 "name" : "download",
10805 "parameters" : {
10806 "additionalProperties" : 0,
10807 "properties" : {
10808 "filename" : {
10809 "description" : "The backup file name.",
10810 "maxLength" : 256,
10811 "minLength" : 4,
10812 "pattern" : "pmg-backup_[0-9A-Za-z_-]+\\.tgz",
10813 "type" : "string"
10814 },
10815 "node" : {
10816 "description" : "The cluster node name.",
10817 "format" : "pve-node",
10818 "type" : "string",
10819 "typetext" : "<string>"
10820 }
10821 }
10822 },
10823 "permissions" : {
10824 "check" : [
10825 "admin"
10826 ]
10827 },
10828 "protected" : 1,
10829 "proxyto" : "node",
10830 "returns" : {
10831 "type" : "string"
10832 }
10833 },
10834 "POST" : {
10835 "description" : "Restore the system configuration.",
10836 "method" : "POST",
10837 "name" : "restore",
10838 "parameters" : {
10839 "additionalProperties" : 0,
10840 "properties" : {
10841 "config" : {
10842 "default" : 0,
10843 "description" : "Restore system configuration.",
10844 "optional" : 1,
10845 "type" : "boolean",
10846 "typetext" : "<boolean>"
10847 },
10848 "database" : {
10849 "default" : 1,
10850 "description" : "Restore the rule database. This is the default.",
10851 "optional" : 1,
10852 "type" : "boolean",
10853 "typetext" : "<boolean>"
10854 },
10855 "filename" : {
10856 "description" : "The backup file name.",
10857 "maxLength" : 256,
10858 "minLength" : 4,
10859 "pattern" : "pmg-backup_[0-9A-Za-z_-]+\\.tgz",
10860 "type" : "string"
10861 },
10862 "node" : {
10863 "description" : "The cluster node name.",
10864 "format" : "pve-node",
10865 "type" : "string",
10866 "typetext" : "<string>"
10867 },
10868 "statistic" : {
10869 "default" : 0,
10870 "description" : "Restore statistic databases. Only considered when you restore the 'database'.",
10871 "optional" : 1,
10872 "type" : "boolean",
10873 "typetext" : "<boolean>"
10874 }
10875 }
10876 },
10877 "permissions" : {
10878 "check" : [
10879 "admin"
10880 ]
10881 },
10882 "protected" : 1,
10883 "proxyto" : "node",
10884 "returns" : {
10885 "type" : "string"
10886 }
10887 }
10888 },
10889 "leaf" : 1,
10890 "path" : "/nodes/{node}/backup/{filename}",
10891 "text" : "{filename}"
10892 }
10893 ],
10894 "info" : {
10895 "GET" : {
10896 "description" : "List all stored backups (files named proxmox-backup_{DATE}.tgz).",
10897 "method" : "GET",
10898 "name" : "list",
10899 "parameters" : {
10900 "additionalProperties" : 0,
10901 "properties" : {
10902 "node" : {
10903 "description" : "The cluster node name.",
10904 "format" : "pve-node",
10905 "type" : "string",
10906 "typetext" : "<string>"
10907 }
10908 }
10909 },
10910 "permissions" : {
10911 "check" : [
10912 "admin",
10913 "audit"
10914 ]
10915 },
10916 "protected" : 1,
10917 "proxyto" : "node",
10918 "returns" : {
10919 "items" : {
10920 "properties" : {
10921 "filename" : {
10922 "description" : "The backup file name.",
10923 "maxLength" : 256,
10924 "minLength" : 4,
10925 "pattern" : "pmg-backup_[0-9A-Za-z_-]+\\.tgz",
10926 "type" : "string"
10927 },
10928 "size" : {
10929 "description" : "Size of backup file in bytes.",
10930 "type" : "integer"
10931 },
10932 "timestamp" : {
10933 "description" : "Backup timestamp (Unix epoch).",
10934 "type" : "integer"
10935 }
10936 },
10937 "type" : "object"
10938 },
10939 "links" : [
10940 {
10941 "href" : "{filename}",
10942 "rel" : "child"
10943 }
10944 ],
10945 "type" : "array"
10946 }
10947 },
10948 "POST" : {
10949 "description" : "Backup the system configuration.",
10950 "method" : "POST",
10951 "name" : "backup",
10952 "parameters" : {
10953 "additionalProperties" : 0,
10954 "properties" : {
10955 "node" : {
10956 "description" : "The cluster node name.",
10957 "format" : "pve-node",
10958 "type" : "string",
10959 "typetext" : "<string>"
10960 },
10961 "statistic" : {
10962 "default" : 1,
10963 "description" : "Backup statistic databases.",
10964 "optional" : 1,
10965 "type" : "boolean",
10966 "typetext" : "<boolean>"
10967 }
10968 }
10969 },
10970 "permissions" : {
10971 "check" : [
10972 "admin"
10973 ]
10974 },
10975 "protected" : 1,
10976 "proxyto" : "node",
10977 "returns" : {
10978 "type" : "string"
10979 }
10980 }
10981 },
10982 "leaf" : 0,
10983 "path" : "/nodes/{node}/backup",
10984 "text" : "backup"
10985 },
9fda36b0
DM
10986 {
10987 "info" : {
10988 "GET" : {
10989 "description" : "Read node RRD statistics",
10990 "method" : "GET",
10991 "name" : "rrddata",
10992 "parameters" : {
10993 "additionalProperties" : 0,
10994 "properties" : {
10995 "cf" : {
10996 "description" : "The RRD consolidation function",
10997 "enum" : [
10998 "AVERAGE",
10999 "MAX"
11000 ],
11001 "optional" : 1,
11002 "type" : "string"
11003 },
11004 "node" : {
11005 "description" : "The cluster node name.",
11006 "format" : "pve-node",
11007 "type" : "string",
11008 "typetext" : "<string>"
11009 },
11010 "timeframe" : {
11011 "description" : "Specify the time frame you are interested in.",
11012 "enum" : [
11013 "hour",
11014 "day",
11015 "week",
11016 "month",
11017 "year"
11018 ],
11019 "type" : "string"
11020 }
11021 }
11022 },
732d76e1
DM
11023 "permissions" : {
11024 "check" : [
11025 "admin",
11026 "audit"
11027 ]
11028 },
9fda36b0
DM
11029 "protected" : 1,
11030 "proxyto" : "node",
11031 "returns" : {
11032 "items" : {
11033 "properties" : {},
11034 "type" : "object"
11035 },
11036 "type" : "array"
11037 }
11038 }
11039 },
11040 "leaf" : 1,
11041 "path" : "/nodes/{node}/rrddata",
11042 "text" : "rrddata"
11043 },
11044 {
11045 "info" : {
11046 "GET" : {
11047 "description" : "Read system log",
11048 "method" : "GET",
11049 "name" : "syslog",
11050 "parameters" : {
11051 "additionalProperties" : 0,
11052 "properties" : {
11053 "limit" : {
11054 "minimum" : 0,
11055 "optional" : 1,
11056 "type" : "integer",
11057 "typetext" : "<integer> (0 - N)"
11058 },
11059 "node" : {
11060 "description" : "The cluster node name.",
11061 "format" : "pve-node",
11062 "type" : "string",
11063 "typetext" : "<string>"
11064 },
11065 "service" : {
11066 "description" : "Service ID",
11067 "maxLength" : 128,
11068 "optional" : 1,
11069 "type" : "string",
11070 "typetext" : "<string>"
11071 },
11072 "since" : {
11073 "description" : "Display all log since this date-time string.",
11074 "optional" : 1,
11075 "pattern" : "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
11076 "type" : "string"
11077 },
11078 "start" : {
11079 "minimum" : 0,
11080 "optional" : 1,
11081 "type" : "integer",
11082 "typetext" : "<integer> (0 - N)"
11083 },
11084 "until" : {
11085 "description" : "Display all log until this date-time string.",
11086 "optional" : 1,
11087 "pattern" : "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
11088 "type" : "string"
11089 }
11090 }
11091 },
732d76e1
DM
11092 "permissions" : {
11093 "check" : [
11094 "admin",
11095 "audit"
11096 ]
11097 },
9fda36b0
DM
11098 "protected" : 1,
11099 "proxyto" : "node",
11100 "returns" : {
11101 "items" : {
11102 "properties" : {
11103 "n" : {
11104 "description" : "Line number",
11105 "type" : "integer"
11106 },
11107 "t" : {
11108 "description" : "Line text",
11109 "type" : "string"
11110 }
11111 },
11112 "type" : "object"
11113 },
11114 "type" : "array"
11115 }
11116 }
11117 },
11118 "leaf" : 1,
11119 "path" : "/nodes/{node}/syslog",
11120 "text" : "syslog"
11121 },
11122 {
11123 "info" : {
11124 "POST" : {
274b47fc 11125 "description" : "Creates a Terminal proxy.",
9fda36b0 11126 "method" : "POST",
274b47fc 11127 "name" : "termproxy",
9fda36b0
DM
11128 "parameters" : {
11129 "additionalProperties" : 0,
11130 "properties" : {
11131 "node" : {
11132 "description" : "The cluster node name.",
11133 "format" : "pve-node",
11134 "type" : "string",
11135 "typetext" : "<string>"
11136 },
11137 "upgrade" : {
11138 "default" : 0,
11139 "description" : "Run 'apt-get dist-upgrade' instead of normal shell.",
11140 "optional" : 1,
11141 "type" : "boolean",
11142 "typetext" : "<boolean>"
9fda36b0
DM
11143 }
11144 }
11145 },
274b47fc
DM
11146 "permissions" : {
11147 "check" : [
11148 "admin"
11149 ]
11150 },
9fda36b0
DM
11151 "protected" : 1,
11152 "returns" : {
11153 "additionalProperties" : 0,
11154 "properties" : {
11155 "port" : {
11156 "type" : "integer"
11157 },
11158 "ticket" : {
11159 "type" : "string"
11160 },
11161 "upid" : {
11162 "type" : "string"
11163 },
11164 "user" : {
11165 "type" : "string"
11166 }
11167 }
11168 }
11169 }
11170 },
11171 "leaf" : 1,
274b47fc
DM
11172 "path" : "/nodes/{node}/termproxy",
11173 "text" : "termproxy"
9fda36b0
DM
11174 },
11175 {
11176 "info" : {
11177 "GET" : {
11178 "description" : "Opens a weksocket for VNC traffic.",
11179 "method" : "GET",
11180 "name" : "vncwebsocket",
11181 "parameters" : {
11182 "additionalProperties" : 0,
11183 "properties" : {
11184 "node" : {
11185 "description" : "The cluster node name.",
11186 "format" : "pve-node",
11187 "type" : "string",
11188 "typetext" : "<string>"
11189 },
11190 "port" : {
11191 "description" : "Port number returned by previous vncproxy call.",
11192 "maximum" : 5999,
11193 "minimum" : 5900,
11194 "type" : "integer",
11195 "typetext" : "<integer> (5900 - 5999)"
11196 },
11197 "vncticket" : {
11198 "description" : "Ticket from previous call to vncproxy.",
11199 "maxLength" : 512,
11200 "type" : "string",
11201 "typetext" : "<string>"
11202 }
11203 }
11204 },
274b47fc
DM
11205 "permissions" : {
11206 "check" : [
11207 "admin"
11208 ]
11209 },
9fda36b0
DM
11210 "returns" : {
11211 "properties" : {
11212 "port" : {
11213 "type" : "string"
11214 }
11215 },
11216 "type" : "object"
11217 }
11218 }
11219 },
11220 "leaf" : 1,
11221 "path" : "/nodes/{node}/vncwebsocket",
11222 "text" : "vncwebsocket"
11223 },
11224 {
11225 "info" : {
11226 "GET" : {
11227 "description" : "Read DNS settings.",
11228 "method" : "GET",
11229 "name" : "dns",
11230 "parameters" : {
11231 "additionalProperties" : 0,
11232 "properties" : {
11233 "node" : {
11234 "description" : "The cluster node name.",
11235 "format" : "pve-node",
11236 "type" : "string",
11237 "typetext" : "<string>"
11238 }
11239 }
11240 },
732d76e1
DM
11241 "permissions" : {
11242 "check" : [
11243 "admin",
11244 "audit"
11245 ]
11246 },
9fda36b0
DM
11247 "proxyto" : "node",
11248 "returns" : {
11249 "additionalProperties" : 0,
11250 "properties" : {
11251 "dns1" : {
11252 "description" : "First name server IP address.",
11253 "optional" : 1,
11254 "type" : "string"
11255 },
11256 "dns2" : {
11257 "description" : "Second name server IP address.",
11258 "optional" : 1,
11259 "type" : "string"
11260 },
11261 "dns3" : {
11262 "description" : "Third name server IP address.",
11263 "optional" : 1,
11264 "type" : "string"
11265 },
11266 "search" : {
11267 "description" : "Search domain for host-name lookup.",
11268 "optional" : 1,
11269 "type" : "string"
11270 }
11271 },
11272 "type" : "object"
11273 }
11274 },
11275 "PUT" : {
11276 "description" : "Write DNS settings.",
11277 "method" : "PUT",
11278 "name" : "update_dns",
11279 "parameters" : {
11280 "additionalProperties" : 0,
11281 "properties" : {
11282 "dns1" : {
11283 "description" : "First name server IP address.",
11284 "format" : "ip",
11285 "optional" : 1,
11286 "type" : "string",
11287 "typetext" : "<string>"
11288 },
11289 "dns2" : {
11290 "description" : "Second name server IP address.",
11291 "format" : "ip",
11292 "optional" : 1,
11293 "type" : "string",
11294 "typetext" : "<string>"
11295 },
11296 "dns3" : {
11297 "description" : "Third name server IP address.",
11298 "format" : "ip",
11299 "optional" : 1,
11300 "type" : "string",
11301 "typetext" : "<string>"
11302 },
11303 "node" : {
11304 "description" : "The cluster node name.",
11305 "format" : "pve-node",
11306 "type" : "string",
11307 "typetext" : "<string>"
11308 },
11309 "search" : {
11310 "description" : "Search domain for host-name lookup.",
11311 "type" : "string",
11312 "typetext" : "<string>"
11313 }
11314 }
11315 },
11316 "protected" : 1,
11317 "proxyto" : "node",
11318 "returns" : {
11319 "type" : "null"
11320 }
11321 }
11322 },
11323 "leaf" : 1,
11324 "path" : "/nodes/{node}/dns",
11325 "text" : "dns"
11326 },
11327 {
11328 "info" : {
11329 "GET" : {
11330 "description" : "Read server time and time zone settings.",
11331 "method" : "GET",
11332 "name" : "time",
11333 "parameters" : {
11334 "additionalProperties" : 0,
11335 "properties" : {
11336 "node" : {
11337 "description" : "The cluster node name.",
11338 "format" : "pve-node",
11339 "type" : "string",
11340 "typetext" : "<string>"
11341 }
11342 }
11343 },
732d76e1
DM
11344 "permissions" : {
11345 "check" : [
11346 "admin",
11347 "audit"
11348 ]
11349 },
9fda36b0
DM
11350 "proxyto" : "node",
11351 "returns" : {
11352 "additionalProperties" : 0,
11353 "properties" : {
11354 "localtime" : {
11355 "description" : "Seconds since 1970-01-01 00:00:00 (local time)",
11356 "minimum" : 1297163644,
11357 "type" : "integer"
11358 },
11359 "time" : {
11360 "description" : "Seconds since 1970-01-01 00:00:00 UTC.",
11361 "minimum" : 1297163644,
11362 "type" : "integer"
11363 },
11364 "timezone" : {
11365 "description" : "Time zone",
11366 "type" : "string"
11367 }
11368 },
11369 "type" : "object"
11370 }
11371 },
11372 "PUT" : {
11373 "description" : "Set time zone.",
11374 "method" : "PUT",
11375 "name" : "set_timezone",
11376 "parameters" : {
11377 "additionalProperties" : 0,
11378 "properties" : {
11379 "node" : {
11380 "description" : "The cluster node name.",
11381 "format" : "pve-node",
11382 "type" : "string",
11383 "typetext" : "<string>"
11384 },
11385 "timezone" : {
11386 "description" : "Time zone. The file '/usr/share/zoneinfo/zone.tab' contains the list of valid names.",
11387 "type" : "string",
11388 "typetext" : "<string>"
11389 }
11390 }
11391 },
11392 "protected" : 1,
11393 "proxyto" : "node",
11394 "returns" : {
11395 "type" : "null"
11396 }
11397 }
11398 },
11399 "leaf" : 1,
11400 "path" : "/nodes/{node}/time",
11401 "text" : "time"
11402 },
11403 {
11404 "info" : {
11405 "GET" : {
11406 "description" : "Read server status. This is used by the cluster manager to test the node health.",
11407 "method" : "GET",
11408 "name" : "status",
11409 "parameters" : {
11410 "additionalProperties" : 0,
11411 "properties" : {
11412 "node" : {
11413 "description" : "The cluster node name.",
11414 "format" : "pve-node",
11415 "type" : "string",
11416 "typetext" : "<string>"
11417 }
11418 }
11419 },
11420 "protected" : 1,
11421 "proxyto" : "node",
11422 "returns" : {
11423 "additionalProperties" : 1,
11424 "properties" : {
11425 "insync" : {
11426 "description" : "Database is synced with other nodes.",
11427 "type" : "boolean"
11428 },
11429 "time" : {
11430 "description" : "Seconds since 1970-01-01 00:00:00 UTC.",
11431 "minimum" : 1297163644,
11432 "type" : "integer"
11433 },
11434 "uptime" : {
11435 "description" : "The uptime of the system in seconds.",
11436 "minimum" : 0,
11437 "type" : "integer"
11438 }
11439 },
11440 "type" : "object"
11441 }
274b47fc
DM
11442 },
11443 "POST" : {
11444 "description" : "Reboot or shutdown a node.",
11445 "method" : "POST",
11446 "name" : "node_cmd",
11447 "parameters" : {
11448 "additionalProperties" : 0,
11449 "properties" : {
11450 "command" : {
11451 "description" : "Specify the command.",
11452 "enum" : [
11453 "reboot",
11454 "shutdown"
11455 ],
11456 "type" : "string"
11457 },
11458 "node" : {
11459 "description" : "The cluster node name.",
11460 "format" : "pve-node",
11461 "type" : "string",
11462 "typetext" : "<string>"
11463 }
11464 }
11465 },
11466 "permissions" : {
11467 "check" : [
11468 "admin"
11469 ]
11470 },
11471 "protected" : 1,
11472 "proxyto" : "node",
11473 "returns" : {
11474 "type" : "null"
11475 }
9fda36b0
DM
11476 }
11477 },
11478 "leaf" : 1,
11479 "path" : "/nodes/{node}/status",
11480 "text" : "status"
11481 }
11482 ],
11483 "info" : {
11484 "GET" : {
11485 "description" : "Node index.",
11486 "method" : "GET",
11487 "name" : "index",
11488 "parameters" : {
11489 "additionalProperties" : 0,
11490 "properties" : {
11491 "node" : {
11492 "description" : "The cluster node name.",
11493 "format" : "pve-node",
11494 "type" : "string",
11495 "typetext" : "<string>"
11496 }
11497 }
11498 },
11499 "permissions" : {
11500 "user" : "all"
11501 },
11502 "returns" : {
11503 "items" : {
11504 "properties" : {},
11505 "type" : "object"
11506 },
11507 "links" : [
11508 {
11509 "href" : "{name}",
11510 "rel" : "child"
11511 }
11512 ],
11513 "type" : "array"
11514 }
11515 }
11516 },
11517 "leaf" : 0,
11518 "path" : "/nodes/{node}",
11519 "text" : "{node}"
11520 }
11521 ],
11522 "info" : {
11523 "GET" : {
11524 "description" : "Cluster node index.",
11525 "method" : "GET",
11526 "name" : "index",
11527 "parameters" : {
11528 "additionalProperties" : 0
11529 },
11530 "permissions" : {
11531 "user" : "all"
11532 },
11533 "returns" : {
11534 "items" : {
11535 "properties" : {},
11536 "type" : "object"
11537 },
11538 "links" : [
11539 {
11540 "href" : "{node}",
11541 "rel" : "child"
11542 }
11543 ],
11544 "type" : "array"
11545 }
11546 }
11547 },
11548 "leaf" : 0,
11549 "path" : "/nodes",
11550 "text" : "nodes"
11551 },
11552 {
11553 "children" : [
11554 {
11555 "children" : [
11556 {
11557 "info" : {
11558 "DELETE" : {
11559 "description" : "Delete a user.",
11560 "method" : "DELETE",
11561 "name" : "delete",
11562 "parameters" : {
11563 "additionalProperties" : 0,
11564 "properties" : {
11565 "userid" : {
11566 "description" : "User ID",
11567 "format" : "pmg-userid",
11568 "maxLength" : 64,
11569 "minLength" : 4,
11570 "type" : "string",
11571 "typetext" : "<string>"
11572 }
11573 }
11574 },
11575 "protected" : 1,
11576 "proxyto" : "master",
11577 "returns" : {
11578 "type" : "null"
11579 }
11580 },
11581 "GET" : {
11582 "description" : "Read User data.",
11583 "method" : "GET",
11584 "name" : "read",
11585 "parameters" : {
11586 "additionalProperties" : 0,
11587 "properties" : {
11588 "userid" : {
11589 "description" : "User ID",
11590 "format" : "pmg-userid",
11591 "maxLength" : 64,
11592 "minLength" : 4,
11593 "type" : "string",
11594 "typetext" : "<string>"
11595 }
11596 }
11597 },
4a46ced6
DM
11598 "permissions" : {
11599 "check" : [
11600 "admin",
11601 "qmanager",
11602 "audit"
11603 ]
11604 },
9fda36b0
DM
11605 "protected" : 1,
11606 "proxyto" : "master",
11607 "returns" : {
11608 "properties" : {},
11609 "type" : "object"
11610 }
11611 },
11612 "PUT" : {
11613 "description" : "Update user data.",
11614 "method" : "PUT",
11615 "name" : "write",
11616 "parameters" : {
11617 "additionalProperties" : 0,
11618 "properties" : {
11619 "comment" : {
11620 "description" : "Comment.",
11621 "optional" : 1,
11622 "type" : "string",
11623 "typetext" : "<string>"
11624 },
11625 "crypt_pass" : {
11626 "description" : "Encrypted password (see `man crypt`)",
11627 "optional" : 1,
11628 "pattern" : "\\$\\d\\$[a-zA-Z0-9\\.\\/]+\\$[a-zA-Z0-9\\.\\/]+",
11629 "type" : "string"
11630 },
11631 "delete" : {
11632 "description" : "A list of settings you want to delete.",
11633 "format" : "pve-configid-list",
11634 "maxLength" : 4096,
11635 "optional" : 1,
11636 "type" : "string",
11637 "typetext" : "<string>"
11638 },
11639 "email" : {
11640 "description" : "Users E-Mail address.",
11641 "format" : "email",
11642 "optional" : 1,
11643 "type" : "string",
11644 "typetext" : "<string>"
11645 },
11646 "enable" : {
11647 "default" : 0,
11648 "description" : "Flag to enable or disable the account.",
11649 "optional" : 1,
11650 "type" : "boolean",
11651 "typetext" : "<boolean>"
11652 },
11653 "expire" : {
11654 "default" : 0,
11655 "description" : "Account expiration date (seconds since epoch). '0' means no expiration date.",
11656 "minimum" : 0,
11657 "optional" : 1,
11658 "type" : "integer",
11659 "typetext" : "<integer> (0 - N)"
11660 },
11661 "firstname" : {
11662 "description" : "First name.",
11663 "maxLength" : 64,
11664 "optional" : 1,
11665 "type" : "string",
11666 "typetext" : "<string>"
11667 },
11668 "keys" : {
11669 "description" : "Keys for two factor auth (yubico).",
11670 "maxLength" : 128,
11671 "optional" : 1,
11672 "type" : "string",
11673 "typetext" : "<string>"
11674 },
11675 "lastname" : {
11676 "description" : "Last name.",
11677 "maxLength" : 64,
11678 "optional" : 1,
11679 "type" : "string",
11680 "typetext" : "<string>"
11681 },
11682 "password" : {
11683 "description" : "Password",
11684 "maxLength" : 32,
11685 "minLength" : 5,
11686 "optional" : 1,
11687 "type" : "string",
11688 "typetext" : "<string>"
11689 },
11690 "role" : {
11691 "description" : "User role. Role 'root' is reseved for the Unix Superuser.",
11692 "enum" : [
11693 "root",
11694 "admin",
11695 "qmanager",
11696 "audit"
11697 ],
11698 "optional" : 1,
11699 "type" : "string"
11700 },
11701 "userid" : {
11702 "description" : "User ID",
11703 "format" : "pmg-userid",
11704 "maxLength" : 64,
11705 "minLength" : 4,
11706 "type" : "string",
11707 "typetext" : "<string>"
11708 }
11709 }
11710 },
11711 "protected" : 1,
11712 "proxyto" : "master",
11713 "returns" : {
11714 "type" : "null"
11715 }
11716 }
11717 },
11718 "leaf" : 1,
11719 "path" : "/access/users/{userid}",
11720 "text" : "{userid}"
11721 }
11722 ],
11723 "info" : {
11724 "GET" : {
11725 "description" : "List users.",
11726 "method" : "GET",
11727 "name" : "index",
11728 "parameters" : {
11729 "additionalProperties" : 0
11730 },
11731 "permissions" : {
11732 "check" : [
4a46ced6
DM
11733 "admin",
11734 "qmanager",
11735 "audit"
9fda36b0
DM
11736 ]
11737 },
11738 "protected" : 1,
11739 "proxyto" : "master",
11740 "returns" : {
11741 "items" : {
11742 "properties" : {
11743 "comment" : {
11744 "optional" : 1,
11745 "type" : "string"
11746 },
11747 "enable" : {
11748 "type" : "boolean"
11749 },
11750 "role" : {
11751 "type" : "string"
11752 },
11753 "userid" : {
11754 "type" : "string"
11755 }
11756 },
11757 "type" : "object"
11758 },
11759 "links" : [
11760 {
11761 "href" : "{userid}",
11762 "rel" : "child"
11763 }
11764 ],
11765 "type" : "array"
11766 }
11767 },
11768 "POST" : {
4a46ced6 11769 "description" : "Create new user",
9fda36b0
DM
11770 "method" : "POST",
11771 "name" : "create",
11772 "parameters" : {
11773 "additionalProperties" : 0,
11774 "properties" : {
11775 "comment" : {
11776 "description" : "Comment.",
11777 "optional" : 1,
11778 "type" : "string",
11779 "typetext" : "<string>"
11780 },
11781 "crypt_pass" : {
11782 "description" : "Encrypted password (see `man crypt`)",
11783 "optional" : 1,
11784 "pattern" : "\\$\\d\\$[a-zA-Z0-9\\.\\/]+\\$[a-zA-Z0-9\\.\\/]+",
11785 "type" : "string"
11786 },
11787 "email" : {
11788 "description" : "Users E-Mail address.",
11789 "format" : "email",
11790 "optional" : 1,
11791 "type" : "string",
11792 "typetext" : "<string>"
11793 },
11794 "enable" : {
11795 "default" : 0,
11796 "description" : "Flag to enable or disable the account.",
11797 "optional" : 1,
11798 "type" : "boolean",
11799 "typetext" : "<boolean>"
11800 },
11801 "expire" : {
11802 "default" : 0,
11803 "description" : "Account expiration date (seconds since epoch). '0' means no expiration date.",
11804 "minimum" : 0,
11805 "optional" : 1,
11806 "type" : "integer",
11807 "typetext" : "<integer> (0 - N)"
11808 },
11809 "firstname" : {
11810 "description" : "First name.",
11811 "maxLength" : 64,
11812 "optional" : 1,
11813 "type" : "string",
11814 "typetext" : "<string>"
a55e94a6 11815 },
9fda36b0
DM
11816 "keys" : {
11817 "description" : "Keys for two factor auth (yubico).",
11818 "maxLength" : 128,
11819 "optional" : 1,
11820 "type" : "string",
11821 "typetext" : "<string>"
11822 },
11823 "lastname" : {
11824 "description" : "Last name.",
11825 "maxLength" : 64,
11826 "optional" : 1,
11827 "type" : "string",
11828 "typetext" : "<string>"
11829 },
11830 "password" : {
11831 "description" : "Password",
11832 "maxLength" : 32,
11833 "minLength" : 5,
11834 "optional" : 1,
11835 "type" : "string",
11836 "typetext" : "<string>"
11837 },
11838 "role" : {
11839 "description" : "User role. Role 'root' is reseved for the Unix Superuser.",
11840 "enum" : [
11841 "root",
11842 "admin",
11843 "qmanager",
11844 "audit"
a55e94a6 11845 ],
9fda36b0
DM
11846 "type" : "string"
11847 },
11848 "userid" : {
11849 "description" : "User ID",
11850 "format" : "pmg-userid",
11851 "maxLength" : 64,
11852 "minLength" : 4,
11853 "type" : "string",
11854 "typetext" : "<string>"
a55e94a6
DM
11855 }
11856 }
11857 },
9fda36b0
DM
11858 "protected" : 1,
11859 "proxyto" : "master",
11860 "returns" : {
11861 "type" : "null"
11862 }
11863 }
11864 },
11865 "leaf" : 0,
11866 "path" : "/access/users",
11867 "text" : "users"
11868 },
11869 {
11870 "info" : {
11871 "GET" : {
11872 "description" : "Dummy. Useful for formaters which want to priovde a login page.",
11873 "method" : "GET",
11874 "name" : "get_ticket",
11875 "parameters" : {
11876 "additionalProperties" : 0
11877 },
11878 "permissions" : {
11879 "user" : "world"
11880 },
11881 "returns" : {
11882 "type" : "null"
11883 }
a55e94a6 11884 },
9fda36b0
DM
11885 "POST" : {
11886 "description" : "Create or verify authentication ticket.",
11887 "method" : "POST",
11888 "name" : "create_ticket",
11889 "parameters" : {
11890 "additionalProperties" : 0,
11891 "properties" : {
11892 "otp" : {
11893 "description" : "One-time password for Two-factor authentication.",
11894 "optional" : 1,
11895 "type" : "string",
11896 "typetext" : "<string>"
410dc2c9 11897 },
9fda36b0
DM
11898 "password" : {
11899 "description" : "The secret password. This can also be a valid ticket.",
11900 "type" : "string",
11901 "typetext" : "<string>"
11902 },
274b47fc
DM
11903 "path" : {
11904 "description" : "Verify ticket, and check if user have access on 'path'",
11905 "maxLength" : 64,
11906 "optional" : 1,
11907 "type" : "string",
11908 "typetext" : "<string>"
11909 },
9fda36b0
DM
11910 "realm" : {
11911 "description" : "You can optionally pass the realm using this parameter. Normally the realm is simply added to the username <username>@<relam>.",
732d76e1
DM
11912 "enum" : [
11913 "pam",
11914 "pmg",
11915 "quarantine"
11916 ],
9fda36b0
DM
11917 "maxLength" : 32,
11918 "optional" : 1,
732d76e1 11919 "type" : "string"
9fda36b0
DM
11920 },
11921 "username" : {
11922 "description" : "User name",
11923 "maxLength" : 64,
11924 "type" : "string",
11925 "typetext" : "<string>"
11926 }
11927 }
11928 },
11929 "permissions" : {
11930 "description" : "You need to pass valid credientials.",
11931 "user" : "world"
11932 },
11933 "protected" : 1,
11934 "returns" : {
11935 "properties" : {
11936 "CSRFPreventionToken" : {
11937 "optional" : 1,
11938 "type" : "string"
11939 },
11940 "role" : {
11941 "optional" : 1,
11942 "type" : "string"
11943 },
11944 "ticket" : {
11945 "optional" : 1,
11946 "type" : "string"
11947 },
11948 "username" : {
11949 "type" : "string"
11950 }
11951 },
11952 "type" : "object"
11953 }
11954 }
11955 },
11956 "leaf" : 1,
11957 "path" : "/access/ticket",
11958 "text" : "ticket"
11959 },
11960 {
11961 "info" : {
11962 "PUT" : {
11963 "description" : "Change user password.",
11964 "method" : "PUT",
11965 "name" : "change_passsword",
11966 "parameters" : {
11967 "additionalProperties" : 0,
11968 "properties" : {
11969 "password" : {
11970 "description" : "The new password.",
11971 "maxLength" : 64,
11972 "minLength" : 5,
11973 "type" : "string",
11974 "typetext" : "<string>"
11975 },
11976 "userid" : {
11977 "description" : "User ID",
11978 "format" : "pmg-userid",
11979 "maxLength" : 64,
11980 "minLength" : 4,
11981 "type" : "string",
11982 "typetext" : "<string>"
410dc2c9
DM
11983 }
11984 }
11985 },
9fda36b0
DM
11986 "permissions" : {
11987 "description" : "Each user is allowed to change his own password. Only root can change the password of another user.",
11988 "user" : "all"
11989 },
11990 "protected" : 1,
11991 "returns" : {
11992 "type" : "null"
11993 }
11994 }
11995 },
11996 "leaf" : 1,
11997 "path" : "/access/password",
11998 "text" : "password"
11999 }
12000 ],
12001 "info" : {
12002 "GET" : {
12003 "description" : "Directory index.",
12004 "method" : "GET",
12005 "name" : "index",
12006 "parameters" : {
12007 "additionalProperties" : 0
12008 },
12009 "permissions" : {
12010 "user" : "all"
12011 },
12012 "returns" : {
12013 "items" : {
12014 "properties" : {
12015 "subdir" : {
12016 "type" : "string"
12017 }
12018 },
12019 "type" : "object"
410dc2c9 12020 },
9fda36b0
DM
12021 "links" : [
12022 {
12023 "href" : "{subdir}",
12024 "rel" : "child"
12025 }
12026 ],
12027 "type" : "array"
12028 }
12029 }
12030 },
12031 "leaf" : 0,
12032 "path" : "/access",
12033 "text" : "access"
12034 },
12035 {
12036 "children" : [
12037 {
12038 "children" : [
410dc2c9
DM
12039 {
12040 "info" : {
9fda36b0
DM
12041 "DELETE" : {
12042 "description" : "Delete user whitelist entries.",
12043 "method" : "DELETE",
12044 "name" : "whitelist_delete",
410dc2c9
DM
12045 "parameters" : {
12046 "additionalProperties" : 0,
12047 "properties" : {
9fda36b0
DM
12048 "address" : {
12049 "description" : "The address you want to remove.",
12050 "maxLength" : 512,
12051 "minLength" : 3,
12052 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
12053 "type" : "string"
410dc2c9 12054 },
9fda36b0
DM
12055 "pmail" : {
12056 "description" : "List entries for the user with this primary email address. Quarantine users cannot speficy this parameter, but it is required for all other roles.",
12057 "format" : "email",
d7cd791b
DM
12058 "optional" : 1,
12059 "type" : "string",
12060 "typetext" : "<string>"
410dc2c9
DM
12061 }
12062 }
12063 },
9fda36b0
DM
12064 "permissions" : {
12065 "check" : [
12066 "admin",
12067 "qmanager",
12068 "audit",
12069 "quser"
12070 ]
12071 },
410dc2c9 12072 "protected" : 1,
410dc2c9 12073 "returns" : {
9fda36b0 12074 "type" : "null"
410dc2c9
DM
12075 }
12076 }
12077 },
12078 "leaf" : 1,
9fda36b0
DM
12079 "path" : "/quarantine/whitelist/{address}",
12080 "text" : "{address}"
12081 }
12082 ],
12083 "info" : {
12084 "GET" : {
12085 "description" : "Show user whitelist.",
12086 "method" : "GET",
12087 "name" : "whitelist",
12088 "parameters" : {
12089 "additionalProperties" : 0,
12090 "properties" : {
12091 "pmail" : {
12092 "description" : "List entries for the user with this primary email address. Quarantine users cannot speficy this parameter, but it is required for all other roles.",
12093 "format" : "email",
12094 "optional" : 1,
12095 "type" : "string",
12096 "typetext" : "<string>"
12097 }
12098 }
12099 },
12100 "permissions" : {
12101 "check" : [
12102 "admin",
12103 "qmanager",
12104 "audit",
12105 "quser"
12106 ]
12107 },
12108 "returns" : {
12109 "items" : {
12110 "properties" : {
12111 "address" : {
12112 "type" : "string"
410dc2c9
DM
12113 }
12114 },
9fda36b0
DM
12115 "type" : "object"
12116 },
12117 "type" : "array"
12118 }
12119 },
12120 "POST" : {
12121 "description" : "Add user whitelist entries.",
12122 "method" : "POST",
12123 "name" : "whitelist_add",
12124 "parameters" : {
12125 "additionalProperties" : 0,
12126 "properties" : {
12127 "address" : {
12128 "description" : "The address you want to add.",
12129 "maxLength" : 512,
12130 "minLength" : 3,
12131 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
12132 "type" : "string"
12133 },
12134 "pmail" : {
12135 "description" : "List entries for the user with this primary email address. Quarantine users cannot speficy this parameter, but it is required for all other roles.",
12136 "format" : "email",
12137 "optional" : 1,
12138 "type" : "string",
12139 "typetext" : "<string>"
410dc2c9
DM
12140 }
12141 }
12142 },
9fda36b0
DM
12143 "permissions" : {
12144 "check" : [
12145 "admin",
12146 "qmanager",
12147 "audit",
12148 "quser"
12149 ]
12150 },
12151 "protected" : 1,
12152 "returns" : {
12153 "type" : "null"
12154 }
12155 }
12156 },
12157 "leaf" : 0,
12158 "path" : "/quarantine/whitelist",
12159 "text" : "whitelist"
12160 },
12161 {
12162 "children" : [
12163 {
12164 "info" : {
12165 "DELETE" : {
12166 "description" : "Delete user blacklist entries.",
12167 "method" : "DELETE",
12168 "name" : "blacklist_delete",
12169 "parameters" : {
12170 "additionalProperties" : 0,
12171 "properties" : {
12172 "address" : {
12173 "description" : "The address you want to remove.",
410dc2c9 12174 "maxLength" : 512,
9fda36b0
DM
12175 "minLength" : 3,
12176 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
12177 "type" : "string"
12178 },
12179 "pmail" : {
12180 "description" : "List entries for the user with this primary email address. Quarantine users cannot speficy this parameter, but it is required for all other roles.",
12181 "format" : "email",
12182 "optional" : 1,
410dc2c9
DM
12183 "type" : "string",
12184 "typetext" : "<string>"
12185 }
12186 }
12187 },
9fda36b0
DM
12188 "permissions" : {
12189 "check" : [
12190 "admin",
12191 "qmanager",
12192 "audit",
12193 "quser"
12194 ]
12195 },
12196 "protected" : 1,
410dc2c9 12197 "returns" : {
9fda36b0 12198 "type" : "null"
410dc2c9
DM
12199 }
12200 }
12201 },
12202 "leaf" : 1,
9fda36b0
DM
12203 "path" : "/quarantine/blacklist/{address}",
12204 "text" : "{address}"
12205 }
12206 ],
12207 "info" : {
12208 "GET" : {
12209 "description" : "Show user blacklist.",
12210 "method" : "GET",
12211 "name" : "blacklist",
12212 "parameters" : {
12213 "additionalProperties" : 0,
12214 "properties" : {
12215 "pmail" : {
12216 "description" : "List entries for the user with this primary email address. Quarantine users cannot speficy this parameter, but it is required for all other roles.",
12217 "format" : "email",
12218 "optional" : 1,
12219 "type" : "string",
12220 "typetext" : "<string>"
12221 }
12222 }
12223 },
12224 "permissions" : {
12225 "check" : [
12226 "admin",
12227 "qmanager",
12228 "audit",
12229 "quser"
12230 ]
12231 },
12232 "returns" : {
12233 "items" : {
12234 "properties" : {
12235 "address" : {
12236 "type" : "string"
410dc2c9
DM
12237 }
12238 },
9fda36b0
DM
12239 "type" : "object"
12240 },
12241 "type" : "array"
12242 }
12243 },
12244 "POST" : {
12245 "description" : "Add user blacklist entries.",
12246 "method" : "POST",
12247 "name" : "blacklist_add",
12248 "parameters" : {
12249 "additionalProperties" : 0,
12250 "properties" : {
12251 "address" : {
12252 "description" : "The address you want to add.",
12253 "maxLength" : 512,
12254 "minLength" : 3,
12255 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
12256 "type" : "string"
12257 },
12258 "pmail" : {
12259 "description" : "List entries for the user with this primary email address. Quarantine users cannot speficy this parameter, but it is required for all other roles.",
12260 "format" : "email",
12261 "optional" : 1,
12262 "type" : "string",
12263 "typetext" : "<string>"
12264 }
12265 }
12266 },
12267 "permissions" : {
12268 "check" : [
12269 "admin",
12270 "qmanager",
12271 "audit",
12272 "quser"
12273 ]
12274 },
12275 "protected" : 1,
12276 "returns" : {
12277 "type" : "null"
12278 }
12279 }
12280 },
12281 "leaf" : 0,
12282 "path" : "/quarantine/blacklist",
12283 "text" : "blacklist"
12284 },
12285 {
12286 "info" : {
12287 "GET" : {
12288 "description" : "Get a list of receivers of spam in the given timespan (Default the last 24 hours).",
12289 "method" : "GET",
12290 "name" : "spamusers",
12291 "parameters" : {
12292 "additionalProperties" : 0,
12293 "properties" : {
12294 "endtime" : {
12295 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
12296 "minimum" : 1,
12297 "optional" : 1,
12298 "type" : "integer",
12299 "typetext" : "<integer> (1 - N)"
12300 },
12301 "starttime" : {
12302 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
12303 "minimum" : 0,
12304 "optional" : 1,
12305 "type" : "integer",
12306 "typetext" : "<integer> (0 - N)"
410dc2c9 12307 }
9fda36b0
DM
12308 }
12309 },
12310 "permissions" : {
12311 "check" : [
12312 "admin",
12313 "qmanager",
12314 "audit"
12315 ]
12316 },
12317 "returns" : {
12318 "items" : {
12319 "properties" : {
12320 "mail" : {
12321 "description" : "the receiving email",
12322 "type" : "string"
12323 }
12324 },
12325 "type" : "object"
410dc2c9 12326 },
9fda36b0
DM
12327 "type" : "array"
12328 }
12329 }
12330 },
12331 "leaf" : 1,
12332 "path" : "/quarantine/spamusers",
12333 "text" : "spamusers"
12334 },
12335 {
12336 "info" : {
12337 "GET" : {
12338 "description" : "Get Spam Quarantine Status",
12339 "method" : "GET",
12340 "name" : "spamstatus",
12341 "parameters" : {
12342 "additionalProperties" : 0
12343 },
12344 "permissions" : {
12345 "check" : [
12346 "admin",
12347 "qmanager",
12348 "audit"
12349 ]
12350 },
12351 "returns" : {
12352 "properties" : {
12353 "avgbytes" : {
12354 "description" : "Average size of stored mails in bytes.",
12355 "type" : "number"
12356 },
12357 "avgspam" : {
12358 "description" : "Average spam level.",
12359 "type" : "number"
12360 },
12361 "count" : {
12362 "description" : "Number of stored mails.",
12363 "type" : "integer"
12364 },
12365 "mbytes" : {
12366 "description" : "Estimated disk space usage in MByte.",
12367 "type" : "number"
12368 }
12369 },
12370 "type" : "object"
12371 }
12372 }
12373 },
12374 "leaf" : 1,
12375 "path" : "/quarantine/spamstatus",
12376 "text" : "spamstatus"
12377 },
12378 {
12379 "info" : {
12380 "GET" : {
12381 "description" : "Get a list of users with whitelist/blacklist setttings.",
12382 "method" : "GET",
12383 "name" : "quarusers",
12384 "parameters" : {
12385 "additionalProperties" : 0
12386 },
12387 "permissions" : {
12388 "check" : [
12389 "admin",
12390 "qmanager",
12391 "audit"
12392 ]
12393 },
12394 "returns" : {
12395 "items" : {
12396 "properties" : {
12397 "mail" : {
12398 "description" : "the receiving email",
12399 "type" : "string"
410dc2c9
DM
12400 }
12401 },
9fda36b0
DM
12402 "type" : "object"
12403 },
12404 "type" : "array"
12405 }
12406 }
12407 },
12408 "leaf" : 1,
12409 "path" : "/quarantine/quarusers",
12410 "text" : "quarusers"
12411 },
12412 {
12413 "info" : {
12414 "GET" : {
12415 "description" : "Get a list of quarantined spam mails in the given timeframe (default the last 24 hours) for the given user.",
12416 "method" : "GET",
12417 "name" : "spam",
12418 "parameters" : {
12419 "additionalProperties" : 0,
12420 "properties" : {
12421 "endtime" : {
12422 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
12423 "minimum" : 1,
12424 "optional" : 1,
12425 "type" : "integer",
12426 "typetext" : "<integer> (1 - N)"
12427 },
12428 "pmail" : {
12429 "description" : "List entries for the user with this primary email address. Quarantine users cannot speficy this parameter, but it is required for all other roles.",
12430 "format" : "email",
12431 "optional" : 1,
12432 "type" : "string",
12433 "typetext" : "<string>"
12434 },
12435 "starttime" : {
12436 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
12437 "minimum" : 0,
12438 "optional" : 1,
12439 "type" : "integer",
12440 "typetext" : "<integer> (0 - N)"
410dc2c9
DM
12441 }
12442 }
12443 },
9fda36b0
DM
12444 "permissions" : {
12445 "check" : [
12446 "admin",
12447 "qmanager",
12448 "audit",
12449 "quser"
12450 ]
12451 },
12452 "returns" : {
12453 "items" : {
12454 "properties" : {
12455 "bytes" : {
12456 "description" : "Size of raw email.",
12457 "type" : "integer"
12458 },
12459 "envelope_sender" : {
12460 "description" : "SMTP envelope sender.",
12461 "type" : "string"
12462 },
12463 "from" : {
12464 "description" : "Header 'From' field.",
12465 "type" : "string"
12466 },
12467 "id" : {
12468 "description" : "Unique ID",
12469 "type" : "string"
12470 },
12471 "receiver" : {
12472 "description" : "Receiver email address",
12473 "type" : "string"
12474 },
12475 "sender" : {
12476 "description" : "Header 'Sender' field.",
12477 "optional" : 1,
12478 "type" : "string"
12479 },
12480 "spamlevel" : {
12481 "description" : "Spam score.",
12482 "type" : "number"
12483 },
12484 "subject" : {
12485 "description" : "Header 'Subject' field.",
12486 "type" : "string"
12487 },
12488 "time" : {
12489 "description" : "Receive time stamp",
12490 "type" : "integer"
410dc2c9
DM
12491 }
12492 },
9fda36b0 12493 "type" : "object"
410dc2c9 12494 },
9fda36b0
DM
12495 "type" : "array"
12496 }
12497 }
12498 },
12499 "leaf" : 1,
12500 "path" : "/quarantine/spam",
12501 "text" : "spam"
12502 },
12503 {
12504 "info" : {
12505 "GET" : {
12506 "description" : "Get a list of quarantined virus mails in the given timeframe (default the last 24 hours).",
12507 "method" : "GET",
12508 "name" : "virus",
12509 "parameters" : {
12510 "additionalProperties" : 0,
12511 "properties" : {
12512 "endtime" : {
12513 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
12514 "minimum" : 1,
12515 "optional" : 1,
12516 "type" : "integer",
12517 "typetext" : "<integer> (1 - N)"
410dc2c9 12518 },
9fda36b0
DM
12519 "starttime" : {
12520 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
12521 "minimum" : 0,
12522 "optional" : 1,
12523 "type" : "integer",
12524 "typetext" : "<integer> (0 - N)"
410dc2c9
DM
12525 }
12526 }
12527 },
9fda36b0
DM
12528 "permissions" : {
12529 "check" : [
12530 "admin",
12531 "qmanager",
12532 "audit"
12533 ]
12534 },
12535 "returns" : {
12536 "items" : {
12537 "properties" : {
12538 "bytes" : {
12539 "description" : "Size of raw email.",
12540 "type" : "integer"
12541 },
12542 "envelope_sender" : {
12543 "description" : "SMTP envelope sender.",
12544 "type" : "string"
12545 },
12546 "from" : {
12547 "description" : "Header 'From' field.",
12548 "type" : "string"
12549 },
12550 "id" : {
12551 "description" : "Unique ID",
12552 "type" : "string"
12553 },
12554 "receiver" : {
12555 "description" : "Receiver email address",
12556 "type" : "string"
12557 },
12558 "sender" : {
12559 "description" : "Header 'Sender' field.",
12560 "optional" : 1,
12561 "type" : "string"
12562 },
12563 "subject" : {
12564 "description" : "Header 'Subject' field.",
12565 "type" : "string"
12566 },
12567 "time" : {
12568 "description" : "Receive time stamp",
12569 "type" : "integer"
12570 },
12571 "virusname" : {
12572 "description" : "Virus name.",
12573 "type" : "string"
d7cd791b
DM
12574 }
12575 },
9fda36b0
DM
12576 "type" : "object"
12577 },
12578 "type" : "array"
12579 }
12580 }
12581 },
12582 "leaf" : 1,
12583 "path" : "/quarantine/virus",
12584 "text" : "virus"
12585 },
12586 {
12587 "info" : {
12588 "GET" : {
12589 "description" : "Get Virus Quarantine Status",
12590 "method" : "GET",
12591 "name" : "virusstatus",
12592 "parameters" : {
12593 "additionalProperties" : 0
12594 },
12595 "permissions" : {
12596 "check" : [
12597 "admin",
12598 "qmanager",
12599 "audit"
12600 ]
12601 },
12602 "returns" : {
12603 "properties" : {
12604 "avgbytes" : {
12605 "description" : "Average size of stored mails in bytes.",
12606 "type" : "number"
12607 },
12608 "count" : {
12609 "description" : "Number of stored mails.",
12610 "type" : "integer"
12611 },
12612 "mbytes" : {
12613 "description" : "Estimated disk space usage in MByte.",
12614 "type" : "number"
d7cd791b 12615 }
9fda36b0
DM
12616 },
12617 "type" : "object"
12618 }
d7cd791b 12619 }
9fda36b0
DM
12620 },
12621 "leaf" : 1,
12622 "path" : "/quarantine/virusstatus",
12623 "text" : "virusstatus"
12624 },
12625 {
d7cd791b
DM
12626 "info" : {
12627 "GET" : {
9fda36b0 12628 "description" : "Get email data. There is a special formatter called 'htmlmail' to get sanitized html view of the mail content (use the '/api2/htmlmail/quarantine/content' url).",
d7cd791b 12629 "method" : "GET",
9fda36b0 12630 "name" : "content",
d7cd791b
DM
12631 "parameters" : {
12632 "additionalProperties" : 0,
12633 "properties" : {
9fda36b0
DM
12634 "id" : {
12635 "description" : "Unique ID",
274b47fc
DM
12636 "maxLength" : 60,
12637 "pattern" : "C\\d+R\\d+T\\d+",
9fda36b0
DM
12638 "type" : "string"
12639 },
12640 "raw" : {
12641 "default" : 0,
12642 "description" : "Display 'raw' eml data. This is only used with the 'htmlmail' formatter.",
12643 "optional" : 1,
12644 "type" : "boolean",
12645 "typetext" : "<boolean>"
d7cd791b
DM
12646 }
12647 }
12648 },
12649 "permissions" : {
9fda36b0
DM
12650 "check" : [
12651 "admin",
12652 "qmanager",
12653 "audit",
12654 "quser"
12655 ]
d7cd791b
DM
12656 },
12657 "returns" : {
9fda36b0
DM
12658 "properties" : {
12659 "bytes" : {
12660 "description" : "Size of raw email.",
12661 "type" : "integer"
12662 },
12663 "content" : {
12664 "description" : "Raw email data (first 4096 bytes). Useful for preview. NOTE: The 'htmlmail' formatter displays the whole email.",
12665 "type" : "string"
12666 },
12667 "envelope_sender" : {
12668 "description" : "SMTP envelope sender.",
12669 "type" : "string"
12670 },
12671 "from" : {
12672 "description" : "Header 'From' field.",
12673 "type" : "string"
12674 },
12675 "header" : {
12676 "description" : "Raw email header data.",
12677 "type" : "string"
12678 },
12679 "id" : {
12680 "description" : "Unique ID",
12681 "type" : "string"
12682 },
12683 "receiver" : {
12684 "description" : "Receiver email address",
12685 "type" : "string"
12686 },
12687 "sender" : {
12688 "description" : "Header 'Sender' field.",
12689 "optional" : 1,
12690 "type" : "string"
12691 },
12692 "spaminfo" : {
12693 "description" : "Information about matched spam tests (name, score, desc, url).",
12694 "type" : "array"
12695 },
12696 "spamlevel" : {
12697 "description" : "Spam score.",
12698 "type" : "number"
12699 },
12700 "subject" : {
12701 "description" : "Header 'Subject' field.",
12702 "type" : "string"
12703 },
12704 "time" : {
12705 "description" : "Receive time stamp",
12706 "type" : "integer"
12707 }
d7cd791b 12708 },
9fda36b0
DM
12709 "type" : "object"
12710 }
12711 },
12712 "POST" : {
12713 "description" : "Execute quarantine actions.",
12714 "method" : "POST",
12715 "name" : "action",
12716 "parameters" : {
12717 "additionalProperties" : 0,
12718 "properties" : {
12719 "action" : {
12720 "description" : "Action - specify what you want to do with the mail.",
12721 "enum" : [
12722 "whitelist",
12723 "blacklist",
12724 "deliver",
12725 "delete"
12726 ],
12727 "type" : "string"
12728 },
12729 "id" : {
12730 "description" : "Unique ID",
274b47fc
DM
12731 "maxLength" : 60,
12732 "pattern" : "C\\d+R\\d+T\\d+",
9fda36b0 12733 "type" : "string"
410dc2c9 12734 }
9fda36b0
DM
12735 }
12736 },
12737 "permissions" : {
12738 "check" : [
12739 "admin",
12740 "qmanager",
12741 "quser"
12742 ]
12743 },
12744 "protected" : 1,
12745 "returns" : {
12746 "type" : "null"
410dc2c9
DM
12747 }
12748 }
12749 },
9fda36b0
DM
12750 "leaf" : 1,
12751 "path" : "/quarantine/content",
12752 "text" : "content"
410dc2c9
DM
12753 }
12754 ],
12755 "info" : {
12756 "GET" : {
9fda36b0 12757 "description" : "Directory index.",
410dc2c9
DM
12758 "method" : "GET",
12759 "name" : "index",
12760 "parameters" : {
12761 "additionalProperties" : 0
12762 },
12763 "permissions" : {
12764 "user" : "all"
12765 },
12766 "returns" : {
12767 "items" : {
12768 "properties" : {},
12769 "type" : "object"
12770 },
12771 "links" : [
12772 {
9fda36b0 12773 "href" : "{name}",
410dc2c9
DM
12774 "rel" : "child"
12775 }
12776 ],
12777 "type" : "array"
12778 }
12779 }
12780 },
12781 "leaf" : 0,
9fda36b0
DM
12782 "path" : "/quarantine",
12783 "text" : "quarantine"
410dc2c9
DM
12784 },
12785 {
12786 "children" : [
a55e94a6
DM
12787 {
12788 "children" : [
12789 {
12790 "info" : {
a55e94a6 12791 "GET" : {
9fda36b0 12792 "description" : "Detailed Contact Statistics.",
a55e94a6 12793 "method" : "GET",
9fda36b0 12794 "name" : "contactdetails",
a55e94a6
DM
12795 "parameters" : {
12796 "additionalProperties" : 0,
9fda36b0
DM
12797 "properties" : {
12798 "contact" : {
12799 "description" : "Contact email address.",
12800 "maxLength" : 512,
12801 "minLength" : 3,
12802 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
12803 "type" : "string"
a55e94a6 12804 },
9fda36b0
DM
12805 "day" : {
12806 "description" : "Day of month. Get statistics for a single day.",
12807 "maximum" : 31,
12808 "minimum" : 1,
a55e94a6
DM
12809 "optional" : 1,
12810 "type" : "integer",
9fda36b0 12811 "typetext" : "<integer> (1 - 31)"
a55e94a6 12812 },
9fda36b0
DM
12813 "endtime" : {
12814 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
12815 "minimum" : 1,
a55e94a6 12816 "optional" : 1,
9fda36b0
DM
12817 "type" : "integer",
12818 "typetext" : "<integer> (1 - N)"
a55e94a6 12819 },
9fda36b0
DM
12820 "filter" : {
12821 "description" : "Sender address filter.",
12822 "maxLength" : 512,
a55e94a6
DM
12823 "optional" : 1,
12824 "type" : "string",
12825 "typetext" : "<string>"
12826 },
9fda36b0
DM
12827 "month" : {
12828 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
12829 "maximum" : 12,
12830 "minimum" : 1,
a55e94a6 12831 "optional" : 1,
9fda36b0
DM
12832 "type" : "integer",
12833 "typetext" : "<integer> (1 - 12)"
a55e94a6 12834 },
9fda36b0
DM
12835 "orderby" : {
12836 "description" : "Remote sorting configuration(JSON, ExtJS compatible).",
12837 "maxLength" : 4096,
a55e94a6
DM
12838 "optional" : 1,
12839 "type" : "string",
12840 "typetext" : "<string>"
12841 },
9fda36b0
DM
12842 "starttime" : {
12843 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
12844 "minimum" : 0,
a55e94a6 12845 "optional" : 1,
9fda36b0
DM
12846 "type" : "integer",
12847 "typetext" : "<integer> (0 - N)"
a55e94a6 12848 },
9fda36b0
DM
12849 "year" : {
12850 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
12851 "maximum" : 3000,
12852 "minimum" : 1900,
12853 "optional" : 1,
12854 "type" : "integer",
12855 "typetext" : "<integer> (1900 - 3000)"
a55e94a6
DM
12856 }
12857 }
12858 },
9fda36b0
DM
12859 "permissions" : {
12860 "check" : [
12861 "admin",
12862 "qmanager",
12863 "audit"
12864 ]
12865 },
a55e94a6 12866 "returns" : {
9fda36b0
DM
12867 "items" : {
12868 "properties" : {
12869 "blocked" : {
12870 "description" : "Mail was blocked.",
12871 "type" : "boolean"
12872 },
12873 "bytes" : {
12874 "description" : "Mail traffic (Bytes).",
12875 "type" : "number"
12876 },
12877 "sender" : {
12878 "description" : "Sender email.",
12879 "type" : "string"
12880 },
12881 "spamlevel" : {
12882 "description" : "Spam score.",
12883 "type" : "number"
12884 },
12885 "time" : {
12886 "description" : "Receive time stamp",
12887 "type" : "integer"
12888 },
12889 "virusinfo" : {
12890 "description" : "Virus name.",
12891 "optional" : 1,
12892 "type" : "string"
12893 }
12894 },
12895 "type" : "object"
12896 },
12897 "type" : "array"
a55e94a6
DM
12898 }
12899 }
12900 },
12901 "leaf" : 1,
9fda36b0
DM
12902 "path" : "/statistics/contact/{contact}",
12903 "text" : "{contact}"
a55e94a6
DM
12904 }
12905 ],
12906 "info" : {
12907 "GET" : {
9fda36b0 12908 "description" : "Contact Address Statistics.",
a55e94a6 12909 "method" : "GET",
9fda36b0 12910 "name" : "contact",
a55e94a6
DM
12911 "parameters" : {
12912 "additionalProperties" : 0,
12913 "properties" : {
9fda36b0
DM
12914 "day" : {
12915 "description" : "Day of month. Get statistics for a single day.",
12916 "maximum" : 31,
12917 "minimum" : 1,
a55e94a6
DM
12918 "optional" : 1,
12919 "type" : "integer",
9fda36b0 12920 "typetext" : "<integer> (1 - 31)"
a55e94a6 12921 },
9fda36b0
DM
12922 "endtime" : {
12923 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
12924 "minimum" : 1,
410dc2c9 12925 "optional" : 1,
9fda36b0
DM
12926 "type" : "integer",
12927 "typetext" : "<integer> (1 - N)"
410dc2c9 12928 },
9fda36b0
DM
12929 "filter" : {
12930 "description" : "Contact address filter.",
12931 "maxLength" : 512,
12932 "optional" : 1,
410dc2c9
DM
12933 "type" : "string",
12934 "typetext" : "<string>"
12935 },
9fda36b0
DM
12936 "month" : {
12937 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
12938 "maximum" : 12,
12939 "minimum" : 1,
410dc2c9 12940 "optional" : 1,
9fda36b0
DM
12941 "type" : "integer",
12942 "typetext" : "<integer> (1 - 12)"
410dc2c9 12943 },
9fda36b0
DM
12944 "orderby" : {
12945 "description" : "Remote sorting configuration(JSON, ExtJS compatible).",
12946 "maxLength" : 4096,
12947 "optional" : 1,
410dc2c9
DM
12948 "type" : "string",
12949 "typetext" : "<string>"
9fda36b0
DM
12950 },
12951 "starttime" : {
12952 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
12953 "minimum" : 0,
12954 "optional" : 1,
12955 "type" : "integer",
12956 "typetext" : "<integer> (0 - N)"
12957 },
12958 "year" : {
12959 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
12960 "maximum" : 3000,
12961 "minimum" : 1900,
12962 "optional" : 1,
12963 "type" : "integer",
12964 "typetext" : "<integer> (1900 - 3000)"
410dc2c9
DM
12965 }
12966 }
12967 },
12968 "permissions" : {
9fda36b0
DM
12969 "check" : [
12970 "admin",
12971 "qmanager",
12972 "audit"
12973 ]
410dc2c9 12974 },
410dc2c9 12975 "returns" : {
9fda36b0
DM
12976 "items" : {
12977 "properties" : {
12978 "bytes" : {
12979 "description" : "Mail traffic (Bytes).",
12980 "type" : "number"
12981 },
12982 "contact" : {
12983 "description" : "Contact email.",
12984 "type" : "string"
12985 },
12986 "count" : {
12987 "description" : "Mail count.",
12988 "optional" : 1,
12989 "type" : "number"
12990 },
12991 "viruscount" : {
12992 "description" : "Number of sent virus mails.",
12993 "optional" : 1,
12994 "type" : "number"
12995 }
410dc2c9 12996 },
9fda36b0 12997 "type" : "object"
410dc2c9 12998 },
9fda36b0
DM
12999 "links" : [
13000 {
13001 "href" : "{contact}",
13002 "rel" : "child"
13003 }
13004 ],
13005 "type" : "array"
410dc2c9
DM
13006 }
13007 }
13008 },
9fda36b0
DM
13009 "leaf" : 0,
13010 "path" : "/statistics/contact",
13011 "text" : "contact"
410dc2c9
DM
13012 },
13013 {
9fda36b0
DM
13014 "children" : [
13015 {
13016 "info" : {
13017 "GET" : {
13018 "description" : "Detailed Sender Statistics.",
13019 "method" : "GET",
13020 "name" : "senderdetails",
13021 "parameters" : {
13022 "additionalProperties" : 0,
13023 "properties" : {
13024 "day" : {
13025 "description" : "Day of month. Get statistics for a single day.",
13026 "maximum" : 31,
13027 "minimum" : 1,
13028 "optional" : 1,
13029 "type" : "integer",
13030 "typetext" : "<integer> (1 - 31)"
13031 },
13032 "endtime" : {
13033 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
13034 "minimum" : 1,
13035 "optional" : 1,
13036 "type" : "integer",
13037 "typetext" : "<integer> (1 - N)"
13038 },
13039 "filter" : {
13040 "description" : "Receiver address filter.",
13041 "maxLength" : 512,
13042 "optional" : 1,
13043 "type" : "string",
13044 "typetext" : "<string>"
13045 },
13046 "month" : {
13047 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
13048 "maximum" : 12,
13049 "minimum" : 1,
13050 "optional" : 1,
13051 "type" : "integer",
13052 "typetext" : "<integer> (1 - 12)"
13053 },
13054 "orderby" : {
13055 "description" : "Remote sorting configuration(JSON, ExtJS compatible).",
13056 "maxLength" : 4096,
13057 "optional" : 1,
13058 "type" : "string",
13059 "typetext" : "<string>"
13060 },
13061 "sender" : {
13062 "description" : "Sender email address.",
13063 "maxLength" : 512,
13064 "minLength" : 3,
13065 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
13066 "type" : "string"
13067 },
13068 "starttime" : {
13069 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
13070 "minimum" : 0,
13071 "optional" : 1,
13072 "type" : "integer",
13073 "typetext" : "<integer> (0 - N)"
13074 },
13075 "year" : {
13076 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
13077 "maximum" : 3000,
13078 "minimum" : 1900,
13079 "optional" : 1,
13080 "type" : "integer",
13081 "typetext" : "<integer> (1900 - 3000)"
13082 }
13083 }
13084 },
13085 "permissions" : {
13086 "check" : [
13087 "admin",
13088 "qmanager",
13089 "audit"
13090 ]
13091 },
13092 "returns" : {
13093 "items" : {
13094 "properties" : {
13095 "blocked" : {
13096 "description" : "Mail was blocked.",
13097 "type" : "boolean"
13098 },
13099 "bytes" : {
13100 "description" : "Mail traffic (Bytes).",
13101 "type" : "number"
13102 },
13103 "receiver" : {
13104 "description" : "Receiver email.",
13105 "type" : "string"
13106 },
13107 "spamlevel" : {
13108 "description" : "Spam score.",
13109 "type" : "number"
13110 },
13111 "time" : {
13112 "description" : "Receive time stamp",
13113 "type" : "integer"
13114 },
13115 "virusinfo" : {
13116 "description" : "Virus name.",
13117 "optional" : 1,
13118 "type" : "string"
13119 }
13120 },
13121 "type" : "object"
13122 },
13123 "type" : "array"
13124 }
13125 }
13126 },
13127 "leaf" : 1,
13128 "path" : "/statistics/sender/{sender}",
13129 "text" : "{sender}"
13130 }
13131 ],
410dc2c9 13132 "info" : {
9fda36b0
DM
13133 "GET" : {
13134 "description" : "Sender Address Statistics.",
13135 "method" : "GET",
13136 "name" : "sender",
410dc2c9
DM
13137 "parameters" : {
13138 "additionalProperties" : 0,
13139 "properties" : {
9fda36b0
DM
13140 "day" : {
13141 "description" : "Day of month. Get statistics for a single day.",
13142 "maximum" : 31,
13143 "minimum" : 1,
13144 "optional" : 1,
13145 "type" : "integer",
13146 "typetext" : "<integer> (1 - 31)"
13147 },
13148 "endtime" : {
13149 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
13150 "minimum" : 1,
13151 "optional" : 1,
13152 "type" : "integer",
13153 "typetext" : "<integer> (1 - N)"
13154 },
13155 "filter" : {
13156 "description" : "Sender address filter.",
13157 "maxLength" : 512,
13158 "optional" : 1,
410dc2c9
DM
13159 "type" : "string",
13160 "typetext" : "<string>"
13161 },
9fda36b0
DM
13162 "month" : {
13163 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
13164 "maximum" : 12,
13165 "minimum" : 1,
13166 "optional" : 1,
13167 "type" : "integer",
13168 "typetext" : "<integer> (1 - 12)"
13169 },
13170 "orderby" : {
13171 "description" : "Remote sorting configuration(JSON, ExtJS compatible).",
13172 "maxLength" : 4096,
13173 "optional" : 1,
410dc2c9
DM
13174 "type" : "string",
13175 "typetext" : "<string>"
9fda36b0
DM
13176 },
13177 "starttime" : {
13178 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
13179 "minimum" : 0,
13180 "optional" : 1,
13181 "type" : "integer",
13182 "typetext" : "<integer> (0 - N)"
13183 },
13184 "year" : {
13185 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
13186 "maximum" : 3000,
13187 "minimum" : 1900,
13188 "optional" : 1,
13189 "type" : "integer",
13190 "typetext" : "<integer> (1900 - 3000)"
410dc2c9
DM
13191 }
13192 }
13193 },
a55e94a6 13194 "permissions" : {
9fda36b0
DM
13195 "check" : [
13196 "admin",
13197 "qmanager",
13198 "audit"
13199 ]
a55e94a6 13200 },
410dc2c9 13201 "returns" : {
9fda36b0
DM
13202 "items" : {
13203 "properties" : {
13204 "bytes" : {
13205 "description" : "Mail traffic (Bytes).",
13206 "type" : "number"
13207 },
13208 "count" : {
13209 "description" : "Mail count.",
13210 "optional" : 1,
13211 "type" : "number"
13212 },
13213 "sender" : {
13214 "description" : "Sender email.",
13215 "type" : "string"
13216 },
13217 "viruscount" : {
13218 "description" : "Number of sent virus mails.",
13219 "optional" : 1,
13220 "type" : "number"
13221 }
13222 },
13223 "type" : "object"
13224 },
13225 "links" : [
13226 {
13227 "href" : "{sender}",
13228 "rel" : "child"
13229 }
13230 ],
13231 "type" : "array"
410dc2c9 13232 }
9fda36b0
DM
13233 }
13234 },
13235 "leaf" : 0,
13236 "path" : "/statistics/sender",
13237 "text" : "sender"
13238 },
d7cd791b
DM
13239 {
13240 "children" : [
13241 {
13242 "info" : {
9fda36b0
DM
13243 "GET" : {
13244 "description" : "Detailed Receiver Statistics.",
13245 "method" : "GET",
13246 "name" : "receiverdetails",
d7cd791b
DM
13247 "parameters" : {
13248 "additionalProperties" : 0,
13249 "properties" : {
9fda36b0
DM
13250 "day" : {
13251 "description" : "Day of month. Get statistics for a single day.",
13252 "maximum" : 31,
13253 "minimum" : 1,
13254 "optional" : 1,
13255 "type" : "integer",
13256 "typetext" : "<integer> (1 - 31)"
13257 },
13258 "endtime" : {
13259 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
13260 "minimum" : 1,
13261 "optional" : 1,
13262 "type" : "integer",
13263 "typetext" : "<integer> (1 - N)"
13264 },
13265 "filter" : {
13266 "description" : "Sender address filter.",
d7cd791b 13267 "maxLength" : 512,
9fda36b0
DM
13268 "optional" : 1,
13269 "type" : "string",
13270 "typetext" : "<string>"
d7cd791b 13271 },
9fda36b0
DM
13272 "month" : {
13273 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
13274 "maximum" : 12,
13275 "minimum" : 1,
13276 "optional" : 1,
13277 "type" : "integer",
13278 "typetext" : "<integer> (1 - 12)"
13279 },
13280 "orderby" : {
13281 "description" : "Remote sorting configuration(JSON, ExtJS compatible).",
13282 "maxLength" : 4096,
d7cd791b
DM
13283 "optional" : 1,
13284 "type" : "string",
13285 "typetext" : "<string>"
9fda36b0
DM
13286 },
13287 "receiver" : {
13288 "description" : "Receiver email address.",
13289 "maxLength" : 512,
13290 "minLength" : 3,
13291 "pattern" : "(?:|[^\\s\\/\\@]+\\@[^\\s\\/\\@]+)",
13292 "type" : "string"
13293 },
13294 "starttime" : {
13295 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
13296 "minimum" : 0,
13297 "optional" : 1,
13298 "type" : "integer",
13299 "typetext" : "<integer> (0 - N)"
13300 },
13301 "year" : {
13302 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
13303 "maximum" : 3000,
13304 "minimum" : 1900,
13305 "optional" : 1,
13306 "type" : "integer",
13307 "typetext" : "<integer> (1900 - 3000)"
d7cd791b
DM
13308 }
13309 }
13310 },
13311 "permissions" : {
13312 "check" : [
13313 "admin",
13314 "qmanager",
9fda36b0 13315 "audit"
d7cd791b
DM
13316 ]
13317 },
d7cd791b 13318 "returns" : {
9fda36b0
DM
13319 "items" : {
13320 "properties" : {
13321 "blocked" : {
13322 "description" : "Mail was blocked.",
13323 "type" : "boolean"
13324 },
13325 "bytes" : {
13326 "description" : "Mail traffic (Bytes).",
13327 "type" : "number"
13328 },
13329 "sender" : {
13330 "description" : "Sender email.",
13331 "type" : "string"
13332 },
13333 "spamlevel" : {
13334 "description" : "Spam score.",
13335 "type" : "number"
13336 },
13337 "time" : {
13338 "description" : "Receive time stamp",
13339 "type" : "integer"
13340 },
13341 "virusinfo" : {
13342 "description" : "Virus name.",
13343 "optional" : 1,
13344 "type" : "string"
13345 }
13346 },
13347 "type" : "object"
13348 },
13349 "type" : "array"
d7cd791b
DM
13350 }
13351 }
13352 },
13353 "leaf" : 1,
9fda36b0
DM
13354 "path" : "/statistics/receiver/{receiver}",
13355 "text" : "{receiver}"
d7cd791b
DM
13356 }
13357 ],
13358 "info" : {
13359 "GET" : {
9fda36b0 13360 "description" : "Receiver Address Statistics.",
d7cd791b 13361 "method" : "GET",
9fda36b0 13362 "name" : "receiver",
d7cd791b
DM
13363 "parameters" : {
13364 "additionalProperties" : 0,
13365 "properties" : {
9fda36b0
DM
13366 "day" : {
13367 "description" : "Day of month. Get statistics for a single day.",
13368 "maximum" : 31,
13369 "minimum" : 1,
13370 "optional" : 1,
13371 "type" : "integer",
13372 "typetext" : "<integer> (1 - 31)"
13373 },
13374 "endtime" : {
13375 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
13376 "minimum" : 1,
13377 "optional" : 1,
13378 "type" : "integer",
13379 "typetext" : "<integer> (1 - N)"
13380 },
13381 "filter" : {
13382 "description" : "Receiver address filter.",
13383 "maxLength" : 512,
13384 "optional" : 1,
13385 "type" : "string",
13386 "typetext" : "<string>"
13387 },
13388 "month" : {
13389 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
13390 "maximum" : 12,
13391 "minimum" : 1,
13392 "optional" : 1,
13393 "type" : "integer",
13394 "typetext" : "<integer> (1 - 12)"
13395 },
13396 "orderby" : {
13397 "description" : "Remote sorting configuration(JSON, ExtJS compatible).",
13398 "maxLength" : 4096,
d7cd791b
DM
13399 "optional" : 1,
13400 "type" : "string",
13401 "typetext" : "<string>"
9fda36b0
DM
13402 },
13403 "starttime" : {
13404 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
13405 "minimum" : 0,
13406 "optional" : 1,
13407 "type" : "integer",
13408 "typetext" : "<integer> (0 - N)"
13409 },
13410 "year" : {
13411 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
13412 "maximum" : 3000,
13413 "minimum" : 1900,
13414 "optional" : 1,
13415 "type" : "integer",
13416 "typetext" : "<integer> (1900 - 3000)"
d7cd791b
DM
13417 }
13418 }
13419 },
13420 "permissions" : {
13421 "check" : [
13422 "admin",
13423 "qmanager",
9fda36b0 13424 "audit"
d7cd791b
DM
13425 ]
13426 },
13427 "returns" : {
13428 "items" : {
13429 "properties" : {
9fda36b0
DM
13430 "bytes" : {
13431 "description" : "Mail traffic (Bytes).",
13432 "type" : "number"
13433 },
13434 "count" : {
13435 "description" : "Mail count.",
13436 "optional" : 1,
13437 "type" : "number"
13438 },
13439 "receiver" : {
13440 "description" : "Sender email.",
d7cd791b 13441 "type" : "string"
9fda36b0
DM
13442 },
13443 "spamcount" : {
13444 "description" : "Number of sent spam mails.",
13445 "optional" : 1,
13446 "type" : "number"
13447 },
13448 "viruscount" : {
13449 "description" : "Number of sent virus mails.",
13450 "optional" : 1,
13451 "type" : "number"
d7cd791b
DM
13452 }
13453 },
13454 "type" : "object"
13455 },
9fda36b0
DM
13456 "links" : [
13457 {
13458 "href" : "{receiver}",
13459 "rel" : "child"
d7cd791b 13460 }
9fda36b0
DM
13461 ],
13462 "type" : "array"
d7cd791b
DM
13463 }
13464 }
13465 },
13466 "leaf" : 0,
9fda36b0
DM
13467 "path" : "/statistics/receiver",
13468 "text" : "receiver"
d7cd791b
DM
13469 },
13470 {
d7cd791b
DM
13471 "info" : {
13472 "GET" : {
9fda36b0 13473 "description" : "Mail Domains Statistics.",
d7cd791b 13474 "method" : "GET",
9fda36b0 13475 "name" : "domains",
d7cd791b
DM
13476 "parameters" : {
13477 "additionalProperties" : 0,
13478 "properties" : {
9fda36b0
DM
13479 "day" : {
13480 "description" : "Day of month. Get statistics for a single day.",
13481 "maximum" : 31,
13482 "minimum" : 1,
13483 "optional" : 1,
13484 "type" : "integer",
13485 "typetext" : "<integer> (1 - 31)"
13486 },
13487 "endtime" : {
13488 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
13489 "minimum" : 1,
13490 "optional" : 1,
13491 "type" : "integer",
13492 "typetext" : "<integer> (1 - N)"
13493 },
13494 "month" : {
13495 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
13496 "maximum" : 12,
13497 "minimum" : 1,
13498 "optional" : 1,
13499 "type" : "integer",
13500 "typetext" : "<integer> (1 - 12)"
13501 },
13502 "starttime" : {
13503 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
13504 "minimum" : 0,
d7cd791b 13505 "optional" : 1,
9fda36b0
DM
13506 "type" : "integer",
13507 "typetext" : "<integer> (0 - N)"
13508 },
13509 "year" : {
13510 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
13511 "maximum" : 3000,
13512 "minimum" : 1900,
13513 "optional" : 1,
13514 "type" : "integer",
13515 "typetext" : "<integer> (1900 - 3000)"
d7cd791b
DM
13516 }
13517 }
13518 },
13519 "permissions" : {
13520 "check" : [
13521 "admin",
13522 "qmanager",
9fda36b0 13523 "audit"
d7cd791b
DM
13524 ]
13525 },
13526 "returns" : {
13527 "items" : {
13528 "properties" : {
274b47fc
DM
13529 "bytes_in" : {
13530 "description" : "Incoming mail traffic (Bytes).",
13531 "type" : "number"
13532 },
13533 "bytes_out" : {
13534 "description" : "Outgoing mail traffic (Bytes).",
13535 "type" : "number"
13536 },
9fda36b0
DM
13537 "count_in" : {
13538 "description" : "Incoming mail count.",
13539 "type" : "number"
13540 },
13541 "count_out" : {
13542 "description" : "Outgoing mail count.",
13543 "type" : "number"
13544 },
13545 "domain" : {
13546 "description" : "Domain name.",
d7cd791b 13547 "type" : "string"
9fda36b0 13548 },
9fda36b0
DM
13549 "spamcount_in" : {
13550 "description" : "Incoming spam mails.",
13551 "type" : "number"
13552 },
13553 "spamcount_out" : {
13554 "description" : "Outgoing spam mails.",
13555 "type" : "number"
13556 },
13557 "viruscount_in" : {
13558 "description" : "Number of incoming virus mails.",
13559 "type" : "number"
13560 },
13561 "viruscount_out" : {
13562 "description" : "Number of outgoing virus mails.",
13563 "type" : "number"
d7cd791b
DM
13564 }
13565 },
13566 "type" : "object"
13567 },
13568 "type" : "array"
13569 }
9fda36b0
DM
13570 }
13571 },
13572 "leaf" : 1,
13573 "path" : "/statistics/domains",
13574 "text" : "domains"
13575 },
13576 {
13577 "info" : {
13578 "GET" : {
13579 "description" : "General Mail Statistics.",
13580 "method" : "GET",
13581 "name" : "mail",
d7cd791b
DM
13582 "parameters" : {
13583 "additionalProperties" : 0,
13584 "properties" : {
9fda36b0
DM
13585 "day" : {
13586 "description" : "Day of month. Get statistics for a single day.",
13587 "maximum" : 31,
13588 "minimum" : 1,
13589 "optional" : 1,
13590 "type" : "integer",
13591 "typetext" : "<integer> (1 - 31)"
d7cd791b 13592 },
9fda36b0
DM
13593 "endtime" : {
13594 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
13595 "minimum" : 1,
d7cd791b 13596 "optional" : 1,
9fda36b0
DM
13597 "type" : "integer",
13598 "typetext" : "<integer> (1 - N)"
13599 },
13600 "month" : {
13601 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
13602 "maximum" : 12,
13603 "minimum" : 1,
13604 "optional" : 1,
13605 "type" : "integer",
13606 "typetext" : "<integer> (1 - 12)"
13607 },
13608 "starttime" : {
13609 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
13610 "minimum" : 0,
13611 "optional" : 1,
13612 "type" : "integer",
13613 "typetext" : "<integer> (0 - N)"
13614 },
13615 "year" : {
13616 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
13617 "maximum" : 3000,
13618 "minimum" : 1900,
13619 "optional" : 1,
13620 "type" : "integer",
13621 "typetext" : "<integer> (1900 - 3000)"
d7cd791b
DM
13622 }
13623 }
13624 },
13625 "permissions" : {
13626 "check" : [
13627 "admin",
13628 "qmanager",
9fda36b0 13629 "audit"
d7cd791b
DM
13630 ]
13631 },
d7cd791b 13632 "returns" : {
9fda36b0
DM
13633 "properties" : {
13634 "avptime" : {
13635 "description" : "Average mail processing time in seconds.",
13636 "type" : "number"
13637 },
13638 "bounces_in" : {
13639 "description" : "Incoming bounce mail count (sender = <>).",
13640 "type" : "number"
13641 },
13642 "bounces_out" : {
13643 "description" : "Outgoing bounce mail count (sender = <>).",
13644 "type" : "number"
13645 },
13646 "bytes_in" : {
13647 "description" : "Incoming mail traffic (bytes).",
13648 "type" : "number"
13649 },
13650 "bytes_out" : {
13651 "description" : "Outgoing mail traffic (bytes).",
13652 "type" : "number"
13653 },
13654 "count" : {
13655 "description" : "Overall mail count (in and out).",
13656 "type" : "number"
13657 },
13658 "count_in" : {
13659 "description" : "Incoming mail count.",
13660 "type" : "number"
13661 },
13662 "count_out" : {
13663 "description" : "Outgoing mail count.",
13664 "type" : "number"
13665 },
13666 "glcount" : {
13667 "description" : "Number of greylisted mails.",
13668 "type" : "number"
13669 },
13670 "junk_in" : {
274b47fc 13671 "description" : "Incoming junk mail count (viruscount_in + spamcount_in + glcount + spfcount + rbl_rejects + pregreet_rejects).",
9fda36b0
DM
13672 "type" : "number"
13673 },
13674 "junk_out" : {
13675 "description" : "Outgoing junk mail count (viruscount_out + spamcount_out).",
13676 "type" : "number"
13677 },
274b47fc
DM
13678 "pregreet_rejects" : {
13679 "description" : "PREGREET recject count.",
13680 "type" : "integer"
13681 },
13682 "rbl_rejects" : {
13683 "description" : "Number of RBL rejects.",
13684 "type" : "integer"
13685 },
9fda36b0
DM
13686 "spamcount_in" : {
13687 "description" : "Incoming spam mails.",
13688 "type" : "number"
13689 },
13690 "spamcount_out" : {
13691 "description" : "Outgoing spam mails.",
13692 "type" : "number"
13693 },
13694 "spfcount" : {
13695 "description" : "Mails rejected by SPF.",
13696 "type" : "number"
13697 },
13698 "viruscount_in" : {
13699 "description" : "Number of incoming virus mails.",
13700 "type" : "number"
13701 },
13702 "viruscount_out" : {
13703 "description" : "Number of outgoing virus mails.",
13704 "type" : "number"
13705 }
13706 },
13707 "type" : "object"
d7cd791b
DM
13708 }
13709 }
13710 },
9fda36b0
DM
13711 "leaf" : 1,
13712 "path" : "/statistics/mail",
13713 "text" : "mail"
d7cd791b 13714 },
732d76e1
DM
13715 {
13716 "info" : {
13717 "GET" : {
13718 "description" : "Mail Count Statistics.",
13719 "method" : "GET",
13720 "name" : "recent",
13721 "parameters" : {
13722 "additionalProperties" : 0,
13723 "properties" : {
13724 "hours" : {
13725 "default" : 12,
13726 "description" : "How many hours you want to get",
13727 "maximum" : 24,
13728 "minimum" : 1,
13729 "optional" : 1,
13730 "type" : "integer",
13731 "typetext" : "<integer> (1 - 24)"
13732 },
13733 "timespan" : {
13734 "default" : 1800,
13735 "description" : "The Timespan for one datapoint (in seconds)",
13736 "maximum" : 1800,
13737 "minimum" : 1,
13738 "optional" : 1,
13739 "type" : "integer",
13740 "typetext" : "<integer> (1 - 1800)"
13741 }
13742 }
13743 },
13744 "permissions" : {
13745 "check" : [
13746 "admin",
13747 "qmanager",
13748 "audit"
13749 ]
13750 },
13751 "returns" : {
13752 "items" : {
13753 "properties" : {
13754 "bytes_in" : {
13755 "description" : "Number of incoming bytes mails.",
13756 "type" : "number"
13757 },
13758 "bytes_out" : {
13759 "description" : "Number of outgoing bytes mails.",
13760 "type" : "number"
13761 },
13762 "count" : {
13763 "description" : "Overall mail count (in and out).",
13764 "type" : "number"
13765 },
13766 "count_in" : {
13767 "description" : "Incoming mail count.",
13768 "type" : "number"
13769 },
13770 "count_out" : {
13771 "description" : "Outgoing mail count.",
13772 "type" : "number"
13773 },
13774 "index" : {
13775 "description" : "Time index.",
13776 "type" : "integer"
13777 },
13778 "spam" : {
13779 "description" : "Overall spam mail count (in and out).",
13780 "type" : "number"
13781 },
13782 "spam_in" : {
13783 "description" : "Incoming spam mails (spamcount_in + glcount + spfcount).",
13784 "type" : "number"
13785 },
13786 "spam_out" : {
13787 "description" : "Outgoing spam mails.",
13788 "type" : "number"
13789 },
13790 "time" : {
13791 "description" : "Time (Unix epoch).",
13792 "type" : "integer"
13793 },
13794 "timespan" : {
13795 "description" : "Timespan in seconds for one data point",
13796 "type" : "number"
13797 },
13798 "virus_in" : {
13799 "description" : "Number of incoming virus mails.",
13800 "type" : "number"
13801 },
13802 "virus_out" : {
13803 "description" : "Number of outgoing virus mails.",
13804 "type" : "number"
13805 }
13806 },
13807 "type" : "object"
13808 },
13809 "type" : "array"
13810 }
13811 }
13812 },
13813 "leaf" : 1,
13814 "path" : "/statistics/recent",
13815 "text" : "recent"
13816 },
13817 {
13818 "info" : {
13819 "GET" : {
13820 "description" : "Top recent Mail Receivers (including spam)",
13821 "method" : "GET",
13822 "name" : "recentreceivers",
13823 "parameters" : {
13824 "additionalProperties" : 0,
13825 "properties" : {
13826 "hours" : {
13827 "default" : 12,
13828 "description" : "How many hours you want to get",
13829 "maximum" : 24,
13830 "minimum" : 1,
13831 "optional" : 1,
13832 "type" : "integer",
13833 "typetext" : "<integer> (1 - 24)"
13834 },
13835 "limit" : {
13836 "default" : 5,
13837 "description" : "The maximum number of receivers to return.",
13838 "maximum" : 50,
13839 "minimum" : 1,
13840 "optional" : 1,
13841 "type" : "integer",
13842 "typetext" : "<integer> (1 - 50)"
13843 }
13844 }
13845 },
13846 "permissions" : {
13847 "check" : [
13848 "admin",
13849 "qmanager",
13850 "audit"
13851 ]
13852 },
13853 "returns" : {
13854 "items" : {
13855 "properties" : {
13856 "count" : {
13857 "description" : "The count of incoming not blocked E-Mails",
13858 "type" : "integer"
13859 },
13860 "receiver" : {
13861 "description" : "The receiver",
13862 "type" : "string"
13863 }
13864 },
13865 "type" : "object"
13866 },
13867 "type" : "array"
13868 }
13869 }
13870 },
13871 "leaf" : 1,
13872 "path" : "/statistics/recentreceivers",
13873 "text" : "recentreceivers"
13874 },
d7cd791b 13875 {
9fda36b0
DM
13876 "info" : {
13877 "GET" : {
13878 "description" : "Mail Count Statistics.",
13879 "method" : "GET",
13880 "name" : "mailcount",
13881 "parameters" : {
13882 "additionalProperties" : 0,
13883 "properties" : {
13884 "day" : {
13885 "description" : "Day of month. Get statistics for a single day.",
13886 "maximum" : 31,
13887 "minimum" : 1,
13888 "optional" : 1,
13889 "type" : "integer",
13890 "typetext" : "<integer> (1 - 31)"
d7cd791b 13891 },
9fda36b0
DM
13892 "endtime" : {
13893 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
13894 "minimum" : 1,
13895 "optional" : 1,
13896 "type" : "integer",
13897 "typetext" : "<integer> (1 - N)"
d7cd791b 13898 },
9fda36b0
DM
13899 "month" : {
13900 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
13901 "maximum" : 12,
13902 "minimum" : 1,
13903 "optional" : 1,
13904 "type" : "integer",
13905 "typetext" : "<integer> (1 - 12)"
13906 },
13907 "starttime" : {
13908 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
13909 "minimum" : 0,
13910 "optional" : 1,
13911 "type" : "integer",
13912 "typetext" : "<integer> (0 - N)"
13913 },
13914 "timespan" : {
13915 "default" : 3600,
13916 "description" : "Return Mails/<timespan>, where <timespan> is specified in seconds.",
13917 "maximum" : 31622400,
13918 "minimum" : 3600,
13919 "optional" : 1,
13920 "type" : "integer",
13921 "typetext" : "<integer> (3600 - 31622400)"
13922 },
13923 "year" : {
13924 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
13925 "maximum" : 3000,
13926 "minimum" : 1900,
13927 "optional" : 1,
13928 "type" : "integer",
13929 "typetext" : "<integer> (1900 - 3000)"
d7cd791b
DM
13930 }
13931 }
13932 },
9fda36b0
DM
13933 "permissions" : {
13934 "check" : [
13935 "admin",
13936 "qmanager",
13937 "audit"
13938 ]
13939 },
13940 "returns" : {
13941 "items" : {
13942 "properties" : {
13943 "bounces_in" : {
13944 "description" : "Incoming bounce mail count (sender = <>).",
13945 "type" : "number"
13946 },
13947 "bounces_out" : {
13948 "description" : "Outgoing bounce mail count (sender = <>).",
13949 "type" : "number"
13950 },
13951 "count" : {
13952 "description" : "Overall mail count (in and out).",
13953 "type" : "number"
13954 },
13955 "count_in" : {
13956 "description" : "Incoming mail count.",
13957 "type" : "number"
13958 },
13959 "count_out" : {
13960 "description" : "Outgoing mail count.",
13961 "type" : "number"
13962 },
13963 "index" : {
13964 "description" : "Time index.",
13965 "type" : "integer"
13966 },
274b47fc
DM
13967 "pregreet_rejects" : {
13968 "description" : "PREGREET recject count.",
13969 "type" : "integer"
13970 },
13971 "rbl_rejects" : {
13972 "description" : "Number of RBL rejects.",
13973 "type" : "integer"
13974 },
9fda36b0 13975 "spamcount_in" : {
274b47fc 13976 "description" : "Incoming spam mails (spamcount_in + glcount + spfcount + rbl_rejects + pregreet_rejects).",
9fda36b0
DM
13977 "type" : "number"
13978 },
13979 "spamcount_out" : {
13980 "description" : "Outgoing spam mails.",
13981 "type" : "number"
13982 },
13983 "time" : {
13984 "description" : "Time (Unix epoch).",
13985 "type" : "integer"
13986 },
13987 "viruscount_in" : {
13988 "description" : "Number of incoming virus mails.",
13989 "type" : "number"
13990 },
13991 "viruscount_out" : {
13992 "description" : "Number of outgoing virus mails.",
13993 "type" : "number"
13994 }
13995 },
13996 "type" : "object"
13997 },
13998 "type" : "array"
13999 }
d7cd791b 14000 }
9fda36b0
DM
14001 },
14002 "leaf" : 1,
14003 "path" : "/statistics/mailcount",
14004 "text" : "mailcount"
14005 },
14006 {
d7cd791b
DM
14007 "info" : {
14008 "GET" : {
9fda36b0 14009 "description" : "Get Statistics about detected Viruses.",
d7cd791b 14010 "method" : "GET",
9fda36b0 14011 "name" : "virus",
d7cd791b
DM
14012 "parameters" : {
14013 "additionalProperties" : 0,
14014 "properties" : {
9fda36b0
DM
14015 "day" : {
14016 "description" : "Day of month. Get statistics for a single day.",
14017 "maximum" : 31,
14018 "minimum" : 1,
14019 "optional" : 1,
14020 "type" : "integer",
14021 "typetext" : "<integer> (1 - 31)"
14022 },
d7cd791b 14023 "endtime" : {
9fda36b0 14024 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
d7cd791b
DM
14025 "minimum" : 1,
14026 "optional" : 1,
14027 "type" : "integer",
14028 "typetext" : "<integer> (1 - N)"
14029 },
9fda36b0
DM
14030 "month" : {
14031 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
14032 "maximum" : 12,
14033 "minimum" : 1,
d7cd791b 14034 "optional" : 1,
9fda36b0
DM
14035 "type" : "integer",
14036 "typetext" : "<integer> (1 - 12)"
d7cd791b
DM
14037 },
14038 "starttime" : {
9fda36b0 14039 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
d7cd791b
DM
14040 "minimum" : 0,
14041 "optional" : 1,
14042 "type" : "integer",
14043 "typetext" : "<integer> (0 - N)"
9fda36b0
DM
14044 },
14045 "year" : {
14046 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
14047 "maximum" : 3000,
14048 "minimum" : 1900,
14049 "optional" : 1,
14050 "type" : "integer",
14051 "typetext" : "<integer> (1900 - 3000)"
d7cd791b
DM
14052 }
14053 }
14054 },
14055 "permissions" : {
14056 "check" : [
14057 "admin",
14058 "qmanager",
9fda36b0 14059 "audit"
d7cd791b
DM
14060 ]
14061 },
14062 "returns" : {
14063 "items" : {
14064 "properties" : {
14065 "count" : {
9fda36b0 14066 "description" : "Detection count.",
d7cd791b
DM
14067 "type" : "integer"
14068 },
9fda36b0
DM
14069 "name" : {
14070 "description" : "Virus name.",
14071 "type" : "string"
d7cd791b
DM
14072 }
14073 },
14074 "type" : "object"
14075 },
d7cd791b
DM
14076 "type" : "array"
14077 }
14078 }
14079 },
9fda36b0
DM
14080 "leaf" : 1,
14081 "path" : "/statistics/virus",
14082 "text" : "virus"
d7cd791b
DM
14083 },
14084 {
14085 "info" : {
14086 "GET" : {
9fda36b0 14087 "description" : "Get the count of spam mails grouped by spam score. Count for score 10 includes mails with spam score > 10.",
d7cd791b 14088 "method" : "GET",
9fda36b0 14089 "name" : "spamscores",
d7cd791b
DM
14090 "parameters" : {
14091 "additionalProperties" : 0,
14092 "properties" : {
9fda36b0
DM
14093 "day" : {
14094 "description" : "Day of month. Get statistics for a single day.",
14095 "maximum" : 31,
14096 "minimum" : 1,
14097 "optional" : 1,
14098 "type" : "integer",
14099 "typetext" : "<integer> (1 - 31)"
d7cd791b 14100 },
9fda36b0
DM
14101 "endtime" : {
14102 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
14103 "minimum" : 1,
d7cd791b 14104 "optional" : 1,
9fda36b0
DM
14105 "type" : "integer",
14106 "typetext" : "<integer> (1 - N)"
14107 },
14108 "month" : {
14109 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
14110 "maximum" : 12,
14111 "minimum" : 1,
14112 "optional" : 1,
14113 "type" : "integer",
14114 "typetext" : "<integer> (1 - 12)"
14115 },
14116 "starttime" : {
14117 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
14118 "minimum" : 0,
14119 "optional" : 1,
14120 "type" : "integer",
14121 "typetext" : "<integer> (0 - N)"
14122 },
14123 "year" : {
14124 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
14125 "maximum" : 3000,
14126 "minimum" : 1900,
14127 "optional" : 1,
14128 "type" : "integer",
14129 "typetext" : "<integer> (1900 - 3000)"
d7cd791b
DM
14130 }
14131 }
14132 },
14133 "permissions" : {
14134 "check" : [
14135 "admin",
14136 "qmanager",
9fda36b0 14137 "audit"
d7cd791b
DM
14138 ]
14139 },
14140 "returns" : {
9fda36b0
DM
14141 "items" : {
14142 "properties" : {
14143 "count" : {
14144 "description" : "Detection count.",
14145 "type" : "integer"
14146 },
14147 "level" : {
14148 "description" : "Spam level.",
14149 "type" : "string"
14150 },
14151 "ratio" : {
14152 "description" : "Portion of overall mail count.",
14153 "type" : "number"
14154 }
d7cd791b 14155 },
9fda36b0
DM
14156 "type" : "object"
14157 },
14158 "type" : "array"
14159 }
14160 }
14161 },
14162 "leaf" : 1,
14163 "path" : "/statistics/spamscores",
14164 "text" : "spamscores"
14165 },
14166 {
14167 "info" : {
14168 "GET" : {
14169 "description" : "Get the count of spam mails grouped by spam score. Count for score 10 includes mails with spam score > 10.",
14170 "method" : "GET",
14171 "name" : "maildistribution",
14172 "parameters" : {
14173 "additionalProperties" : 0,
14174 "properties" : {
14175 "day" : {
14176 "description" : "Day of month. Get statistics for a single day.",
14177 "maximum" : 31,
14178 "minimum" : 1,
d7cd791b 14179 "optional" : 1,
9fda36b0
DM
14180 "type" : "integer",
14181 "typetext" : "<integer> (1 - 31)"
d7cd791b 14182 },
9fda36b0
DM
14183 "endtime" : {
14184 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
14185 "minimum" : 1,
14186 "optional" : 1,
14187 "type" : "integer",
14188 "typetext" : "<integer> (1 - N)"
d7cd791b 14189 },
9fda36b0
DM
14190 "month" : {
14191 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
14192 "maximum" : 12,
14193 "minimum" : 1,
14194 "optional" : 1,
14195 "type" : "integer",
14196 "typetext" : "<integer> (1 - 12)"
d7cd791b 14197 },
9fda36b0
DM
14198 "starttime" : {
14199 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
14200 "minimum" : 0,
14201 "optional" : 1,
14202 "type" : "integer",
14203 "typetext" : "<integer> (0 - N)"
d7cd791b 14204 },
9fda36b0
DM
14205 "year" : {
14206 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
14207 "maximum" : 3000,
14208 "minimum" : 1900,
14209 "optional" : 1,
14210 "type" : "integer",
14211 "typetext" : "<integer> (1900 - 3000)"
d7cd791b 14212 }
9fda36b0
DM
14213 }
14214 },
14215 "permissions" : {
14216 "check" : [
14217 "admin",
14218 "qmanager",
14219 "audit"
14220 ]
14221 },
14222 "returns" : {
14223 "items" : {
14224 "properties" : {
14225 "bounces_in" : {
14226 "description" : "Incoming bounce mail count (sender = <>).",
14227 "type" : "number"
14228 },
14229 "bounces_out" : {
14230 "description" : "Outgoing bounce mail count (sender = <>).",
14231 "type" : "number"
14232 },
14233 "count" : {
14234 "description" : "Overall mail count (in and out).",
14235 "type" : "number"
14236 },
14237 "count_in" : {
14238 "description" : "Incoming mail count.",
14239 "type" : "number"
14240 },
14241 "count_out" : {
14242 "description" : "Outgoing mail count.",
14243 "type" : "number"
14244 },
14245 "index" : {
14246 "description" : "Hour (0-23).",
14247 "type" : "integer"
14248 },
14249 "spamcount_in" : {
14250 "description" : "Incoming spam mails (spamcount_in + glcount + spfcount).",
14251 "type" : "number"
14252 },
14253 "spamcount_out" : {
14254 "description" : "Outgoing spam mails.",
14255 "type" : "number"
14256 },
14257 "viruscount_in" : {
14258 "description" : "Number of incoming virus mails.",
14259 "type" : "number"
14260 },
14261 "viruscount_out" : {
14262 "description" : "Number of outgoing virus mails.",
14263 "type" : "number"
14264 }
14265 },
14266 "type" : "object"
d7cd791b 14267 },
9fda36b0 14268 "type" : "array"
d7cd791b 14269 }
9fda36b0
DM
14270 }
14271 },
14272 "leaf" : 1,
14273 "path" : "/statistics/maildistribution",
14274 "text" : "maildistribution"
14275 },
14276 {
14277 "info" : {
14278 "GET" : {
274b47fc 14279 "description" : "Early SMTP reject count statistic (RBL, PREGREET rejects with postscreen)",
9fda36b0 14280 "method" : "GET",
274b47fc 14281 "name" : "rejectcount",
d7cd791b
DM
14282 "parameters" : {
14283 "additionalProperties" : 0,
14284 "properties" : {
9fda36b0
DM
14285 "day" : {
14286 "description" : "Day of month. Get statistics for a single day.",
14287 "maximum" : 31,
14288 "minimum" : 1,
14289 "optional" : 1,
14290 "type" : "integer",
14291 "typetext" : "<integer> (1 - 31)"
d7cd791b 14292 },
9fda36b0
DM
14293 "endtime" : {
14294 "description" : "Only consider entries older than 'endtime' (unix epoch). This is set to '<start> + 1day' by default.",
14295 "minimum" : 1,
14296 "optional" : 1,
14297 "type" : "integer",
14298 "typetext" : "<integer> (1 - N)"
14299 },
14300 "month" : {
14301 "description" : "Month. You will get statistics for the whole month if you do not specify a day.",
14302 "maximum" : 12,
14303 "minimum" : 1,
14304 "optional" : 1,
14305 "type" : "integer",
14306 "typetext" : "<integer> (1 - 12)"
14307 },
14308 "starttime" : {
14309 "description" : "Only consider entries newer than 'starttime' (unix epoch). Default is 'now - 1day'.",
14310 "minimum" : 0,
14311 "optional" : 1,
14312 "type" : "integer",
14313 "typetext" : "<integer> (0 - N)"
14314 },
14315 "timespan" : {
14316 "default" : 3600,
274b47fc 14317 "description" : "Return RBL/PREGREET rejects/<timespan>, where <timespan> is specified in seconds.",
9fda36b0
DM
14318 "maximum" : 31622400,
14319 "minimum" : 3600,
14320 "optional" : 1,
14321 "type" : "integer",
14322 "typetext" : "<integer> (3600 - 31622400)"
14323 },
14324 "year" : {
14325 "description" : "Year. Defaults to current year. You will get statistics for the whole year if you do not specify a month or day.",
14326 "maximum" : 3000,
14327 "minimum" : 1900,
14328 "optional" : 1,
14329 "type" : "integer",
14330 "typetext" : "<integer> (1900 - 3000)"
d7cd791b
DM
14331 }
14332 }
14333 },
14334 "permissions" : {
14335 "check" : [
14336 "admin",
14337 "qmanager",
9fda36b0 14338 "audit"
d7cd791b
DM
14339 ]
14340 },
d7cd791b 14341 "returns" : {
9fda36b0
DM
14342 "items" : {
14343 "properties" : {
9fda36b0
DM
14344 "index" : {
14345 "description" : "Time index.",
14346 "type" : "integer"
14347 },
274b47fc
DM
14348 "pregreet_rejects" : {
14349 "description" : "PREGREET recject count.",
14350 "type" : "integer"
14351 },
14352 "rbl_rejects" : {
14353 "description" : "RBL recject count.",
14354 "type" : "integer"
14355 },
9fda36b0
DM
14356 "time" : {
14357 "description" : "Time (Unix epoch).",
14358 "type" : "integer"
14359 }
14360 },
14361 "type" : "object"
14362 },
14363 "type" : "array"
d7cd791b
DM
14364 }
14365 }
14366 },
14367 "leaf" : 1,
274b47fc
DM
14368 "path" : "/statistics/rejectcount",
14369 "text" : "rejectcount"
d7cd791b
DM
14370 }
14371 ],
14372 "info" : {
14373 "GET" : {
14374 "description" : "Directory index.",
14375 "method" : "GET",
14376 "name" : "index",
14377 "parameters" : {
14378 "additionalProperties" : 0
14379 },
14380 "permissions" : {
9fda36b0
DM
14381 "check" : [
14382 "admin",
14383 "qmanager",
14384 "audit"
14385 ]
d7cd791b
DM
14386 },
14387 "returns" : {
14388 "items" : {
14389 "properties" : {},
14390 "type" : "object"
14391 },
14392 "links" : [
14393 {
14394 "href" : "{name}",
14395 "rel" : "child"
14396 }
14397 ],
14398 "type" : "array"
14399 }
14400 }
14401 },
14402 "leaf" : 0,
9fda36b0
DM
14403 "path" : "/statistics",
14404 "text" : "statistics"
d7cd791b 14405 },
410dc2c9
DM
14406 {
14407 "info" : {
14408 "GET" : {
14409 "description" : "API version details.",
14410 "method" : "GET",
14411 "name" : "version",
14412 "parameters" : {
14413 "additionalProperties" : 0
14414 },
14415 "permissions" : {
14416 "user" : "all"
14417 },
14418 "returns" : {
14419 "properties" : {
14420 "release" : {
14421 "type" : "string"
14422 },
14423 "repoid" : {
14424 "type" : "string"
14425 },
14426 "version" : {
14427 "type" : "string"
14428 }
14429 },
14430 "type" : "object"
14431 }
14432 }
14433 },
14434 "leaf" : 1,
14435 "path" : "/version",
14436 "text" : "version"
14437 }
14438]
14439;
14440