▤ 動画容量ナビ

動画の容量と保存 · 参考資料確認日 2026年9月22日

Microsoft Graph driveItemの250 MBとchunk条件を分ける

Microsoft Graphのupload method上限は、OneDriveやSharePointに保存できる最終file sizeそのものではありません。転送方法、chunk、sessionの状態、保存先quotaを分けて選びます。

simple upload methodは250 MBまで

driveItemのsimple upload methodがsupportするfile sizeは250 MBまでです。1回のrequestで内容を送る方法なので、250 MBを超えるfileや通信断から再開したいtransferにはupload sessionを選びます。

250 MBはこのmethodの境界です。OneDriveやSharePoint側の最終file ceiling、利用plan、残りstorageまで250 MBになるという意味ではありません。quota不足はupload session作成時点で表面化する場合があります。

各requestは60 MiB未満、chunkは320 KiB単位

upload sessionではfile全体または分割したbyte rangeを順番に送ります。各requestは60 MiB未満にし、rangesはsequential orderで送信します。final fragment以外のchunk sizeは320 KiB(327,680 bytes)の倍数にします。

upload sessionへのrequestが404になった場合、そのsessionは失われており、残りchunkだけを続けるのではなく新しいsessionからuploadをやり直します。method、chunk sizing、session lifetime、保存先quotaは別のgateです。

methodを選び、404ではsessionを作り直す

fileが250 MB以下でresume不要ならsimple uploadを検討します。250 MBを超える場合や中断再開が必要ならupload sessionを作り、60 MiB未満かつ320 KiBの倍数となるchunk sizeを決め、順番に送ってください。

session作成時に失敗したら保存先quotaと権限を確認します。送信中に404となったらsessionが消失したものとして新しいsessionからrestartします。upload sessionの条件を満たしても、保存先planのfile ceilingや空き容量が解消されるわけではありません。

参考資料

  • Microsoft Graph simple upload

    https://learn.microsoft.com/en-us/graph/api/driveitem-put-content?view=graph-rest-1.0

    確認日:2026-09-22

  • Microsoft Graph upload session

    https://learn.microsoft.com/en-us/graph/api/driveitem-createuploadsession?view=graph-rest-1.0

    確認日:2026-09-22