RESTful knowledge exchange
Post Reply
Mardock
Influencer
Posts: 23
Liked: never
Joined: Jul 10, 2014 3:40 pm
Contact:

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

Post by 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
Veeam Vanguard
Posts: 148
Liked: 47 times
Joined: May 25, 2016 3:29 am
Full Name: Ben Young
Contact:

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

Post by benyoung »

What is inside the tags?
Mardock
Influencer
Posts: 23
Liked: never
Joined: Jul 10, 2014 3:40 pm
Contact:

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

Post by 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
Veeam Vanguard
Posts: 148
Liked: 47 times
Joined: May 25, 2016 3:29 am
Full Name: Ben Young
Contact:

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

Post by 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
Product Manager
Posts: 20270
Liked: 2252 times
Joined: Oct 26, 2012 3:28 pm
Full Name: Vladimir Eremin
Contact:

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

Post by 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
Influencer
Posts: 23
Liked: never
Joined: Jul 10, 2014 3:40 pm
Contact:

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

Post by 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
Product Manager
Posts: 20270
Liked: 2252 times
Joined: Oct 26, 2012 3:28 pm
Full Name: Vladimir Eremin
Contact:

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

Post by 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!
Post Reply

Who is online

Users browsing this forum: No registered users and 4 guests