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