GET /api/job_invocations
List job invocations

参数

参数名字 描述
search
选填

过滤结果

Validations:

  • Must be String

order
选填

结果排序

Validations:

  • Must be String

page
选填

页数

Validations:

  • Must be String

per_page
选填

每个请求中的条目数

Validations:

  • Must be String


GET /api/job_invocations/:id
Show job invocation

参数

参数名字 描述
id
必填

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.


POST /api/job_invocations
Create a job invocation

参数

参数名字 描述
job_invocation
必填

Validations:

  • Must be a Hash

job_invocation[job_template_id]
必填

The job template to use

Validations:

  • Must be String

job_invocation[targeting_type]
必填

Invocation type, one of {"static_query"=>"Static Query", "dynamic_query"=>"Dynamic Query"}

Validations:

  • Must be String

job_invocation[inputs]
选填 , 允许空值

Inputs to use

Validations:

  • Must be Hash

job_invocation[ssh]
选填 , 允许空值

SSH provider specific options

Validations:

  • Must be a Hash

job_invocation[ssh][effective_user]
选填 , 允许空值

What user should be used to run the script (using sudo-like mechanisms). Defaults to a template parameter or global setting.

Validations:

  • Must be String

job_invocation[recurrence]
选填 , 允许空值

Create a recurring job

Validations:

  • Must be a Hash

job_invocation[recurrence][cron_line]
选填 , 允许空值

How often the job should occur, in the cron format

Validations:

  • Must be String

job_invocation[recurrence][max_iteration]
选填 , 允许空值

Repeat a maximum of N times

Validations:

  • Must be a number.

job_invocation[recurrence][end_time]
选填 , 允许空值

Perform no more executions after this time

Validations:

  • Must be DateTime

job_invocation[scheduling]
选填 , 允许空值

Schedule the job to start at a later time

Validations:

  • Must be a Hash

job_invocation[scheduling][start_at]
选填 , 允许空值

Schedule the job for a future time

Validations:

  • Must be DateTime

job_invocation[scheduling][start_before]
选填 , 允许空值

Indicates that the action should be cancelled if it cannot be started before this time.

Validations:

  • Must be DateTime

job_invocation[concurrency_control]
选填 , 允许空值

Control concurrency level and distribution over time

Validations:

  • Must be a Hash

job_invocation[concurrency_control][time_span]
选填 , 允许空值

Distribute tasks over N seconds

Validations:

  • Must be Integer

job_invocation[concurrency_control][concurrency_level]
选填 , 允许空值

Run at most N tasks at a time

Validations:

  • Must be Integer

job_invocation[bookmark_id]
选填 , 允许空值

Validations:

  • Must be Integer

job_invocation[search_query]
选填 , 允许空值

Validations:

  • Must be Integer

job_invocation[description_format]
选填 , 允许空值

Override the description format from the template for this invocation only

Validations:

  • Must be String


GET /api/job_invocations/:id/hosts/:host_id
Get output for a host

参数

参数名字 描述
id
必填

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.

host_id
必填

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.

since
选填

Validations:

  • Must be String