すべてのプロダクト
Search
ドキュメントセンター

OpenSearch:ScheduledTask

最終更新日:Apr 02, 2026

ScheduledTask オブジェクトは、OpenSearch アプリケーションの定期的なインデックス再作成タスクを記述します。これには、タスクのスケジューリング構成、現在の実行状態、タスクタイプ、およびデータフィルター条件が含まれます。

{
    "id": "cfd5ebe9-bcdd-11ea-a58d-98039b07e4ec",
    "progress": 0,
    "status": 3,
    "lastRanTimestamp": null,
    "type": "wipe",
    "running": false,
    "paused": false,
    "finished": false,
    "idle": true,
    "created": 1593747144,
    "updated": 1593747144,
    "cron": "0 0 * * 1,2,3,4,5,6,7",
    "enabled": true,
    "appId": null,
    "appGroupId": "100303899",
    "ownerId": "84",
    "lastScheduledTimestamp": null,
    "forkedAppId": "",
    "appGroup": {
        "id": "100303899"
    },
    "owner": {
        "id": "84"
    },
    "filter": {
        "field": "title",
        "days": 30,
        "unit": "s"
    }
}

フィールド

ID と所有権

フィールドタイプ説明
idString定期的なインデックス再作成タスクの ID。
appIdStringバージョンの ID。
appGroupIdStringアプリケーションの ID。
appGroup.idStringアプリケーションの ID。
ownerIdStringオーナーの ID。
owner.idStringオーナーの ID。
forkedAppIdStringインデックス再作成の実行元となるソースバージョンの ID。

スケジューリング

フィールドタイプ説明
cronStringタスクスケジュールを定義する cron 式です。たとえば、0 0 * * 1,2,3,4,5,6,7 は、タスクを毎日深夜 0 時に実行します。cron 構文の詳細については、「ScheduledTask の cron フィールド」をご参照ください。
enabledブール値定期タスクを有効にするかどうかを指定します。
lastScheduledTimestamp整数/nullタスクが最後にスケジュールされたときのタイムスタンプです。
lastRanTimestamp整数/null定期的なインデックス再作成タスクが最後に実行されたときのタイムスタンプです。

タスクタイプ

フィールドタイプ説明
typeStringタスクが実行する操作のタイプ。有効な値: wipe (データ削除タスク)、fork (データインポートおよびインデックス再作成タスク)、reindex (インデックス再作成タスク)、clear (データクリアリングタスク)。

実行状態

フィールドタイプ説明
progressInteger定期的なインデックス再作成タスクの進捗。
statusIntegerタスクの現在の状態。有効な値: 0 (実行中)、1 (一時停止中)、2 (完了)、3 (アイドル)。
runningBooleanタスクが現在実行中であるかどうかを指定します。status0 に対応します。
pausedBooleanタスクが一時停止中であるかどうかを指定します。status1 に対応します。
finishedBooleanタスクが完了したかどうかを指定します。status2 に対応します。
idleBooleanタスクがアイドル状態であり、次の定期実行を待機しているかどうかを指定します。status3 に対応します。

データフィルター

filter オブジェクトは、フィールドの有効期限に基づいてタスクが削除するデータを指定します。

フィールドタイプ説明
filterObject期限切れデータを識別して削除するために使用される条件。
filter.fieldString有効期限設定に対して評価されるインデックスフィールドの名前。
filter.daysInteger有効期限のしきい値 (日数)。この値よりも古いデータは削除されます。有効な値: 7~180。
filter.unitStringfilter.field に保存されている値の単位。有効な値: s (秒)、ms (ミリ秒)。