集信管理情報の登録および更新

集信管理情報を登録および更新します。

Examples

REQUEST EXAMPLE

サンプルは以下となります。

{
  "id": "LOOPBACK",
  "meta": {
    "modified_datetime": "2022-10-20T12:52:48.682153Z",
    "modified_user": "user_name",
    "request_user": {
      "systems_role": "admin",
      "managements_id_role": "owner"
    },
    "display_name": "loopback",
    "comment": "sample comment",
    "valid_term": {
      "start": "2025-10-03T03:04:05+09:00",
      "end": "2025-10-04T03:04:05+09:00"
    },
    "accept_term": {
      "start": "03:04:05+09:00",
      "end": "04:04:05+09:00"
    }
  },
  "authorities": [
    {
      "type": "user",
      "name": "user_name",
      "role": "owner"
    }
  ],
  "file": {
    "name": "/tmp/rcv/sample",
    "permission": {
      "owner": {
        "readable": true,
        "writable": true,
        "executable": false
      }
    },
    "write_mode": "replace",
    "abnormal_treat": "keep"
  },
  "code_conversion": {
    "own_code_set": "system",
    "standard_for_japanese": "jis83",
    "ebcdic_set": "auto"
  },
  "job": {
    "successful": "SUCCESS_JOB",
    "unsuccessful": "UNSUCCESSFUL_JOB"
  },
  "communication": {
    "transfer_group": "GROUPID",
    "finish_sync_mode": "job"
  },
  "security": {
    "password_type": "ascii",
    "password": "paSSw0rd",
    "verify": "none"
  }
}

Request Interface

https://ControlURL/api/v1/managements/receivings/detail

= 備考 =

WebAPIのControlURLで指定するパスはHULFTの管理画面にアクセスするためのURLと同じURLです。

詳細は以下を参照してください。

スタートアップガイド(EC2)

: 導入手順

スタートアップガイド(Fargate)

: 導入手順

REQUEST BODY SCHEMA : application/json

id : string

ファイルID (必須)

50バイト以内で指定します。

英大文字数字、および“_”で指定します。

meta : object

メタ情報 (必須)

display_name : string

表示名 (必須)

1024バイト以内で指定します。

comment : string

コメント

1024バイト以内で指定します。

valid_term : object

管理情報の有効期間

start : string <date-time>

有効期間 (開始)

end : string <date-time>

有効期間 (終了)

「有効期間 (終了)」は「有効期間 (開始)」より後の時間を指定します。

accept_term : object

要求の受付時間帯

管理情報に対する要求を受付する時間帯

省略すると、管理情報の有効期間内のすべての日時で要求を受け付けます。

start : string

受付時間帯 (開始) (必須)

end : string

受付時間帯 (終了) (必須)

authorities : Array of objects

権限情報

最大権限情報数:100

以下の構造の情報(Array[])を複数(~100)設定可能です。

Array[

type : string

ユーザーグループID/ユーザーID (必須)

管理情報に対する権限を保持している、ユーザーグループおよびユーザーのID

以下のいずれかを指定します。

group

: ユーザーグループIDを、3バイトから255バイトの英数字、および半角スペース、“-”、“/”、“*”を除く記号で指定

user

: ユーザーIDを、1024バイト以内の英数字、および“/”を除く記号で指定

name : string

権限付与対象名 (必須)

role : string

管理情報の権限 (必須)

「ユーザーグループID」および「ユーザーID」の、管理情報に対する権限

以下のいずれかを指定します。

owner

: 所有者(管理情報に対してすべての操作が可能なユーザー)

contributor

: 更新者(管理情報の情報を更新可能なユーザー)

executor

: 実行者(管理情報を使用して、転送を開始できるユーザー)

reader

: 閲覧者(管理情報を参照できるユーザー)

auditor

: 監視者(履歴だけを参照できるユーザー)

]

file : object

集信ファイル (必須)

