全部产品
对象存储 OSS

使用示例

更新时间:2017-08-08 11:23:30   分享:   

安装配置osscmd

在Linux或者Windows上下载SDK安装包后,解压缩后就可以使用 osscmd了。

使用时直接调用python osscmd即可获取相应的说明。每种命令有两种执行模式。以查询用户所创建的bucket为例子。执行的是gs命令,get service的简写。

  • 方法1:不指定ID和KEY,osscmd从默认文件中读取ID和KEY。
  1. $ python osscmd gs
  2. can't get accessid/accesskey, setup use : config --id=accessid --key=accesskey

注意:如果出现这样的提示表明没有配置好ID和KEY,见步骤2中提示的配置命令。

如果配置好ID和KEY,并且ID和KEY有效,执行

  1. $ python osscmd gs
  2. 2013-07-19 08:11 test-oss-sample
  3. Bucket Number is: 1
  • 方法2:直接在命令中指定ID和KEY,osscmd从命令行中读取ID和KEY。如果ID和KEY有效,执行后会得之后的结果。
  1. $ python osscmd gs --id=your_id --key=your_key --host=your_endpoint
  2. 2013-07-19 08:11 test-oss-sample
  3. Bucket Number is: 1

如果要配置用户的ID和KEY到默认的文件中,请运行如下命令用来配置访问OSS所需要的ID和KEY。默认的OSS HOST为oss.aliyuncs.com。

  1. $python osscmd config --id=your_id --key=your_key --host=your_endpoint

如果出现类似“Your configuration is saved into ”的提示表明ID和KEY已经保存成功了。

基础操作

列出创建的bucket

  1. $python osscmd getallbucket

如果是刚刚使用OSS的用户因为没有创建bucket,输出是空

创建bucket

创建一个Bucket名字为mybucketname的bucket。

  1. $python osscmd createbucket mybucketname

创建“mybucketname”的bucket,有可能不成功。因为OSS中的bucket名字是全局唯一的,并且有人已经创建了这个bucket。这个时候需要换一个名字。例如在bucket名字中加入特定的日期。

查看是否创建成功

  1. $python osscmd getallbucket

如果没有成功请检查osscmd返回的错误信息。

查看Object

成功创建bucket后,查看bucket中有哪些object。

  1. $python osscmd list oss://mybucketname/

由于bucket中还没有object,输出是空的。

上传object

向bucket中上传一个object。假如本地文件名叫local_existed_file,其MD5值如下所示。

  1. $ md5sum local_existed_file 7625e1adc3a4b129763d580ca0a78e44 local_existed_file
  2. $ python osscmd put local_existed_file oss://mybucketname/test_object

提示md5sumLinux 命令, Windows 下无此命令。

再次查看Object

如果创建成功,再次查看bucket中有哪些object。

  1. $python osscmd list oss://mybucketname/

下载object

从bucket中下载object到本地文件,并比对下载的文件的md5值

  1. $ python osscmd get oss://mybucketname/test_object download_file
  2. $ md5sum download_file
  3. 7625e1adc3a4b129763d580ca0a78e44 download_file

提示md5sumLinux 命令, Windows 下无此命令。

删除object

  1. $ python osscmd delete oss://mybucketname/test_object

删除bucket

注意:如果bucket中还有object的话则这个bucket不能被删除。

  1. $ python osscmd deletebucket mybucketname

使用lifecycle

配置一个lifecycle的xml格式的文本文件

  1. <LifecycleConfiguration>
  2. <Rule>
  3. <ID>1125</ID>
  4. <Prefix>log_backup/</Prefix>
  5. <Status>Enabled</Status>
  6. <Expiration>
  7. <Days>2</Days>
  8. </Expiration>
  9. </Rule>
  10. </LifecycleConfiguration>

这个表示删除bucket下,以log_backup/ 为前缀的,并且相对当前时间超过2天的object。详细的规则配置可以参考API文档

写入lifecycle

  1. python osscmd putlifecycle oss://mybucket lifecycle.xml
  2. 0.150(s) elapsed

读取lifecycle

  1. python osscmd getlifecycle oss://mybucket
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <LifecycleConfiguration>
  4. <Rule>
  5. <ID>1125</ID>
  6. <Prefix>log_backup/</Prefix>
  7. <Status>Enabled</Status>
  8. <Expiration>
  9. <Days>2</Days>
  10. </Expiration>
  11. </Rule>
  12. </LifecycleConfiguration>
  13. 0.027(s) elapsed

删除lifecycle

  1. python osscmd deletelifecycle oss://mybucket
  2. 0.139(s) elapsed

读取lifecyle

  1. python osscmd getlifecycle oss://mybucket
  2. Error Headers:
  3. [('content-length', '288'), ('server', 'AliyunOSS'), ('connection', 'close'), ('x-oss-request-id', '54C74FEE5D7F6B24E5042630'), ('date', 'Tue, 27 Jan 2015 08:44:30 GMT'), ('content-type', 'application/xml')]
  4. Error Body:
  5. <?xml version="1.0" encoding="UTF-8"?>
  6. <Error>
  7. <BucketName>mybucket</BucketName>
  8. <Code>NoSuchLifecycle</Code>
  9. <Message>No Row found in Lifecycle Table.</Message>
  10. <RequestId>54C74FEE5D7F6B24E5042630</RequestId>
  11. <HostId>mybucket.oss-maque-hz-a.alibaba.net</HostId>
  12. </Error>
  13. Error Status:
  14. 404
  15. getlifecycle Failed!

防盗链设置

允许空referer访问

  1. $osscmd putreferer oss://test --allow_empty_referer=true
  2. 0.004(s) elapsed

获取设置的referer

  1. $osscmd getreferer oss://test
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <RefererConfiguration>
  4. <AllowEmptyReferer>true</AllowEmptyReferer>
  5. <RefererList />
  6. </RefererConfiguration>

不允许空referer,只允许referer为test的请求

  1. $osscmd putreferer oss://test --allow_empty_referer=false --referer='www.test.com'
  2. 0.092(s) elapsed

获取设置的referer

  1. $osscmd getreferer oss://test
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <RefererConfiguration>
  4. <AllowEmptyReferer>false</AllowEmptyReferer>
  5. <RefererList>
  6. <Referer>www.test.com</Referer>
  7. </RefererList>
  8. </RefererConfiguration>

不允许空referer,只允许referer为test和test1的请求

  1. $osscmd putreferer oss://test --allow_empty_referer=false --referer='www.test.com,www.test1.com'

获取设置的referer

  1. $osscmd getreferer oss://test
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <RefererConfiguration>
  4. <AllowEmptyReferer>false</AllowEmptyReferer>
  5. <RefererList>
  6. <Referer>www.test.com</Referer>
  7. <Referer>www.test1.com</Referer>
  8. </RefererList>
  9. </RefererConfiguration>

使用logging

设置logging

  1. $osscmd putlogging oss://mybucket oss://myloggingbucket/mb

获取设置的logging

  1. $osscmd getlogging oss://mybucket
本文导读目录
本文导读目录
以上内容是否对您有帮助?