| @@ 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, |
|