name : string

集信ファイル名 (必須)

4085バイト以内で指定します。

owner : string

オーナー名

14バイト以内で指定します。

英数字、“-”、“.”および“_”で指定します。“_”は先頭に指定できません。

転送コンテナに登録されている所有者名を設定してください。

注意

「オーナー名」と「グループ名」は両方指定するか、両方省略してください。

「オーナー名」を省略した場合、転送コンテナを起動したユーザーのユーザー名で集信ファイルが作成されます。

group : string

グループ名

14バイト以内で指定します。

英数字、“-”、“.”および“_”で指定します。“_”は先頭に指定できません。

転送コンテナに登録されているグループ名を設定してください。

注意

「オーナー名」と「グループ名」は両方指定するか、両方省略してください。

「グループ名」を省略した場合、転送コンテナを起動したユーザーのグループ名で集信ファイルが作成されます。

permission : object

ファイル権限

owner : object

オーナー権限

省略すると、以下の値が設定されます。

  • readable: true

  • writable: true

  • executable: false

readable : boolean

読み込み権限 (必須)

writable : boolean

書き込み権限 (必須)

executable : boolean

実行権限 (必須)

group : object

グループ権限

省略すると、以下の値が設定されます。

  • readable: true

  • writable: true

  • executable: false

readable : boolean

読み込み権限 (必須)

writable : boolean

書き込み権限 (必須)

executable : boolean

実行権限 (必須)

other : object

その他のメンバー権限

省略すると、以下の値が設定されます。

  • readable: true

  • writable: true

  • executable: false

readable : boolean

読み込み権限 (必須)

writable : boolean

書き込み権限 (必須)

executable : boolean

実行権限 (必須)

write_mode : string

登録モード (必須)

集信するファイルの登録方法

以下のいずれかを指定します。

new

: 新規作成(集信ファイルを新規に作成、同名のファイルがすでに存在している場合はエラー)

replace

: 置き換え(既存のファイル内容を受信データに置き換え、ファイルが存在しない場合は新規に作成)

append

: 追加(既存ファイルの最後に受信データを追加、ファイルが存在しない場合は新規に作成)

abnormal_treat : string

異常時の処理 (必須)

集信に失敗したときの集信ファイルの処理

以下のいずれかを指定します。

delete

: 削除(集信ファイルを削除)

keep

: 保存(集信が失敗した時点の集信ファイルを保持)

recover

: 復元(集信開始前に集信ファイルをバックアップし、集信が失敗したらバックアップを復元)

code_conversion : object

コード変換

省略すると、以下の値が設定されます。

  • own_code_set: system

  • standard_for_japanese: system

  • ebcdic_set: auto

own_code_set : string

転送コードセット (必須)

自ホストの文字コード

以下のいずれかを指定します。

system

: システム(システム動作環境設定の「転送コードセット」の設定値)

utf8

: UTF-8

sjis

: Shift-JIS

euc_jp

: EUC-JP

gb18030

: GB18030

standard_for_japanese : string

日本語規格 (必須)

「転送コードセット」で指定した文字コードのJIS年度

日本語コード変換の場合のみ、設定値が有効となります。

以下のいずれかを指定します。

system

: システム(システム動作環境設定の「日本語規格」の設定値)

jis83

: JIS83(JIS 83年度)

jis78

: JIS78(JIS 78年度)

ebcdic_set : string

相手ホストのEBCDICセット

1バイトコードを変換するときに使用するEBCDIC系コードセット

配信側ホスト(相手ホスト)のEBCDICセットを指定します。

この設定は、配信側ホストがEBCDIC系コードセットで、「コード変換」が“receiving”の場合に有効です。

以下のいずれかを指定します。

auto

: 自動

katakana

: カナ文字

lowercase

: 英小文字

ascii

: ASCII

japan_latin_for_ibm

: IBM英小文字

japan_latin_extended_for_ibm

