NoSuchBucket

NoSuchBucket is an error code used by cloud storage services, most prominently Amazon S3, to indicate that the specified bucket does not exist or is not accessible to the requester. It arises in the S3 REST API and in AWS SDKs when an operation targets a bucket that cannot be found at the given endpoint. The accompanying HTTP status is typically 404 Not Found, and the error response includes the code NoSuchBucket and a message such as “The specified bucket does not exist.”

Common causes include a typographical error in the bucket name, the bucket having been deleted or never created in the account, and requests that target the wrong region or endpoint. Because S3 buckets are globally unique and region-specific in terms of endpoints, using an incorrect region or a misconfigured URL can trigger NoSuchBucket. Access to a bucket may also be restricted by permissions in a way that leads the service to report that the bucket does not exist for the requester, though this depends on the specific service and configuration.

Diagnosis and resolution typically involve verifying the exact bucket name for correctness, confirming the bucket’s existence in the intended AWS account and region, and ensuring the correct endpoint or region is used in the request. It is also prudent to review IAM and bucket policies to ensure that the requester has the required permissions. If the bucket was deleted or never created, the appropriate action is to create or recreate the bucket or adjust the workflow accordingly.

NoSuchBucket is distinct from errors related to missing objects within a bucket, such as NoSuchKey.