REresilio
Jobs

Get job by id

Returns job info.

get/jobs/{id}

Request

  • Base URL
    https://localhost:8446/api/v2
  • Auth
    API key in header Authorization

Path parameters

idnumber required

Job id

Response

Successful response

accessstring required

Access

created_atnumber required

Job creation time (timestamp in seconds)

created_bystring required

Name of the user who created the job

use_new_cipherboolean

New version of cipher suite. Not applicable for script job

total_transferrednumber

Total bytes transferred. Not applicable for script job

groupsobject required

Array of job groups

groups.idnumber required

Group id

groups.permissionstring required

Group permissions

groups.pathobject required

Group path

groups.path.macrostring

Macro. If the parameter is not specified, custom path is used. If use %USERDEFINED% or %GETFILES% macro, you mustn't use path field for all OS

groups.path.linuxstring required

Linux path

groups.path.linux_cachestring required

Linux cache path. Only for group with caching_gateway role

groups.path.winstring required

Windows path

groups.path.osxstring required

OS X path

groups.path.androidstring required

Android path

groups.path.xboxstring required

Xbox path. Only for distribution jobs

groups.rolestring required

Role. primary_storage, caching_gateway roles are used in file_caching jobs. primary_storage, caching_gateway, enduser roles are used in hybrid_work jobs. regular role is used in distribution, consolidation, script, sync, storage_tiering_and_archival jobs.

groups.file_policy_idnumber required

File policy id. Only for group with caching_gateway, enduser role

groups.priority_agentsboolean required

Priority agents. Only for group with primary_storage role or group in sync job.

groups.lock_serverboolean required

Locks server. Only for the case when setting.use_file_locking is true for High availability group with primary_storage role or in sync job.

agentsobject required

Array of job agents

agents.idnumber required

Agent id

agents.permissionstring required

Agent permissions

agents.pathobject required

Agent path

agents.path.macrostring

Macro. If the parameter is not specified, custom path is used. If use %USERDEFINED% or %GETFILES% macro, you mustn't use path field for all OS

agents.path.linuxstring required

Linux path

agents.path.linux_cachestring required

Linux cache path. Only for agent with caching_gateway role

agents.path.winstring required

Windows path

agents.path.osxstring required

OS X path

agents.path.androidstring required

Android path

agents.path.xboxstring required

Xbox path. Only for distribution jobs

agents.storage_config_idnumber required

Storage connector config id. If the parameter is not specified, Storage connector isn't used

agents.rolestring required

Role primary_storage, caching_gateway roles are used in file_caching jobs. primary_storage, caching_gateway, enduser roles are used in hybrid_work jobs. regular role is used in distribution, consolidation, script, sync, storage_tiering_and_archival jobs.

agents.file_policy_idnumber required

File policy id. Only for agent with caching_gateway, enduser role

agents.priority_agentsboolean required

Priority agents. Only for agent with primary_storage role or agent in sync job.

agents.lock_serverboolean required

Locks server. Only for the case when setting.use_file_locking is true for agent with primary_storage role or agent in sync job.

notificationsobject required

List of job notifications

notifications.idnumber required

Notification id

notifications.destinationsobject required

Array of notification destinations

notifications.destinations.emailstring required

Email to send notifications

notifications.destinations.user_idnumber required

Id of user to send notifications

notifications.destinations.web_hook_idnumber required

Id of webhook to send notifications

notifications.triggerstring required

Notification trigger.

notifications.settingsobject required

Notification settings

notifications.settings.error_codestring required

Error code to trigger notification. Is null in case of notification is configured for any error code. Only for JOB_RUN_ERROR trigger

notifications.settings.notify_after_error_timeoutboolean required

Trigger notification after error timeout. Only for JOB_RUN_ERROR trigger

notifications.settings.error_timeoutnumber

Error timeout (seconds). Only for JOB_RUN_ERROR trigger. Minimum value is 1 minute

notifications.settings.notify_on_error_removeboolean required

Notify when error is resolved. Only for JOB_RUN_ERROR trigger

notifications.settings.complete_timeoutnumber required

Send notification if job run isn't complete within time wait period (seconds). Only for JOB_RUN_NOT_COMPLETE trigger. Minimum value is 1 minute

notifications.settings.dont_send_if_no_data_transferredboolean required

Skip notice if jobs did not transfer files. Only for JOB_RUN_FINISHED trigger

scriptobject

Script for script job

script.linuxobject required

Linux command

script.linux.scriptstring required

Command

script.linux.shellstring required

Shell

script.linux.extstring required

Script file extension

script.winobject required

Windows command

script.win.scriptstring required

Command

script.win.shellstring required

Shell

script.win.extstring required

Script file extension

script.osxobject required

Mac command

script.osx.scriptstring required

Command

script.osx.shellstring required

Shell

script.osx.extstring required

Script file extension

script.androidobject required

Android command

script.android.scriptstring required

Command

script.android.shellstring required

Shell

script.android.extstring required

Script file extension

