Documentation

システムジョブテンプレートリストの API エンドポイント

このリソースに GET リクエストを実行して、システムジョブテンプレートリストを取得します。

GET /api/v2/system_job_templates/
HTTP 200 OK
Content-Type: application/json
Vary: Accept
Allow: GET, HEAD, OPTIONS
X-API-Time: 0.060s

返されるデータ構造には以下のものが含まれます。

{
    "count": 99,
    "next": null,
    "previous": null,
    "results": [
        ...
    ]
}

count フィールドはクエリーで見つかったシステムジョブテンプレートの合計数を示します。next および previous フィールドは、単一ページに収まらない結果がある場合に、それらの結果へのリンクを提供します。results にはシステムジョブテンプレートのレコードが一覧表示されますが、ゼロの場合もあります。

結果

各システムジョブテンプレートのデータ構造には以下のフィールドが含まれます。

  • id: システムジョブテンプレートのデータベース ID (整数)
  • type: システムジョブテンプレートのデータタイプ (複数選択)
    • system_job_template: システムジョブテンプレート
  • url: システムジョブテンプレートの URL (文字列)
  • related: 関連リソースの URL のあるデータ構造 (オブジェクト)
  • summary_fields: 関連リソースの名前/説明のあるデータ構造 (オブジェクト)
  • created: システムジョブテンプレート作成時のタイムスタンプ (日時)
  • modified: システムジョブテンプレートの最終更新時のタイムスタンプ (日時)
  • name: (文字列)
  • description: (文字列)
  • last_job_run: (日時)
  • last_job_failed: (ブール値)
  • has_schedules: (ブール値)
  • next_job_run: (日時)
  • status: (複数選択)
    • new: 新規
    • pending: 保留中
    • waiting: 待機中
    • running: 実行中
    • successful: 成功
    • failed: 失敗
    • error: エラー
    • canceled: キャンセル済み
    • never updated: 更新されていません
    • ok: OK
    • missing: 不明
    • none: 外部ソースがありません
    • updating: 更新中
  • job_type: (複数選択)
    • "": ———
    • cleanup_jobs: 特定の日数より前のジョブを削除
    • cleanup_activitystream: 特定の日数より前のアクティビティーストリームのエントリーを削除
    • cleanup_deleted: 削除済みのアイテムをデータベースから完全削除
    • cleanup_facts: システムトラッキングデータを完全削除またはその粒度を削減

オプションエンドポイントの確認

オプションエンドポイント テーブルでは、このエンドポイントのオプションを確認できます。ブラウザー表示が可能な API でエンドポイントを表示している場合は、「オプション」ボタンをクリックすると以下の raw JSON が表示されます。

name System Job Template List
description # List System Job Templates: Make a GET request to this resource to retrieve the list of system job templates.
renders
0 application/json
1 text/html
parses
0 application/json
added_in_version 1.2
types
0 system_job_template
actions
GET
id
type integer
label ID
help_text Database ID for this system job template.
type
type multiple choice
help_text Data type for this system job template.
choices
0
0 system_job_template
1 System Job Template
url
type string
help_text URL for this system job template.
related
type object
help_text Data structure with URLs of related resources.
summary_fields
type object
help_text Data structure with name/description for related resources.
created
type datetime
help_text Timestamp when this system job template was created.
modified
type datetime
help_text Timestamp when this system job template was last modified.
name
type string
label name
description
type string
label description
last_job_run
type datetime
label last job run
last_job_failed
type boolean
label last job failed
has_schedules
type boolean
label has schedules
next_job_run
type datetime
label next job run
status
type multiple choice
label status
choices
0
0 new
1 New
1
0 pending
1 Pending
2
0 waiting
1 Waiting
3
0 running
1 Running
4
0 successful
1 Successful
5
0 failed
1 Failed
6
0 error
1 Error
7
0 canceled
1 Canceled
8
0 never updated
1 Never Updated
9
0 ok
1 OK
10
0 missing
1 Missing
11
0 none
1 No External Source
12
0 updating
1 Updating
job_type
type multiple choice
label job type
choices
0
0 (Empty Text)
1 ---------
1
0 cleanup_jobs
1 Remove jobs older than a certain number of days
2
0 cleanup_activitystream
1 Remove activity stream entries older than a certain number of days
3
0 cleanup_deleted
1 Purge previously deleted items from the database
4
0 cleanup_facts
1 Purge and/or reduce the granularity of system tracking data
search_fields
0 description
1 name