| @@ 5391-5427 (lines=37) @@ | ||
| 5388 | ||
| 5389 | return self._send_xml_command(cmd) |
|
| 5390 | ||
| 5391 | def modify_role( |
|
| 5392 | self, |
|
| 5393 | role_id: str, |
|
| 5394 | *, |
|
| 5395 | comment: Optional[str] = None, |
|
| 5396 | name: Optional[str] = None, |
|
| 5397 | users: Optional[List[str]] = None |
|
| 5398 | ) -> Any: |
|
| 5399 | """Modifies an existing role. |
|
| 5400 | ||
| 5401 | Arguments: |
|
| 5402 | role_id: UUID of role to modify. |
|
| 5403 | comment: Name of role. |
|
| 5404 | name: Comment on role. |
|
| 5405 | users: List of user names. |
|
| 5406 | ||
| 5407 | Returns: |
|
| 5408 | The response. See :py:meth:`send_command` for details. |
|
| 5409 | """ |
|
| 5410 | if not role_id: |
|
| 5411 | raise RequiredArgument( |
|
| 5412 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 5413 | ) |
|
| 5414 | ||
| 5415 | cmd = XmlCommand("modify_role") |
|
| 5416 | cmd.set_attribute("role_id", role_id) |
|
| 5417 | ||
| 5418 | if comment: |
|
| 5419 | cmd.add_element("comment", comment) |
|
| 5420 | ||
| 5421 | if name: |
|
| 5422 | cmd.add_element("name", name) |
|
| 5423 | ||
| 5424 | if users: |
|
| 5425 | cmd.add_element("users", _to_comma_list(users)) |
|
| 5426 | ||
| 5427 | return self._send_xml_command(cmd) |
|
| 5428 | ||
| 5429 | def modify_scanner( |
|
| 5430 | self, |
|
| @@ 5020-5056 (lines=37) @@ | ||
| 5017 | ||
| 5018 | return self._send_xml_command(cmd) |
|
| 5019 | ||
| 5020 | def modify_group( |
|
| 5021 | self, |
|
| 5022 | group_id: str, |
|
| 5023 | *, |
|
| 5024 | comment: Optional[str] = None, |
|
| 5025 | name: Optional[str] = None, |
|
| 5026 | users: Optional[List[str]] = None |
|
| 5027 | ) -> Any: |
|
| 5028 | """Modifies an existing group. |
|
| 5029 | ||
| 5030 | Arguments: |
|
| 5031 | group_id: UUID of group to modify. |
|
| 5032 | comment: Comment on group. |
|
| 5033 | name: Name of group. |
|
| 5034 | users: List of user names to be in the group |
|
| 5035 | ||
| 5036 | Returns: |
|
| 5037 | The response. See :py:meth:`send_command` for details. |
|
| 5038 | """ |
|
| 5039 | if not group_id: |
|
| 5040 | raise RequiredArgument( |
|
| 5041 | function=self.modify_group.__name__, argument='group_id' |
|
| 5042 | ) |
|
| 5043 | ||
| 5044 | cmd = XmlCommand("modify_group") |
|
| 5045 | cmd.set_attribute("group_id", group_id) |
|
| 5046 | ||
| 5047 | if comment: |
|
| 5048 | cmd.add_element("comment", comment) |
|
| 5049 | ||
| 5050 | if name: |
|
| 5051 | cmd.add_element("name", name) |
|
| 5052 | ||
| 5053 | if users: |
|
| 5054 | cmd.add_element("users", _to_comma_list(users)) |
|
| 5055 | ||
| 5056 | return self._send_xml_command(cmd) |
|
| 5057 | ||
| 5058 | def modify_note( |
|
| 5059 | self, |
|