greenbone / python-gvm

        cmd.add_element('copy', override_id)

        return self._send_xml_command(cmd)

    def create_permission(self, name, subject_id, subject_type, *,

                          resource_id=None, resource_type=None,

                          comment=None):

        """Create a new permission

        Arguments:

            name (str): Name of the new permission

            subject_id (str): UUID of subject to whom the permission is granted

            subject_type (str): Type of the subject user, group or role

            comment (str, optional): Comment for the permission

            resource_id (str, optional): UUID of entity to which the permission

                applies

            resource_type (str, optional): Type of the resource. For Super

                permissions user, group or role

        Returns:

            The response. See :py:meth:`send_command` for details.

        """

        if not name:

            raise RequiredArgument('create_permission requires a name argument')

        if not subject_id:

            raise RequiredArgument(

                'create_permission requires a subject_id argument')

        if subject_type not in ('user', 'group', 'role'):

            raise InvalidArgument(

                'create_permission requires subject_type to be either user, '

                'group or role')

        cmd = XmlCommand('create_permission')

        cmd.add_element('name', name)

        _xmlsubject = cmd.add_element('subject', attrs={'id': subject_id})

        _xmlsubject.add_element('type', type)

        if comment:

            cmd.add_element('comment', comment)

        if resource_id and resource_type:

            _xmlresource = cmd.add_element('resource',

                                           attrs={'id': resource_id})

            _xmlresource.add_element('type', resource_type)

        return self._send_xml_command(cmd)

    def clone_permission(self, permission_id):

        """Clone an existing permission

        return self._send_xml_command(cmd)

    def modify_permission(self, permission_id, *, comment=None, name=None,

                          resource_id=None, resource_type=None,

                          subject_id=None, subject_type=None):

        """Modifies an existing permission.

        Arguments:

            permission_id (str): UUID of permission to be modified.

            comment (str, optional): The comment on the permission.

            name (str, optional): Permission name, currently the name of

                a command.

            subject_id (str, optional): UUID of subject to whom the permission

                is granted

            subject_type (str, optional): Type of the subject user, group or

                role

            resource_id (str, optional): UUID of entity to which the permission

                applies

            resource_type (str, optional): Type of the resource. For Super

                permissions user, group or role

        Returns:

            The response. See :py:meth:`send_command` for details.

        """

        if not permission_id:

            raise RequiredArgument('modify_permission requires '

                                   'a permission_id element')

        cmd = XmlCommand('modify_permission')

        cmd.set_attribute('permission_id', permission_id)

        if comment:

            cmd.add_element('comment', comment)

        if name:

            cmd.add_element('name', name)

        if resource_id and resource_type:

            _xmlresource = cmd.add_element('resource',

                                           attrs={'id': resource_id})

            _xmlresource.add_element('type', resource_type)

        if subject_id and subject_type:

            _xmlsubject = cmd.add_element('subject',

                                          attrs={'id': subject_id})

            _xmlsubject.add_element('type', subject_type)

        return self._send_xml_command(cmd)