Oracle Linux Automation Manager CLIおよびAPIリファレンス・ガイド

ジョブ・テンプレートの起動

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

パス・パラメータ

id: 文字列

ルート・スキーマ : 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."
}

先頭に戻る