@@ 1094-1130 (lines=37) @@ | ||
1091 | ||
1092 | return self._send_xml_command(cmd) |
|
1093 | ||
1094 | def modify_role( |
|
1095 | self, |
|
1096 | role_id: str, |
|
1097 | *, |
|
1098 | comment: Optional[str] = None, |
|
1099 | name: Optional[str] = None, |
|
1100 | users: Optional[List[str]] = None, |
|
1101 | ) -> Any: |
|
1102 | """Modifies an existing role. |
|
1103 | ||
1104 | Arguments: |
|
1105 | role_id: UUID of role to modify. |
|
1106 | comment: Name of role. |
|
1107 | name: Comment on role. |
|
1108 | users: List of user names. |
|
1109 | ||
1110 | Returns: |
|
1111 | The response. See :py:meth:`send_command` for details. |
|
1112 | """ |
|
1113 | if not role_id: |
|
1114 | raise RequiredArgument( |
|
1115 | function=self.modify_role.__name__, argument='role_id argument' |
|
1116 | ) |
|
1117 | ||
1118 | cmd = XmlCommand("modify_role") |
|
1119 | cmd.set_attribute("role_id", role_id) |
|
1120 | ||
1121 | if comment: |
|
1122 | cmd.add_element("comment", comment) |
|
1123 | ||
1124 | if name: |
|
1125 | cmd.add_element("name", name) |
|
1126 | ||
1127 | if users: |
|
1128 | cmd.add_element("users", to_comma_list(users)) |
|
1129 | ||
1130 | return self._send_xml_command(cmd) |
|
1131 | ||
1132 | def modify_setting( |
|
1133 | self, |
|
@@ 1001-1037 (lines=37) @@ | ||
998 | ||
999 | return self._send_xml_command(cmd) |
|
1000 | ||
1001 | def modify_group( |
|
1002 | self, |
|
1003 | group_id: str, |
|
1004 | *, |
|
1005 | comment: Optional[str] = None, |
|
1006 | name: Optional[str] = None, |
|
1007 | users: Optional[List[str]] = None, |
|
1008 | ) -> Any: |
|
1009 | """Modifies an existing group. |
|
1010 | ||
1011 | Arguments: |
|
1012 | group_id: UUID of group to modify. |
|
1013 | comment: Comment on group. |
|
1014 | name: Name of group. |
|
1015 | users: List of user names to be in the group |
|
1016 | ||
1017 | Returns: |
|
1018 | The response. See :py:meth:`send_command` for details. |
|
1019 | """ |
|
1020 | if not group_id: |
|
1021 | raise RequiredArgument( |
|
1022 | function=self.modify_group.__name__, argument='group_id' |
|
1023 | ) |
|
1024 | ||
1025 | cmd = XmlCommand("modify_group") |
|
1026 | cmd.set_attribute("group_id", group_id) |
|
1027 | ||
1028 | if comment: |
|
1029 | cmd.add_element("comment", comment) |
|
1030 | ||
1031 | if name: |
|
1032 | cmd.add_element("name", name) |
|
1033 | ||
1034 | if users: |
|
1035 | cmd.add_element("users", to_comma_list(users)) |
|
1036 | ||
1037 | return self._send_xml_command(cmd) |
|
1038 | ||
1039 | def modify_report_format( |
|
1040 | self, |