ジョブの出力と結果の取得
GET
/jobs/{jobId}/output
ジョブの結果および進行状況を示すジョブ出力を取得します。これは、制限およびオフセット・パラメータを使用してページ区切りできます。
リクエスト
サポートされるメディア・タイプ
- application/json
パス・パラメータ
- jobId: string
スケジュール済ジョブの一意の整数ジョブID値。
問合せパラメータ
- limit(optional): integer
ジョブ出力リソースに含めるジョブ結果の行数。デフォルト値:
0
- offset(optional): integer
ジョブ出力リソースに含めるジョブ結果の最初の行の識別子。デフォルト値:
0
レスポンス
サポートされるメディア・タイプ
- application/json
200 レスポンス
OK。複数のプロパティを持つジョブ出力リソース表現と、少なくとも"self"リンクを持つlinks配列を含むJSONオブジェクト。
ネストされたスキーマ: collectionResourceLinks
タイプ:
ソースの表示
object
- href(optional): string
正しいURLパラメータを持つ絶対形式で指定された参照ハイパーリンク要素。
- rel(optional): string
指定できる値:
[ "next", "prev", "first", "last" ]
説明されたリソースを持つリンクの関係のタイプを指定します。
デフォルト・レスポンス
予期しないエラー操作の実行中の問題のエラー詳細を含むJSONオブジェクト。
ルート・スキーマ: errorResource
タイプ:
ソースの表示
object
- errorCode(optional): string
tittleに表示されるエラー・メッセージに関連する、アプリケーション固有のエラー・コード。
- errorDetails(optional): array errorDetails
複数のエラーがレポートされている場合は、この配列の階層構造に編成できます。
- errorPath(optional): string
エラーの発生場所を示すXPathまたはJSONパス。
- instance(optional): string
エラーに関する詳細を提供するリンクへのURI。
- status(optional): integer
HTTPステータス・コード。
- title(optional): string
要約エラー・メッセージ。
- type(optional): string
HTTPエラー・コード・ページへのリンク。
例
次の例は、cURLを使用してRESTリソースにGETリクエストを発行することによって、既存のジョブの結果と出力を表示する方法を示しています。
curl -u restUser -X GET "https://RHP_node_name:8894/rhp-restapi/rhp/jobs/1/output"
HTTPステータス・コードとレスポンス・ヘッダー
レスポンス・ヘッダーの例を次に示します。
HTTP/1.1 200
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true
Access-Control-Allow-Methods: GET,PUT,POST,DELETE,PATCH,OPTIONS
Access-Control-Allow-Headers: X-Requested-With, Content-Type, Content-Length, Authorization
Connection: keep-alive
Content-Type: application/json
Content-Length: 556
Date: Tue, 19 Jun 2018 14:03:23 GMT
レスポンス本体
{
"output" : "nodeName.domain.com: Audit ID: 6\nnodeName.domain.com: Creating a new ACFS file system for image "DB_Image1" ...\nnodeName.domain.com: Copying files...\nnodeName.domain.com: Copying home contents...\nnodeName.domain.com: Changing the home ownership to user aime1...\nnodeName.domain.com: Changing the home ownership to user aime1...",
"offset" : 0,
"limit" : 6,
"hasMore" : no,
"links" : [{
"uri" : "http://RHP_node_name:8894/rhp-restapi/rhp/jobs/1/output",
"rel" : "self"
}]
}