アップロード
オブジェクト(ファイル)をアップロードします。アップロードの前後には、トランザクション(Transact)API要求が必要です。
(1) 必要な権限
UploadObject APIを使用するには以下の権限が必要です。
-
ファイルのアップロード権限
(2) リクエストURL
http(s)://Domain:xxxx/コンテキスト名/UploadObject
(3) リクエストインタフェース
項目名 |
説明 |
文字 |
省略 |
省略値 |
||||
---|---|---|---|---|---|---|---|---|
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 |
||||
data_check_algo |
データ検証アルゴリズム
|
半角 |
○ |
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) レスポンスインタフェース
項目名 |
説明 |
備考 |
---|---|---|
object_id |
オブジェクトID 正常にアップロードしたファイルのオブジェクトIDが返却されます。 |
|
operation_id |
処理識別子 当該トランザクションの識別子を返却します。 |
|