REresilio
Agents

Get Agent jobs by Agent id

Returns all jobs configuration for Agent.

get/agents/{id}/jobs

Request

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

Path parameters

idnumber required

Agent id

Response

Successful response

permissionstring required

Agent permissions

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

pathstring required

Agents path

storage_config_idnumber required

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

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.

file_policy_idnumber required

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

priority_agentsboolean required

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

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.

triggersobject

Job triggers. Only for distribution, consolidation, storage_tiering_and_archival jobs

triggers.pre_indexingobject

Before file-indexing begins

triggers.pre_indexing.scriptstring required

Command

triggers.pre_indexing.shellstring required

Shell

triggers.pre_indexing.extstring required

Script file extension

triggers.pre_moveobject

Before an agent finalizing download. Only for distribution jobs

triggers.pre_move.scriptstring required

Command

triggers.pre_move.shellstring required

Shell

triggers.pre_move.extstring required

Script file extension

triggers.post_downloadobject

After an agent completes downloading

triggers.post_download.scriptstring required

Command

triggers.post_download.shellstring required

Shell

triggers.post_download.extstring required

Script file extension

triggers.completeobject

After all agents complete downloading

triggers.complete.linuxobject required

Linux command

triggers.complete.scriptstring required

Command

triggers.complete.shellstring required

Shell

scriptobject

Script for script job

script.scriptstring required

Command

script.shellstring required

Shell

script.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.