Amazon Simple Storage Service

Developer Guide (API Version 2006-03-01)

What Is Amazon S3?
Introduction
Making Requests
- Making Requests over IPv6
  - Using Dual-Stack Endpoints
- Making Requests Using the AWS SDKs
- Making Requests Using the REST API
  - Virtual Hosting of Buckets
  - Request Redirection and the REST API
Buckets
- Restrictions and Limitations
- Examples of Creating a Bucket
- Deleting or Emptying a Bucket
- Default Encryption for a Bucket
- Bucket Website Configuration
- Transfer Acceleration
  - Transfer Acceleration Examples
- Requester Pays Buckets
  - Configure with the Console
  - Configure with the REST API
- Access Control
- Billing and Usage Reporting
Objects
- Object Key and Metadata
- Storage Classes
- Subresources
- Versioning
- Object Tagging
  - Managing Object Tags
- Lifecycle Management
- Cross-Origin Resource Sharing (CORS)
  - Enabling CORS
  - Troubleshooting CORS
- Operations on Objects
Storage Class Analysis
Inventory
Managing Access
- Introduction
- Using Bucket Policies and User Policies
- Managing Access with ACLs
  - Access Control List (ACL) Overview
  - Managing ACLs
Protecting Data
- Data Encryption
  - Server-Side Encryption
  - Client-Side Encryption
    - Option 1 Example: Using an AWS KMS–Managed Customer Master Key
    - Option 2 Examples: Using a Client-Side Master Key
      - Client-Side Symmetric Master Key
      - Client-Side Asymmetric Master Key
- Reduced Redundancy Storage
  - Setting the Storage Class of an Object You Upload
  - Changing the Storage Class of an Object in Amazon S3
    - Return Code for Lost Data
- Versioning
Hosting a Static Website
- Website Endpoints
- Configuring a Bucket for Website Hosting
- Example Walkthroughs
Notifications
- Example Walkthrough 1
- Example Walkthrough 2
- Event Message Structure
Cross-Region Replication (CRR)
- What Is and Is Not Replicated
- Setting Up CRR
- Additional CRR Configurations
  - CRR: Change Replica Owner
  - CRR: Replicating Objects Created with SSE Using AWS KMS-Managed Encryption Keys
- CRR Examples
- CRR Status Information
- CRR Troubleshooting
- CRR: Additional Considerations
Request Routing
- Request Redirection and the REST API
- DNS Considerations
Performance Optimization
- Request Rate and Performance Considerations
- TCP Window Scaling
- TCP Selective Acknowledgement
Monitoring
- Monitoring Tools
- Monitoring Metrics with CloudWatch
- Metrics Configurations for Buckets
- Logging API Calls with AWS CloudTrail
BitTorrent
- How You are Charged for BitTorrent Delivery
- Using BitTorrent to Retrieve Objects Stored in Amazon S3
- Publishing Content Using Amazon S3 and BitTorrent
Amazon DevPay
- Amazon S3 Customer Data Isolation
- Amazon DevPay Token Mechanism
- Amazon S3 and Amazon DevPay Authentication
- Amazon S3 Bucket Limitation
- Amazon S3 and Amazon DevPay Process
- Additional Information
Error Handling
- The REST Error Response
  - Error Response
- The SOAP Error Response
- Amazon S3 Error Best Practices
Troubleshooting Amazon S3
Server Access Logging
- Enabling Logging Using the Console
- Enabling Logging Programmatically
- Log Format
- Deleting Log Files
AWS SDKs and Explorers
- Set Up the AWS CLI
- Using the AWS SDK for Java
- Using the AWS SDK for .NET
- Using the AWS SDK for PHP and Running PHP Examples
- Using the AWS SDK for Ruby - Version 3
- Using the AWS SDK for Python (Boto)
Appendices
- Appendix A: Using the SOAP API
- Appendix B: Authenticating Requests (AWS Signature Version 2)
Resources
Document History
AWS Glossary

Using the AWS SDK for Python (Boto)

Boto is a Python package that provides interfaces to AWS including Amazon S3. For more information about Boto, go to the AWS SDK for Python (Boto). The getting started link on this page provides step-by-step instructions to get started.

Document Conventions

« Previous Next »

© 2017, Amazon Web Services, Inc. or its affiliates. All rights reserved.

Warning

Javascript is disabled or is unavailable in your browser.
To use the AWS Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Follow Lee on X/Twitter - Father, Husband, Serial builder creating AI, crypto, games & web tools. We are friends :) AI Will Come To Life!

Check out: eBank.nz (Art Generator) | Netwrck.com (AI Tools) | Text-Generator.io (AI API) | BitBank.nz (Crypto AI) | ReadingTime (Kids Reading) | RewordGame | BigMultiplayerChess | WebFiddle | How.nz | Helix AI Assistant