2.8. サーバータスクの使用
Data Grid サーバータスクを取得、実行、およびアップロードします。
2.8.1. サーバータスク情報の取得
GET リクエストで利用可能なサーバータスクに関する情報を表示します。
GET /rest/v2/tasks
表2.38 リクエストパラメーター
| パラメーター | 必須またはオプション | 値 |
|---|---|---|
|
| オプション |
|
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