アップロードセッション

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

id string

例"F971964745A5CD0C001BBE4E58196BFD"

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

type string

例"upload_session"

upload_session

次の値に固定: upload_session

num_parts_processed integer / int32

例455

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

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

part_size integer / int64

例1024

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

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

session_endpoints object

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

session_endpoints.abort string

例"https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD"

セッションの中止に使用されるURL。

session_endpoints.commit string

例"https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/commit"

ファイルのコミットに使用されるURL

session_endpoints.list_parts string

例"https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/parts"

すべてのパーツのリストを取得するためのURL。

session_endpoints.log_event string

例"https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/log"

アップロードログの取得に使用されるURL。

session_endpoints.status string

例"https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD"

アップロードステータスの取得に使用されるURL。

session_endpoints.upload_part string

例"https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD"

パーツのアップロード先のURL

session_expires_at string / date-time

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

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

total_parts integer / int32

例1000

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

レスポンスの例

{
  "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
}