| @@ 5757-5793 (lines=37) @@ | ||
| 5754 | ||
| 5755 | return self._send_xml_command(cmd) |
|
| 5756 | ||
| 5757 | def modify_role( |
|
| 5758 | self, |
|
| 5759 | role_id: str, |
|
| 5760 | *, |
|
| 5761 | comment: Optional[str] = None, |
|
| 5762 | name: Optional[str] = None, |
|
| 5763 | users: Optional[List[str]] = None, |
|
| 5764 | ) -> Any: |
|
| 5765 | """Modifies an existing role. |
|
| 5766 | ||
| 5767 | Arguments: |
|
| 5768 | role_id: UUID of role to modify. |
|
| 5769 | comment: Name of role. |
|
| 5770 | name: Comment on role. |
|
| 5771 | users: List of user names. |
|
| 5772 | ||
| 5773 | Returns: |
|
| 5774 | The response. See :py:meth:`send_command` for details. |
|
| 5775 | """ |
|
| 5776 | if not role_id: |
|
| 5777 | raise RequiredArgument( |
|
| 5778 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 5779 | ) |
|
| 5780 | ||
| 5781 | cmd = XmlCommand("modify_role") |
|
| 5782 | cmd.set_attribute("role_id", role_id) |
|
| 5783 | ||
| 5784 | if comment: |
|
| 5785 | cmd.add_element("comment", comment) |
|
| 5786 | ||
| 5787 | if name: |
|
| 5788 | cmd.add_element("name", name) |
|
| 5789 | ||
| 5790 | if users: |
|
| 5791 | cmd.add_element("users", to_comma_list(users)) |
|
| 5792 | ||
| 5793 | return self._send_xml_command(cmd) |
|
| 5794 | ||
| 5795 | def modify_scanner( |
|
| 5796 | self, |
|
| @@ 5498-5534 (lines=37) @@ | ||
| 5495 | ) |
|
| 5496 | return self.modify_config_set_family_selection(config_id, **kwargs) |
|
| 5497 | ||
| 5498 | def modify_group( |
|
| 5499 | self, |
|
| 5500 | group_id: str, |
|
| 5501 | *, |
|
| 5502 | comment: Optional[str] = None, |
|
| 5503 | name: Optional[str] = None, |
|
| 5504 | users: Optional[List[str]] = None, |
|
| 5505 | ) -> Any: |
|
| 5506 | """Modifies an existing group. |
|
| 5507 | ||
| 5508 | Arguments: |
|
| 5509 | group_id: UUID of group to modify. |
|
| 5510 | comment: Comment on group. |
|
| 5511 | name: Name of group. |
|
| 5512 | users: List of user names to be in the group |
|
| 5513 | ||
| 5514 | Returns: |
|
| 5515 | The response. See :py:meth:`send_command` for details. |
|
| 5516 | """ |
|
| 5517 | if not group_id: |
|
| 5518 | raise RequiredArgument( |
|
| 5519 | function=self.modify_group.__name__, argument='group_id' |
|
| 5520 | ) |
|
| 5521 | ||
| 5522 | cmd = XmlCommand("modify_group") |
|
| 5523 | cmd.set_attribute("group_id", group_id) |
|
| 5524 | ||
| 5525 | if comment: |
|
| 5526 | cmd.add_element("comment", comment) |
|
| 5527 | ||
| 5528 | if name: |
|
| 5529 | cmd.add_element("name", name) |
|
| 5530 | ||
| 5531 | if users: |
|
| 5532 | cmd.add_element("users", to_comma_list(users)) |
|
| 5533 | ||
| 5534 | return self._send_xml_command(cmd) |
|
| 5535 | ||
| 5536 | def modify_note( |
|
| 5537 | self, |
|