@@ 5307-5343 (lines=37) @@ | ||
5304 | ||
5305 | return self._send_xml_command(cmd) |
|
5306 | ||
5307 | def modify_role( |
|
5308 | self, |
|
5309 | role_id: str, |
|
5310 | *, |
|
5311 | comment: Optional[str] = None, |
|
5312 | name: Optional[str] = None, |
|
5313 | users: Optional[List[str]] = None |
|
5314 | ) -> Any: |
|
5315 | """Modifies an existing role. |
|
5316 | ||
5317 | Arguments: |
|
5318 | role_id: UUID of role to modify. |
|
5319 | comment: Name of role. |
|
5320 | name: Comment on role. |
|
5321 | users: List of user names. |
|
5322 | ||
5323 | Returns: |
|
5324 | The response. See :py:meth:`send_command` for details. |
|
5325 | """ |
|
5326 | if not role_id: |
|
5327 | raise RequiredArgument( |
|
5328 | function=self.modify_role.__name__, argument='role_id argument' |
|
5329 | ) |
|
5330 | ||
5331 | cmd = XmlCommand("modify_role") |
|
5332 | cmd.set_attribute("role_id", role_id) |
|
5333 | ||
5334 | if comment: |
|
5335 | cmd.add_element("comment", comment) |
|
5336 | ||
5337 | if name: |
|
5338 | cmd.add_element("name", name) |
|
5339 | ||
5340 | if users: |
|
5341 | cmd.add_element("users", _to_comma_list(users)) |
|
5342 | ||
5343 | return self._send_xml_command(cmd) |
|
5344 | ||
5345 | def modify_scanner( |
|
5346 | self, |
|
@@ 4936-4972 (lines=37) @@ | ||
4933 | ||
4934 | return self._send_xml_command(cmd) |
|
4935 | ||
4936 | def modify_group( |
|
4937 | self, |
|
4938 | group_id: str, |
|
4939 | *, |
|
4940 | comment: Optional[str] = None, |
|
4941 | name: Optional[str] = None, |
|
4942 | users: Optional[List[str]] = None |
|
4943 | ) -> Any: |
|
4944 | """Modifies an existing group. |
|
4945 | ||
4946 | Arguments: |
|
4947 | group_id: UUID of group to modify. |
|
4948 | comment: Comment on group. |
|
4949 | name: Name of group. |
|
4950 | users: List of user names to be in the group |
|
4951 | ||
4952 | Returns: |
|
4953 | The response. See :py:meth:`send_command` for details. |
|
4954 | """ |
|
4955 | if not group_id: |
|
4956 | raise RequiredArgument( |
|
4957 | function=self.modify_group.__name__, argument='group_id' |
|
4958 | ) |
|
4959 | ||
4960 | cmd = XmlCommand("modify_group") |
|
4961 | cmd.set_attribute("group_id", group_id) |
|
4962 | ||
4963 | if comment: |
|
4964 | cmd.add_element("comment", comment) |
|
4965 | ||
4966 | if name: |
|
4967 | cmd.add_element("name", name) |
|
4968 | ||
4969 | if users: |
|
4970 | cmd.add_element("users", _to_comma_list(users)) |
|
4971 | ||
4972 | return self._send_xml_command(cmd) |
|
4973 | ||
4974 | def modify_note( |
|
4975 | self, |