# HULFT接続確認

接続先ホストへの接続確認を行います。

## Examples

RESPONSE EXAMPLE

HULFT for zOS のサンプルは以下となります。

接続先v10

    {
      "meta": {
        "request_user_role": "admin"
      },
      "os_type": "zos",
      "version": "v10",
      "product_version": "V10L02R00P00",
      "huladmin_version": "V10L02",
      "is_connectable": true,
      "strong_key_mode": "disable",
      "need_to_be_loggedin": false
    }

接続先v7（接続サポート対象外）

    {
      "meta": {
        "request_user_role": "admin"
      },
      "os_type": "unsupported",
      "version": "v7",
      "is_connectable": false
    }

接続先v8（接続サポート対象外）

    {
      "meta": {
        "request_user_role": "admin"
      },
      "os_type": "zos",
      "version": "v8",
      "product_version": "V08L05R02PA0",
      "huladmin_version": "V08L04",
      "is_connectable": false,
      "strong_key_mode": "enable",
      "need_to_be_loggedin": false
    }

## Request Interface

    http://ControlURL/api/v1/hulft/{hulft-host-id}/health

= 備考 =

上のRequest InterfaceのURLで、斜体の文字部分に指定するパスについては以下を参照してください。

HULFT10 API Gateway ガイド : Request Interfaceの指定

## Response Interface

### 200 OK

RESPONSE HEADERS

X-Request-ID : string

  WebAPIのリクエストID

RESPONSE SCHEMA : application/json

meta : object
  request_user_role : string

    API実行ユーザーの権限

    以下のいずれかが取得されます。

    admin

      : ユーザーの管理や接続先HULFTの追加を行うことができる権限

    member

      : 登録済みのHULFTへの接続を行うことができる権限

os_type : string

  接続先ホスト機種

  以下のいずれかが取得されます。

  windows

    : Windows環境

  linux

    : Linux/AIX環境

  ibmi

    : IBM i（AS/400）環境

  zos

    : z/OS（汎用機）環境

  unsupported

    : 上記以外の環境

version : string

  バージョン

  接続先HULFTのメジャーバージョン

  通信の内容から接続先HULFTのバージョンを推測します。

product_version : string

  製品バージョン

  接続先HULFTの製品バージョン

  取得が可能だった場合のみ表示。

huladmin_version : string

  HULADMINバージョン

  接続先HULFTが対応しているHULADMINバージョン

  取得が可能だった場合のみ表示。

is_connectable : boolean

  接続サポート有無

strong_key_mode : string

  高強度暗号強制モードの設定値

  有効な場合は、配信管理情報登録時および集信管理情報登録時に64桁の暗号キーの指定が必須

  以下のいずれかが取得されます。

  disable

    : 無効

  enable

    : 有効

need_to_be_loggedin : boolean

  パスワードチェック有無

  管理画面セキュリティのパスワードチェックが有効な環境には接続できません。

### 401 認証エラー

RESPONSE HEADERS

X-Request-ID : string

  WebAPIのリクエストID

RESPONSE SCHEMA : application/json

request_id : string

  リクエストID

accept_datetime : string <date-time>

  受付日時

api_path : string

  APIパス

http_method : string

  HTTPリクエストのメソッド形式

  以下のいずれかが取得されます。

  GET

  HEAD

  POST

  OPTIONS

  PUT

  DELETE

  TRACE

  PATCH

  LINK

  UNLINK

### 403 認可エラー

RESPONSE HEADERS

X-Request-ID : string

  WebAPIのリクエストID

RESPONSE SCHEMA : application/json

request_id : string

  リクエストID

accept_datetime : string <date-time>

  受付日時

api_path : string

  APIパス

http_method : string

  HTTPリクエストのメソッド形式

  以下のいずれかが取得されます。

  GET

  HEAD

  POST

  OPTIONS

  PUT

  DELETE

  TRACE

  PATCH

  LINK

  UNLINK

errors : Array of objects

  エラー詳細情報

  以下の構造の情報（Array[]）が複数取得されます。

  Array[

  kind : string

    エラー種別

  description : string

    エラーの説明

  measure : string

    対処方法

  detail : string

    詳細エラー情報

  ]

### 500 サーバー内部エラー

RESPONSE HEADERS

X-Request-ID : string

  WebAPIのリクエストID

RESPONSE SCHEMA : application/json

request_id : string

  リクエストID

accept_datetime : string <date-time>

  受付日時

api_path : string

  APIパス

http_method : string

  HTTPリクエストのメソッド形式

  以下のいずれかが取得されます。

  GET

  HEAD

  POST

  OPTIONS

  PUT

  DELETE

  TRACE

  PATCH

  LINK

  UNLINK

errors : Array of objects

  エラー詳細情報

  以下の構造の情報（Array[]）が複数取得されます。

  Array[

  kind : string

    エラー種別

  description : string

    エラーの説明

  measure : string

    対処方法

  detail : string

    詳細エラー情報

  ]

### 502 HULFT接続エラー

RESPONSE HEADERS

X-Request-ID : string

  WebAPIのリクエストID

RESPONSE SCHEMA : application/json

request_id : string

  リクエストID

accept_datetime : string <date-time>

  受付日時

api_path : string

  APIパス

http_method : string

  HTTPリクエストのメソッド形式

  以下のいずれかが取得されます。

  GET

  HEAD

  POST

  OPTIONS

  PUT

  DELETE

  TRACE

  PATCH

  LINK

  UNLINK

errors : Array of objects

  エラー詳細情報

  以下の構造の情報（Array[]）が複数取得されます。

  Array[

  kind : string

    エラー種別

  description : string

    エラーの説明

  measure : string

    対処方法

  detail : string

    詳細エラー情報

  additional : object

    HULFTエラー追加情報

    code : integer

      HULFT実行結果

    detail : string

      HULFT詳細コード

    latest_process_id : string

      最新処理ID

    message : string

      HULFTエラーメッセージ

  ]

### 504 タイムアウトエラー

RESPONSE HEADERS

X-Request-ID : string

  WebAPIのリクエストID

RESPONSE SCHEMA : application/json

request_id : string

  リクエストID

accept_datetime : string <date-time>

  受付日時

api_path : string

  APIパス

http_method : string

  HTTPリクエストのメソッド形式

  以下のいずれかが取得されます。

  GET

  HEAD

  POST

  OPTIONS

  PUT

  DELETE

  TRACE

  PATCH

  LINK

  UNLINK

errors : Array of objects

  エラー詳細情報

  以下の構造の情報（Array[]）が複数取得されます。

  Array[

  kind : string

    エラー種別

  description : string

    エラーの説明

  measure : string

    対処方法

  detail : string

    詳細エラー情報

  ]