greenbone / python-gvm

        cmd.add_element("copy", scanner_id)

        return self._send_xml_command(cmd)

    def create_schedule(

        self,

        name: str,

        *,

        comment: Optional[str] = None,

        first_time_minute: Optional[int] = None,

        first_time_hour: Optional[int] = None,

        first_time_day_of_month: Optional[int] = None,

        first_time_month: Optional[int] = None,

        first_time_year: Optional[int] = None,

        duration: Optional[int] = None,

        duration_unit: Optional[TimeUnit] = None,

        period: Optional[int] = None,

        period_unit: Optional[TimeUnit] = None,

        timezone: Optional[str] = None

    ) -> Any:

        """Create a new schedule

        Arguments:

            name: Name of the schedule

            comment: Comment for the schedule

            first_time_minute: First time minute the schedule will run. Must be

                an integer >= 0.

            first_time_hour: First time hour the schedule will run. Must be an

                integer >= 0.

            first_time_day_of_month: First time day of month the schedule will

                run. Must be an integer > 0 <= 31.

            first_time_month: First time month the schedule will run. Must be an

                integer >= 1 <= 12.

            first_time_year: First time year the schedule will run. Must be an

                integer >= 1970.

            duration: How long the Manager will run the scheduled task for until

                it gets paused if not finished yet. Must be an integer > 0.

            duration_unit: Unit of the duration. One of second,

                minute, hour, day, week, month, year, decade. Required if

                duration is set.

            period: How often the Manager will repeat the

                scheduled task. Must be an integer > 0.

            period_unit: Unit of the period. One of second,

                minute, hour, day, week, month, year, decade. Required if

                period is set.

            timezone: The timezone the schedule will follow

        Returns:

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

        """

        if not name:

            raise RequiredArgument(

                function=self.create_schedule.__name__, argument='name'

            )

        cmd = XmlCommand("create_schedule")

        cmd.add_element("name", name)

        if comment:

            cmd.add_element("comment", comment)

        if (

            first_time_minute is not None

            or first_time_hour is not None

            or first_time_day_of_month is not None

            or first_time_month is not None

            or first_time_year is not None

        ):

            if first_time_minute is None:

                raise RequiredArgument(

                    function=self.create_schedule.__name__,

                    argument='first_time_minute',

                )

            elif (

                not isinstance(first_time_minute, numbers.Integral)

                or first_time_minute < 0

            ):

                raise InvalidArgument(

                    "first_time_minute argument of create_schedule needs to be "

                    "an integer greater or equal 0"

                )

            if first_time_hour is None:

                raise RequiredArgument(

                    function=self.create_schedule.__name__,

                    argument='first_time_hour',

                )

            elif (

                not isinstance(first_time_hour, numbers.Integral)

                or first_time_hour < 0

            ):

                raise InvalidArgument(

                    "first_time_hour argument of create_schedule needs to be "

                    "an integer greater or equal 0"

                )

            if first_time_day_of_month is None:

                raise RequiredArgument(

                    function=self.create_schedule.__name__,

                    argument='first_time_day_of_month',

                )

            elif (

                not isinstance(first_time_day_of_month, numbers.Integral)

                or first_time_day_of_month < 1

                or first_time_day_of_month > 31

            ):

                raise InvalidArgument(

                    "first_time_day_of_month argument of create_schedule needs "

                    "to be an integer between 1 and 31"

                )

            if first_time_month is None:

                raise RequiredArgument(

                    function=self.create_schedule.__name__,

                    argument='first_time_month',

                )

            elif (

                not isinstance(first_time_month, numbers.Integral)

                or first_time_month < 1

                or first_time_month > 12

            ):

                raise InvalidArgument(

                    "first_time_month argument of create_schedule needs "

                    "to be an integer between 1 and 12"

                )

            if first_time_year is None:

                raise RequiredArgument(

                    function=self.create_schedule.__name__,

                    argument='first_time_year',

                )

            elif (

                not isinstance(first_time_year, numbers.Integral)

                or first_time_year < 1970

            ):

                raise InvalidArgument(

                    "first_time_year argument of create_schedule needs "

                    "to be an integer greater or equal 1970"

                )

            _xmlftime = cmd.add_element("first_time")

            _xmlftime.add_element("minute", str(first_time_minute))

            _xmlftime.add_element("hour", str(first_time_hour))

            _xmlftime.add_element("day_of_month", str(first_time_day_of_month))

            _xmlftime.add_element("month", str(first_time_month))

            _xmlftime.add_element("year", str(first_time_year))

        if duration is not None:

            if not duration_unit:

                raise RequiredArgument(

                    function=self.create_schedule.__name__,

                    argument='duration_unit',

                )

            if not isinstance(duration_unit, TimeUnit):

                raise InvalidArgumentType(

                    function=self.create_schedule.__name__,

                    argument='duration_unit',

                    arg_type=TimeUnit.__name__,

                )

            if not isinstance(duration, numbers.Integral) or duration < 1:

                raise InvalidArgument(

                    "duration argument must be an integer greater than 0"

                )

            _xmlduration = cmd.add_element("duration", str(duration))

            _xmlduration.add_element("unit", duration_unit.value)

        if period is not None:

            if not period_unit:

                raise RequiredArgument(

                    function=self.create_schedule.__name__,

                    argument='period_unit',

                )

            if not isinstance(period_unit, TimeUnit):

                raise InvalidArgumentType(

                    function=self.create_schedule.__name__,

                    argument='period_unit',

                    arg_type=TimeUnit.__name__,

                )

            if not isinstance(period, numbers.Integral) or period < 0:

                raise InvalidArgument(

                    "period argument must be a positive integer"

                )

            _xmlperiod = cmd.add_element("period", str(period))

            _xmlperiod.add_element("unit", period_unit.value)

        if timezone:

            cmd.add_element("timezone", timezone)

        return self._send_xml_command(cmd)

    def clone_schedule(self, schedule_id: str) -> Any:

        """Clone an existing schedule

        return self._send_xml_command(cmd)

    def modify_schedule(

        self,

        schedule_id: str,

        *,

        comment: Optional[str] = None,

        name: Optional[str] = None,

        first_time_minute: Optional[int] = None,

        first_time_hour: Optional[int] = None,

        first_time_day_of_month: Optional[int] = None,

        first_time_month: Optional[int] = None,

        first_time_year: Optional[int] = None,

        duration: Optional[int] = None,

        duration_unit: Optional[TimeUnit] = None,

        period: Optional[int] = None,

        period_unit: Optional[TimeUnit] = None,

        timezone: Optional[str] = None

    ) -> Any:

        """Modifies an existing schedule.

        Arguments:

            schedule_id: UUID of schedule to modify.

            name: Name of the schedule

            comment: Comment for the schedule

            first_time_minute: First time minute the schedule will run. Must be

                an integer >= 0.

            first_time_hour: First time hour the schedule will run. Must be an

                integer >= 0.

            first_time_day_of_month: First time day of month the schedule will

                run. Must be an integer > 0 <= 31.

            first_time_month: First time month the schedule will run. Must be an

                integer >= 1 <= 12.

            first_time_year: First time year the schedule will run

            duration: How long the Manager will run the scheduled task for until

                it gets paused if not finished yet.

            duration_unit: Unit of the duration. One of second, minute, hour,

                day, week, month, year, decade. Required if duration is set.

            period: How often the Manager will repeat the scheduled task. Must

                be an integer > 0.

            period_unit: Unit of the period. One of second, minute, hour, day,

                week, month, year, decade. Required if period is set.

            timezone: The timezone the schedule will follow

        Returns:

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

        """

        if not schedule_id:

            raise RequiredArgument(

                function=self.modify_schedule.__name__, argument='schedule_id'

            )

        cmd = XmlCommand("modify_schedule")

        cmd.set_attribute("schedule_id", schedule_id)

        if comment:

            cmd.add_element("comment", comment)

        if name:

            cmd.add_element("name", name)

        if (

            first_time_minute is not None

            or first_time_hour is not None

            or first_time_day_of_month is not None

            or first_time_month is not None

            or first_time_year is not None

        ):

            if first_time_minute is None:

                raise RequiredArgument(

                    function=self.modify_schedule.__name__,

                    argument='first_time_minute',

                )

            elif (

                not isinstance(first_time_minute, numbers.Integral)

                or first_time_minute < 0

            ):

                raise InvalidArgument(

                    "first_time_minute argument of modify_schedule needs to be "

                    "an integer greater or equal 0"

                )

            if first_time_hour is None:

                raise RequiredArgument(

                    function=self.modify_schedule.__name__,

                    argument='first_time_hour',

                )

            elif (

                not isinstance(first_time_hour, numbers.Integral)

                or first_time_hour < 0

            ):

                raise InvalidArgument(

                    "first_time_hour argument of modify_schedule needs to be "

                    "an integer greater or equal 0"

                )

            if first_time_day_of_month is None:

                raise RequiredArgument(

                    function=self.modify_schedule.__name__,

                    argument='first_time_day_of_month',

                )

            elif (

                not isinstance(first_time_day_of_month, numbers.Integral)

                or first_time_day_of_month < 1

                or first_time_day_of_month > 31

            ):

                raise InvalidArgument(

                    "first_time_day_of_month argument of modify_schedule needs "

                    "to be an integer between 1 and 31"

                )

            if first_time_month is None:

                raise RequiredArgument(

                    function=self.modify_schedule.__name__,

                    argument='first_time_month',

                )

            elif (

                not isinstance(first_time_month, numbers.Integral)

                or first_time_month < 1

                or first_time_month > 12

            ):

                raise InvalidArgument(

                    "first_time_month argument of modify_schedule needs "

                    "to be an integer between 1 and 12"

                )

            if first_time_year is None:

                raise RequiredArgument(

                    function=self.modify_schedule.__name__,

                    argument='first_time_year',

                )

            elif (

                not isinstance(first_time_year, numbers.Integral)

                or first_time_year < 1970

            ):

                raise InvalidArgument(

                    "first_time_year argument of create_schedule needs "

                    "to be an integer greater or equal 1970"

                )

            _xmlftime = cmd.add_element("first_time")

            _xmlftime.add_element("minute", str(first_time_minute))

            _xmlftime.add_element("hour", str(first_time_hour))

            _xmlftime.add_element("day_of_month", str(first_time_day_of_month))

            _xmlftime.add_element("month", str(first_time_month))

            _xmlftime.add_element("year", str(first_time_year))

        if duration is not None:

            if not duration_unit:

                raise RequiredArgument(

                    function=self.modify_schedule.__name__,

                    argument='duration_unit',

                )

            if not isinstance(duration_unit, TimeUnit):

                raise InvalidArgumentType(

                    function=self.modify_schedule.__name__,

                    argument='duration_unit',

                    arg_type=TimeUnit.__name__,

                )

            if not isinstance(duration, numbers.Integral) or duration < 1:

                raise InvalidArgument(

                    "duration argument must be an integer greater than 0"

                )

            _xmlduration = cmd.add_element("duration", str(duration))

            _xmlduration.add_element("unit", duration_unit.value)

        if period is not None:

            if not period_unit:

                raise RequiredArgument(

                    function=self.modify_schedule.__name__,

                    argument='period_unit',

                )

            if not isinstance(period_unit, TimeUnit):

                raise InvalidArgumentType(

                    function=self.modify_schedule.__name__,

                    argument='period_unit',

                    arg_type=TimeUnit.__name__,

                )

            if not isinstance(period, numbers.Integral) or period < 1:

                raise InvalidArgument(

                    "period argument must be an integer greater than 0"

                )

            _xmlperiod = cmd.add_element("period", str(period))

            _xmlperiod.add_element("unit", period_unit.value)

        if timezone:

            cmd.add_element("timezone", timezone)

        return self._send_xml_command(cmd)

    def modify_setting(

        self,