新浪云存储[C/C++ Library] and [命令行工具]
- libcurl
- libcurl-devel
- libxml2
- libxml2-devel
For CentOS, you will need to run
yum install libcurl* libxml2*.
- Linux: 使用
make编译, 编译后在buile/目录下生成: 1.动态链接库(libs3.so)、2.静态链接库(libs3.a)、3.可执行命令行工具(s3); - OSX: 用XCode打开工程文件
osx/s3.xcodeproj, 编译生成: 1.静态链接库(libs3.a)、2.可执行命令行工具(s3-cli); - Windows: 目前只支持MingW编译.
- 示例源码: src/s3.c
- 命令使用:
# 设置环境变量:
$ export S3_ACCESS_KEY_ID="您的access key"
$ export S3_SECRET_ACCESS_KEY="您的secret key"
# 使用命令行:
$ ./s3 help
This is a program for performing single requests to Sina Cloud Storage.
Options:
Command Line:
-f/--force : force operation despite warnings
-h/--vhost-style : use virtual-host-style URIs (default is path-style)
-u/--unencrypted : unencrypted (use HTTP instead of HTTPS)
-s/--show-properties : show response properties on stdout
-r/--retries : retry retryable failures this number of times
(default is 5)
Environment:
S3_ACCESS_KEY_ID : access key ID (required)
S3_SECRET_ACCESS_KEY : secret access key (required)
S3_HOSTNAME : specify alternative host (optional)
Commands (with <required parameters> and [optional parameters]) :
(NOTE: all command parameters take a value and are specified using the
pattern parameter=value)
help : Prints this help text
list : Lists owned buckets
[allDetails] : Show full details
create : Create a new bucket
<bucket> : Bucket to create
[cannedAcl] : Canned ACL for the bucket (see Canned ACLs)
delete : Delete a bucket or key
<bucket>[/<key>] : Bucket or bucket/key to delete
list : List bucket contents
<bucket> : Bucket to list
[prefix] : Prefix for results set
[marker] : Where in results set to start listing
[delimiter] : Delimiter for rolling up results set
[maxkeys] : Maximum number of keys to return in results set
[allDetails] : Show full details for each key
getacl : Get the ACL of a bucket or key
<bucket>[/<key>] : Bucket or bucket/key to get the ACL of
[filename] : Output filename for ACL (default is stdout)
setacl : Set the ACL of a bucket or key
<bucket>[/<key>] : Bucket or bucket/key to set the ACL of
[filename] : Input filename for ACL (default is stdin)
put : Puts an object
<bucket>/<key> : Bucket/key to put object to
[filename] : Filename to read source data from (default is stdin)
[contentLength] : How many bytes of source data to put (required if
source file is stdin)
[cacheControl] : Cache-Control HTTP header string to associate with
object
[contentType] : Content-Type HTTP header string to associate with
object
[md5] : MD5 for validating source data
[contentDispositionFilename] : Content-Disposition filename string to
associate with object
[contentEncoding] : Content-Encoding HTTP header string to associate
with object
[expires] : Expiration date to associate with object
[cannedAcl] : Canned ACL for the object (see Canned ACLs)
[x-amz-meta-...]] : Metadata headers to associate with the object
copy : Copies an object; if any options are set, the entire
metadata of the object is replaced
<sourcebucket>/<sourcekey> : Source bucket/key
<destbucket>/<destkey> : Destination bucket/key
[cacheControl] : Cache-Control HTTP header string to associate with
object
[contentType] : Content-Type HTTP header string to associate with
object
[contentDispositionFilename] : Content-Disposition filename string to
associate with object
[contentEncoding] : Content-Encoding HTTP header string to associate
with object
[expires] : Expiration date to associate with object
[cannedAcl] : Canned ACL for the object (see Canned ACLs)
[x-amz-meta-...]] : Metadata headers to associate with the object
get : Gets an object
<buckey>/<key> : Bucket/key of object to get
[filename] : Filename to write object data to (required if -s
command line parameter was used)
[ifModifiedSince] : Only return the object if it has been modified since
this date
[ifNotmodifiedSince] : Only return the object if it has not been modified
since this date
[ifMatch] : Only return the object if its ETag header matches
this string
[ifNotMatch] : Only return the object if its ETag header does not
match this string
[startByte] : First byte of byte range to return
[byteCount] : Number of bytes of byte range to return
head : Gets only the headers of an object, implies -s
<bucket>/<key> : Bucket/key of object to get headers of
gqs : Generates an authenticated query string
<bucket>[/<key>] : Bucket or bucket/key to generate query string for
[expires] : Expiration date for query string
[resource] : Sub-resource of key for query string, without a
leading '?', for example, "meta"
Canned ACLs:
The following canned ACLs are supported:
private (default), public-read, public-read-write, authenticated-read
ACL Format:
For the getacl and setacl commands, the format of the ACL list is:
1) An initial line giving the owner id in this format:
OwnerID <Owner ID> <Owner Display Name>
2) Optional header lines, giving column headers, starting with the
word "Type", or with some number of dashes
3) Grant lines, of the form:
<Grant Type> (whitespace) <Grantee> (whitespace) <Permission>
where Grant Type is one of: UserID, or Group, and
Grantee is the identification of the grantee based on this type,
and Permission is one of: READ, WRITE, READ_ACP, or FULL_CONTROL.
Examples:
OwnerID SINA0000001001HBK3UT SINA0000001001HBK3UT
Type Grantee Display Name Permission
------ ------------------------ ----------------------- --------------
UserID SINA0000001001LNL6CP SINA0000001001LNL6CP READ
UserID SINA0000001001LNL6CP SINA0000001001LNL6CP WRITE
Group Authenticated AWS Users READ
Group All Users READ
Note that the easiest way to modify an ACL is to first get it, saving it
into a file, then modifying the file, and then setting the modified file
back as the new ACL for the bucket/object.
Date Format:
The format for dates used in parameters is as ISO 8601 dates, i.e.
YYYY-MM-DDTHH:MM:SS[+/-dd:dd]. Examples:
2008-07-29T20:36:14
2008-07-29T20:36:14-06:00
2008-07-29T20:36:14+11:30