システム・ジョブ・テンプレートのスケジュールのリスト
get
/api/v2/system_job_templates/{id}/schedules/
このリソースに対してGETリクエストを行って、選択したシステム・ジョブ・テンプレートに関連付けられたスケジュールのリストを取得します。
結果のデータ構造には次が含まれます。
{
"count": 99,
"next": null,
"previous": null,
"results": [
...
]
}
countフィールドは、対象となる問合せで見つかったスケジュールの合計数を示します。nextフィールドとpreviousフィールドには、結果が1ページに収まらない場合に、追加の結果へのリンクが表示されます。resultsリストには、0個以上のスケジュール・レコードが含まれます。
結果
それぞれのスケジュールのデータ構造には次のフィールドが含まれます。
rrule: スケジュールのiCal繰返しルールを表す値。(文字列)id: このスケジュールのデータベースID。(整数)type: このスケジュールのデータ型。(選択)url: このスケジュールのURL。(文字列)related: 関連リソースのURLを含むデータ構造。(オブジェクト)summary_fields: 関連リソースの名前/説明を含むデータ構造。一部のオブジェクトの出力は、パフォーマンス上の理由によって制限される場合があります。(オブジェクト)created: このスケジュールが作成されたときのタイムスタンプ。(日時)modified: このスケジュールが最後に変更されたときのタイムスタンプ。(日時)name: このスケジュールの名前。(文字列)description: このスケジュールのオプションの説明。(文字列)extra_data: (json)inventory: プロンプトとして適用されるインベントリ(ジョブ・テンプレートによってインベントリの指定を求めるプロンプトが表示されると仮定する) (id)scm_branch: (文字列)job_type: (選択)None: ---------"": ---------run: 実行check: チェック
job_tags: (文字列)skip_tags: (文字列)limit: (文字列)diff_mode: (ブール)verbosity: (選択)None: ---------0: 0 (標準)1: 1 (詳細)2: 2 (より詳細)3: 3 (デバッグ)4: 4 (接続デバッグ)5: 5 (WinRMデバッグ)
execution_environment: 実行に使用されるコンテナ・イメージ。(id)forks: (整数)job_slice_count: (整数)timeout: (整数)unified_job_template: (id)enabled: このスケジュールの処理を有効にします。(ブール)dtstart: 初回のスケジュールはこの時間以降に発生します。(日時)dtend: 最後のスケジュールはこの時間より前に発生し、これ以降、スケジュールは失効します。(日時)next_run: スケジュールされたアクションが次に実行される時間。(日時)timezone: このスケジュールが実行されるタイムゾーン。このフィールドはRRULEから抽出されます。RRULEのタイムゾーンが別のタイムゾーンにリンクされている場合、そのリンクがこのフィールドに反映されます。(フィールド)until: このスケジュールを終了する日付。このフィールドはRRULEから計算されます。スケジュールに終了日がない場合は、空の文字列が返されます(フィールド)
ソート
スケジュールが特定の順序で返されるように指定するには、GETリクエストでorder_by問合せ文字列パラメータを使用します。
?order_by=name
フィールド名の先頭にダッシュ-を付けると逆の順序でソートされます。
?order_by=-name
フィールド名をカンマ,で区切ると、複数のソート・フィールドを指定できます。
?order_by=name,some_other_field
ページ区切り
リクエストごとに返される結果の数を変更するには、page_size問合せ文字列パラメータを使用します。特定のページの結果を取得するには、page問合せ文字列パラメータを使用します。
?page_size=100&page=2
結果で返されるpreviousリンクおよびnextリンクは、これらの問合せ文字列パラメータを自動的に設定します。
検索
モデルのすべての指定テキスト・フィールド内で大/小文字を区別しない検索を実行するには、search問合せ文字列パラメータを使用します。
?search=findme
(Ansible Tower 3.1.0で追加)関連フィールド全体を検索します。
?related__search=findme
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
問合せパラメータ
- page: 整数
ページ区切りが設定された結果セット内のページ番号。
- page_size: 整数
ページごとに返す結果の数。
- search: 文字列
検索条件。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
ネストされたスキーマ : Schedule
型:
ソースを表示
object- created: 文字列
タイトル:
Created読取り専用:true - description: 文字列
タイトル:
Description - diff_mode: ブール
タイトル:
Diff mode - dtend: 文字列(日付-時間)
タイトル:
Dtend読取り専用:true最後のスケジュールはこの時間より前に発生し、これ以降、スケジュールは失効します。 - dtstart: 文字列(日付-時間)
タイトル:
Dtstart読取り専用:true初回のスケジュールはこの時間以降に発生します。 - enabled: ブール
タイトル:
Enabledデフォルト値:trueこのスケジュールの処理を有効にします。 - execution_environment: 整数
タイトル:
Execution environment実行に使用されるコンテナ・イメージ。 - extra_data: オブジェクト Extra data
タイトル:
Extra data - forks: 整数
タイトル:
Forks最小値:0 - id: 整数
タイトル:
ID読取り専用:true - inventory: 整数
タイトル:
Inventoryプロンプトとして適用されるインベントリ(ジョブ・テンプレートによってインベントリのプロンプトが表示されると仮定する) - job_slice_count: 整数
タイトル:
Job slice count最小値:0 - job_tags: 文字列
タイトル:
Job tags - job_type: 文字列
タイトル:
Job type指定できる値:[ "run", "check" ] - limit: 文字列
タイトル:
Limit - modified: 文字列
タイトル:
Modified読取り専用:true - name(必須): 文字列
タイトル:
Name最小長:1最大長:512 - next_run: 文字列(日付-時間)
タイトル:
Next run読取り専用:trueスケジュールされたアクションの次回の実行日時。 - related: 文字列
- rrule(必須): 文字列
タイトル:
Rrule最小長:1スケジュールのiCal繰返しルールを表す値。 - scm_branch: 文字列
タイトル:
Scm branch - skip_tags: 文字列
タイトル:
Skip tags - summary_fields: 文字列
タイトル:
Summary fields読取り専用:true - timeout: 整数
タイトル:
Timeout - timezone: 文字列
タイトル:
Timezone読取り専用:trueこのスケジュールが実行されるタイムゾーン。このフィールドはRRULEから抽出されます。RRULEのタイムゾーンが別のタイムゾーンにリンクされている場合、そのリンクがこのフィールドに反映されます。 - type: 文字列
タイトル:
Type読取り専用:true - unified_job_template(必須): 整数
タイトル:
Unified job template - until: 文字列
タイトル:
Until読取り専用:trueこのスケジュールを終了する日付。このフィールドはRRULEから計算されます。スケジュールに終了日がない場合は、空の文字列が返されます - url: 文字列
タイトル:
Url読取り専用:true - verbosity: 文字列
タイトル:
Verbosity指定できる値:[ "0", "1", "2", "3", "4", "5" ]
ネストされたスキーマ : Extra data
型:
objectタイトル:
Extra data