@@ 5694-5730 (lines=37) @@ | ||
5691 | ||
5692 | return self._send_xml_command(cmd) |
|
5693 | ||
5694 | def modify_role( |
|
5695 | self, |
|
5696 | role_id: str, |
|
5697 | *, |
|
5698 | comment: Optional[str] = None, |
|
5699 | name: Optional[str] = None, |
|
5700 | users: Optional[List[str]] = None, |
|
5701 | ) -> Any: |
|
5702 | """Modifies an existing role. |
|
5703 | ||
5704 | Arguments: |
|
5705 | role_id: UUID of role to modify. |
|
5706 | comment: Name of role. |
|
5707 | name: Comment on role. |
|
5708 | users: List of user names. |
|
5709 | ||
5710 | Returns: |
|
5711 | The response. See :py:meth:`send_command` for details. |
|
5712 | """ |
|
5713 | if not role_id: |
|
5714 | raise RequiredArgument( |
|
5715 | function=self.modify_role.__name__, argument='role_id argument' |
|
5716 | ) |
|
5717 | ||
5718 | cmd = XmlCommand("modify_role") |
|
5719 | cmd.set_attribute("role_id", role_id) |
|
5720 | ||
5721 | if comment: |
|
5722 | cmd.add_element("comment", comment) |
|
5723 | ||
5724 | if name: |
|
5725 | cmd.add_element("name", name) |
|
5726 | ||
5727 | if users: |
|
5728 | cmd.add_element("users", to_comma_list(users)) |
|
5729 | ||
5730 | return self._send_xml_command(cmd) |
|
5731 | ||
5732 | def modify_scanner( |
|
5733 | self, |
|
@@ 5435-5471 (lines=37) @@ | ||
5432 | ) |
|
5433 | return self.modify_config_set_family_selection(config_id, **kwargs) |
|
5434 | ||
5435 | def modify_group( |
|
5436 | self, |
|
5437 | group_id: str, |
|
5438 | *, |
|
5439 | comment: Optional[str] = None, |
|
5440 | name: Optional[str] = None, |
|
5441 | users: Optional[List[str]] = None, |
|
5442 | ) -> Any: |
|
5443 | """Modifies an existing group. |
|
5444 | ||
5445 | Arguments: |
|
5446 | group_id: UUID of group to modify. |
|
5447 | comment: Comment on group. |
|
5448 | name: Name of group. |
|
5449 | users: List of user names to be in the group |
|
5450 | ||
5451 | Returns: |
|
5452 | The response. See :py:meth:`send_command` for details. |
|
5453 | """ |
|
5454 | if not group_id: |
|
5455 | raise RequiredArgument( |
|
5456 | function=self.modify_group.__name__, argument='group_id' |
|
5457 | ) |
|
5458 | ||
5459 | cmd = XmlCommand("modify_group") |
|
5460 | cmd.set_attribute("group_id", group_id) |
|
5461 | ||
5462 | if comment: |
|
5463 | cmd.add_element("comment", comment) |
|
5464 | ||
5465 | if name: |
|
5466 | cmd.add_element("name", name) |
|
5467 | ||
5468 | if users: |
|
5469 | cmd.add_element("users", to_comma_list(users)) |
|
5470 | ||
5471 | return self._send_xml_command(cmd) |
|
5472 | ||
5473 | def modify_note( |
|
5474 | self, |