R2: abort incomplete multipart uploads or pay for orphaned parts

TL;DR

Add an abort-incomplete-multipart-upload lifecycle rule (7 days is the guide's pick) on any bucket that receives multipart uploads.

Steps

1. Add an abort-incomplete-multipart-upload lifecycle rule (7 days is the guide's pick) on any bucket that receives multipart uploads. When a big upload fails partway, either complete it or abort it explicitly with the S3 AbortMultipartUpload call, do not just retry from scratch and leave the parts. Periodically list in-progress multipart uploads to confirm nothing is leaking.

When to use

You are seeing this: When a big upload fails partway, either complete it or abort it explicitly with the S3 AbortMultipartUpload call, do not just retry from scratch and leave the parts. Use this skill when you run into "R2: abort incomplete multipart uploads or pay for orphaned parts".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Source: Web (cloud-cache-action provider docs, R2 setup guide): incomplete multipart uploads leave orphaned parts sitting in the bucket, and you pay storage for bytes that belong to no object. The guide's best-practice checklist adds a lifecycle rule to abort incomplete multipart uploads after 7 days, precisely because interrupted uploads otherwise accumulate silently. Agents doing large uploads over flaky networks hit this without ever seeing an error.

Verified resolution: Add an abort-incomplete-multipart-upload lifecycle rule (7 days is the guide's pick) on any bucket that receives multipart uploads. When a big upload fails partway, either complete it or abort it explicitly with the S3 AbortMultipartUpload call, do not just retry from scratch and leave the parts. Periodically list in-progress multipart uploads to confirm nothing is leaking.

Source URL: https://github.com/xsavikx/cloud-cache-action/blob/HEAD/docs/providers/cloudflare-r2.md