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