# 中継履歴の出力

中継履歴の一覧を、中継開始日時の降順で表示します。

## コマンド形式

    hspctl [global options] list [command options] relay-histories

## パラメーター説明

[global options]

  すべてのコマンドに共通で使用するオプションを指定します。

  詳細は、「コマンドラインインターフェース」を参照してください。

[command options]
  --lines, -n <number>

    出力件数

    指定件数のレコード分、アクション受付履歴が出力されます。

    1から100まで指定できます。

  --offset <number>

    出力するレコードのオフセット指定

    先頭からオフセットの指定件数分リストに表示されません。

    最大値は、2,147,483,647です。

## 出力内容

中継履歴について、以下の項目が出力されます。

- SERIAL_ID

  中継シリアルID

  HULFT10 Smart Proxyでの中継のトランザクションを一意に識別する文字列です。

- RELAY_STATUS

  中継ステータス

  以下の中継の状態が表示されます。

  connecting

    : 接続中（データ中継の準備中）

  relaying

    : データ中継中

  succeeded

    : 中継が成功で完了した

  failed

    : 中継が失敗で完了した

- STARTED_AT

  中継開始日時

  中継を開始した日時（UTC）が表示されます。

- FINISHED_AT

  中継終了日時（UTC）

  中継を終了した日時（UTC）が表示されます。

- SOURCE_HOST

  配信元ホスト名（ホスト名：ポート番号）

  ファイルを配信したホストの名前です。

  HULFTによる転送である場合、配信を行ったHULFTの区別ができるよう集信ポートも表示されます。

- DESTINATION_HOST

  集信先ホスト名（ホスト名：ポート番号）

  ファイルを集信したホストの名前です。

  HULFTによる転送である場合、集信を行ったHULFTの区別ができるよう集信ポートも表示されます。

- PROTOCOL_TYPE

  プロトコル種別

  中継した際の通信プロトコルです。

- FILE_ID

  ファイルID

  配信したファイルのファイルIDです。

- SOURCE_PROXY

  接続元プロキシ（サービス名（ホスト名:ポート番号））

  HULFT10 Smart Proxy間で中継した際に配信側となった中継プロキシのホスト名です。

  中継履歴を記録するHULFT10 Smart Proxyが配信側であるときにはデータが記録されていないため、出力時は空白となります。

- DESTINATION_PROXY

  接続先プロキシ（サービス名(ホスト名:ポート番号)）

  HULFT10 Smart Proxy間で中継した際に集信側となった中継プロキシのホスト名です。

  中継履歴を記録するHULFT10 Smart Proxyが集信側であるときにはデータが記録されていないため、出力時は空白となります。

- RELAYED_BYTE_SIZE

  中継データサイズ

  HULFT10 Smart Proxyが集信側に送り出したデータのサイズです。

  HULFT10 Smart Proxyが中継したデータサイズを示したものであるため、転送したファイルのサイズやHULFTの転送履歴のデータサイズとは一致しない場合があります。

- ERROR_DETAILS

  エラー詳細

  中継でエラーが起きた際の詳細情報です。

  HULFT10 Smart Proxy上で起きたエラーの詳細や、HULFTの詳細コードおよびメッセージが出力されます。

- CONNECTION_RETRY_COUNT

  接続試行回数

  HULFT10 Smart Proxyが中継先に接続するときの接続試行回数です。

- TRANSFER_ID

  転送識別子

  HULFTの最新転送識別子です。

  HULFTやManagerの履歴でも最新転送識別子が出力されています。

- PROCESSING_ID

  処理識別子

  HULFTの最新処理識別子です。

  HULFTやManagerの履歴でも最新処理識別子が出力されています。

## 出力例

    SERIAL_ID                            RELAY_STATUS STARTED_AT           FINISHED_AT          SOURCE_HOST  DESTINATION_HOST FILE_ID      PROTOCOL_TYPE   SOURCE_PROXY         DESTINATION_PROXY CONNECTION_RETRY_COUNT RELAYED_BYTE_SIZE ERROR_DETAILS TRANSFER_ID                                                      PROCESSING_ID
    019071c7-73ac-7718-8b15-3d695d167cfb succeeded    2024-07-02T04:50:15Z 2024-07-02T04:50:15Z apple:30000  banana:30000     TESTFILEID01 HULFT(Transfer) sp1(nginx-001:42000)                   0                      0                               9ada1f5148526e94c4ae8942eb469ef732000300000000000000000000000000 9ADA1F5148526E94C4AE8942EB469EF732
    019071c7-6f58-72d6-b9c1-894dc1c6c4e1 succeeded    2024-07-02T04:50:14Z 2024-07-02T04:50:15Z banana:30000 apple:31000      TESTFILEID02 Unknown         sp1(nginx-001:42000)                   0                      0                               9ada1f5148526e94c4ae8942eb469ef732000300000000000000000000000000 9ADA1F5148526E94C4AE8942EB469EF732
    019071c7-781d-722b-b35a-0b1ac366a7c3 succeeded    2024-07-02T04:50:16Z 2024-07-02T04:50:16Z apple:30000  banana:30000     TESTFILEID03 HULFT(Transfer) sp1(nginx-001:42000)                   0                      0                               3f7d4f96a5a389c9f12431357b7c01b032000300000000000000000000000000 3F7D4F96A5A389C9F12431357B7C01B032
    019071c7-7481-704d-9bd2-f7334cf572b1 succeeded    2024-07-02T04:50:15Z 2024-07-02T04:50:16Z banana:30000 apple:31000      TESTFILEID04 Unknown         sp1(nginx-001:42000)                   0                      0                               3f7d4f96a5a389c9f12431357b7c01b032000300000000000000000000000000 3F7D4F96A5A389C9F12431357B7C01B032