| @@ 5438-5474 (lines=37) @@ | ||
| 5435 | ||
| 5436 | return self._send_xml_command(cmd) |
|
| 5437 | ||
| 5438 | def modify_role( |
|
| 5439 | self, |
|
| 5440 | role_id: str, |
|
| 5441 | *, |
|
| 5442 | comment: Optional[str] = None, |
|
| 5443 | name: Optional[str] = None, |
|
| 5444 | users: Optional[List[str]] = None |
|
| 5445 | ) -> Any: |
|
| 5446 | """Modifies an existing role. |
|
| 5447 | ||
| 5448 | Arguments: |
|
| 5449 | role_id: UUID of role to modify. |
|
| 5450 | comment: Name of role. |
|
| 5451 | name: Comment on role. |
|
| 5452 | users: List of user names. |
|
| 5453 | ||
| 5454 | Returns: |
|
| 5455 | The response. See :py:meth:`send_command` for details. |
|
| 5456 | """ |
|
| 5457 | if not role_id: |
|
| 5458 | raise RequiredArgument( |
|
| 5459 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 5460 | ) |
|
| 5461 | ||
| 5462 | cmd = XmlCommand("modify_role") |
|
| 5463 | cmd.set_attribute("role_id", role_id) |
|
| 5464 | ||
| 5465 | if comment: |
|
| 5466 | cmd.add_element("comment", comment) |
|
| 5467 | ||
| 5468 | if name: |
|
| 5469 | cmd.add_element("name", name) |
|
| 5470 | ||
| 5471 | if users: |
|
| 5472 | cmd.add_element("users", _to_comma_list(users)) |
|
| 5473 | ||
| 5474 | return self._send_xml_command(cmd) |
|
| 5475 | ||
| 5476 | def modify_scanner( |
|
| 5477 | self, |
|
| @@ 5062-5098 (lines=37) @@ | ||
| 5059 | ||
| 5060 | return self._send_xml_command(cmd) |
|
| 5061 | ||
| 5062 | def modify_group( |
|
| 5063 | self, |
|
| 5064 | group_id: str, |
|
| 5065 | *, |
|
| 5066 | comment: Optional[str] = None, |
|
| 5067 | name: Optional[str] = None, |
|
| 5068 | users: Optional[List[str]] = None |
|
| 5069 | ) -> Any: |
|
| 5070 | """Modifies an existing group. |
|
| 5071 | ||
| 5072 | Arguments: |
|
| 5073 | group_id: UUID of group to modify. |
|
| 5074 | comment: Comment on group. |
|
| 5075 | name: Name of group. |
|
| 5076 | users: List of user names to be in the group |
|
| 5077 | ||
| 5078 | Returns: |
|
| 5079 | The response. See :py:meth:`send_command` for details. |
|
| 5080 | """ |
|
| 5081 | if not group_id: |
|
| 5082 | raise RequiredArgument( |
|
| 5083 | function=self.modify_group.__name__, argument='group_id' |
|
| 5084 | ) |
|
| 5085 | ||
| 5086 | cmd = XmlCommand("modify_group") |
|
| 5087 | cmd.set_attribute("group_id", group_id) |
|
| 5088 | ||
| 5089 | if comment: |
|
| 5090 | cmd.add_element("comment", comment) |
|
| 5091 | ||
| 5092 | if name: |
|
| 5093 | cmd.add_element("name", name) |
|
| 5094 | ||
| 5095 | if users: |
|
| 5096 | cmd.add_element("users", _to_comma_list(users)) |
|
| 5097 | ||
| 5098 | return self._send_xml_command(cmd) |
|
| 5099 | ||
| 5100 | def modify_note( |
|
| 5101 | self, |
|