2.7.21 タスクログの取得
機能
指定したタスクのタスクログを取得します。
実行権限
Adminロール，Developロール，Modifyロール，Submitロール
APIのバージョン
v1
リクエスト形式
GET http://host:port/Automation/version/objects/TaskLogs
APIの実行ユーザーが権限を持つすべてのタスクを対象に，指定したtaskIDのタスクログを取得します。クエリパラメータを指定すると，一覧を取得する対象を絞り込めます。
指定したtaskIDのタスクログを，offsetに指定した値を起点にし，最大でreadSize分取得します。reverseを指定した場合は，offsetから逆方向にreadSize分取得します。クエリパラメータは，次の形式で指定してください。
なお，ログは行単位で取得されます。指定したログサイズに達した場合は，取得中の行は取得されません。
?クエリパラメータ=値[&クエリパラメータ=値...]
クエリパラメータ |
フィルタ条件 |
|---|---|
taskID |
指定した値と等しい |
readSize |
指定した値と等しい（ただし，タスクログの最後まで） |
offset |
指定した値と等しい |
reverse※ |
offsetからの取得方向を逆にする |
- 注※
reverseには，値を指定しないでください。
そのほかに指定できるクエリパラメータについては，「2.2.9 クエリパラメータ」を参照してください。
- 指定例
taskID=512のタスクログを，読み出し位置3,000バイトから逆方向に1,000バイト分，取得する場合の指定例を次に示します。
?taskID=512&offset=3000&readSize=1000&reverse
ステータスコード
リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。
ステータスコード |
メッセージ |
説明 |
|---|---|---|
200 |
OK |
成功しました。 |
400 |
Bad Request |
引数が不正です。 |
401 |
Unauthorized |
ログイン権限がありません。 |
404 |
Not found |
権限が不正です。または，リソースがありません。 |
412 |
Precondition failed |
サーバが起動していません。 |
500 |
Server-side error |
サーバ処理エラーが発生しました。 |
レスポンスのスキーマ
リクエストに対するレスポンスボディーの構造を次に示します。
{
"data" : [ {"タスクログ機能のリソース（Tasklogs）のメンバー" : 値 ... }, ... ],
"count" : クエリパラメータの条件に合致したデータの個数（0～n）
}
使用例
taskID=2052のタスクログを，最初（読み出し位置0バイト）から5,000,000バイト分，取得する場合の使用例を示します。
リクエストヘッダー:
GET /Automation/v1/objects/TaskLogs?taskID=2052&offset=0&readSize=5000000 HTTP/1.1
Host: 10.196.184.238:22015
Accept: application/json
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1
Accept-Language: ja
レスポンスヘッダー:
HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:42:47 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO a6daa83f23a873c39c7a65069728796ce882153_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
レスポンスボディー:
{
"data" : [ {
"instanceID" : 2052,
"text" : "**** Windows Server 2012 R2 6.3
TZ=America/Los_Angeles
2014/07/14 04:57:31.730\r\n
yyyy/mm/dd hh:mm:ss.sss pid tid message-id message(LANG=ja)\r\n
8947 2014/07/14 04:57:31.746 Automation 27A4F43E 12252248 KNAE08001-I 部品実行を開始しました（タスク名：Execute remote command_20140714045708，タスクID：2052，ステップID：/remoteHostCommandExe，実行ID：@A102）。\r\n
9101 2014/07/14 04:57:31.824 Automation 27A4F43E 12252248 KNAE08129-I 汎用コマンド実行を開始しました（コマンド：a）。\r\n
9103 2014/07/14 04:57:31.824 Automation 27A4F43E 12252248 KNAE08070-I root権限に昇格する設定（SSH接続用）が有効になっています。\r\n
9140 2014/07/14 04:57:34.433 Automation 27A4F43E 12252248 KNAE08131-E ER 汎用コマンド実行に失敗しました（コマンド：a，部品戻り値：77）。\r\n
9148 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08002-I 部品実行を終了しました（タスク名：Execute remote command_20140714045708，タスクID：2052，ステップID：/remoteHostCommandExe，実行ID：@A102，部品戻り値：77）。\r\n
9152 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I schema_version=1.1\r\n9154 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I vendor=com.hitachi.software.dna\r\n
9156 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I name=ExecuteCommandPlugin\r\n9158 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I version=01.10.00\r\n
9160 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I plugin_type=javaClass\r\n9162 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I vendor_display_name=(株)日立製作所\r\n
9164 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I display_name=汎用コマンド実行部品\r\n
9166 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I short_description=コマンドラインを対象ホストで実行する部品です。\r\n
9168 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I tags=Basic,Hitachi\r\n9170 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I enable_SSH_charset_detection=true\r\n
9172 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.mail.bcc, value=\r\n
9174 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.mail.cc, value=\r\n
9177 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.mail.from, value=********\r\n
9179 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.mail.notify, value=false\r\n
9182 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.mail.smtp.password, value=********\r\n
9184 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.mail.smtp.port, value=25\r\n
9186 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.mail.smtp.server, value=\r\n
9188 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.mail.smtp.userid, value=\r\n
9190 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.mail.to, value=\r\n
9192 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=com.hitachi.software.dna.sys.task.log.level, value=10\r\n
9194 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=common.remoteCommand, value=a\r\n
9196 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=common.remoteCommandParameter, value=a\r\n
9198 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=common.stdoutProperty, value=\r\n
9200 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=common.targetHost, value=a\r\n
9202 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=foreach.max_value, value=3\r\n
9204 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=mail.plugin.retry.interval, value=10\r\n
9206 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=mail.plugin.retry.times, value=3\r\n
9208 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=plugin.private.builtin.baseUrl, value=http://WIN-JLTV0PQLK2A:22015/Automation/\r\n
9210 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.service.category, value=OS_Operations/Basic\r\n
9212 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.service.name, value=Execute remote command\r\n
9214 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.service.resourceGroupName, value=DefaultServiceGroup\r\n
9216 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.step.path, value=/remoteHostCommandExe\r\n
9218 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.step.prevReturnCode, value=0\r\n
9220 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.task.description, value=\r\n
9222 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.task.dir, value=C:\\Program Files\\HiCommand\\Automation\\data\\task\\2052\r\n
9224 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.task.id, value=2052\r\n
9226 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.task.name, value=Execute remote command_20140714045708\r\n
9228 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.task.submitter, value=System\r\n
9230 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=reserved.task.url, value=http://WIN-JLTV0PQLK2A:22015/Automation/launcher/TaskDetails?task_id=2052\r\n
9232 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=account, value=\r\n
9234 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=commandLine, value=a\r\n
9236 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=commandLineParameter, value=a\r\n
9238 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=credentialType, value=destination\r\n
9240 2014/07/14 04:57:34.449 Automation 27A4F43E 12252248 KNAE08004-I property=destinationHost, value=a\r\n
9243 2014/07/14 04:57:34.457 Automation 27A4F43E 12252248 KNAE08004-I property=password, value=********\r\n
9245 2014/07/14 04:57:34.457 Automation 27A4F43E 12252248 KNAE08004-I property=stdoutPattern1, value=((?s).*)\r\n
9247 2014/07/14 04:57:34.457 Automation 27A4F43E 12252248 KNAE08004-I property=stdoutPattern2, value=\r\n
9249 2014/07/14 04:57:34.457 Automation 27A4F43E 12252248 KNAE08004-I property=stdoutPattern3, value=\r\n
9252 2014/07/14 04:57:34.457 Automation 27A4F43E 12252248 KNAE08004-I property=suPassword, value=********\r\n
9254 2014/07/14 04:57:34.457 Automation 27A4F43E 12252248 KNAE08009-I 部品の標準出力はありません。\r\n
9258 2014/07/14 04:57:34.699 Automation 27A4F43E 12252248 KNAE08014-E ER 指定された接続先ホスト名の名前解決に失敗しました（詳細情報：a [errno=11004, syscall=getaddrinfo]）。
指定された接続先ホスト名の名前解決ができません。接続先ホスト名の指定値，ネットワークおよびDNSの設定を確認して，再度サービスを実行してください。\r\n
9260 2014/07/14 04:57:34.699 Automation 27A4F43E 12252248 KNAE08016-E ER 部品実行で障害が発生しました（タスク名：Execute remote command_20140714045708，タスクID：2052，ステップID：/remoteHostCommandExe，実行ID：@A102，部品戻り値：77）。\r\n
次の要因が考えられます。\r\n・部品実行で何らかの障害が発生した。\r\n・タスクの強制停止操作が行われた。\r\n
・本製品の停止操作が行われた。\r\n
タスクログおよび公開ログ(Server[n].log)の発生時刻前後のメッセージを確認して対処してください。タスクの強制停止や本製品の停止操作の形跡がなく，
発生時刻前後にエラーメッセージも出力されていない場合は，資料採取ツールで資料を採取し，システム管理者に連絡してください。\r\n
**** Windows Server 2012 R2 6.3 TZ=America/Los_Angeles 2014/07/14 04:58:17.793\r\n
yyyy/mm/dd hh:mm:ss.sss pid tid message-id message(LANG=ja)\r\n
9913 2014/07/14 04:58:17.793 Automation 27A4F43E 1A87FBF6 KNAE08904-I 失敗した次のステップからリトライしました（ユーザーID：System）。\r\n",
"totalSize" : 9477,
"readSize" : 9477,
"lineCount" : 66,
"offset" : 0,
"reverse" : false
} ],
"count" : 1
}