--- title: Rename S3 Folders Swiftly with Python and Boto SDK description: Discover how to quickly rename S3 folder objects using Python and the powerful boto SDK. canonical: https://adamtheautomator.com/rename-s3-folder/ --- # Rename S3 Folders Swiftly with Python and Boto SDK > Discover how to quickly rename S3 folder objects using Python and the powerful boto SDK. Source: https://adamtheautomator.com/rename-s3-folder/ --- - Rename S3 Folders Swiftly with Python and Boto SDK Tap to hide Home - Tutorials - Guidebooks - Instructors - Get Paid to Write - Advertising - Recommended Resources - About Adam Search for: - - - - # Rename S3 Folders Swiftly with Python and Boto SDK Published:26 July 2019 - 3 min. read - AWS S3 - Python [](https://adamtheautomator.com/author/adam-bertram/) [Adam Bertram](https://adamtheautomator.com/author/adam-bertram/) Read [more tutorials](https://adamtheautomator.com/author/adam-bertram/) by Adam Bertram! - - [](https://specopssoft.com/product/specops-password-auditor/?utm_source=adamtheautomator&utm_medium=referral&utm_campaign=adamtheautomator_referral_na&utm_content=display) Audit Active Directory for stale users, weak passwords, and other security risks with [Specops Password Auditor](https://specopssoft.com/product/specops-password-auditor/?utm_source=adamtheautomator&utm_medium=referral&utm_campaign=adamtheautomator_referral_na&utm_content=text). Table of Contents - Prerequisites - Rename S3 Folder Key with Boto - Summary XFacebookLinkedIn To rename a folder on a traditional file system is a piece of cake but what if that file system wasn't really a file system at all? In that case, it gets a little trickier! Amazon's S3 service consists of objects with key values. To rename S3 folder objects, we still need to perform typical file system-like actions like renaming folders. Renaming S3 "folders" isn't possible; not even in the S3 management console but we can perform a workaround. We can create a new "folder" in S3 and then move all of the files from that "folder" to the new "folder". Once all of the files are moved, we can then remove the source "folder". S3 Buckets Containing Files to Rename S3 Folder Objects To do this, use [Python](https://adamtheautomator.com/tag/python/) and the [boto3 module](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html). If you're working with S3 and Python and not using the boto3 module, you're missing out. It makes things much easier to work with. Related:[Getting Started: Managing AWS EC2 with Python Boto3](https://adamtheautomator.com/boto3-ec2/) ## Prerequisites For the demonstration I'll be showing you to work, you'll need to meet a few prereqs ahead of time: - macOS/Linux - Python 3+ - The boto3 module (pip install boto3 to get it) - An Amazon S3 Bucket - An AWS IAM user access key and secret access key with access to S3 - An existing "folder" with "files" inside in your S3 bucket Related:[Learning Identity and Access Management (IAM) AWS Through Examples](https://adamtheautomator.com/iam-aws/) ## Rename S3 Folder Key with Boto To rename our S3 folder, we'll need to import the boto3 module and I've chosen to assign some of the values I'll be working with as variables. import boto3 awsAccessKey = '' awsSecretAccessKey = '' s3BucketName = '' oldFolderKey = '' newFolderKey = '' Once I've done that, I'll need to authenticate to S3 by providing my access key ID and secret key for the IAM user I'll be using. In this case, I've chosen to use a boto3 session. I'll be using a boto3 resource to work with S3. session = boto3.Session(aws_access_key_id=awsAccessKey, aws_secret_access_key=awsSecretAccessKey) s3 = session.resource('s3') Once I've done that, I then need to find all of the files matching my key prefix to rename S3 folder. You can see below that I'm using a Python for loop to read all of the objects in my S3 bucket. I'm using the optional filter action and filtering all of the S3 objects in the bucket down to only eventually rename S3 folder I want. bucket = s3.Bucket(s3BucketName) for object in bucket.objects.filter(Prefix=oldFolderKey): Once I've started the [for loop](https://adamtheautomator.com/powershell-for-loop/) iterating over the "folder" key and all of the "file" keys inside of it, I'll then need to exclude the "folder" key itself since I won't be copying that. I just need the file keys. I'm excluding that by an if statement that matches all key values that don't end with a forward slash. After I'm in the block that will only contain file key values, I'm now assigning the file name and destination key names to make it easier to reference. for object in bucket.objects.filter(Prefix=oldFolderKey): srcKey = object.key if not srcKey.endswith('/'): fileName = srcKey.split('/')[-1] destFileKey = newFolderKey + '/' + fileName copySource = s3BucketName + '/' + srcKey s3.Object(s3BucketName, destFileKey).copy_from(CopySource=copySource) Once you have all of that setup, I then finally do the actual copy using the copy_from action. You can see below that I'm creating an S3 object using the bucket name and destination file key. I'm then passing the source key to the copy_from action. for object in bucket.objects.filter(Prefix=oldFolderKey): srcKey = object.key if not srcKey.endswith('/'): fileName = srcKey.split('/')[-1] destFileKey = newFolderKey + '/' + fileName copySource = s3BucketName + '/' + srcKey s3.Object(s3BucketName, destFileKey).copy_from(CopySource=copySource) Once the loop has finished and all of the files have been copied to the new key, I'll then need to use the delete action to clean all of the files including the "folder" key since it is not inside of the if condition. for object in bucket.objects.filter(Prefix=oldFolderKey): srcKey = object.key if not srcKey.endswith('/'): fileName = srcKey.split('/')[-1] destFileKey = newFolderKey + '/' + fileName copySource = s3BucketName + '/' + srcKey s3.Object(s3BucketName, destFileKey).copy_from(CopySource=copySource) s3.Object(s3BucketName, srcKey).delete() ## Summary At this point, we're done! You should now see all of the files that were previously in the source key under the destination key with no sign of the source key! Hate ads? Want to support the writer? Get many of our tutorials packaged as an ATA Guidebook. [Explore ATA Guidebooks](https://adamtheautomator.com/ata-guidebooks/) ## More from ATA Learning and Partners - ### Recommended Resources! Recommended Resources for Training, Information Security, Automation, and more! - ### Get Paid to Write! ATA Learning is always seeking instructors of all experience levels. Regardless if you’re a junior admin or system architect, you have something to share. Why not write on a platform with an existing audience and share your knowledge with the world? - ### ATA Learning Guidebooks ATA Learning is known for its high-quality written tutorials in the form of blog posts. Support ATA Learning with ATA Guidebook PDF eBooks available offline and with no ads! ## Categories - IT Ops - Cloud - DevOps - Home Ops - Information Security - Software Development ## Site - Home - Tutorials - Guidebooks - Instructors - Get Paid to Write - Advertising - Recommended Resources - About Adam Copyright 2026© ATA Learning | [Privacy Policy](https://adamtheautomator.com/privacy/) Don't be left behind with the ATA Learning Newsletter! Looks like you're offline!