: IBM英小文字拡張

japan_katakana_extended_for_ibm

: IBMカナ文字拡張

省略すると、“auto”が設定されます。

job : object

ジョブ起動設定

successful : string

正常時ジョブID

ファイルの集信が正常終了したときに起動するジョブID

50バイト以内で指定します。

英数字、および“_”で指定します。

unsuccessful : string

異常時ジョブID

ファイルの集信が異常終了したときに起動するジョブID

50バイト以内で指定します。

英数字、および“_”で指定します。

communication : object

通信設定

省略すると、以下の値が設定されます。

  • finish_sync_mode: eof

transfer_group : string

転送グループID

集信ファイルの転送グループID

50バイト以内で指定します。

英数字、および“_”で指定します。

finish_sync_mode : string

集信完了通知

配信側ホストへの集信完了通知

以下のいずれかを指定します。

eof

: 受信完了(ファイル受信完了後に通知)

job

: 正常時ジョブ完了(集信後正常時ジョブ完了後に通知)

省略すると、“eof”が設定されます。

security : object

セキュリティ設定

省略すると、以下の値が設定されます。

  • password_type: ascii

  • verify: none

password_type : string

暗号キーの種類

データを暗号化するキーの種類

以下のいずれかを指定します。

ascii

: データを暗号化するキーを8バイトから20バイトの英数字で指定

hex

: データを暗号化するキーを16桁から40桁の16進数で指定

省略すると、“ascii”が設定されます。

password : string <password>

暗号キー

verify : string

データ検証

集信するファイルに対するデータ検証の有無

以下のいずれかを指定します。

none

: データ検証を行わない

sha256

: SHA256でデータ検証を行う

省略すると、“none”が設定されます。

Response Interface

200 既存管理情報の更新に成功

RESPONSE HEADERS

X-Request-ID : string

WebAPI履歴のリクエストID

RESPONSE SCHEMA : application/json

id : string

ファイルID

meta : object

メタ情報

modified_datetime : string <date-time>

更新日時

modified_user : string

更新ユーザー

request_user : object

ロール情報

systems_role : string

APIを実行したユーザーの「ユーザーの権限」

managements_id_role : string

APIを実行したユーザーの「管理情報の権限」

display_name : string

表示名

comment : string

コメント

valid_term : object

管理情報の有効期間

start : string <date-time>

有効期間 (開始)

end : string <date-time>

有効期間 (終了)

accept_term : object

要求の受付時間帯

start : string

受付時間帯 (開始)

end : string

受付時間帯 (終了)

authorities : Array of objects

権限情報

以下の構造の情報(Array[])が複数(~100)取得されます。

Array[

type : string

ユーザーグループID/ユーザーID

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

group

: ユーザーグループIDを、3バイトから255バイトの英数字、および半角スペース、“-”、“/”、“*”を除く記号で指定

user

: ユーザーIDを、1024バイト以内の英数字、および“/”を除く記号で指定

name : string

権限付与対象名

role : string

管理情報の権限

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

owner

: 所有者(管理情報に対してすべての操作が可能なユーザー)

contributor

: 更新者(管理情報の情報を更新可能なユーザー)

executor

: 実行者(管理情報を使用して、転送を開始できるユーザー)

reader

: 閲覧者(管理情報を参照できるユーザー)

auditor

: 監視者(履歴だけを参照できるユーザー)

]

file : object

集信ファイル

name : string

集信ファイル名

owner : string

オーナー名

group : string

グループ名

permission : object

ファイル権限

owner : object

オーナー権限

readable : boolean

読み込み権限

writable : boolean

書き込み権限

executable : boolean

実行権限

group : object

グループ権限

readable : boolean

読み込み権限

writable : boolean

書き込み権限

executable : boolean

実行権限

other : object

その他のメンバー権限

readable : boolean

読み込み権限

writable : boolean

書き込み権限

