既存ファイルのアップロードセッションを作成

post
https://upload.box.com/api/2.0
/files/:file_id/upload_sessions/

既存ファイルのアップロードセッションを作成します。

Request

Bearer [ACCESS_TOKEN]
application/json

Path Parameters

stringin pathrequired
12345

ファイルを表す一意の識別子。

ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123の場合、file_id123です。

Request Body

stringin bodyoptional
Project.mov

新規ファイルの新しい名前 (省略可)

integer / int64in bodyrequired
104857600

アップロードされるファイルの合計バイト数

Response

新しいアップロードセッションを返します。

ファイルがすでに存在する場合、またはアカウントのディスク容量が不足している場合は、エラーを返します。

予期しないクライアントエラー。

post
既存ファイルのアップロードセッションを作成
You can now try out some of our APIs live, right here in the documentation.
Log in

Request Example

cURL
curl -i -X POST "https://upload.box.com/api/2.0/files/12345/upload_sessions" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{
       "file_size": 104857600
     }'
Python
file_size = 26000000
upload_session = client.file('11111').create_upload_session(file_size)
print('Created upload session {0} with chunk size of {1} bytes'.format(upload_session.id, upload_session.part_size))

Response Example

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