| @@ 5426-5462 (lines=37) @@ | ||
| 5423 | ||
| 5424 | return self._send_xml_command(cmd) |
|
| 5425 | ||
| 5426 | def modify_role( |
|
| 5427 | self, |
|
| 5428 | role_id: str, |
|
| 5429 | *, |
|
| 5430 | comment: Optional[str] = None, |
|
| 5431 | name: Optional[str] = None, |
|
| 5432 | users: Optional[List[str]] = None |
|
| 5433 | ) -> Any: |
|
| 5434 | """Modifies an existing role. |
|
| 5435 | ||
| 5436 | Arguments: |
|
| 5437 | role_id: UUID of role to modify. |
|
| 5438 | comment: Name of role. |
|
| 5439 | name: Comment on role. |
|
| 5440 | users: List of user names. |
|
| 5441 | ||
| 5442 | Returns: |
|
| 5443 | The response. See :py:meth:`send_command` for details. |
|
| 5444 | """ |
|
| 5445 | if not role_id: |
|
| 5446 | raise RequiredArgument( |
|
| 5447 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 5448 | ) |
|
| 5449 | ||
| 5450 | cmd = XmlCommand("modify_role") |
|
| 5451 | cmd.set_attribute("role_id", role_id) |
|
| 5452 | ||
| 5453 | if comment: |
|
| 5454 | cmd.add_element("comment", comment) |
|
| 5455 | ||
| 5456 | if name: |
|
| 5457 | cmd.add_element("name", name) |
|
| 5458 | ||
| 5459 | if users: |
|
| 5460 | cmd.add_element("users", _to_comma_list(users)) |
|
| 5461 | ||
| 5462 | return self._send_xml_command(cmd) |
|
| 5463 | ||
| 5464 | def modify_scanner( |
|
| 5465 | self, |
|
| @@ 5050-5086 (lines=37) @@ | ||
| 5047 | ||
| 5048 | return self._send_xml_command(cmd) |
|
| 5049 | ||
| 5050 | def modify_group( |
|
| 5051 | self, |
|
| 5052 | group_id: str, |
|
| 5053 | *, |
|
| 5054 | comment: Optional[str] = None, |
|
| 5055 | name: Optional[str] = None, |
|
| 5056 | users: Optional[List[str]] = None |
|
| 5057 | ) -> Any: |
|
| 5058 | """Modifies an existing group. |
|
| 5059 | ||
| 5060 | Arguments: |
|
| 5061 | group_id: UUID of group to modify. |
|
| 5062 | comment: Comment on group. |
|
| 5063 | name: Name of group. |
|
| 5064 | users: List of user names to be in the group |
|
| 5065 | ||
| 5066 | Returns: |
|
| 5067 | The response. See :py:meth:`send_command` for details. |
|
| 5068 | """ |
|
| 5069 | if not group_id: |
|
| 5070 | raise RequiredArgument( |
|
| 5071 | function=self.modify_group.__name__, argument='group_id' |
|
| 5072 | ) |
|
| 5073 | ||
| 5074 | cmd = XmlCommand("modify_group") |
|
| 5075 | cmd.set_attribute("group_id", group_id) |
|
| 5076 | ||
| 5077 | if comment: |
|
| 5078 | cmd.add_element("comment", comment) |
|
| 5079 | ||
| 5080 | if name: |
|
| 5081 | cmd.add_element("name", name) |
|
| 5082 | ||
| 5083 | if users: |
|
| 5084 | cmd.add_element("users", _to_comma_list(users)) |
|
| 5085 | ||
| 5086 | return self._send_xml_command(cmd) |
|
| 5087 | ||
| 5088 | def modify_note( |
|
| 5089 | self, |
|