executable : boolean

実行権限

write_mode : string

登録モード

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

new

: 新規作成(集信ファイルを新規に作成、同名のファイルがすでに存在している場合はエラー)

replace

: 置き換え(既存のファイル内容を受信データに置き換え、ファイルが存在しない場合は新規に作成)

append

: 追加(既存ファイルの最後に受信データを追加、ファイルが存在しない場合は新規に作成)

abnormal_treat : string

異常時の処理

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

delete

: 削除(集信ファイルを削除)

keep

: 保存(集信が失敗した時点の集信ファイルを保持)

recover

: 復元(集信開始前に集信ファイルをバックアップし、集信が失敗したらバックアップを復元)

code_conversion : object

コード変換

own_code_set : string

転送コードセット

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

system

: システム(システム動作環境設定の「転送コードセット」の設定値)

utf8

: UTF-8

sjis

: Shift-JIS

euc_jp

: EUC-JP

gb18030

: GB18030

standard_for_japanese : string

日本語規格

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

system

: システム(システム動作環境設定の「日本語規格」の設定値)

jis83

: JIS83(JIS 83年度)

jis78

: JIS78(JIS 78年度)

ebcdic_set : string

相手ホストのEBCDICセット

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

auto

: 自動

katakana

: カナ文字

lowercase

: 英小文字

ascii

: ASCII

japan_latin_for_ibm

: IBM英小文字

japan_latin_extended_for_ibm

: IBM英小文字拡張

japan_katakana_extended_for_ibm

: IBMカナ文字拡張

job : object

ジョブ起動設定

successful : string

正常時ジョブID

unsuccessful : string

異常時ジョブID

communication : object

通信設定

transfer_group : string

転送グループID

finish_sync_mode : string

集信完了通知

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

eof

: 受信完了(ファイル受信完了後に通知)

job

: 正常時ジョブ完了(集信後正常時ジョブ完了後に通知)

security : object

セキュリティ設定

password_type : string

暗号キーの種類

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

ascii

: データを暗号化するキーを8バイトから20バイトの英数字で指定

hex

: データを暗号化するキーを16桁から40桁の16進数で指定

password : string <password>

暗号キー

verify : string

データ検証

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

none

: データ検証を行わない

sha256

: SHA256でデータ検証を行う

201 新規管理情報登録に成功

RESPONSE HEADERS

X-Request-ID : string

WebAPI履歴のリクエストID

Location : string

作成されたリソースのパス

RESPONSE SCHEMA : application/json

id : string

ファイルID

meta : object

メタ情報

modified_datetime : string <date-time>

更新日時

modified_user : string

更新ユーザー

request_user : object

ロール情報

systems_role : string

APIを実行したユーザーの「ユーザーの権限」

managements_id_role : string

APIを実行したユーザーの「管理情報の権限」

display_name : string

表示名

comment : string

コメント

valid_term : object

管理情報の有効期間

start : string <date-time>

有効期間 (開始)

end : string <date-time>

有効期間 (終了)

accept_term : object

要求の受付時間帯

start : string

受付時間帯 (開始)

end : string

受付時間帯 (終了)

authorities : Array of objects

権限情報

以下の構造の情報(Array[])が複数(~100)取得されます。

Array[

type : string

ユーザーグループID/ユーザーID

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

group

: ユーザーグループIDを、3バイトから255バイトの英数字、および半角スペース、“-”、“/”、“*”を除く記号で指定

user

: ユーザーIDを、1024バイト以内の英数字、および“/”を除く記号で指定

name : string

権限付与対象名

role : string

管理情報の権限

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

owner

: 所有者(管理情報に対してすべての操作が可能なユーザー)

contributor

: 更新者(管理情報の情報を更新可能なユーザー)

executor

: 実行者(管理情報を使用して、転送を開始できるユーザー)

reader

: 閲覧者(管理情報を参照できるユーザー)

auditor

: 監視者(履歴だけを参照できるユーザー)

]

