メインコンテンツへスキップ
GET
/
files
/
upload_sessions
/
{upload_session_id}
cURL
curl -i -X GET "https://upload.box.com/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
{
  "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

​
upload_session_id
string
required

アップロードセッションのID。

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

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