Create a Job Template
post
/api/v2/job_templates/
Make a POST request to this resource with the following job template fields to create a new job template:
name: Name of this job template. (string, required)description: Optional description of this job template. (string, default="")job_type: (choice)run: Run (default)check: Check
inventory: (id, default=``)project: (id, default=``)playbook: (string, default="")scm_branch: Branch to use in job run. Project default used if blank. Only allowed if project allow_override field is set to true. (string, default="")forks: (integer, default=0)limit: (string, default="")verbosity: (choice)0: 0 (Normal) (default)1: 1 (Verbose)2: 2 (More Verbose)3: 3 (Debug)4: 4 (Connection Debug)5: 5 (WinRM Debug)
extra_vars: (json, default=``)job_tags: (string, default="")force_handlers: (boolean, default=False)skip_tags: (string, default="")start_at_task: (string, default="")timeout: The amount of time (in seconds) to run before the task is canceled. (integer, default=0)-
use_fact_cache: If enabled, the service will act as an Ansible Fact Cache Plugin; persisting facts at the end of a playbook run to the database and caching facts for use by Ansible. (boolean, default=False) -
execution_environment: The container image to be used for execution. (id, default=``) host_config_key: (string, default="")ask_scm_branch_on_launch: (boolean, default=False)ask_diff_mode_on_launch: (boolean, default=False)ask_variables_on_launch: (boolean, default=False)ask_limit_on_launch: (boolean, default=False)ask_tags_on_launch: (boolean, default=False)ask_skip_tags_on_launch: (boolean, default=False)ask_job_type_on_launch: (boolean, default=False)ask_verbosity_on_launch: (boolean, default=False)ask_inventory_on_launch: (boolean, default=False)ask_credential_on_launch: (boolean, default=False)ask_execution_environment_on_launch: (boolean, default=False)ask_labels_on_launch: (boolean, default=False)ask_forks_on_launch: (boolean, default=False)ask_job_slice_count_on_launch: (boolean, default=False)ask_timeout_on_launch: (boolean, default=False)ask_instance_groups_on_launch: (boolean, default=False)survey_enabled: (boolean, default=False)become_enabled: (boolean, default=False)diff_mode: If enabled, textual changes made to any templated files on the host are shown in the standard output (boolean, default=False)-
allow_simultaneous: (boolean, default=False) -
job_slice_count: The number of jobs to slice into at runtime. Will cause the Job Template to launch a workflow if value is greater than 1. (integer, default=1) webhook_service: Service that webhook requests will be accepted from (choice)"": ---------github: GitHubgitlab: GitLabbitbucket_dc: BitBucket DataCenter
webhook_credential: Personal Access Token for posting back the status to the service API (id, default=``)prevent_instance_group_fallback: If enabled, the job template will prevent adding any inventory or organization instance groups to the list of preferred instances groups to run on.If this setting is enabled and you provided an empty list, the global instance groups will be applied. (boolean, default=False)
Request
Supported Media Types
- application/json
Root Schema : JobTemplate
Type:
Show Source
object-
allow_simultaneous:
boolean
Title:
Allow simultaneous -
ask_credential_on_launch:
boolean
Title:
Ask credential on launch -
ask_diff_mode_on_launch:
boolean
Title:
Ask diff mode on launch -
ask_execution_environment_on_launch:
boolean
Title:
Ask execution environment on launch -
ask_forks_on_launch:
boolean
Title:
Ask forks on launch -
ask_instance_groups_on_launch:
boolean
Title:
Ask instance groups on launch -
ask_inventory_on_launch:
boolean
Title:
Ask inventory on launch -
ask_job_slice_count_on_launch:
boolean
Title:
Ask job slice count on launch -
ask_job_type_on_launch:
boolean
Title:
Ask job type on launch -
ask_labels_on_launch:
boolean
Title:
Ask labels on launch -
ask_limit_on_launch:
boolean
Title:
Ask limit on launch -
ask_scm_branch_on_launch:
boolean
Title:
Ask scm branch on launch -
ask_skip_tags_on_launch:
boolean
Title:
Ask skip tags on launch -
ask_tags_on_launch:
boolean
Title:
Ask tags on launch -
ask_timeout_on_launch:
boolean
Title:
Ask timeout on launch -
ask_variables_on_launch:
boolean
Title:
Ask variables on launch -
ask_verbosity_on_launch:
boolean
Title:
Ask verbosity on launch -
become_enabled:
boolean
Title:
Become enabled -
created:
string
Title:
CreatedRead Only:true -
custom_virtualenv:
string
Title:
Custom virtualenvRead Only:trueMinimum Length:1Local absolute file path containing a custom Python virtualenv to use -
description:
string
Title:
Description -
diff_mode:
boolean
Title:
Diff modeIf enabled, textual changes made to any templated files on the host are shown in the standard output -
execution_environment:
integer
Title:
Execution environmentThe container image to be used for execution. -
extra_vars:
string
Title:
Extra vars -
force_handlers:
boolean
Title:
Force handlers -
forks:
integer
Title:
ForksMinimum Value:0 -
host_config_key:
string
Title:
Host config keyMaximum Length:1024 -
id:
integer
Title:
IDRead Only:true -
inventory:
integer
Title:
Inventory -
job_slice_count:
integer
Title:
Job slice countMinimum Value:0Default Value:1The number of jobs to slice into at runtime. Will cause the Job Template to launch a workflow if value is greater than 1. -
job_tags:
string
Title:
Job tags -
job_type:
string
Title:
Job typeDefault Value:runAllowed Values:[ "run", "check" ] -
last_job_failed:
boolean
Title:
Last job failedRead Only:true -
last_job_run:
string(date-time)
Title:
Last job runRead Only:true -
limit:
string
Title:
Limit -
modified:
string
Title:
ModifiedRead Only:true -
name(required):
string
Title:
NameMinimum Length:1Maximum Length:512 -
next_job_run:
string(date-time)
Title:
Next job runRead Only:true -
organization:
integer
Title:
OrganizationRead Only:trueThe organization used to determine access to this template. -
playbook:
string
Title:
PlaybookMaximum Length:1024 -
prevent_instance_group_fallback:
boolean
Title:
Prevent instance group fallbackIf enabled, the job template will prevent adding any inventory or organization instance groups to the list of preferred instances groups to run on.If this setting is enabled and you provided an empty list, the global instance groups will be applied. -
project:
string
Title:
Project - related: string
-
scm_branch:
string
Title:
Scm branchMaximum Length:1024Branch to use in job run. Project default used if blank. Only allowed if project allow_override field is set to true. -
skip_tags:
string
Title:
Skip tagsMaximum Length:1024 -
start_at_task:
string
Title:
Start at taskMaximum Length:1024 -
status:
string
Title:
StatusRead Only:trueAllowed Values:[ "new", "pending", "waiting", "running", "successful", "failed", "error", "canceled", "never updated" ] -
summary_fields:
string
Title:
Summary fieldsRead Only:true -
survey_enabled:
boolean
Title:
Survey enabled -
timeout:
integer
Title:
TimeoutThe amount of time (in seconds) to run before the task is canceled. -
type:
string
Title:
TypeRead Only:true -
url:
string
Title:
UrlRead Only:true -
use_fact_cache:
boolean
Title:
Use fact cacheIf enabled, the service will act as an Ansible Fact Cache Plugin; persisting facts at the end of a playbook run to the database and caching facts for use by Ansible. -
verbosity:
integer
Title:
VerbosityAllowed Values:[ "0", "1", "2", "3", "4", "5" ] -
webhook_credential:
integer
Title:
Webhook credentialPersonal Access Token for posting back the status to the service API -
webhook_service:
string
Title:
Webhook serviceAllowed Values:[ "github", "gitlab", "bitbucket_dc" ]Service that webhook requests will be accepted from
Response
Supported Media Types
- application/json
201 Response
Root Schema : JobTemplate
Type:
Show Source
object-
allow_simultaneous:
boolean
Title:
Allow simultaneous -
ask_credential_on_launch:
boolean
Title:
Ask credential on launch -
ask_diff_mode_on_launch:
boolean
Title:
Ask diff mode on launch -
ask_execution_environment_on_launch:
boolean
Title:
Ask execution environment on launch -
ask_forks_on_launch:
boolean
Title:
Ask forks on launch -
ask_instance_groups_on_launch:
boolean
Title:
Ask instance groups on launch -
ask_inventory_on_launch:
boolean
Title:
Ask inventory on launch -
ask_job_slice_count_on_launch:
boolean
Title:
Ask job slice count on launch -
ask_job_type_on_launch:
boolean
Title:
Ask job type on launch -
ask_labels_on_launch:
boolean
Title:
Ask labels on launch -
ask_limit_on_launch:
boolean
Title:
Ask limit on launch -
ask_scm_branch_on_launch:
boolean
Title:
Ask scm branch on launch -
ask_skip_tags_on_launch:
boolean
Title:
Ask skip tags on launch -
ask_tags_on_launch:
boolean
Title:
Ask tags on launch -
ask_timeout_on_launch:
boolean
Title:
Ask timeout on launch -
ask_variables_on_launch:
boolean
Title:
Ask variables on launch -
ask_verbosity_on_launch:
boolean
Title:
Ask verbosity on launch -
become_enabled:
boolean
Title:
Become enabled -
created:
string
Title:
CreatedRead Only:true -
custom_virtualenv:
string
Title:
Custom virtualenvRead Only:trueMinimum Length:1Local absolute file path containing a custom Python virtualenv to use -
description:
string
Title:
Description -
diff_mode:
boolean
Title:
Diff modeIf enabled, textual changes made to any templated files on the host are shown in the standard output -
execution_environment:
integer
Title:
Execution environmentThe container image to be used for execution. -
extra_vars:
string
Title:
Extra vars -
force_handlers:
boolean
Title:
Force handlers -
forks:
integer
Title:
ForksMinimum Value:0 -
host_config_key:
string
Title:
Host config keyMaximum Length:1024 -
id:
integer
Title:
IDRead Only:true -
inventory:
integer
Title:
Inventory -
job_slice_count:
integer
Title:
Job slice countMinimum Value:0Default Value:1The number of jobs to slice into at runtime. Will cause the Job Template to launch a workflow if value is greater than 1. -
job_tags:
string
Title:
Job tags -
job_type:
string
Title:
Job typeDefault Value:runAllowed Values:[ "run", "check" ] -
last_job_failed:
boolean
Title:
Last job failedRead Only:true -
last_job_run:
string(date-time)
Title:
Last job runRead Only:true -
limit:
string
Title:
Limit -
modified:
string
Title:
ModifiedRead Only:true -
name(required):
string
Title:
NameMinimum Length:1Maximum Length:512 -
next_job_run:
string(date-time)
Title:
Next job runRead Only:true -
organization:
integer
Title:
OrganizationRead Only:trueThe organization used to determine access to this template. -
playbook:
string
Title:
PlaybookMaximum Length:1024 -
prevent_instance_group_fallback:
boolean
Title:
Prevent instance group fallbackIf enabled, the job template will prevent adding any inventory or organization instance groups to the list of preferred instances groups to run on.If this setting is enabled and you provided an empty list, the global instance groups will be applied. -
project:
string
Title:
Project - related: string
-
scm_branch:
string
Title:
Scm branchMaximum Length:1024Branch to use in job run. Project default used if blank. Only allowed if project allow_override field is set to true. -
skip_tags:
string
Title:
Skip tagsMaximum Length:1024 -
start_at_task:
string
Title:
Start at taskMaximum Length:1024 -
status:
string
Title:
StatusRead Only:trueAllowed Values:[ "new", "pending", "waiting", "running", "successful", "failed", "error", "canceled", "never updated" ] -
summary_fields:
string
Title:
Summary fieldsRead Only:true -
survey_enabled:
boolean
Title:
Survey enabled -
timeout:
integer
Title:
TimeoutThe amount of time (in seconds) to run before the task is canceled. -
type:
string
Title:
TypeRead Only:true -
url:
string
Title:
UrlRead Only:true -
use_fact_cache:
boolean
Title:
Use fact cacheIf enabled, the service will act as an Ansible Fact Cache Plugin; persisting facts at the end of a playbook run to the database and caching facts for use by Ansible. -
verbosity:
integer
Title:
VerbosityAllowed Values:[ "0", "1", "2", "3", "4", "5" ] -
webhook_credential:
integer
Title:
Webhook credentialPersonal Access Token for posting back the status to the service API -
webhook_service:
string
Title:
Webhook serviceAllowed Values:[ "github", "gitlab", "bitbucket_dc" ]Service that webhook requests will be accepted from