アップロードセッションの作成

ガイド アップロード 分割アップロード アップロードセッションの作成

アップロードセッションの作成

アップロードセッションを作成するには、目的のfile_nameとそのファイルを配置するfolder_id、およびアップロードするファイルのfile_sizeを指定してPOST /files/upload_sessions APIを呼び出します。

既存ファイルの新しいバージョン用のセッションを作成するには、代わりにPOST /files/:id/upload_sessions APIを呼び出します。この場合、file_namefolder_idは、プロセスでファイルの名前変更または移動を行う場合にのみ必要となります。

事前チェック

アップロードセッションの作成によって事前チェックも実行されるため、分割アップロードを行う際に個別に行う必要はありません。

レスポンス

セッションが正常に作成されると、応答には、セッションID、パーツ数、パーツサイズ、および使用する関連する次のAPIエンドポイントへのリンクを含むアップロードセッションが含まれます。

{
  "id": "F971964745A5CD0C001BBE4E58196BFD",
  "type": "upload_session",
  "session_expires_at": "2012-12-12T10:53:43-08:00",
  "part_size": 1024,
  "total_parts": 1000,
  "num_parts_processed": 455,
  "session_endpoints": {
    "upload_part": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "commit": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/commit",
    "abort": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "list_parts": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/parts",
    "status": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "log_event": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/log"
  }
}

アップロードセッションは、個々のパーツをアップロードするときに使用するパーツのサイズを定義します。