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

DatoCMSでアップロードしたアセットがフィールドに入らないとき

プロジェクトにファイルを保存できたことは、どのモデルのフィールドでも選べることを意味しません。失敗した段階を特定します。

アセット1 GBとフィールド検証は別

DatoCMSのアセットアップロード上限は1 GB/アセットです。ただしSingle AssetやGalleryのフィールドには、より小さいサイズ、拡張子、画像寸法などのvalidationを設定できます。プロジェクトに存在するアセットでも、特定フィールドには入れられないことがあります。

Content Management APIには3秒あたり60リクエストの制限もあり、超過時は429とx-ratelimit-resetが案内されています。これはファイル1件のサイズ上限ではありません。invalid draftsを許すモデルでは、検証が公開時まで遅れる場合があります。

アセットの保存自体が失敗したか、対象フィールドへの設定で失敗したか確認します。フィールドならサイズ、拡張子、寸法のvalidationを調べ、draftの保存と公開時の検証条件も区別してください。

429ならレスポンスのrate-limit resetを確認して再試行時刻を決めます。公式clientの再試行動作を独自clientにも自動的に当てはめず、エラーと再試行の扱いを実装側で確認します。

www.datocms.com
https://www.datocms.com/docs/content-management-api/technical-limits
確認日：2026-09-21
www.datocms.com
https://www.datocms.com/docs/content-modelling/validations
確認日：2026-09-21
www.datocms.com
https://www.datocms.com/docs/content-management-api/resources/field
確認日：2026-09-21