| @@ 2383-2419 (lines=37) @@ | ||
| 2380 | ||
| 2381 | return self._send_xml_command(cmd) |
|
| 2382 | ||
| 2383 | def modify_role( |
|
| 2384 | self, |
|
| 2385 | role_id: str, |
|
| 2386 | *, |
|
| 2387 | comment: Optional[str] = None, |
|
| 2388 | name: Optional[str] = None, |
|
| 2389 | users: Optional[List[str]] = None, |
|
| 2390 | ) -> Any: |
|
| 2391 | """Modifies an existing role. |
|
| 2392 | ||
| 2393 | Arguments: |
|
| 2394 | role_id: UUID of role to modify. |
|
| 2395 | comment: Name of role. |
|
| 2396 | name: Comment on role. |
|
| 2397 | users: List of user names. |
|
| 2398 | ||
| 2399 | Returns: |
|
| 2400 | The response. See :py:meth:`send_command` for details. |
|
| 2401 | """ |
|
| 2402 | if not role_id: |
|
| 2403 | raise RequiredArgument( |
|
| 2404 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 2405 | ) |
|
| 2406 | ||
| 2407 | cmd = XmlCommand("modify_role") |
|
| 2408 | cmd.set_attribute("role_id", role_id) |
|
| 2409 | ||
| 2410 | if comment: |
|
| 2411 | cmd.add_element("comment", comment) |
|
| 2412 | ||
| 2413 | if name: |
|
| 2414 | cmd.add_element("name", name) |
|
| 2415 | ||
| 2416 | if users: |
|
| 2417 | cmd.add_element("users", to_comma_list(users)) |
|
| 2418 | ||
| 2419 | return self._send_xml_command(cmd) |
|
| 2420 | ||
| 2421 | def modify_setting( |
|
| 2422 | self, |
|
| @@ 2290-2326 (lines=37) @@ | ||
| 2287 | ||
| 2288 | return self._send_xml_command(cmd) |
|
| 2289 | ||
| 2290 | def modify_group( |
|
| 2291 | self, |
|
| 2292 | group_id: str, |
|
| 2293 | *, |
|
| 2294 | comment: Optional[str] = None, |
|
| 2295 | name: Optional[str] = None, |
|
| 2296 | users: Optional[List[str]] = None, |
|
| 2297 | ) -> Any: |
|
| 2298 | """Modifies an existing group. |
|
| 2299 | ||
| 2300 | Arguments: |
|
| 2301 | group_id: UUID of group to modify. |
|
| 2302 | comment: Comment on group. |
|
| 2303 | name: Name of group. |
|
| 2304 | users: List of user names to be in the group |
|
| 2305 | ||
| 2306 | Returns: |
|
| 2307 | The response. See :py:meth:`send_command` for details. |
|
| 2308 | """ |
|
| 2309 | if not group_id: |
|
| 2310 | raise RequiredArgument( |
|
| 2311 | function=self.modify_group.__name__, argument='group_id' |
|
| 2312 | ) |
|
| 2313 | ||
| 2314 | cmd = XmlCommand("modify_group") |
|
| 2315 | cmd.set_attribute("group_id", group_id) |
|
| 2316 | ||
| 2317 | if comment: |
|
| 2318 | cmd.add_element("comment", comment) |
|
| 2319 | ||
| 2320 | if name: |
|
| 2321 | cmd.add_element("name", name) |
|
| 2322 | ||
| 2323 | if users: |
|
| 2324 | cmd.add_element("users", to_comma_list(users)) |
|
| 2325 | ||
| 2326 | return self._send_xml_command(cmd) |
|
| 2327 | ||
| 2328 | def modify_report_format( |
|
| 2329 | self, |
|