| @@ 150-186 (lines=37) @@ | ||
| 147 | cmd.set_attribute("group_id", group_id) |
|
| 148 | return self._send_xml_command(cmd) |
|
| 149 | ||
| 150 | def modify_group( |
|
| 151 | self, |
|
| 152 | group_id: str, |
|
| 153 | *, |
|
| 154 | comment: Optional[str] = None, |
|
| 155 | name: Optional[str] = None, |
|
| 156 | users: Optional[List[str]] = None, |
|
| 157 | ) -> Any: |
|
| 158 | """Modifies an existing group. |
|
| 159 | ||
| 160 | Arguments: |
|
| 161 | group_id: UUID of group to modify. |
|
| 162 | comment: Comment on group. |
|
| 163 | name: Name of group. |
|
| 164 | users: List of user names to be in the group |
|
| 165 | ||
| 166 | Returns: |
|
| 167 | The response. See :py:meth:`send_command` for details. |
|
| 168 | """ |
|
| 169 | if not group_id: |
|
| 170 | raise RequiredArgument( |
|
| 171 | function=self.modify_group.__name__, argument='group_id' |
|
| 172 | ) |
|
| 173 | ||
| 174 | cmd = XmlCommand("modify_group") |
|
| 175 | cmd.set_attribute("group_id", group_id) |
|
| 176 | ||
| 177 | if comment: |
|
| 178 | cmd.add_element("comment", comment) |
|
| 179 | ||
| 180 | if name: |
|
| 181 | cmd.add_element("name", name) |
|
| 182 | ||
| 183 | if users: |
|
| 184 | cmd.add_element("users", to_comma_list(users)) |
|
| 185 | ||
| 186 | return self._send_xml_command(cmd) |
|
| 187 | ||
| @@ 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 | ||