| @@ 5507-5543 (lines=37) @@ | ||
| 5504 | ||
| 5505 | return self._send_xml_command(cmd) |
|
| 5506 | ||
| 5507 | def modify_role( |
|
| 5508 | self, |
|
| 5509 | role_id: str, |
|
| 5510 | *, |
|
| 5511 | comment: Optional[str] = None, |
|
| 5512 | name: Optional[str] = None, |
|
| 5513 | users: Optional[List[str]] = None, |
|
| 5514 | ) -> Any: |
|
| 5515 | """Modifies an existing role. |
|
| 5516 | ||
| 5517 | Arguments: |
|
| 5518 | role_id: UUID of role to modify. |
|
| 5519 | comment: Name of role. |
|
| 5520 | name: Comment on role. |
|
| 5521 | users: List of user names. |
|
| 5522 | ||
| 5523 | Returns: |
|
| 5524 | The response. See :py:meth:`send_command` for details. |
|
| 5525 | """ |
|
| 5526 | if not role_id: |
|
| 5527 | raise RequiredArgument( |
|
| 5528 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 5529 | ) |
|
| 5530 | ||
| 5531 | cmd = XmlCommand("modify_role") |
|
| 5532 | cmd.set_attribute("role_id", role_id) |
|
| 5533 | ||
| 5534 | if comment: |
|
| 5535 | cmd.add_element("comment", comment) |
|
| 5536 | ||
| 5537 | if name: |
|
| 5538 | cmd.add_element("name", name) |
|
| 5539 | ||
| 5540 | if users: |
|
| 5541 | cmd.add_element("users", to_comma_list(users)) |
|
| 5542 | ||
| 5543 | return self._send_xml_command(cmd) |
|
| 5544 | ||
| 5545 | def modify_scanner( |
|
| 5546 | self, |
|
| @@ 5248-5284 (lines=37) @@ | ||
| 5245 | ) |
|
| 5246 | return self.modify_config_set_family_selection(config_id, **kwargs) |
|
| 5247 | ||
| 5248 | def modify_group( |
|
| 5249 | self, |
|
| 5250 | group_id: str, |
|
| 5251 | *, |
|
| 5252 | comment: Optional[str] = None, |
|
| 5253 | name: Optional[str] = None, |
|
| 5254 | users: Optional[List[str]] = None, |
|
| 5255 | ) -> Any: |
|
| 5256 | """Modifies an existing group. |
|
| 5257 | ||
| 5258 | Arguments: |
|
| 5259 | group_id: UUID of group to modify. |
|
| 5260 | comment: Comment on group. |
|
| 5261 | name: Name of group. |
|
| 5262 | users: List of user names to be in the group |
|
| 5263 | ||
| 5264 | Returns: |
|
| 5265 | The response. See :py:meth:`send_command` for details. |
|
| 5266 | """ |
|
| 5267 | if not group_id: |
|
| 5268 | raise RequiredArgument( |
|
| 5269 | function=self.modify_group.__name__, argument='group_id' |
|
| 5270 | ) |
|
| 5271 | ||
| 5272 | cmd = XmlCommand("modify_group") |
|
| 5273 | cmd.set_attribute("group_id", group_id) |
|
| 5274 | ||
| 5275 | if comment: |
|
| 5276 | cmd.add_element("comment", comment) |
|
| 5277 | ||
| 5278 | if name: |
|
| 5279 | cmd.add_element("name", name) |
|
| 5280 | ||
| 5281 | if users: |
|
| 5282 | cmd.add_element("users", to_comma_list(users)) |
|
| 5283 | ||
| 5284 | return self._send_xml_command(cmd) |
|
| 5285 | ||
| 5286 | def modify_note( |
|
| 5287 | self, |
|