Updated Amazon S3 API (markdown)

Chris Lu 2020-12-25 22:24:16 -08:00
parent a4f35512d1
commit 90da87d4e7

@ -1,5 +1,6 @@
To be compatible with Amazon S3 API, a separate "weed s3" command is provided. This provides much faster access when reading or writing files, compared to operating files on the cloud. To be compatible with Amazon S3 API, a separate "weed s3" command is provided. This provides much faster access when reading or writing files, compared to operating files on the cloud.
# How it works?
`weed s3` will start a stateless gateway server to bridge the Amazon S3 API to SeaweedFS Filer. `weed s3` will start a stateless gateway server to bridge the Amazon S3 API to SeaweedFS Filer.
For convenience, `weed server -s3` will start a master, a volume server, a filer, and the S3 gateway. And `weed filer -s3` can start a filer and the S3 gateway together also. For convenience, `weed server -s3` will start a master, a volume server, a filer, and the S3 gateway. And `weed filer -s3` can start a filer and the S3 gateway together also.
@ -7,6 +8,24 @@ Each bucket is stored in one collection, and mapped to folder /buckets/<bucket_n
A bucket can be deleted efficiently by deleting the whole collection. A bucket can be deleted efficiently by deleting the whole collection.
## Setup Notes
Each bucket has its own collection. Usually one collection uses 7 volumes, where each volume is 30GB by default. So if you want to create multiple buckets, you may run out of volumes very quickly unless you have a large disk.
Try to keep the volume size low. For example,
```
weed master -volumeSizeLimitMB=64
```
The other side is to reduce the number of volumes to create. In `weed shell`, you can configure this way:
```
$ weed shell
> fs.configure -locationPrefix="/buckets/" -volumeGrowthCount=3 -apply
```
# Supported APIs
Currently, the following APIs are supported. Currently, the following APIs are supported.
``` ```