@@ 6498-6534 (lines=37) @@ | ||
6495 | ||
6496 | return self._send_xml_command(cmd) |
|
6497 | ||
6498 | def modify_role( |
|
6499 | self, |
|
6500 | role_id: str, |
|
6501 | *, |
|
6502 | comment: Optional[str] = None, |
|
6503 | name: Optional[str] = None, |
|
6504 | users: Optional[List[str]] = None, |
|
6505 | ) -> Any: |
|
6506 | """Modifies an existing role. |
|
6507 | ||
6508 | Arguments: |
|
6509 | role_id: UUID of role to modify. |
|
6510 | comment: Name of role. |
|
6511 | name: Comment on role. |
|
6512 | users: List of user names. |
|
6513 | ||
6514 | Returns: |
|
6515 | The response. See :py:meth:`send_command` for details. |
|
6516 | """ |
|
6517 | if not role_id: |
|
6518 | raise RequiredArgument( |
|
6519 | function=self.modify_role.__name__, argument='role_id argument' |
|
6520 | ) |
|
6521 | ||
6522 | cmd = XmlCommand("modify_role") |
|
6523 | cmd.set_attribute("role_id", role_id) |
|
6524 | ||
6525 | if comment: |
|
6526 | cmd.add_element("comment", comment) |
|
6527 | ||
6528 | if name: |
|
6529 | cmd.add_element("name", name) |
|
6530 | ||
6531 | if users: |
|
6532 | cmd.add_element("users", to_comma_list(users)) |
|
6533 | ||
6534 | return self._send_xml_command(cmd) |
|
6535 | ||
6536 | def modify_scanner( |
|
6537 | self, |
|
@@ 6207-6243 (lines=37) @@ | ||
6204 | ) |
|
6205 | return self.modify_config_set_family_selection(config_id, **kwargs) |
|
6206 | ||
6207 | def modify_group( |
|
6208 | self, |
|
6209 | group_id: str, |
|
6210 | *, |
|
6211 | comment: Optional[str] = None, |
|
6212 | name: Optional[str] = None, |
|
6213 | users: Optional[List[str]] = None, |
|
6214 | ) -> Any: |
|
6215 | """Modifies an existing group. |
|
6216 | ||
6217 | Arguments: |
|
6218 | group_id: UUID of group to modify. |
|
6219 | comment: Comment on group. |
|
6220 | name: Name of group. |
|
6221 | users: List of user names to be in the group |
|
6222 | ||
6223 | Returns: |
|
6224 | The response. See :py:meth:`send_command` for details. |
|
6225 | """ |
|
6226 | if not group_id: |
|
6227 | raise RequiredArgument( |
|
6228 | function=self.modify_group.__name__, argument='group_id' |
|
6229 | ) |
|
6230 | ||
6231 | cmd = XmlCommand("modify_group") |
|
6232 | cmd.set_attribute("group_id", group_id) |
|
6233 | ||
6234 | if comment: |
|
6235 | cmd.add_element("comment", comment) |
|
6236 | ||
6237 | if name: |
|
6238 | cmd.add_element("name", name) |
|
6239 | ||
6240 | if users: |
|
6241 | cmd.add_element("users", to_comma_list(users)) |
|
6242 | ||
6243 | return self._send_xml_command(cmd) |
|
6244 | ||
6245 | def modify_note( |
|
6246 | self, |