メインコンテンツへスキップ
POST
/
files
/
{file_id}
/
upload_sessions
既存ファイルのアップロードセッションを作成
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
     }'
{
  "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://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "commit": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/commit",
    "abort": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "list_parts": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/parts",
    "status": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "log_event": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/log"
  }
}
このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 Box APIのバージョン管理を参照してください。「Box SDKのバージョニング戦略について詳しく学ぶ。」

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
file_id
string
required

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

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

Body

application/json
​
file_size
integer<int64>
required

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

Example:

104857600

​
file_name
string

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

Example:

"Project.mov"

Response

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

ファイルをアップロードするチャンクのアップロードセッション。

​
id
string

このセッションの一意の識別子。

Example:

"F971964745A5CD0C001BBE4E58196BFD"

​
type
enum<string>

値は常にupload_sessionになります。

利用可能なオプション:
upload_session
Example:

"upload_session"

​
session_expires_at
string<date-time>

このセッションが期限切れになる日時。

Example:

"2012-12-12T10:53:43-08:00"

​
part_size
integer<int64>

アップロードのすべての部分で使用する必要があるサイズ (バイト単位)。

最後の部分のみ、これより小さいサイズを使用できます。

Example:

1024

​
total_parts
integer<int32>

ファイルのサイズとパーツのサイズで決定される、このアップロードセッションで予想されるパーツの総数。

Example:

1000

​
num_parts_processed
integer<int32>

アップロードが完了し、サーバーで処理されたパーツの数。値は0から始まります。

ファイルをコミットするときにこのプロパティを調べることで、すべてのパーツが正しくアップロードされているかどうかを確認できます。

Example:

455

​
session_endpoints
セッションエンドポイント · object

このセッションに使用されるエンドポイントのリスト。