triggersobject

Job triggers. Only for distribution, consolidation, storage_tiering_and_archival jobs

triggers.pre_indexingobject

Before file-indexing begins

triggers.pre_indexing.linuxobject required

Linux command

triggers.pre_indexing.linux.scriptstring required

Command

triggers.pre_indexing.linux.shellstring required

Shell

triggers.pre_indexing.linux.extstring required

Script file extension

triggers.pre_indexing.winobject required

Windows command

triggers.pre_indexing.win.scriptstring required

Command

triggers.pre_indexing.win.shellstring required

Shell

triggers.pre_indexing.win.extstring required

Script file extension

triggers.pre_indexing.osxobject required

Mac command

triggers.pre_indexing.osx.scriptstring required

Command

triggers.pre_indexing.osx.shellstring required

Shell

triggers.pre_indexing.osx.extstring required

Script file extension

triggers.pre_indexing.androidobject required

Android command

triggers.pre_indexing.android.scriptstring required

Command

triggers.pre_indexing.android.shellstring required

Shell

triggers.pre_indexing.android.extstring required

Script file extension

triggers.pre_moveobject

Before an agent finalizing download. Only for distribution jobs

triggers.pre_move.linuxobject required

Linux command

triggers.pre_move.linux.scriptstring required

Command

triggers.pre_move.linux.shellstring required

Shell

triggers.pre_move.linux.extstring required

Script file extension

triggers.pre_move.winobject required

Windows command

triggers.pre_move.win.scriptstring required

Command

triggers.pre_move.win.shellstring required

Shell

triggers.pre_move.win.extstring required

Script file extension

triggers.pre_move.osxobject required

Mac command

triggers.pre_move.osx.scriptstring required

Command

triggers.pre_move.osx.shellstring required

Shell

triggers.pre_move.osx.extstring required

Script file extension

triggers.pre_move.androidobject required

Android command

triggers.pre_move.android.scriptstring required

Command

triggers.pre_move.android.shellstring required

Shell

triggers.pre_move.android.extstring required

Script file extension

triggers.post_downloadobject

After an agent completes downloading

triggers.post_download.linuxobject required

Linux command

triggers.post_download.linux.scriptstring required

Command

triggers.post_download.linux.shellstring required

Shell

triggers.post_download.linux.extstring required

Script file extension

triggers.post_download.winobject required

Windows command

triggers.post_download.win.scriptstring required

Command

triggers.post_download.win.shellstring required

Shell

triggers.post_download.win.extstring required

Script file extension

triggers.post_download.osxobject required

Mac command

triggers.post_download.osx.scriptstring required

Command

triggers.post_download.osx.shellstring required

Shell

triggers.post_download.osx.extstring required

Script file extension

triggers.post_download.androidobject required

Android command

triggers.post_download.android.scriptstring required

Command

triggers.post_download.android.shellstring required

Shell

triggers.post_download.android.extstring required

Script file extension

triggers.post_download.xboxobject required

Xbox command

triggers.post_download.xbox.scriptstring required

Command

triggers.post_download.xbox.shellstring required

Shell

triggers.post_download.xbox.extstring required

Script file extension

triggers.completeobject

After all agents complete downloading

triggers.complete.linuxobject required

Linux command

triggers.complete.linux.scriptstring required

Command

triggers.complete.linux.shellstring required

Shell

triggers.complete.linux.extstring required

Script file extension

triggers.complete.winobject required

Windows command

triggers.complete.win.scriptstring required

Command

triggers.complete.win.shellstring required

Shell

triggers.complete.win.extstring required

Script file extension

triggers.complete.osxobject required

Mac command

triggers.complete.osx.scriptstring required

Command

triggers.complete.osx.shellstring required

Shell

triggers.complete.osx.extstring required

Script file extension

triggers.complete.androidobject required

Android command

triggers.complete.android.scriptstring required

Command

triggers.complete.android.shellstring required

Shell

triggers.complete.android.extstring required

Script file extension

idnumber required

Job id

typestring required

Job type

namestring required

Job name

descriptionstring required

Job description

schedulerobject

Scheduler. Not applicable for sync, file_caching, hybrid_work job

scheduler.typestring required

Type of the scheduler

scheduler.timenumber

once - timestamp in seconds, daily - number of seconds since midnight, weekly - array of seconds since midnight

scheduler.everynumber

minutes - run every N minutes(min 5 minutes), hourly - run every N hours, daily - run every N days

scheduler.daysnumber

weekly - array of days of week to run (encoded in numbers from 0 to 6, 0 is Sunday)

scheduler.startnumber

Scheduler start time (timestamp in seconds) for minutes, hourly, daily and weekly schedulers

scheduler.finishnumber

Scheduler finish time (timestamp in seconds) for minutes, hourly, daily and weekly schedulers

scheduler.configobject

Job monthly scheduler configuration

scheduler.config.offsetnumber required

Specifies the position within a month When representing a day, the value range is 1–31 When representing monday, tuesday, wednesday, thursday, friday, saturday, and sunday the value range is 1–5

