| @@ 533-569 (lines=37) @@ | ||
| 530 | ||
| 531 | return self._send_xml_command(cmd) |
|
| 532 | ||
| 533 | def modify_group( |
|
| 534 | self, |
|
| 535 | group_id: str, |
|
| 536 | *, |
|
| 537 | comment: Optional[str] = None, |
|
| 538 | name: Optional[str] = None, |
|
| 539 | users: Optional[List[str]] = None, |
|
| 540 | ) -> Any: |
|
| 541 | """Modifies an existing group. |
|
| 542 | ||
| 543 | Arguments: |
|
| 544 | group_id: UUID of group to modify. |
|
| 545 | comment: Comment on group. |
|
| 546 | name: Name of group. |
|
| 547 | users: List of user names to be in the group |
|
| 548 | ||
| 549 | Returns: |
|
| 550 | The response. See :py:meth:`send_command` for details. |
|
| 551 | """ |
|
| 552 | if not group_id: |
|
| 553 | raise RequiredArgument( |
|
| 554 | function=self.modify_group.__name__, argument='group_id' |
|
| 555 | ) |
|
| 556 | ||
| 557 | cmd = XmlCommand("modify_group") |
|
| 558 | cmd.set_attribute("group_id", group_id) |
|
| 559 | ||
| 560 | if comment: |
|
| 561 | cmd.add_element("comment", comment) |
|
| 562 | ||
| 563 | if name: |
|
| 564 | cmd.add_element("name", name) |
|
| 565 | ||
| 566 | if users: |
|
| 567 | cmd.add_element("users", to_comma_list(users)) |
|
| 568 | ||
| 569 | return self._send_xml_command(cmd) |
|
| 570 | ||
| 571 | def modify_setting( |
|
| 572 | self, |
|
| @@ 143-179 (lines=37) @@ | ||
| 140 | cmd.set_attribute("role_id", role_id) |
|
| 141 | return self._send_xml_command(cmd) |
|
| 142 | ||
| 143 | def modify_role( |
|
| 144 | self, |
|
| 145 | role_id: str, |
|
| 146 | *, |
|
| 147 | comment: Optional[str] = None, |
|
| 148 | name: Optional[str] = None, |
|
| 149 | users: Optional[List[str]] = None, |
|
| 150 | ) -> Any: |
|
| 151 | """Modifies an existing role. |
|
| 152 | ||
| 153 | Arguments: |
|
| 154 | role_id: UUID of role to modify. |
|
| 155 | comment: Name of role. |
|
| 156 | name: Comment on role. |
|
| 157 | users: List of user names. |
|
| 158 | ||
| 159 | Returns: |
|
| 160 | The response. See :py:meth:`send_command` for details. |
|
| 161 | """ |
|
| 162 | if not role_id: |
|
| 163 | raise RequiredArgument( |
|
| 164 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 165 | ) |
|
| 166 | ||
| 167 | cmd = XmlCommand("modify_role") |
|
| 168 | cmd.set_attribute("role_id", role_id) |
|
| 169 | ||
| 170 | if comment: |
|
| 171 | cmd.add_element("comment", comment) |
|
| 172 | ||
| 173 | if name: |
|
| 174 | cmd.add_element("name", name) |
|
| 175 | ||
| 176 | if users: |
|
| 177 | cmd.add_element("users", to_comma_list(users)) |
|
| 178 | ||
| 179 | return self._send_xml_command(cmd) |
|
| 180 | ||