> ## Documentation Index > Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt > Use this file to discover all available pages before exploring further. # エラー > Blob Storage API が返すすべてのエラーコードと、その HTTP ステータス、対処方法。 すべてのエラーは同じ形式です。`code` は安定しておりコードで扱うためのものです。`message` は存在する場合、人が読むための説明であり、変更される可能性があります。 ```json theme={null} { "status": "error", "code": "UPGRADE_REQUIRED", "message": "Custom metadata is available on Pro and Enterprise plans only." } ``` 再試行は `429` と `5xx` の場合のみ、バックオフを入れて行ってください。`429` 以外のすべての `4xx` は、リクエスト自体を変更する必要があることを意味します。 ## 認証と制限 | コード | HTTP | 意味 | | -------------------------- | ---- | ---------------------------------------------------------------------------- | | `ACCESS_DENIED` | 401 | 認証情報がないか、認識されませんでした。 | | `PERMISSION_DENIED` | 401 | この操作には有効な有料プランが必要ですが、アカウントにありません。 | | `MISSING_SCOPE` | 403 | API キーにこのルートに必要なスコープがありません。[認証](/ja/blob-reference/authentication)を参照してください。 | | `RESOURCE_NOT_ALLOWED` | 403 | API キーが特定のアプリケーションに制限されています。 | | `UPLOAD_TOKEN_NOT_ALLOWED` | 403 | アップロードトークンはアップロードルートでのみ機能します。 | | `UPLOAD_TOKEN_USED` | 401 | アップロードトークンの使用回数が残っていません。期限切れのトークンは `ACCESS_DENIED` を返します。 | | `ACCOUNT_BLOCKED` | 403 | アカウントはファイルの保存をブロックされています。サポートにお問い合わせください。 | | `UPGRADE_REQUIRED` | 403 | このオプションはご利用のプランに含まれていません。`message` でそれを利用できるプランが示されます。 | | `RATE_LIMIT` | 429 | アカウント全体の API 枠を使い切ったか、IP が無効な認証情報を送信しすぎました。 | | `RATE_LIMITED` | 429 | このルート固有の制限に達しました。待ってから再試行してください。 | ## オブジェクト | コード | HTTP | 意味 | | ------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `INVALID_OBJECT` | 400 | オブジェクト id の形式が正しくないか、あなたのものではありません。 | | `INVALID_OBJECT_NAME` | 400 | `name` が許可されたパターン (1〜128 文字) に一致しません。 | | `INVALID_OBJECT_PREFIX` | 400 | `prefix` が許可されたパターンに一致しません。 | | `INVALID_OBJECT_EXPIRE` | 400 | `expire` が有効な期間 (1 時間〜1825 日) ではありません。 | | `INVALID_OBJECT_PRIVATE` | 400 | `private` が `true` または `false` ではありません。 | | `INVALID_OBJECT_SECURITY_HASH` | 400 | `security_hash` がブール値ではないか、プライベートオブジェクトで `false` になっています。 | | `INVALID_OBJECT_OVERWRITE` | 400 | `overwrite` が `true` または `false` ではありません。 | | `INVALID_OBJECT_DISPOSITION` | 400 | `disposition` が `inline` または `attachment` ではありません。 | | `INVALID_OBJECT_CACHE_CONTROL` | 400 | `cache_control` が `immutable`、`no-cache`、`max-age=60..31536000` のいずれでもありません。 | | `INVALID_OBJECT_METADATA` | 400 | `metadata` の形式が正しくないか、予約済みのキーを使用しているか、5 キーまたは 512 バイトを超えています。 | | `INVALID_STORAGE_AUTO_DOWNLOAD` | 400 | `auto_download` が `true` または `false` ではありません。 | | `INVALID_CHECKSUM` | 400 | `checksum_sha256` が小文字 16 進数 64 文字ではありません。 | | `CHECKSUM_MISMATCH` | 400 | ファイルが `checksum_sha256` と一致しません。何も保存されていません。 | | `INVALID_DESTINATION` | 400 | コピーの `destination` の形式が正しくありません。 | | `SAME_OBJECT` | 400 | コピー元とコピー先が同じオブジェクトです。 | | `NOTHING_TO_UPDATE` | 400 | リクエストはどのフィールドも変更しません。 | | `INVALID_CONTINUATION_TOKEN` | 400 | 一覧の `cursor` の形式が正しくないか、有効期限が切れています。カーソルなしで最初からやり直してください。 | | `TOO_MANY_OBJECTS` | 400 | 1 回のリクエストに含まれるオブジェクトが多すぎます (削除は 100、更新は 50)。 | | `PREFIX_NOT_ALLOWED` | 403 | アップロードトークンは別のプレフィックスに紐付けられています。 | | `OBJECT_NOT_FOUND` | 404 | オブジェクトが存在しません。 | | `OBJECT_ALREADY_EXISTS` | 409 | この id のオブジェクトが存在し、`overwrite` が `false` です。 | | `OBJECT_IS_LEGACY` | オブジェクトごと | [オブジェクトの更新](/ja/blob-reference/endpoint/update)の `results` で返されます。オブジェクトは2026年9月のアップデート以前に保存されたレガシーファイルで、ヘッダーを変更する前に[オブジェクトのコピー](/ja/blob-reference/endpoint/copy) (`move: true`) で移動する必要があります。 | | `VISIBILITY_CHANGE_FAILED` | オブジェクトごと | [オブジェクトの更新](/ja/blob-reference/endpoint/update)の `results` で返されます: オブジェクトをプライベートにできず、**公開されたまま**です。再試行してください。 | | `UPDATE_FAILED` / `COPY_FAILED` / `DELETE_FAILED` | 500 | 操作に失敗しました。再試行してください。 | ## アップロード | コード | HTTP | 意味 | | ------------------------------------------------------------ | ---- | --------------------------------------------------------------------------------------------------- | | `INVALID_CONTENT_TYPE` | 409 | [オブジェクトのアップロード](/ja/blob-reference/endpoint/post)は、ファイルをちょうど 1 つ含む `multipart/form-data` のみを受け付けます。 | | `INVALID_FILE` | 400 | ファイルパートがないか、読み取れません。 | | `INVALID_FILE_TYPE` | 400 | ファイル拡張子の形式が正しくないか、長すぎます。 | | `BLOCKED_FILE_TYPE` | 400 | 実行ファイルとインストーラーは受け付けられません。 | | `FILE_TYPE_NOT_ALLOWED` | 400 | アップロードトークンまたはプレフィックスのルールがこの拡張子を許可していません。 | | `FILE_TOO_SMALL` | 400 | ファイルは 512 バイト以上である必要があります。 | | `FILE_TOO_LARGE` | 413 | 1 回のリクエストで 100 MB を超えた (チャンクアップロードを使用してください) か、プラン、トークン、またはルールで許可されたサイズを超えています。 | | `STORAGE_QUOTA_EXCEEDED` | 403 | アカウントが含まれるストレージの上限に達しました。 | | `TOO_MANY_CONCURRENT_UPLOADS` | 429 | このアカウントではすでに 4 件のアップロードが実行中です。 | | `PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE` | 503 | ストレージが一時的に利用できません。再試行してください。 | | `UPLOAD_FAILED` | 500 | アップロードに失敗しました。再試行してください。 | ## チャンクアップロード | コード | HTTP | 意味 | | ---------------------------- | ---- | ----------------------------------------------- | | `INVALID_UPLOAD_TOKEN` | 400 | `upload` トークンがないか、形式が正しくないか、あなたのものではありません。 | | `INVALID_CHUNK_PART` | 400 | `part` が 1〜2048 の整数ではありません。 | | `EMPTY_CHUNK` | 400 | パートの本文が空です。 | | `CHUNK_TOO_LARGE` | 413 | パートが 32 MB を超えています。 | | `CHUNK_TOO_SMALL` | 400 | 最後以外のパートが 5 MB 未満です。 | | `NO_CHUNKS_UPLOADED` | 400 | パートが 1 つも送信される前に完了が呼び出されました。 | | `TOO_MANY_OPEN_UPLOADS` | 429 | アカウントに 32 件の未完了のアップロードがあります。いずれかを完了または中止してください。 | | `TOO_MANY_CONCURRENT_CHUNKS` | 429 | このアカウントではすでに 6 つのパートが送信中です。 | | `UPLOAD_NOT_FOUND` | 404 | アップロードは完了、中止、または期限切れになりました。 | ## 一時リンクと共有 | コード | HTTP | 意味 | | -------------------------- | ---- | ------------------------------------------ | | `INVALID_DOWNLOAD_EXPIRES` | 400 | `expires` が 60〜86400 秒の範囲外です。 | | `INVALID_FILENAME` | 400 | 無効な文字を取り除いた後、`filename` が空になりました。 | | `INVALID_EXPIRES_IN` | 400 | `expires_in` が許可された範囲外です。 | | `INVALID_MAX_DOWNLOADS` | 400 | `max_downloads` が 1〜10000 の範囲外です。 | | `INVALID_PASSWORD` | 400 | パスワードは 8〜128 文字である必要があります。 | | `INVALID_SHARE` | 400 | 共有 id の形式が正しくありません。 | | `SHARE_NOT_FOUND` | 404 | 共有が存在しないか、すでに取り消されています。 | | `TOO_MANY_SHARES` | 409 | アカウントに 1000 件の有効な共有があります。先にいくつかを取り消してください。 | ## アカウント設定とアップロードトークン | コード | HTTP | 意味 | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | ------------------------------------------------------------------------------------------------------------------ | | `INVALID_BODY` | 400 | 本文がないか、JSON オブジェクトではありません。 | | `INVALID_RULES` | 400 | `rules` が配列ではありません。 | | `TOO_MANY_RULES` | 400 | Enterprise でルールが 20 件を超えています。その他のプランでは、プランの上限 (Hobby と Standard で 5 件、Pro で 10 件) を超えると `UPGRADE_REQUIRED` が返されます。 | | `INVALID_RULE_PREFIX` / `DUPLICATE_RULE_PREFIX` | 400 | ルールのプレフィックスの形式が正しくないか、別のルールのプレフィックスと重複しています。 | | `INVALID_RULE_PRIVATE` / `INVALID_RULE_EXPIRE` / `INVALID_RULE_MAX_SIZE` / `INVALID_RULE_EXTENSIONS` / `INVALID_RULE_CACHE_CONTROL` / `INVALID_RULE_DELETE_AFTER` | 400 | ルールのフィールドが無効です。レスポンスにはそのルールの `prefix` が含まれます。 | | `INVALID_EXPIRES_IN` / `INVALID_MAX_USES` / `INVALID_MAX_SIZE` / `INVALID_ALLOWED_EXTENSIONS` | 400 | アップロードトークンのフィールドが範囲外です。 | | `UPLOAD_TOKEN_TOO_LARGE` | 400 | トークンのオプションがトークンに収まりません。メタデータまたは拡張子リストを短くしてください。 | ## S3 認証情報 | コード | HTTP | 意味 | | -------------------- | ---- | ------------------------------------------ | | `API_KEY_REQUIRED` | 400 | S3 認証情報は、ダッシュボードのセッションではなく API キーから導出されます。 | | `LEGACY_API_KEY` | 400 | API キーが旧形式です。アカウント設定で新しいキーを作成してください。 | | `INVALID_CREDENTIAL` | 401 | API キーを検証できませんでした。 | [S3 ゲートウェイ](/ja/blob-reference/s3-compatibility)は、代わりに標準の S3 XML エラーを返します。 ## グローバル | コード | HTTP | 意味 | | ------------------------------- | ---- | ----------------------------- | | `ROUTE_NOT_FOUND` / `NOT_FOUND` | 404 | ルートが存在しません。 | | `INTERNAL_SERVER_ERROR` | 500 | 予期しないエラーです。しばらくしてから再試行してください。 |