greenbone / python-gvm

        return self._send_xml_command(cmd)

    def modify_note(

        self,

        note_id: str,

        text: str,

        *,

        seconds_active: Optional[int] = None,

        hosts: Optional[List[str]] = None,

        port: Optional[int] = None,

        result_id: Optional[str] = None,

        severity: Optional[Severity] = None,

        task_id: Optional[str] = None,

        threat: Optional[SeverityLevel] = None

    ) -> Any:

        """Modifies an existing note.

        Arguments:

            note_id: UUID of note to modify.

            text: The text of the note.

            seconds_active: Seconds note will be active. -1 on always, 0 off.

            hosts: A list of hosts addresses

            port: Port to which note applies.

            result_id: Result to which note applies.

            severity: Severity to which note applies.

            task_id: Task to which note applies.

            threat: Threat level to which note applies. Will be converted to

                severity.

        Returns:

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

        """

        if not note_id:

            raise RequiredArgument(

                function=self.modify_note.__name__, argument='note_id'

            )

        if not text:

            raise RequiredArgument(

                function=self.modify_note.__name__, argument='text'

            )

        cmd = XmlCommand("modify_note")

        cmd.set_attribute("note_id", note_id)

        cmd.add_element("text", text)

        if not seconds_active is None:

            cmd.add_element("active", str(seconds_active))

        if hosts:

            cmd.add_element("hosts", _to_comma_list(hosts))

        if port:

            cmd.add_element("port", str(port))

        if result_id:

            cmd.add_element("result", attrs={"id": result_id})

        if severity:

            cmd.add_element("severity", str(severity))

        if task_id:

            cmd.add_element("task", attrs={"id": task_id})

        if threat is not None:

            if not isinstance(threat, SeverityLevel):

                raise InvalidArgumentType(

                    function=self.modify_note.__name__,

                    argument='threat',

                    arg_type=SeverityLevel.__name__,

                )

            cmd.add_element("threat", threat.value)

        return self._send_xml_command(cmd)

    def modify_override(

        self,

        return self._send_xml_command(cmd)

    def create_note(

        self,

        text: str,

        nvt_oid: str,

        *,

        seconds_active: Optional[int] = None,

        hosts: Optional[List[str]] = None,

        port: Optional[int] = None,

        result_id: Optional[str] = None,

        severity: Optional[Severity] = None,

        task_id: Optional[str] = None,

        threat: Optional[SeverityLevel] = None

    ) -> Any:

        """Create a new note

        Arguments:

            text: Text of the new note

            nvt_id: OID of the nvt to which note applies

            seconds_active: Seconds note will be active. -1 on

                always, 0 off

            hosts: A list of hosts addresses

            port: Port to which the note applies

            result_id: UUID of a result to which note applies

            severity: Severity to which note applies

            task_id: UUID of task to which note applies

            threat: Severity level to which note applies. Will be converted to

                severity.

        Returns:

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

        """

        if not text:

            raise RequiredArgument(

                function=self.create_note.__name__, argument='text'

            )

        if not nvt_oid:

            raise RequiredArgument(

                function=self.create_note.__name__, argument='nvt_oid'

            )

        cmd = XmlCommand("create_note")

        cmd.add_element("text", text)

        cmd.add_element("nvt", attrs={"oid": nvt_oid})

        if not seconds_active is None:

            cmd.add_element("active", str(seconds_active))

        if hosts:

            cmd.add_element("hosts", _to_comma_list(hosts))

        if port:

            cmd.add_element("port", str(port))

        if result_id:

            cmd.add_element("result", attrs={"id": result_id})

        if severity:

            cmd.add_element("severity", str(severity))

        if task_id:

            cmd.add_element("task", attrs={"id": task_id})

        if threat is not None:

            if not isinstance(threat, SeverityLevel):

                raise InvalidArgumentType(

                    function="create_note",

                    argument="threat",

                    arg_type=SeverityLevel.__name__,

                )

            cmd.add_element("threat", threat.value)

        return self._send_xml_command(cmd)

    def clone_note(self, note_id: str) -> Any:

        """Clone an existing note