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