@@ 5226-5262 (lines=37) @@ | ||
5223 | ||
5224 | return self._send_xml_command(cmd) |
|
5225 | ||
5226 | def modify_role( |
|
5227 | self, |
|
5228 | role_id: str, |
|
5229 | *, |
|
5230 | comment: Optional[str] = None, |
|
5231 | name: Optional[str] = None, |
|
5232 | users: Optional[List[str]] = None |
|
5233 | ) -> Any: |
|
5234 | """Modifies an existing role. |
|
5235 | ||
5236 | Arguments: |
|
5237 | role_id: UUID of role to modify. |
|
5238 | comment: Name of role. |
|
5239 | name: Comment on role. |
|
5240 | users: List of user names. |
|
5241 | ||
5242 | Returns: |
|
5243 | The response. See :py:meth:`send_command` for details. |
|
5244 | """ |
|
5245 | if not role_id: |
|
5246 | raise RequiredArgument( |
|
5247 | function=self.modify_role.__name__, argument='role_id argument' |
|
5248 | ) |
|
5249 | ||
5250 | cmd = XmlCommand("modify_role") |
|
5251 | cmd.set_attribute("role_id", role_id) |
|
5252 | ||
5253 | if comment: |
|
5254 | cmd.add_element("comment", comment) |
|
5255 | ||
5256 | if name: |
|
5257 | cmd.add_element("name", name) |
|
5258 | ||
5259 | if users: |
|
5260 | cmd.add_element("users", _to_comma_list(users)) |
|
5261 | ||
5262 | return self._send_xml_command(cmd) |
|
5263 | ||
5264 | def modify_scanner( |
|
5265 | self, |
|
@@ 4855-4891 (lines=37) @@ | ||
4852 | ||
4853 | return self._send_xml_command(cmd) |
|
4854 | ||
4855 | def modify_group( |
|
4856 | self, |
|
4857 | group_id: str, |
|
4858 | *, |
|
4859 | comment: Optional[str] = None, |
|
4860 | name: Optional[str] = None, |
|
4861 | users: Optional[List[str]] = None |
|
4862 | ) -> Any: |
|
4863 | """Modifies an existing group. |
|
4864 | ||
4865 | Arguments: |
|
4866 | group_id: UUID of group to modify. |
|
4867 | comment: Comment on group. |
|
4868 | name: Name of group. |
|
4869 | users: List of user names to be in the group |
|
4870 | ||
4871 | Returns: |
|
4872 | The response. See :py:meth:`send_command` for details. |
|
4873 | """ |
|
4874 | if not group_id: |
|
4875 | raise RequiredArgument( |
|
4876 | function=self.modify_group.__name__, argument='group_id' |
|
4877 | ) |
|
4878 | ||
4879 | cmd = XmlCommand("modify_group") |
|
4880 | cmd.set_attribute("group_id", group_id) |
|
4881 | ||
4882 | if comment: |
|
4883 | cmd.add_element("comment", comment) |
|
4884 | ||
4885 | if name: |
|
4886 | cmd.add_element("name", name) |
|
4887 | ||
4888 | if users: |
|
4889 | cmd.add_element("users", _to_comma_list(users)) |
|
4890 | ||
4891 | return self._send_xml_command(cmd) |
|
4892 | ||
4893 | def modify_note( |
|
4894 | self, |