file : object

集信ファイル

name : string

集信ファイル名

owner : string

オーナー名

group : string

グループ名

permission : object

ファイル権限

owner : object

オーナー権限

readable : boolean

読み込み権限

writable : boolean

書き込み権限

executable : boolean

実行権限

group : object

グループ権限

readable : boolean

読み込み権限

writable : boolean

書き込み権限

executable : boolean

実行権限

other : object

その他のメンバー権限

readable : boolean

読み込み権限

writable : boolean

書き込み権限

executable : boolean

実行権限

write_mode : string

登録モード

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

new

: 新規作成(集信ファイルを新規に作成、同名のファイルがすでに存在している場合はエラー)

replace

: 置き換え(既存のファイル内容を受信データに置き換え、ファイルが存在しない場合は新規に作成)

append

: 追加(既存ファイルの最後に受信データを追加、ファイルが存在しない場合は新規に作成)

abnormal_treat : string

異常時の処理

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

delete

: 削除(集信ファイルを削除)

keep

: 保存(集信が失敗した時点の集信ファイルを保持)

recover

: 復元(集信開始前に集信ファイルをバックアップし、集信が失敗したらバックアップを復元)

code_conversion : object

コード変換

own_code_set : string

転送コードセット

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

system

: システム(システム動作環境設定の「転送コードセット」の設定値)

utf8

: UTF-8

sjis

: Shift-JIS

euc_jp

: EUC-JP

gb18030

: GB18030

standard_for_japanese : string

日本語規格

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

system

: システム(システム動作環境設定の「日本語規格」の設定値)

jis83

: JIS83(JIS 83年度)

jis78

: JIS78(JIS 78年度)

ebcdic_set : string

相手ホストのEBCDICセット

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

auto

: 自動

katakana

: カナ文字

lowercase

: 英小文字

ascii

: ASCII

japan_latin_for_ibm

: IBM英小文字

japan_latin_extended_for_ibm

: IBM英小文字拡張

japan_katakana_extended_for_ibm

: IBMカナ文字拡張

job : object

ジョブ起動設定

successful : string

正常時ジョブID

unsuccessful : string

異常時ジョブID

communication : object

通信設定

transfer_group : string

転送グループID

finish_sync_mode : string

集信完了通知

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

eof

: 受信完了(ファイル受信完了後に通知)

job

: 正常時ジョブ完了(集信後正常時ジョブ完了後に通知)

security : object

セキュリティ設定

password_type : string

暗号キーの種類

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

ascii

: データを暗号化するキーを8バイトから20バイトの英数字で指定

hex

: データを暗号化するキーを16桁から40桁の16進数で指定

password : string <password>

暗号キー

verify : string

データ検証

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

none

: データ検証を行わない

sha256

: SHA256でデータ検証を行う

400 リクエストパラメーターの指定が不正

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 : (Error1(object or null)) or (Error2(object or null)) or (Error3(object or null))

"Error1"、"Error2"、"Error3"のいずれかが取得されます。

Error1
message : string

エラーメッセージ

tables : Array of strings

テーブル情報

query : string

クエリ情報

Error2
hulft_id : string

HULFT ID

code : integer

実行結果

detail : integer

詳細コード

message : string

エラーメッセージ

Error3
message : string

エラーメッセージ

fields : string

クエリ情報

]

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

詳細エラー情報

additional : (Error1(object or null)) or (Error2(object or null)) or (Error3(object or null))

"Error1"、"Error2"、"Error3"のいずれかが取得されます。

Error1
message : string

エラーメッセージ

tables : Array of strings

テーブル情報

query : string

クエリ情報

Error2
hulft_id : string

HULFT ID

code : integer

実行結果

detail : integer

詳細コード

message : string

エラーメッセージ

Error3
message : string

エラーメッセージ

fields : string

クエリ情報

]