@@ 533-569 (lines=37) @@ | ||
530 | ||
531 | return self._send_xml_command(cmd) |
|
532 | ||
533 | def modify_group( |
|
534 | self, |
|
535 | group_id: str, |
|
536 | *, |
|
537 | comment: Optional[str] = None, |
|
538 | name: Optional[str] = None, |
|
539 | users: Optional[List[str]] = None, |
|
540 | ) -> Any: |
|
541 | """Modifies an existing group. |
|
542 | ||
543 | Arguments: |
|
544 | group_id: UUID of group to modify. |
|
545 | comment: Comment on group. |
|
546 | name: Name of group. |
|
547 | users: List of user names to be in the group |
|
548 | ||
549 | Returns: |
|
550 | The response. See :py:meth:`send_command` for details. |
|
551 | """ |
|
552 | if not group_id: |
|
553 | raise RequiredArgument( |
|
554 | function=self.modify_group.__name__, argument='group_id' |
|
555 | ) |
|
556 | ||
557 | cmd = XmlCommand("modify_group") |
|
558 | cmd.set_attribute("group_id", group_id) |
|
559 | ||
560 | if comment: |
|
561 | cmd.add_element("comment", comment) |
|
562 | ||
563 | if name: |
|
564 | cmd.add_element("name", name) |
|
565 | ||
566 | if users: |
|
567 | cmd.add_element("users", to_comma_list(users)) |
|
568 | ||
569 | return self._send_xml_command(cmd) |
|
570 | ||
571 | def modify_setting( |
|
572 | self, |
@@ 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 |