| @@ 1094-1130 (lines=37) @@ | ||
| 1091 | ||
| 1092 | return self._send_xml_command(cmd) |
|
| 1093 | ||
| 1094 | def modify_role( |
|
| 1095 | self, |
|
| 1096 | role_id: str, |
|
| 1097 | *, |
|
| 1098 | comment: Optional[str] = None, |
|
| 1099 | name: Optional[str] = None, |
|
| 1100 | users: Optional[List[str]] = None, |
|
| 1101 | ) -> Any: |
|
| 1102 | """Modifies an existing role. |
|
| 1103 | ||
| 1104 | Arguments: |
|
| 1105 | role_id: UUID of role to modify. |
|
| 1106 | comment: Name of role. |
|
| 1107 | name: Comment on role. |
|
| 1108 | users: List of user names. |
|
| 1109 | ||
| 1110 | Returns: |
|
| 1111 | The response. See :py:meth:`send_command` for details. |
|
| 1112 | """ |
|
| 1113 | if not role_id: |
|
| 1114 | raise RequiredArgument( |
|
| 1115 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 1116 | ) |
|
| 1117 | ||
| 1118 | cmd = XmlCommand("modify_role") |
|
| 1119 | cmd.set_attribute("role_id", role_id) |
|
| 1120 | ||
| 1121 | if comment: |
|
| 1122 | cmd.add_element("comment", comment) |
|
| 1123 | ||
| 1124 | if name: |
|
| 1125 | cmd.add_element("name", name) |
|
| 1126 | ||
| 1127 | if users: |
|
| 1128 | cmd.add_element("users", to_comma_list(users)) |
|
| 1129 | ||
| 1130 | return self._send_xml_command(cmd) |
|
| 1131 | ||
| 1132 | def modify_setting( |
|
| 1133 | self, |
|
| @@ 1001-1037 (lines=37) @@ | ||
| 998 | ||
| 999 | return self._send_xml_command(cmd) |
|
| 1000 | ||
| 1001 | def modify_group( |
|
| 1002 | self, |
|
| 1003 | group_id: str, |
|
| 1004 | *, |
|
| 1005 | comment: Optional[str] = None, |
|
| 1006 | name: Optional[str] = None, |
|
| 1007 | users: Optional[List[str]] = None, |
|
| 1008 | ) -> Any: |
|
| 1009 | """Modifies an existing group. |
|
| 1010 | ||
| 1011 | Arguments: |
|
| 1012 | group_id: UUID of group to modify. |
|
| 1013 | comment: Comment on group. |
|
| 1014 | name: Name of group. |
|
| 1015 | users: List of user names to be in the group |
|
| 1016 | ||
| 1017 | Returns: |
|
| 1018 | The response. See :py:meth:`send_command` for details. |
|
| 1019 | """ |
|
| 1020 | if not group_id: |
|
| 1021 | raise RequiredArgument( |
|
| 1022 | function=self.modify_group.__name__, argument='group_id' |
|
| 1023 | ) |
|
| 1024 | ||
| 1025 | cmd = XmlCommand("modify_group") |
|
| 1026 | cmd.set_attribute("group_id", group_id) |
|
| 1027 | ||
| 1028 | if comment: |
|
| 1029 | cmd.add_element("comment", comment) |
|
| 1030 | ||
| 1031 | if name: |
|
| 1032 | cmd.add_element("name", name) |
|
| 1033 | ||
| 1034 | if users: |
|
| 1035 | cmd.add_element("users", to_comma_list(users)) |
|
| 1036 | ||
| 1037 | return self._send_xml_command(cmd) |
|
| 1038 | ||
| 1039 | def modify_report_format( |
|
| 1040 | self, |
|