最新バージョン
アップロードセッションをコミット
APIバージョン 2024.0
アップロードセッションを閉じて、アップロード済みのチャンクからファイルを作成します。
実際のエンドポイントURLはCreate upload sessionおよびGet upload sessionエンドポイントが返します。
リクエスト
bearer [ACCESS_TOKEN]
application/json
リクエストヘッダー
stringヘッダー内必須
sha=fpRyg5eVQletdZqEKaFlqwBXJzM=ファイル全体のRFC3230メッセージのダイジェスト。
サポートされているのはSHA1のみです。SHA1ダイジェストはBase64でエンコードされている必要があります。このヘッダーの形式は、sha=BASE64_ENCODED_DIGESTです。
stringヘッダー内省略可能
1変更を加える前にこの項 目が最近変更されていないことを確認します。
その項目の最後に認識されたetag値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは412 Precondition Failedを返して失敗します。
stringヘッダー内省略可能
1項目が変更されている場合にのみ、その項目を返します。
その項目の最後に認識されたetag値をこのヘッダーに渡すと、それ以降に項目が変更されていない場合、エンドポイントは304 Not Modifiedを返して失敗します。
パスパラメータ
stringパス内必須
D5E3F7AアップロードセッションのID。
リクエスト本文
アップロードされたパーツのリストの詳細。
レスポンス
application/jsonFiles
リスト内のファイルオブジェクトを返します。
none
すべてのチャンクがすでにアップロードされているものの、まだ処理されていない場合に返されます。
アップロードセッションを調べてチャンク処理の進捗状況に関する詳細情報を取得し、すべてのチャンクが処理された後でファイルのコミットを再試行します。
application/jsonクライアントエラー
ターゲットフォルダに同じ名前のファイルがすでに存在する場合は、エラーを返します。
application/jsonクライアントエラー
If-MatchまたはIf-None-Match条件に一致しなかった場合は、エラーを返します。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X POST "https://upload.box.com/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/commit" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "digest: sha=fpRyg5eVQletdZqEKaFlqwBXJzM=" \
-H "content-type: application/json" \
-d '{
"parts": [
{
"part_id": "BFDF5379",
"offset": 0,
"size": 8388608,
"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
},
{
"part_id": "E8A3ED8E",
"offset": 8388608,
"size": 1611392,
"sha1": "234b65934ed521fcfe3424b7d814ab8ded5185dc"
}
],
"attributes": {
"content_modified_at": "2017-04-08T00:58:08Z"
}
}'Node/TypeScript v10
await client.chunkedUploads.createFileUploadSessionCommit(
uploadSessionId,
{ parts: parts } satisfies CreateFileUploadSessionCommitRequestBody,
{ digest: digest } satisfies CreateFileUploadSessionCommitHeadersInput,
);Python v10
client.chunked_uploads.create_file_upload_session_commit(
upload_session_id, parts, digest
).NET v10
await client.ChunkedUploads.CreateFileUploadSessionCommitAsync(uploadSessionId: uploadSessionId, requestBody: new CreateFileUploadSessionCommitRequestBody(parts: parts), headers: new CreateFileUploadSessionCommitHeaders(digest: digest));Swift v10
try await client.chunkedUploads.createFileUploadSessionCommit(uploadSessionId: uploadSessionId, requestBody: CreateFileUploadSessionCommitRequestBody(parts: parts), headers: CreateFileUploadSessionCommitHeaders(digest: digest))Java v10
client.getChunkedUploads().createFileUploadSessionCommit(uploadSessionId, new CreateFileUploadSessionCommitRequestBody(parts), new CreateFileUploadSessionCommitHeaders(digest)).NET v6
await client.ChunkedUploads.CreateFileUploadSessionCommitAsync(uploadSessionId: uploadSessionId, requestBody: new CreateFileUploadSessionCommitRequestBody(parts: parts), headers: new CreateFileUploadSessionCommitHeaders(digest: digest));Node v4
await client.chunkedUploads.createFileUploadSessionCommit(
uploadSessionId,
{ parts: parts } satisfies CreateFileUploadSessionCommitRequestBody,
{ digest: digest } satisfies CreateFileUploadSessionCommitHeadersInput,
);