@@ 6543-6579 (lines=37) @@ | ||
6540 | ||
6541 | return self._send_xml_command(cmd) |
|
6542 | ||
6543 | def modify_role( |
|
6544 | self, |
|
6545 | role_id: str, |
|
6546 | *, |
|
6547 | comment: Optional[str] = None, |
|
6548 | name: Optional[str] = None, |
|
6549 | users: Optional[List[str]] = None, |
|
6550 | ) -> Any: |
|
6551 | """Modifies an existing role. |
|
6552 | ||
6553 | Arguments: |
|
6554 | role_id: UUID of role to modify. |
|
6555 | comment: Name of role. |
|
6556 | name: Comment on role. |
|
6557 | users: List of user names. |
|
6558 | ||
6559 | Returns: |
|
6560 | The response. See :py:meth:`send_command` for details. |
|
6561 | """ |
|
6562 | if not role_id: |
|
6563 | raise RequiredArgument( |
|
6564 | function=self.modify_role.__name__, argument='role_id argument' |
|
6565 | ) |
|
6566 | ||
6567 | cmd = XmlCommand("modify_role") |
|
6568 | cmd.set_attribute("role_id", role_id) |
|
6569 | ||
6570 | if comment: |
|
6571 | cmd.add_element("comment", comment) |
|
6572 | ||
6573 | if name: |
|
6574 | cmd.add_element("name", name) |
|
6575 | ||
6576 | if users: |
|
6577 | cmd.add_element("users", _to_comma_list(users)) |
|
6578 | ||
6579 | return self._send_xml_command(cmd) |
|
6580 | ||
6581 | def modify_scanner( |
|
6582 | self, |
|
@@ 6252-6288 (lines=37) @@ | ||
6249 | ) |
|
6250 | return self.modify_config_set_family_selection(config_id, **kwargs) |
|
6251 | ||
6252 | def modify_group( |
|
6253 | self, |
|
6254 | group_id: str, |
|
6255 | *, |
|
6256 | comment: Optional[str] = None, |
|
6257 | name: Optional[str] = None, |
|
6258 | users: Optional[List[str]] = None, |
|
6259 | ) -> Any: |
|
6260 | """Modifies an existing group. |
|
6261 | ||
6262 | Arguments: |
|
6263 | group_id: UUID of group to modify. |
|
6264 | comment: Comment on group. |
|
6265 | name: Name of group. |
|
6266 | users: List of user names to be in the group |
|
6267 | ||
6268 | Returns: |
|
6269 | The response. See :py:meth:`send_command` for details. |
|
6270 | """ |
|
6271 | if not group_id: |
|
6272 | raise RequiredArgument( |
|
6273 | function=self.modify_group.__name__, argument='group_id' |
|
6274 | ) |
|
6275 | ||
6276 | cmd = XmlCommand("modify_group") |
|
6277 | cmd.set_attribute("group_id", group_id) |
|
6278 | ||
6279 | if comment: |
|
6280 | cmd.add_element("comment", comment) |
|
6281 | ||
6282 | if name: |
|
6283 | cmd.add_element("name", name) |
|
6284 | ||
6285 | if users: |
|
6286 | cmd.add_element("users", _to_comma_list(users)) |
|
6287 | ||
6288 | return self._send_xml_command(cmd) |
|
6289 | ||
6290 | def modify_note( |
|
6291 | self, |