| @@ 5226-5262 (lines=37) @@ | ||
| 5223 | ||
| 5224 | return self._send_xml_command(cmd) |
|
| 5225 | ||
| 5226 | def modify_role( |
|
| 5227 | self, |
|
| 5228 | role_id: str, |
|
| 5229 | *, |
|
| 5230 | comment: Optional[str] = None, |
|
| 5231 | name: Optional[str] = None, |
|
| 5232 | users: Optional[List[str]] = None |
|
| 5233 | ) -> Any: |
|
| 5234 | """Modifies an existing role. |
|
| 5235 | ||
| 5236 | Arguments: |
|
| 5237 | role_id: UUID of role to modify. |
|
| 5238 | comment: Name of role. |
|
| 5239 | name: Comment on role. |
|
| 5240 | users: List of user names. |
|
| 5241 | ||
| 5242 | Returns: |
|
| 5243 | The response. See :py:meth:`send_command` for details. |
|
| 5244 | """ |
|
| 5245 | if not role_id: |
|
| 5246 | raise RequiredArgument( |
|
| 5247 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 5248 | ) |
|
| 5249 | ||
| 5250 | cmd = XmlCommand("modify_role") |
|
| 5251 | cmd.set_attribute("role_id", role_id) |
|
| 5252 | ||
| 5253 | if comment: |
|
| 5254 | cmd.add_element("comment", comment) |
|
| 5255 | ||
| 5256 | if name: |
|
| 5257 | cmd.add_element("name", name) |
|
| 5258 | ||
| 5259 | if users: |
|
| 5260 | cmd.add_element("users", _to_comma_list(users)) |
|
| 5261 | ||
| 5262 | return self._send_xml_command(cmd) |
|
| 5263 | ||
| 5264 | def modify_scanner( |
|
| 5265 | self, |
|
| @@ 4855-4891 (lines=37) @@ | ||
| 4852 | ||
| 4853 | return self._send_xml_command(cmd) |
|
| 4854 | ||
| 4855 | def modify_group( |
|
| 4856 | self, |
|
| 4857 | group_id: str, |
|
| 4858 | *, |
|
| 4859 | comment: Optional[str] = None, |
|
| 4860 | name: Optional[str] = None, |
|
| 4861 | users: Optional[List[str]] = None |
|
| 4862 | ) -> Any: |
|
| 4863 | """Modifies an existing group. |
|
| 4864 | ||
| 4865 | Arguments: |
|
| 4866 | group_id: UUID of group to modify. |
|
| 4867 | comment: Comment on group. |
|
| 4868 | name: Name of group. |
|
| 4869 | users: List of user names to be in the group |
|
| 4870 | ||
| 4871 | Returns: |
|
| 4872 | The response. See :py:meth:`send_command` for details. |
|
| 4873 | """ |
|
| 4874 | if not group_id: |
|
| 4875 | raise RequiredArgument( |
|
| 4876 | function=self.modify_group.__name__, argument='group_id' |
|
| 4877 | ) |
|
| 4878 | ||
| 4879 | cmd = XmlCommand("modify_group") |
|
| 4880 | cmd.set_attribute("group_id", group_id) |
|
| 4881 | ||
| 4882 | if comment: |
|
| 4883 | cmd.add_element("comment", comment) |
|
| 4884 | ||
| 4885 | if name: |
|
| 4886 | cmd.add_element("name", name) |
|
| 4887 | ||
| 4888 | if users: |
|
| 4889 | cmd.add_element("users", _to_comma_list(users)) |
|
| 4890 | ||
| 4891 | return self._send_xml_command(cmd) |
|
| 4892 | ||
| 4893 | def modify_note( |
|
| 4894 | self, |
|