Using the S3 StorageService

Configuration

All services are provided a default storage service plug by the host. By configuring the host to use S3, all services will automatically write to this storage. By including the below configuration section in the host config XML, the host will configure with the S3 Storage service instead of the filesystem based one.

<storage type="s3">
  <bucket>{required}</bucket>
  <privatekey>{required}</privatekey>
  <publickey>{required}</publickey>
  
  <!-- the base path inside the bucket, i.e. the storage root -->
  <root>{optional, default: null}</root>
  
  <baseuri>{optional, default: http://s3.amazonaws.com}</baseuri>
  <timeout>{optional, default: 30 (seconds)}</timeout>
</storage>

Note: Currently there is a bug, requiring that <root> is specified. If none is wanted, use <root>/</root>

Caveats

There are certain caveats to using the S3 Storage service:

• Directory GET or DELETE requests much have a trailing slash in their URI to be recognized as directories
• Directory listing will not report expiration date or ttl, must HEAD the file to find out if expiration info exists
• Directory listing always reports date.created with the date.modified value