| @@ 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 |
|
| @@ 3859-3891 (lines=33) @@ | ||
| 3856 | ||
| 3857 | return self._send_xml_command(cmd) |
|
| 3858 | ||
| 3859 | def create_role( |
|
| 3860 | self, |
|
| 3861 | name: str, |
|
| 3862 | *, |
|
| 3863 | comment: Optional[str] = None, |
|
| 3864 | users: Optional[List[str]] = None, |
|
| 3865 | ) -> Any: |
|
| 3866 | """Create a new role |
|
| 3867 | ||
| 3868 | Arguments: |
|
| 3869 | name: Name of the role |
|
| 3870 | comment: Comment for the role |
|
| 3871 | users: List of user names to add to the role |
|
| 3872 | ||
| 3873 | Returns: |
|
| 3874 | The response. See :py:meth:`send_command` for details. |
|
| 3875 | """ |
|
| 3876 | ||
| 3877 | if not name: |
|
| 3878 | raise RequiredArgument( |
|
| 3879 | function=self.create_role.__name__, argument='name' |
|
| 3880 | ) |
|
| 3881 | ||
| 3882 | cmd = XmlCommand("create_role") |
|
| 3883 | cmd.add_element("name", name) |
|
| 3884 | ||
| 3885 | if comment: |
|
| 3886 | cmd.add_element("comment", comment) |
|
| 3887 | ||
| 3888 | if users: |
|
| 3889 | cmd.add_element("users", _to_comma_list(users)) |
|
| 3890 | ||
| 3891 | return self._send_xml_command(cmd) |
|
| 3892 | ||
| 3893 | def clone_role(self, role_id: str) -> Any: |
|
| 3894 | """Clone an existing role |
|