ジョブ・テンプレートの起動
post
/api/v2/job_templates/{id}/launch/
job_templateを起動するには、このリソースに対してPOSTリクエストを行います。 パスワード、インベントリまたは追加変数(extra_vars)が必要な場合は、extra_varsをYAMLまたはJSON文字列として指定し、カッコをエスケープして、POSTデータで渡す必要があります。 inventory_needed_to_start
がTrue
の場合は、inventory
が必要です。
成功した場合、レスポンス・ステータス・コードは201になります。 必要なパスワードが指定されていない場合は、400ステータス・コードが返されます。 ジョブを起動できない場合は、405ステータス・コードが返されます。 指定された資格証明またはインベントリの使用をユーザーが許可されていない場合は、403ステータス・コードが返されます。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
ルート・スキーマ : JobLaunch
型:
ソースを表示
object
- ask_credential_on_launch: boolean
タイトル:
Ask credential on launch
読取り専用:true
- ask_diff_mode_on_launch: boolean
タイトル:
Ask diff mode on launch
読取り専用:true
- ask_execution_environment_on_launch: boolean
タイトル:
Ask execution environment on launch
読取り専用:true
- ask_forks_on_launch: boolean
タイトル:
Ask forks on launch
読取り専用:true
- ask_instance_groups_on_launch: boolean
タイトル:
Ask instance groups on launch
読取り専用:true
- ask_inventory_on_launch: boolean
タイトル:
Ask inventory on launch
読取り専用:true
- ask_job_slice_count_on_launch: boolean
タイトル:
Ask job slice count on launch
読取り専用:true
- ask_job_type_on_launch: boolean
タイトル:
Ask job type on launch
読取り専用:true
- ask_labels_on_launch: boolean
タイトル:
Ask labels on launch
読取り専用:true
- ask_limit_on_launch: boolean
タイトル:
Ask limit on launch
読取り専用:true
- ask_scm_branch_on_launch: boolean
タイトル:
Ask scm branch on launch
読取り専用:true
- ask_skip_tags_on_launch: boolean
タイトル:
Ask skip tags on launch
読取り専用:true
- ask_tags_on_launch: boolean
タイトル:
Ask tags on launch
読取り専用:true
- ask_timeout_on_launch: boolean
タイトル:
Ask timeout on launch
読取り専用:true
- ask_variables_on_launch: boolean
タイトル:
Ask variables on launch
読取り専用:true
- ask_verbosity_on_launch: boolean
タイトル:
Ask verbosity on launch
読取り専用:true
- can_start_without_user_input: boolean
タイトル:
Can start without user input
読取り専用:true
- credential_needed_to_start: string
タイトル:
Credential needed to start
読取り専用:true
- credential_passwords: string
タイトル:
Credential passwords
- credentials: array credentials
一意のアイテムが必要:
true
- defaults: string
タイトル:
Defaults
読取り専用:true
- diff_mode: boolean
タイトル:
Diff mode
- execution_environment: integer
タイトル:
Execution environment
- extra_vars: object Extra vars
タイトル:
Extra vars
- forks: integer
タイトル:
Forks
最小値:0
- instance_groups: array instance_groups
一意のアイテムが必要:
true
- inventory: integer
タイトル:
Inventory
- inventory_needed_to_start: string
タイトル:
Inventory needed to start
読取り専用:true
- job_slice_count: integer
タイトル:
Job slice count
最小値:0
- job_tags: string
タイトル:
Job tags
- job_template_data: string
タイトル:
Job template data
読取り専用:true
- job_type: string
タイトル:
Job type
指定できる値:[ "run", "check" ]
- labels: array labels
一意のアイテムが必要:
true
- limit: string
タイトル:
Limit
- passwords_needed_to_start: string
タイトル:
Passwords needed to start
読取り専用:true
- scm_branch: string
タイトル:
Scm branch
- skip_tags: string
タイトル:
Skip tags
- survey_enabled: string
タイトル:
Survey enabled
読取り専用:true
- timeout: integer
タイトル:
Timeout
- variables_needed_to_start: string
タイトル:
Variables needed to start
読取り専用:true
- verbosity: integer
タイトル:
Verbosity
指定できる値:[ "0", "1", "2", "3", "4", "5" ]
ネストされたスキーマ : 追加バー
型:
object
タイトル:
Extra vars
レスポンス
サポートされているメディア・タイプ
- application/json
201レスポンス
ルート・スキーマ : JobLaunch
型:
ソースを表示
object
- ask_credential_on_launch: boolean
タイトル:
Ask credential on launch
読取り専用:true
- ask_diff_mode_on_launch: boolean
タイトル:
Ask diff mode on launch
読取り専用:true
- ask_execution_environment_on_launch: boolean
タイトル:
Ask execution environment on launch
読取り専用:true
- ask_forks_on_launch: boolean
タイトル:
Ask forks on launch
読取り専用:true
- ask_instance_groups_on_launch: boolean
タイトル:
Ask instance groups on launch
読取り専用:true
- ask_inventory_on_launch: boolean
タイトル:
Ask inventory on launch
読取り専用:true
- ask_job_slice_count_on_launch: boolean
タイトル:
Ask job slice count on launch
読取り専用:true
- ask_job_type_on_launch: boolean
タイトル:
Ask job type on launch
読取り専用:true
- ask_labels_on_launch: boolean
タイトル:
Ask labels on launch
読取り専用:true
- ask_limit_on_launch: boolean
タイトル:
Ask limit on launch
読取り専用:true
- ask_scm_branch_on_launch: boolean
タイトル:
Ask scm branch on launch
読取り専用:true
- ask_skip_tags_on_launch: boolean
タイトル:
Ask skip tags on launch
読取り専用:true
- ask_tags_on_launch: boolean
タイトル:
Ask tags on launch
読取り専用:true
- ask_timeout_on_launch: boolean
タイトル:
Ask timeout on launch
読取り専用:true
- ask_variables_on_launch: boolean
タイトル:
Ask variables on launch
読取り専用:true
- ask_verbosity_on_launch: boolean
タイトル:
Ask verbosity on launch
読取り専用:true
- can_start_without_user_input: boolean
タイトル:
Can start without user input
読取り専用:true
- credential_needed_to_start: string
タイトル:
Credential needed to start
読取り専用:true
- credential_passwords: string
タイトル:
Credential passwords
- credentials: array credentials
一意のアイテムが必要:
true
- defaults: string
タイトル:
Defaults
読取り専用:true
- diff_mode: boolean
タイトル:
Diff mode
- execution_environment: integer
タイトル:
Execution environment
- extra_vars: object Extra vars
タイトル:
Extra vars
- forks: integer
タイトル:
Forks
最小値:0
- instance_groups: array instance_groups
一意のアイテムが必要:
true
- inventory: integer
タイトル:
Inventory
- inventory_needed_to_start: string
タイトル:
Inventory needed to start
読取り専用:true
- job_slice_count: integer
タイトル:
Job slice count
最小値:0
- job_tags: string
タイトル:
Job tags
- job_template_data: string
タイトル:
Job template data
読取り専用:true
- job_type: string
タイトル:
Job type
指定できる値:[ "run", "check" ]
- labels: array labels
一意のアイテムが必要:
true
- limit: string
タイトル:
Limit
- passwords_needed_to_start: string
タイトル:
Passwords needed to start
読取り専用:true
- scm_branch: string
タイトル:
Scm branch
- skip_tags: string
タイトル:
Skip tags
- survey_enabled: string
タイトル:
Survey enabled
読取り専用:true
- timeout: integer
タイトル:
Timeout
- variables_needed_to_start: string
タイトル:
Variables needed to start
読取り専用:true
- verbosity: integer
タイトル:
Verbosity
指定できる値:[ "0", "1", "2", "3", "4", "5" ]
ネストされたスキーマ : 追加バー
型:
object
タイトル:
Extra vars