API GET Job/{id} undocumented TAG <standart>

[Mardock]

Hi,
I work with Veeam REST full API version 9.5.4.2866 (9.5 U4b).

If I make a (GET) /jobs/{ID} the server sometimes returns the TAG <standart> inside the TAG <JobScheduleOptions>

Example:

Code: Select all

<Job>
[CUT]
<JobScheduleOptions>
    <Standart>
        [CUT]
    </Standart>
</JobScheduleOptions>
[CUT]
</Job>

The documentation (https://helpcenter.veeam.com/docs/backu ... l?ver=95u4) doesn't talk about this TAG


Kind Regards,

Mardock.

[benyoung]

What is inside the tags?

[Mardock]

Inside this TAG there is the content that the documentation says should be inside the tag <JobScheduleOptions>.

Example:

Code: Select all

<JobScheduleOptions>
    <Standart>
    	  <RetryOptions>
                <RetryTimes>3</RetryTimes>
                <RetryTimeout>10</RetryTimeout>
                <RetrySpecified>true</RetrySpecified>
            </RetryOptions>
             <WaitForBackupCompletion>true</WaitForBackupCompletion>
            <BackupCompetitionWaitingPeriodMin>180</BackupCompetitionWaitingPeriodMin>
            <OptionsDaily Enabled="true">
                <Kind>Everyday</Kind>
                <Days>Sunday</Days>
                <Days>Monday</Days>
                <Days>Tuesday</Days>
                <Days>Wednesday</Days>
                <Days>Thursday</Days>
                <Days>Friday</Days>
                <Days>Saturday</Days>
                <Time>01:00:00.0000000+02:00</Time>
                <TimeOffsetUtc>1</TimeOffsetUtc>
            </OptionsDaily>
            <OptionsMonthly Enabled="false">
                <Time>00:00:00.0000000+02:00</Time>
                <TimeOffsetUtc>1</TimeOffsetUtc>
                <DayNumberInMonth>Fourth</DayNumberInMonth>
                <DayOfWeek>Saturday</DayOfWeek>
                <Months>January</Months>
                <Months>February</Months>
                <Months>March</Months>
                <Months>April</Months>
                <Months>May</Months>
                <Months>June</Months>
                <Months>July</Months>
                <Months>August</Months>
                <Months>September</Months>
                <Months>October</Months>
                <Months>November</Months>
                <Months>December</Months>
                <DayOfMonth>1</DayOfMonth>
            </OptionsMonthly>
            <OptionsPeriodically Enabled="false">
                <Kind>Hours</Kind>
                <FullPeriod>1</FullPeriod>
                <Schedule>
                    <Day Name="Sunday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Monday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Tuesday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Wednesday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Thursday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Friday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Saturday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                </Schedule>
            </OptionsPeriodically>
            <OptionsContinuous Enabled="false">
                <Schedule>
                    <Day Name="Sunday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Monday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Tuesday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Wednesday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Thursday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Friday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Saturday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                </Schedule>
            </OptionsContinuous>
            <OptionsBackupWindow Enabled="false">
                <TimePeriods>
                    <Day Name="Sunday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Monday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Tuesday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Wednesday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Thursday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Friday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                    <Day Name="Saturday">1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1</Day>
                </TimePeriods>
            </OptionsBackupWindow>
            <OptionsDaisyChaining Enabled="false">
                <PreviousJobUid/>
            </OptionsDaisyChaining>
    </Standart>
</JobScheduleOptions>

[benyoung]

Weird - all of those child nodes are under there. Is there any main difference in the jobs that do an do not have this, i.e type of job, locations etc

Someone from Veeam will know for sure I am guessing it is documented internally somewhere but it would certainly be good to know as it would wreck havoc with parsers/code/models if the schema flip flops around like that

[veremin]

It's a known issue - some parts of new RESTful API model were accidentally added to the current scheme. The documentation has been updated in accordance.

Thanks!

[Mardock]

Sadly this is a breaking change so, in my humble opinion and accordly to semantic versioning https://semver.org/, the API version should go from 1.3 to 2.0 not from 1.3 to 1.4 .

Thanks,
Mardock.

[veremin]

Agree, unfortunately, this bug has been found after the API was released, so now we cannot update scheme version retrospectively.

All we can do is to update documentation accordingly (which we did already).

Thanks!