Weekly Amazon S3 storage audit email

Every Monday morning at 8am, run a weekly Amazon S3 storage audit and email me a prioritized cleanup recommendation. Let me configure the recipient email address, the stale threshold in days (default 90), and the maximum bucket count to scan (default 25).

First, enumerate every bucket in the connected AWS account using amazon-s3 List Buckets. Cap the scan at the configured maximum bucket count so a very large account does not blow the run out.

For each bucket, use amazon-s3 List Objects (V2) with pagination to walk the object list. Track total object count, total size, the largest keys, and per-prefix roll-ups. Follow the continuation token far enough to build a representative view of the bucket instead of stopping at the first page.

For a sample of the largest keys in each bucket (roughly the top 10), call amazon-s3 Head Object (Get Metadata) to confirm the exact size and last-modified timestamp.

Then reason about the data. Call out what is growing, which prefixes look stale (nothing modified inside the stale threshold window), which log dumps or forgotten backups look oversized, and which top offenders are worth cleaning up first. Draft a prioritized cleanup recommendation with plain-English rationale so a non-technical owner can act on it without opening the AWS console.

Compose the report as an HTML email with a subject like "S3 audit for week of <Monday's date>". Use gmail Create a Draft to build the draft addressed to the configured recipient, then gmail Send a Draft to deliver it.