scheduler.config.unitstring required

Specifies the day of the month or the day of week

scheduler.config.directionstring required

Determines the reference point within the month for scheduling. month_beginning - the offset is calculated starting from the first day of the month month_end - the offset is calculated starting from the last day of the month

scheduler.config.timenumber required

Specifies the time of the day to run the job (minutes)

scheduler.skip_if_runningboolean

Wait for job run to complete before starting new one (for all scheduler types except manually and now)

scheduler.next_schedule_run_timenumber

Next start job time (in seconds) applied by scheduler, -1 means no next schedule run

settingsobject

Job settings.

settings.prioritynumber

Job priority. Not applicable for script jobs. The lowest priority: 0, the highest: 10

settings.use_ram_optimizationboolean

Use RAM-optimized configuration. Not applicable for script jobs

settings.reference_instance_idnumber

The Reference Instance (Agent or High Availability group) propagates and overwrites file permissions on other Agents in sync, file_caching, hybrid_work jobs. Selecting a Reference Instance is required for the jobs that synchronize file permissions. Setting's value is -1 in case Reference Instance was deleted from the Job

settings.reference_instance_typestring

The Reference Instance type. Agents and High Availability groups are allowed only. Default value is null (reference instance was removed or was not specified)

settings.reference_agent_idnumber

Deprecated since 4.0. Use reference_instance_type and reference_instance_id instead. The Reference Agent propagates and overwrites file permissions on other Agents in sync, file_caching, hybrid_work jobs. Selecting a Reference Agent is required for the jobs that synchronize file permissions. Default value is null

settings.profileobject

Unique profile settings for job

settings.delete_synced_filesboolean

Delete synced files. Only for distribution, consolidation, storage_tiering_and_archival jobs

settings.delete_synced_files_ttlnumber

Delete synced files (in days). Only for distribution, consolidation, storage_tiering_and_archival jobs

settings.archive_bystring

Criterion to archive by. Determines what field will be used settings.files_list, settings.modification_time or settings.access_time. Only one selected criterion is applied. Similar settings from profile will be ignored. Only for storage_tiering_and_archival job. More information can be found here.

settings.files_liststring

List of regular expressions separated by a new line character \n to match files based on their paths. Only for storage_tiering_and_archival job.

settings.modification_timeobject

Files will be matched based on time in seconds since they were last modified. If only settings.modification_time.min is provided files with modification time earlier than settings.modification_time.min seconds ago will be matched. If only settings.modification_time.max is provided files with modification time later than settings.modification_time.max seconds ago will be matched. If both values are provided they are treated as absolute timestamps in seconds and files with modification time between settings.modification_time.min and settings.modification_time.max will be matched. Only for storage_tiering_and_archival job.

settings.modification_time.maxnumber

Max modification time in seconds.

settings.modification_time.minnumber

Min modification time in seconds.

settings.access_timeobject

Files will be matched based on time in seconds since they were last accessed. If only settings.access_time.min is provided files with access time earlier than settings.access_time.min seconds ago will be matched. If only settings.access_time.max is provided files with access time later than settings.access_time.max seconds ago will be matched. If both values are provided they are treated as absolute timestamps in seconds and files with access time between settings.access_time.min and settings.access_time.max will be matched. Only for storage_tiering_and_archival job.

settings.access_time.maxnumber

Max access time in seconds.

settings.access_time.minnumber

Min access time in seconds.

settings.aws_s3_storage_classstring

Setting that will be used if job's destination is Amazon Glacier storage. Only for storage_tiering_and_archival job.

settings.aws_s3_retrieval_tierstring

Setting that will be used if job's source is Amazon Glacier storage. Only for storage_tiering_and_archival job.

settings.use_file_lockingboolean

File locks setting. Only for sync, file_caching, hybrid_work jobs

settings.file_locks_timeoutnumber

File locks timeout. Applicable only if setting.use_file_locking is true

settings.file_locks_sync_intervalnumber

File locks sync interval. Applicable only if setting.use_file_locking is true

settings.file_locks_ignore_liststring

File locks ignore list. Applicable only if setting.use_file_locking is true

settings.file_locks_allowed_access_when_no_serverstring

File locks access to files when no access to locks server. Applicable only if setting.use_file_locking is true.

settings.map_folder_to_drivestring

Map a local folder to a drive letter, applicable only for hybrid jobs on Windows end-users starting from version 4.2.0.

errorsobject required

List of job errors

errors.codenumber

Error code (deprecated since 2.9.1)

errors.code_strstring required

Error string code

errors.messagestring required

Error message

last_start_timenumber required

Last time in seconds when the job was started

post_command_local_timenumber

Local Agent time after an Agent run completes downloading trigger (in seconds)

pre_move_command_local_timenumber

Local Agent time after an Agent run before finalizing download trigger (in seconds)

profile_idnumber

Job profile id

Changes

No recorded changes to this operation across all 1 revision of this API.