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
- Bucket Website Configuration
- Transfer Acceleration
  - Transfer Acceleration Examples
- Requester Pays Buckets
  - Configure with the Console
  - Configure with the REST API
- Access Control
- Billing and 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
- Configure a Bucket for Website Hosting
- Example Walkthroughs
  - Example: Setting Up a Static Website
  - Example: Setting Up a Static Website Using a Custom Domain
Notifications
- Example Walkthrough 1
- Example Walkthrough 2
- Event Message Structure
Cross-Region Replication
- What Is and Is Not Replicated
- How to Set Up
- Replication Status Information
- Troubleshooting
- Replication and Other Bucket Configurations
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 2
- 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

Hosting a Static Website on Amazon S3

Topics

You can host a static website on Amazon S3. On a static website, individual web pages include static content. They may also contain client-side scripts. By contrast, a dynamic website relies on server-side processing, including server-side scripts such as PHP, JSP, or ASP.NET. Amazon S3 does not support server-side scripting.

Note

Amazon Web Services (AWS) has resources for hosting dynamic websites. To learn more about website hosting on AWS, go to Websites and Website Hosting.

To host your static website, you configure an Amazon S3 bucket for website hosting and then upload your website content to the bucket. The website is then available at the region-specific website endpoint of the bucket:

<bucket-name>.s3-website-<AWS-region>.amazonaws.com

For a list of region specific website endpoints for Amazon S3, see Website Endpoints. For example, suppose you create a bucket called examplebucket in the US East (N. Virginia) Region and configure it as a website. The following example URLs provide access to your website content:

This URL returns a default index document that you configured for the website.
```
http://examplebucket.s3-website-us-east-1.amazonaws.com/
```
This URL requests the photo.jpg object, which is stored at the root level in the bucket.
```
http://examplebucket.s3-website-us-east-1.amazonaws.com/photo.jpg
```

This URL requests the docs/doc1.html object in your bucket.

http://examplebucket.s3-website-us-east-1.amazonaws.com/docs/doc1.html

Using Your Own Domain

Instead of accessing the website by using an Amazon S3 website endpoint, you can use your own domain, such as example.com to serve your content. Amazon S3, in conjunction with Amazon Route 53, supports hosting a website at the root domain. For example if you have the root domain example.com and you host your website on Amazon S3, your website visitors can access the site from their browser by typing either http://www.example.com or http://example.com. For an example walkthrough, see Example: Setting Up a Static Website Using a Custom Domain.

To configure a bucket for website hosting, you add website configuration to the bucket. For more information, see Configure a Bucket for Website Hosting.

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.