| @@ 1968-2004 (lines=37) @@ | ||
| 1965 | ||
| 1966 | return self._send_xml_command(cmd) |
|
| 1967 | ||
| 1968 | def modify_role( |
|
| 1969 | self, |
|
| 1970 | role_id: str, |
|
| 1971 | *, |
|
| 1972 | comment: Optional[str] = None, |
|
| 1973 | name: Optional[str] = None, |
|
| 1974 | users: Optional[List[str]] = None, |
|
| 1975 | ) -> Any: |
|
| 1976 | """Modifies an existing role. |
|
| 1977 | ||
| 1978 | Arguments: |
|
| 1979 | role_id: UUID of role to modify. |
|
| 1980 | comment: Name of role. |
|
| 1981 | name: Comment on role. |
|
| 1982 | users: List of user names. |
|
| 1983 | ||
| 1984 | Returns: |
|
| 1985 | The response. See :py:meth:`send_command` for details. |
|
| 1986 | """ |
|
| 1987 | if not role_id: |
|
| 1988 | raise RequiredArgument( |
|
| 1989 | function=self.modify_role.__name__, argument='role_id argument' |
|
| 1990 | ) |
|
| 1991 | ||
| 1992 | cmd = XmlCommand("modify_role") |
|
| 1993 | cmd.set_attribute("role_id", role_id) |
|
| 1994 | ||
| 1995 | if comment: |
|
| 1996 | cmd.add_element("comment", comment) |
|
| 1997 | ||
| 1998 | if name: |
|
| 1999 | cmd.add_element("name", name) |
|
| 2000 | ||
| 2001 | if users: |
|
| 2002 | cmd.add_element("users", to_comma_list(users)) |
|
| 2003 | ||
| 2004 | return self._send_xml_command(cmd) |
|
| 2005 | ||
| 2006 | def modify_setting( |
|
| 2007 | self, |
|
| @@ 1875-1911 (lines=37) @@ | ||
| 1872 | ||
| 1873 | return self._send_xml_command(cmd) |
|
| 1874 | ||
| 1875 | def modify_group( |
|
| 1876 | self, |
|
| 1877 | group_id: str, |
|
| 1878 | *, |
|
| 1879 | comment: Optional[str] = None, |
|
| 1880 | name: Optional[str] = None, |
|
| 1881 | users: Optional[List[str]] = None, |
|
| 1882 | ) -> Any: |
|
| 1883 | """Modifies an existing group. |
|
| 1884 | ||
| 1885 | Arguments: |
|
| 1886 | group_id: UUID of group to modify. |
|
| 1887 | comment: Comment on group. |
|
| 1888 | name: Name of group. |
|
| 1889 | users: List of user names to be in the group |
|
| 1890 | ||
| 1891 | Returns: |
|
| 1892 | The response. See :py:meth:`send_command` for details. |
|
| 1893 | """ |
|
| 1894 | if not group_id: |
|
| 1895 | raise RequiredArgument( |
|
| 1896 | function=self.modify_group.__name__, argument='group_id' |
|
| 1897 | ) |
|
| 1898 | ||
| 1899 | cmd = XmlCommand("modify_group") |
|
| 1900 | cmd.set_attribute("group_id", group_id) |
|
| 1901 | ||
| 1902 | if comment: |
|
| 1903 | cmd.add_element("comment", comment) |
|
| 1904 | ||
| 1905 | if name: |
|
| 1906 | cmd.add_element("name", name) |
|
| 1907 | ||
| 1908 | if users: |
|
| 1909 | cmd.add_element("users", to_comma_list(users)) |
|
| 1910 | ||
| 1911 | return self._send_xml_command(cmd) |
|
| 1912 | ||
| 1913 | def modify_report_format( |
|
| 1914 | self, |
|