ジョブ・テンプレートの作成
post
/api/v2/job_templates/
次のジョブ・テンプレート・フィールドを指定してこのリソースに対してPOSTリクエストを行って、新しいジョブ・テンプレートを作成します。
name
: このジョブ・テンプレートの名前。(文字列、必須)description
: このジョブ・テンプレートのオプションの説明。(文字列、デフォルト=""
)job_type
: (選択)run
: 実行(デフォルト)check
: チェック
inventory
: (id、デフォルト=``)project
: (id、デフォルト=``)playbook
: (文字列、デフォルト=""
)scm_branch
: ジョブ実行で使用するブランチ。 空白の場合に使用されるプロジェクトのデフォルト。 プロジェクトのallow_overrideフィールドがtrueに設定されている場合にのみ許可されます。(文字列、デフォルト=""
)forks
: (整数、デフォルト=0
)limit
: (文字列、デフォルト=""
)verbosity
: (選択)0
: 0 (標準) (デフォルト)1
: 1 (詳細)2
: 2 (より詳細)3
: 3 (デバッグ)4
: 4 (接続デバッグ)5
: 5 (WinRMデバッグ)
extra_vars
: (json、デフォルト=``)job_tags
: (文字列、デフォルト=""
)force_handlers
: (ブール、デフォルト=False
)skip_tags
: (文字列、デフォルト=""
)start_at_task
: (文字列、デフォルト=""
)timeout
: タスクが取り消されるまでの実行時間(秒)。(整数、デフォルト=0
)-
use_fact_cache
: 有効にすると、TowerはAnsibleファクト・キャッシュ・プラグインとして機能します。プレイブック実行の終了時にファクトをデータベースに永続化し、Ansibleで使用できるようにファクトをキャッシュします。(ブール、デフォルト=False
) -
host_config_key
: (文字列、デフォルト=""
) ask_scm_branch_on_launch
: (ブール、デフォルト=False
)ask_diff_mode_on_launch
: (ブール、デフォルト=False
)ask_variables_on_launch
: (ブール、デフォルト=False
)ask_limit_on_launch
: (ブール、デフォルト=False
)ask_tags_on_launch
: (ブール、デフォルト=False
)ask_skip_tags_on_launch
: (ブール、デフォルト=False
)ask_job_type_on_launch
: (ブール、デフォルト=False
)ask_verbosity_on_launch
: (ブール、デフォルト=False
)ask_inventory_on_launch
: (ブール、デフォルト=False
)ask_credential_on_launch
: (ブール、デフォルト=False
)survey_enabled
: (ブール、デフォルト=False
)become_enabled
: (ブール、デフォルト=False
)diff_mode
: 有効にすると、ホスト上のテンプレート化されたファイルに加えられたテキストの変更が標準出力に表示されます(ブール、デフォルト=False
)allow_simultaneous
: (ブール、デフォルト=False
)custom_virtualenv
: 使用するカスタムPython virtualenvを含むローカルの絶対ファイル・パス(文字列、デフォルト=""
)job_slice_count
: 実行時にスライスするジョブの数。 値が1より大きい場合は、ジョブ・テンプレートによってワークフローが起動されます。(整数、デフォルト=1
)webhook_service
: Webフック・リクエストを受け入れるサービス(選択)""
: ---------github
: GitHubgitlab
: GitLab
webhook_credential
: サービスAPIにステータスをポスト・バックするための個人アクセス・トークン(id、デフォルト=``)
リクエスト
サポートされているメディア・タイプ
- application/json
ルート・スキーマ : schema
例:
{
"ask_inventory_on_launch":true,
"name":"foobar",
"organization":2,
"playbook":"helloworld.yml",
"project":1
}
レスポンス
サポートされているメディア・タイプ
- application/json
201レスポンス
レスポンスの例(application/json)
{
"allow_simultaneous":false,
"ask_credential_on_launch":false,
"ask_diff_mode_on_launch":false,
"ask_inventory_on_launch":true,
"ask_job_type_on_launch":false,
"ask_limit_on_launch":false,
"ask_scm_branch_on_launch":false,
"ask_skip_tags_on_launch":false,
"ask_tags_on_launch":false,
"ask_variables_on_launch":false,
"ask_verbosity_on_launch":false,
"become_enabled":false,
"created":"2018-02-01T08:00:00.000000Z",
"custom_virtualenv":null,
"description":"",
"diff_mode":false,
"extra_vars":"",
"force_handlers":false,
"forks":0,
"host_config_key":"",
"id":3,
"inventory":null,
"job_slice_count":1,
"job_tags":"",
"job_type":"run",
"last_job_failed":false,
"last_job_run":null,
"limit":"",
"modified":"2018-02-01T08:00:00.000000Z",
"name":"foobar",
"next_job_run":null,
"organization":1,
"playbook":"helloworld.yml",
"project":1,
"related":{
"access_list":"/api/v2/job_templates/3/access_list/",
"activity_stream":"/api/v2/job_templates/3/activity_stream/",
"copy":"/api/v2/job_templates/3/copy/",
"credentials":"/api/v2/job_templates/3/credentials/",
"instance_groups":"/api/v2/job_templates/3/instance_groups/",
"jobs":"/api/v2/job_templates/3/jobs/",
"labels":"/api/v2/job_templates/3/labels/",
"launch":"/api/v2/job_templates/3/launch/",
"notification_templates_error":"/api/v2/job_templates/3/notification_templates_error/",
"notification_templates_started":"/api/v2/job_templates/3/notification_templates_started/",
"notification_templates_success":"/api/v2/job_templates/3/notification_templates_success/",
"object_roles":"/api/v2/job_templates/3/object_roles/",
"organization":"/api/v2/organizations/1/",
"project":"/api/v2/projects/1/",
"schedules":"/api/v2/job_templates/3/schedules/",
"slice_workflow_jobs":"/api/v2/job_templates/3/slice_workflow_jobs/",
"survey_spec":"/api/v2/job_templates/3/survey_spec/",
"webhook_key":"/api/v2/job_templates/3/webhook_key/",
"webhook_receiver":""
},
"scm_branch":"",
"skip_tags":"",
"start_at_task":"",
"status":"never updated",
"summary_fields":{
"credentials":[
],
"labels":{
"count":0,
"results":[
]
},
"object_roles":{
"admin_role":{
"description":"Can manage all aspects of the job template",
"id":34,
"name":"Admin"
},
"execute_role":{
"description":"May run the job template",
"id":35,
"name":"Execute"
},
"read_role":{
"description":"May view settings for the job template",
"id":36,
"name":"Read"
}
},
"organization":{
"description":"test-org-desc",
"id":1,
"name":"test-org"
},
"project":{
"description":"test-proj-desc",
"id":1,
"name":"test-proj",
"scm_type":"git",
"status":"never updated"
},
"recent_jobs":[
],
"user_capabilities":{
"copy":true,
"delete":true,
"edit":true,
"schedule":true,
"start":true
}
},
"survey_enabled":false,
"timeout":0,
"type":"job_template",
"url":"/api/v2/job_templates/3/",
"use_fact_cache":false,
"verbosity":0,
"webhook_credential":null,
"webhook_service":""
}
400レスポンス
レスポンスの例(application/json)
{
"ask_scm_branch_on_launch":[
"Project does not allow overriding branch."
]
}
403レスポンス
レスポンスの例(application/json)
{
"detail":"You do not have permission to perform this action."
}