ジョブ・テンプレートの起動
post
/api/v2/job_templates/{id}/launch/
このリソースに対してGETリクエストを行って、job_templateを起動できるかどうか、およびjob_templateを起動するためにパスワードが必要かどうかを判断します。 レスポンスには次のフィールドが含まれます。
ask_variables_on_launch
: 起動時に変数の指定を求めるようにjob_templateが構成されているかどうかを示すフラグ(ブール、読取り専用)ask_tags_on_launch
: 起動時にタグの指定を求めるようにjob_templateが構成されているかどうかを示すフラグ(ブール、読取り専用)ask_skip_tags_on_launch
: 起動時にskip_tagsの指定を求めるようにjob_templateが構成されているかどうかを示すフラグ(ブール、読取り専用)ask_job_type_on_launch
: 起動時にjob_typeの指定を求めるようにjob_templateが構成されているかどうかを示すフラグ(ブール、読取り専用)ask_limit_on_launch
: 起動時に制限の指定を求めるようにjob_templateが構成されているかどうかを示すフラグ(ブール、読取り専用)ask_inventory_on_launch
: 起動時にインベントリの指定を求めるようにjob_templateが構成されているかどうかを示すフラグ(ブール、読取り専用)ask_credential_on_launch
: 起動時に資格証明の指定を求めるようにjob_templateが構成されているかどうかを示すフラグ(ブール、読取り専用)can_start_without_user_input
: ユーザー入力なしでjob_templateを起動できるかどうかを示すフラグ(ブール、読取り専用)passwords_needed_to_start
: job_templateを起動するために必要なパスワード名(配列、読取り専用)variables_needed_to_start
: job_templateを起動するために必要な必須変数名(配列、読取り専用)survey_enabled
: 有効なサーベイがjob_templateにあるかどうかを示すフラグ(ブール、読取り専用)inventory_needed_to_start
: ジョブ・テンプレートに関連付けられたインベントリが存在することを示すフラグ。 ない場合は、ジョブの起動時に指定する必要があります(ブール、読取り専用)
job_templateを起動するには、このリソースに対してPOSTリクエストを行います。 パスワード、インベントリまたは追加変数(extra_vars)が必要な場合は、extra_varsをYAMLまたはJSON文字列として指定し、カッコをエスケープして、POSTデータで渡す必要があります。 inventory_needed_to_start
がTrue
の場合は、inventory
が必要です。
成功した場合、レスポンス・ステータス・コードは201になります。 必要なパスワードが指定されていない場合は、400ステータス・コードが返されます。 ジョブを起動できない場合は、405ステータス・コードが返されます。 指定された資格証明またはインベントリの使用をユーザーが許可されていない場合は、403ステータス・コードが返されます。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
ルート・スキーマ : schema
例:
{
"extra_vars":{
"survey_var":7
}
}
レスポンス
サポートされているメディア・タイプ
- application/json
201レスポンス
レスポンスの例(application/json)
{
"ignored_fields":{
"extra_vars":{
"survey_var":7
}
},
"job":968
}
400レスポンス
レスポンスの例(application/json)
{
"variables_needed_to_start":[
"'secret_value' value missing"
]
}
403レスポンス
レスポンスの例(application/json)
{
"detail":"You do not have permission to perform this action."
}