This is a small client library for making requests to Amazon S3 and other services which expose the same API (such as RADOS).
It was originally written as part of Anansi, but has been split into a separate project to facilitiate reuse.
It depends upon libcurl, liburi and OpenSSL (except on Mac OS X, where CommonCrypto is used instead).
libawsclient URIs have the following form (all parameters are optional if the defaults are sufficient or the information is supplied through specific setter calls):
s3://ACCESSKEY:SECRETKEY@BUCKET/RESOURCE?endpoint=HOSTNAME®ion=REGION&ver=AUTHVER&token=TOKEN
In the above:
| Name | Description |
|---|---|
ACCESSKEY | The AWS access key |
SECRETKEY | The AWS secret key |
HOSTNAME | The endpoint name (defaulting to s3.amazonaws.com for S3 requests) |
REGION | The region name for v4 authentication, e.g., us-west-1 |
AUTHVER | The authentication mechanism to use; defaults to '2' unless a REGION or TOKEN are supplied, in which case '4' |
TOKEN | An AWS session token, if you have one |
BUCKET | The name of the S3 bucket to access |
RESOURCE | The path of the resource within a bucket |