2.8. サーバータスクの使用

Data Grid サーバータスクを取得、実行、およびアップロードします。

2.8.1. サーバータスク情報の取得

GET リクエストで利用可能なサーバータスクに関する情報を表示します。 

GET /rest/v2/tasks

表2.31 リクエストパラメーター

パラメーター必須またはオプション値

type

オプション

user: 内部 (管理者) のタスクを結果から除外します。

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&param.p1=v1&param.p2=v2

Data Grid はタスクの結果で応答します。

2.8.3. スクリプトタスクのアップロード

PUT または POST リクエストでスクリプトタスクをアップロードします。

リクエストのコンテンツペイロードとしてスクリプトを提供します。Data Grid がスクリプトをアップロードした後、GET リクエストでスクリプトを実行することができます。 

POST /rest/v2/tasks/taskName