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