@@ 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, |