Jobs
Execution Manager job scheduling.
Example Telerik.TestStudio.Shared.Communication.Transports.Job object:
Example Telerik.TestStudio.Shared.Communication.Transports.Job object:
{
"Id": "GUID",
"Path": "string",
"PathType": "integer",
"Credentials": {
"StorageUri": "string"
},
"MachinesToUse": [
"machine1",
"machine2"
],
"Schedule": {
"DayOfMonth": "optional integer",
"DayOrdinal": "optional integer",
"DaysOfWeekMask": "integer",
"FirstDayOfWeek": "integer",
"Frequency": "integer",
"Interval": "integer",
"IsRecurring": "boolean",
"MaxOccurences": "optional integer",
"MonthOfYear": "optional integer",
"RecursUntil": "optional DateTime",
"TimeToRun": "DateTime"
},
"Notification": {
"AttachAiiResult": "boolean",
"AttachExcel": "boolean",
"AttachWord": "boolean",
"EmailsList": [
"a@company.com",
"b@company.com"
],
"Notify": "integer",
"ShowFailureInformation": "boolean",
"ShowGeneralInformation": "boolean",
"Subject": "email subject",
"TextAfter": "text",
"TextBefore": "text",
"TextBetween": "text"
},
"ProjectInfo": {
"ProjectSourceLocation": "path",
"SchedulingServerUri": "http://localhost:8015",
"SourceControlServerAddress": "http://tfs.host.domain:port",
"ProjectRemotePath": "uri",
"UseSourceControlVersion": "boolean"
},
"RootFolder": "string",
"Distributed": "boolean"
} Job.PathType allowable values: 0 = RelativeToProjectOnDiskJob.NotificationSettings.Notify allowable values:
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
0 = NeverNotifyJob.Schedule.DaysOfWeekMask allowable values:
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
0 = NoneJob.Schedule.FirstDayOfWeek allowable values:
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
0 = SundayJob.Schedule.Frequency allowable values:
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous
GET
/Jobs
Get all jobs scheduled on the execution manager
Get all jobs scheduled on the execution manager
Parameters
/Jobs
Returns
An array of Telerik.TestStudio.Shared.Communication.Transports.Job objects
Example:
Example:
[
{
"Id": "GUID",
"Path": "string",
"PathType": "integer",
"Credentials": {
"StorageUri": "string"
},
"MachinesToUse": [
"machine1",
"machine2"
],
"Schedule": {
"DayOfMonth": "optional integer",
"DayOrdinal": "optional integer",
"DaysOfWeekMask": "integer",
"FirstDayOfWeek": "integer",
"Frequency": "integer",
"Interval": "integer",
"IsRecurring": "boolean",
"MaxOccurences": "optional integer",
"MonthOfYear": "optional integer",
"RecursUntil": "optional DateTime",
"TimeToRun": "DateTime"
},
"Notification": {
"AttachAiiResult": "boolean",
"AttachExcel": "boolean",
"AttachWord": "boolean",
"EmailsList": [
"a@company.com",
"b@company.com"
],
"Notify": "integer",
"ShowFailureInformation": "boolean",
"ShowGeneralInformation": "boolean",
"Subject": "email subject",
"TextAfter": "text",
"TextBefore": "text",
"TextBetween": "text"
},
"ProjectInfo": {
"ProjectSourceLocation": "path",
"SchedulingServerUri": "http://localhost:8015",
"SourceControlServerAddress": "http://tfs.host.domain:port",
"ProjectRemotePath": "uri",
"UseSourceControlVersion": "boolean"
},
"RootFolder": "string",
"Distributed": "boolean"
}
] Job.PathType allowable values: 0 = RelativeToProjectOnDiskJob.NotificationSettings.Notify allowable values:
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
0 = NeverNotifyJob.Schedule.DaysOfWeekMask allowable values:
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
0 = NoneJob.Schedule.FirstDayOfWeek allowable values:
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
0 = SundayJob.Schedule.Frequency allowable values:
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous
HTTP Status
Reason
200
OK
GET
/Jobs/{id}
Get job scheduled on the execution manager by job id
Get a job scheduled on the execution manager.
Parameters
/Jobs/{id}
id
[Guid]
required
Job id
Returns
Telerik.TestStudio.Shared.Communication.Transports.Job object or null
Example:
Example:
{
"Id": "GUID",
"Path": "string",
"PathType": "integer",
"Credentials": {
"StorageUri": "string"
},
"MachinesToUse": [
"machine1",
"machine2"
],
"Schedule": {
"DayOfMonth": "optional integer",
"DayOrdinal": "optional integer",
"DaysOfWeekMask": "integer",
"FirstDayOfWeek": "integer",
"Frequency": "integer",
"Interval": "integer",
"IsRecurring": "boolean",
"MaxOccurences": "optional integer",
"MonthOfYear": "optional integer",
"RecursUntil": "optional DateTime",
"TimeToRun": "DateTime"
},
"Notification": {
"AttachAiiResult": "boolean",
"AttachExcel": "boolean",
"AttachWord": "boolean",
"EmailsList": [
"a@company.com",
"b@company.com"
],
"Notify": "integer",
"ShowFailureInformation": "boolean",
"ShowGeneralInformation": "boolean",
"Subject": "email subject",
"TextAfter": "text",
"TextBefore": "text",
"TextBetween": "text"
},
"ProjectInfo": {
"ProjectSourceLocation": "path",
"SchedulingServerUri": "http://localhost:8015",
"SourceControlServerAddress": "http://tfs.host.domain:port",
"ProjectRemotePath": "uri",
"UseSourceControlVersion": "boolean"
},
"RootFolder": "string",
"Distributed": "boolean"
} Job.PathType allowable values: 0 = RelativeToProjectOnDiskJob.NotificationSettings.Notify allowable values:
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
0 = NeverNotifyJob.Schedule.DaysOfWeekMask allowable values:
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
0 = NoneJob.Schedule.FirstDayOfWeek allowable values:
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
0 = SundayJob.Schedule.Frequency allowable values:
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous
HTTP Status
Reason
200
OK
POST
/Jobs
Schedule a new job on the execution manager
Schedules a new job.
Expects a Telerik.TestStudio.Shared.Communication.Transports.Job in the request body.
If no Schedule object is supplied, the job will run immediately.
Credentials is optional. MachinesToUse and ProjectInfo are required to schedule/run a job.
Example:
Expects a Telerik.TestStudio.Shared.Communication.Transports.Job in the request body.
If no Schedule object is supplied, the job will run immediately.
Credentials is optional. MachinesToUse and ProjectInfo are required to schedule/run a job.
Example:
{
"Id": "GUID",
"Path": "string",
"PathType": "integer",
"Credentials": {
"StorageUri": "string"
},
"MachinesToUse": [
"machine1",
"machine2"
],
"Schedule": {
"DayOfMonth": "optional integer",
"DayOrdinal": "optional integer",
"DaysOfWeekMask": "integer",
"FirstDayOfWeek": "integer",
"Frequency": "integer",
"Interval": "integer",
"IsRecurring": "boolean",
"MaxOccurences": "optional integer",
"MonthOfYear": "optional integer",
"RecursUntil": "optional DateTime",
"TimeToRun": "DateTime"
},
"Notification": {
"AttachAiiResult": "boolean",
"AttachExcel": "boolean",
"AttachWord": "boolean",
"EmailsList": [
"a@company.com",
"b@company.com"
],
"Notify": "integer",
"ShowFailureInformation": "boolean",
"ShowGeneralInformation": "boolean",
"Subject": "email subject",
"TextAfter": "text",
"TextBefore": "text",
"TextBetween": "text"
},
"ProjectInfo": {
"ProjectSourceLocation": "path",
"SchedulingServerUri": "http://localhost:8015",
"SourceControlServerAddress": "http://tfs.host.domain:port",
"ProjectRemotePath": "uri",
"UseSourceControlVersion": "boolean"
},
"RootFolder": "string",
"Distributed": "boolean"
} Job.PathType allowable values: 0 = RelativeToProjectOnDiskJob.NotificationSettings.Notify allowable values:
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
0 = NeverNotifyJob.Schedule.DaysOfWeekMask allowable values:
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
0 = NoneJob.Schedule.FirstDayOfWeek allowable values:
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
0 = SundayJob.Schedule.Frequency allowable values:
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous
Parameters
/Jobs
job
[Job]
required
Job object. Should be in request body.
Returns
201 Created with job id in response body.
HTTP Status
Reason
201
Created
500
Internal Server Error
555
Custom: No Drones have been registered with this scheduler
556
Custom: Storage service not reachable
558
Custom: Source control server not reachable
PUT
/Jobs/{id}
Update scheduled job
Updates only scheduled jobs. If no schedule object is supplied update will be rejected.
Expects a Telerik.TestStudio.Shared.Communication.Transports.Job in the request body. Example:
Expects a Telerik.TestStudio.Shared.Communication.Transports.Job in the request body. Example:
{
"Id": "GUID",
"Path": "string",
"PathType": "integer",
"Credentials": {
"StorageUri": "string"
},
"MachinesToUse": [
"machine1",
"machine2"
],
"Schedule": {
"DayOfMonth": "optional integer",
"DayOrdinal": "optional integer",
"DaysOfWeekMask": "integer",
"FirstDayOfWeek": "integer",
"Frequency": "integer",
"Interval": "integer",
"IsRecurring": "boolean",
"MaxOccurences": "optional integer",
"MonthOfYear": "optional integer",
"RecursUntil": "optional DateTime",
"TimeToRun": "DateTime"
},
"Notification": {
"AttachAiiResult": "boolean",
"AttachExcel": "boolean",
"AttachWord": "boolean",
"EmailsList": [
"a@company.com",
"b@company.com"
],
"Notify": "integer",
"ShowFailureInformation": "boolean",
"ShowGeneralInformation": "boolean",
"Subject": "email subject",
"TextAfter": "text",
"TextBefore": "text",
"TextBetween": "text"
},
"ProjectInfo": {
"ProjectSourceLocation": "path",
"SchedulingServerUri": "http://localhost:8015",
"SourceControlServerAddress": "http://tfs.host.domain:port",
"ProjectRemotePath": "uri",
"UseSourceControlVersion": "boolean"
},
"RootFolder": "string",
"Distributed": "boolean"
} Job.PathType allowable values: 0 = RelativeToProjectOnDiskJob.NotificationSettings.Notify allowable values:
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
0 = NeverNotifyJob.Schedule.DaysOfWeekMask allowable values:
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
0 = NoneJob.Schedule.FirstDayOfWeek allowable values:
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
0 = SundayJob.Schedule.Frequency allowable values:
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous
Parameters
/Jobs/{id}
id
[Guid]
required
Job id
job
[Job]
required
Job object. Should be in request body.
Returns
202 Accepted
HTTP Status
Reason
202
Accepted
500
Internal Server Error
DELETE
/Jobs/{id}
Stop scheduled/running job by id
Attempts to stop the specified job in the execution manager.
Parameters
/Jobs/{id}
id
[Guid]
required
Job Id
Returns
Telerik.TestStudio.Shared.Communication.Transports.JobCancelResult object Example:
{
"CancelledTestListId": [
"GUID",
"GUID"
]
}HTTP Status
Reason
200
OK