| @@ 3827-3859 (lines=33) @@ | ||
| 3824 | ||
| 3825 | return self._send_xml_command(cmd) |
|
| 3826 | ||
| 3827 | def create_role( |
|
| 3828 | self, |
|
| 3829 | name: str, |
|
| 3830 | *, |
|
| 3831 | comment: Optional[str] = None, |
|
| 3832 | users: Optional[List[str]] = None, |
|
| 3833 | ) -> Any: |
|
| 3834 | """Create a new role |
|
| 3835 | ||
| 3836 | Arguments: |
|
| 3837 | name: Name of the role |
|
| 3838 | comment: Comment for the role |
|
| 3839 | users: List of user names to add to the role |
|
| 3840 | ||
| 3841 | Returns: |
|
| 3842 | The response. See :py:meth:`send_command` for details. |
|
| 3843 | """ |
|
| 3844 | ||
| 3845 | if not name: |
|
| 3846 | raise RequiredArgument( |
|
| 3847 | function=self.create_role.__name__, argument='name' |
|
| 3848 | ) |
|
| 3849 | ||
| 3850 | cmd = XmlCommand("create_role") |
|
| 3851 | cmd.add_element("name", name) |
|
| 3852 | ||
| 3853 | if comment: |
|
| 3854 | cmd.add_element("comment", comment) |
|
| 3855 | ||
| 3856 | if users: |
|
| 3857 | cmd.add_element("users", _to_comma_list(users)) |
|
| 3858 | ||
| 3859 | return self._send_xml_command(cmd) |
|
| 3860 | ||
| 3861 | def clone_role(self, role_id: str) -> Any: |
|
| 3862 | """Clone an existing role |
|
| @@ 1412-1444 (lines=33) @@ | ||
| 1409 | ||
| 1410 | return self._send_xml_command(cmd) |
|
| 1411 | ||
| 1412 | def create_role( |
|
| 1413 | self, |
|
| 1414 | name: str, |
|
| 1415 | *, |
|
| 1416 | comment: Optional[str] = None, |
|
| 1417 | users: Optional[List[str]] = None, |
|
| 1418 | ) -> Any: |
|
| 1419 | """Create a new role |
|
| 1420 | ||
| 1421 | Arguments: |
|
| 1422 | name: Name of the role |
|
| 1423 | comment: Comment for the role |
|
| 1424 | users: List of user names to add to the role |
|
| 1425 | ||
| 1426 | Returns: |
|
| 1427 | The response. See :py:meth:`send_command` for details. |
|
| 1428 | """ |
|
| 1429 | ||
| 1430 | if not name: |
|
| 1431 | raise RequiredArgument( |
|
| 1432 | function=self.create_role.__name__, argument='name' |
|
| 1433 | ) |
|
| 1434 | ||
| 1435 | cmd = XmlCommand("create_role") |
|
| 1436 | cmd.add_element("name", name) |
|
| 1437 | ||
| 1438 | if comment: |
|
| 1439 | cmd.add_element("comment", comment) |
|
| 1440 | ||
| 1441 | if users: |
|
| 1442 | cmd.add_element("users", _to_comma_list(users)) |
|
| 1443 | ||
| 1444 | return self._send_xml_command(cmd) |
|
| 1445 | ||
| 1446 | def clone_role(self, role_id: str) -> Any: |
|
| 1447 | """Clone an existing role |
|