2.8. サーバータスクの使用
Data Grid サーバータスクを取得、実行、およびアップロードします。
2.8.1. サーバータスク情報の取得
GET
リクエストで利用可能なサーバータスクに関する情報を表示します。
GET /rest/v2/tasks
パラメーター | 必須またはオプション | 値 |
---|---|---|
| オプション |
|
Data Grid は、利用可能なタスクのリストで応答します。リストには、次の例のように、タスクの名前、タスクを処理するエンジン、タスクの名前付きパラメーター、タスクの実行モード (ONE_NODE
または ALL_NODES
)、許可されるセキュリティーロールが JSON
形式で記載されています。
[ { "name": "SimpleTask", "type": "TaskEngine", "parameters": [ "p1", "p2" ], "execution_mode": "ONE_NODE", "allowed_role": null }, { "name": "RunOnAllNodesTask", "type": "TaskEngine", "parameters": [ "p1" ], "execution_mode": "ALL_NODES", "allowed_role": null }, { "name": "SecurityAwareTask", "type": "TaskEngine", "parameters": [], "execution_mode": "ONE_NODE", "allowed_role": "MyRole" } ]
2.8.2. タスクの実行
タスク名、オプションのキャッシュ名、param
で始まる必須パラメーターを含む POST
リクエストでタスクを実行します。
POST /rest/v2/tasks/SimpleTask?action=exec&cache=mycache¶m.p1=v1¶m.p2=v2
Data Grid はタスクの結果で応答します。
2.8.3. スクリプトタスクのアップロード
PUT
または POST
リクエストでスクリプトタスクをアップロードします。
リクエストのコンテンツペイロードとしてスクリプトを提供します。Data Grid がスクリプトをアップロードした後、GET
リクエストでスクリプトを実行することができます。
POST /rest/v2/tasks/taskName
2.8.4. スクリプトタスクのダウンロード
GET
要求でスクリプトタスクをダウンロードします。
GET /rest/v2/tasks/taskName?action=script