2.7.11　タスクの再実行 : JP1 Version 12 JP1/Automatic Operation コマンド・API リファレンス

機能

指定したタスクを再実行します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

POST http://host:port/Automation/version/objects/Tasks/id/actions/resubmit/
invoke

リクエストボディーの構造は，次のようになっています。

{
  "name" : "resubmit",
  "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/resubmit/invoke",
  "method" : "POST",
  "parameters" : [ {...} ]
}

リクエストのスキーマで「parameters」のメンバーとして指定できるオブジェクトを，次の表で説明します。

表2‒62　「parameters」のメンバーとして指定できるオブジェクト
機能	リソース名称	数	説明
スケジュール	Schedule	1	サービスの実行予定
プロパティ値の一覧	PropertyValue	0～n	サービスの入力プロパティ

これらのオブジェクトに指定必須のプロパティについて，次に説明します。

共通の設定の場合

表2‒63　共通の設定の場合
リソース名称	メンバー名	数
Schedule	name	1
Schedule	description
Schedule	scheduleType
PropertyValue	keyName	0～n
PropertyValue	value	0～n

［即時実行］の場合

プロパティの指定は不要です。

［指定日時実行］の場合

表2‒64　指定日時実行の場合
リソース名称	メンバー名	数
Schedule	scheduledStartTime	1

［定期実行］の場合

表2‒65　定期実行の場合
リソース名称	メンバー名	数
Schedule	recurrenceInterval	1
Schedule	recurrenceMinutes
Schedule	recurrenceDayOfWeek
Schedule	recurrenceDayOfMonth
Schedule	recurrenceLastDayOfMonth
Schedule	recurrenceStartDate
Schedule	recurrenceTime

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード	メッセージ	説明
200	OK	成功しました。
400	Bad Request	引数が不正です。
401	Unauthorized	ログイン権限がありません。
404	Not found	権限が不正です。または，リソースがありません。
409	Conflict	タスクの状態が正常終了またはキャンセルではありません。
412	Precondition failed	サーバが利用できません。
500	Server-side error	サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造は，次のようになっています。

{
  "instanceID" : "instance-id",
  "created" : "created-date-and-time",
  "updated" : "updated-date-and-time",
  "completed" : "completed-date-and-time",
  "state" : "state",
  "affectedResources" : [ {...} ],
  "result" : [ {...} ],
  "resultType" : "result-type"
}

「affectedResources」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表2‒66　「affectedResources」のメンバーとして出力されるオブジェクト（タスクの再実行）
出力	リソース名称	数	説明
作成されたスケジュールへのリンク	String	1	作成されたスケジュール機能のリソース（Schedules）へのリンク
作成されたタスクへのリンク	String	1	作成されたタスク機能のリソース（Tasks）へのリンク

使用例

instanceID=2026のタスクを再実行する場合の使用例を示します。

リクエストヘッダー:

POST /Automation/v1/objects/Tasks/2026/actions/resubmit/invoke HTTP/1.1
Host: 10.196.184.238:22015
Accept: application/json
Content-Type: application/json
Content-Length: 821
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1
Accept-Language: ja

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:19:39 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 5011884058b535482bf6bac7390956be5fc2122_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : "d2a2284f-9a94-4be0-8813-e5f991762740",
  "created" : "2014-07-14T05:19:40.089-0700",
  "updated" : "2014-07-14T05:19:40.089-0700",
  "completed" : "2014-07-14T05:19:40.089-0700",
  "state" : "success",
  "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2060", "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2063" ],
  "result" : [ ]
}

2.7.11 タスクの再実行

2.7.11　タスクの再実行