アップロード

オブジェクト(ファイル)をアップロードします。アップロードの前後には、トランザクション(Transact)API要求が必要です。

(1) 必要な権限

UploadObject APIを使用するには以下の権限が必要です。

  • ファイルのアップロード権限

(2) リクエストURL

http(s)://Domain:xxxx/コンテキスト名/UploadObject

(3) リクエストインタフェース

表1.33 アップロードのリクエストインタフェースの項目

項目名

説明

文字

省略

省略値

operation_id

処理識別子

当該トランザクションの識別子を34バイトで指定します。トランザクションAPIのレスポンスで取得した値を指定します。

半角

×

 

upload

アップロードファイルの実体

アップロードするファイルの実体を指定します。

混在

×

 

size

ファイルサイズ

アップロードするファイルのサイズを指定します。

半角

ブランク

last_modified

更新日

ファイルの更新日を指定します。

YYYYMMDDHHMMSSsss形式

半角

ブランク

cipher_flag(*1)

cipher_algo(*1)

compression_flag(*1)

compression_algo(*1)

data_check_flag

データ検証有無

データ検証を行うかどうかを指定します。

true

データ検証する

false

データ検証しない

半角

true

data_check_algo

データ検証アルゴリズム

SHA-256

SHA-256アルゴリズム

半角

SHA-256

data_check_value

データ検証値

アップロードするファイルデータのハッシュ値を指定します。

半角

ブランク

ただし、data_check_flagがtrueの場合は省略不可

comment

コメント

コメントを255バイト以内で指定します。

混在

ブランク

save_limit

保存期限

ファイルをサーバ上に保存する期限を指定します。

設定範囲:1~99999(単位:日)

半角

プロパティファイル (env.properties)のfileupload.default.savelimitに従う

download_limit

ダウンロード回数

ファイルをダウンロードできる回数を指定します。ブランクまたは-1を指定した場合、保存期限まで無制限にダウンロードを許可します。

設定範囲:-1、1~9999(単位:回)

半角

-1(保存期限まで有効)

*1

:

システムのリザーブ項目です。

(4) レスポンスインタフェース

表1.34 アップロードのレスポンスインタフェースの項目

項目名

説明

備考

object_id

オブジェクトID

正常にアップロードしたファイルのオブジェクトIDが返却されます。

 

operation_id

処理識別子

当該トランザクションの識別子を返却します。