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

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

既存ファイルの新しいバージョン用のセッションを作成するには、代わりにPOST /files/:id/upload_sessions APIを呼び出します。この場合、file_nameとfolder_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"
  }
}

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

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

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

事前チェック

レスポンス

関連するAPI

関連するガイド