面向对象存储oos教程说明

-.z.OOS客服脚本OOS根本知识1.1什么是OOS"面向对象存储〔Object-OrientedStorage，OOS〕是中国电信为客户提供的一种海量、弹性、高可用、高性价比的存储效劳，是一种开放式的存储效劳。1.2OOS根本概念？面向对象存储的主要概念有：Account〔账户〕、Service〔效劳〕、Object〔对象〕和Bucket〔对象容器〕。它们之间的关系如下列图所示。在使用OOS之前，首先需要在.ctyun.注册一个账号〔Account〕，注册成功之后，OOS会为该账号提供效劳〔Service〕，在该效劳下，用户可以创立1个或多个对象容器〔Bucket〕，每个对象容器中可以存储不限数量的对象〔Object〕。Account在使用OOS之前，需要在.ctyun.注册一个账号〔Account〕。注册时、密码和联系方式、用户名是必填项。注册成功之后，用户可以用该账号登录并使用OOS效劳。ServiceService是OOS为注册成功的用户提供的效劳，该效劳为用户提供弹性可扩展的存储空间及上行和下行流量。用户可以对存储空间和能力进展管理，例如，文件的上传下载、文件的保存、存储空间的访问控制等。BucketBucket是存储Object的容器。面向对象存储的每个Object都必须包含在一个Bucket中。Bucket不能嵌套，每个Bucket中只能存放Object，不能再存放Bucket。每个用户最多可以建立10个Bucket，并且在创立Bucket时需要设定其操作权限。用户只有对Bucket拥有相应的权限，才可以对其进展操作，这样保证了数据的平安性，防止非授权用户的非法访问。Bucket的命名规*如下：对象容器〔Bucket〕的命名规*是：Bucket名称必须全局唯一Bucket名称长度介于3到63字节之间Bucket名称可以由一个或者多个小节组成，小节之间用点〔.〕隔开各个小节需要：只能包含小写字母、数字和短横线〔-〕必须以小写字母或者数字开场必须以小写字母或者数字完毕Bucket名称不能是IP地址形式〔如〕Object用户存储在OOS上的每个文件都是一个Object。文件可以是文本、图片、音频、视频或者网页。OOS支持的单个文件的大小从1字节到5T字节。用户可以上传、下载、删除和共享Object。此外用户还可以对Object的组织形式进展管理，将Object移动或者复制到目标目录下。OOS有什么特点？弹性扩展，按需付费对用户来说，OOS是一种低本钱的存储资源，并且可以无限扩容，用户只需根据所使用的存储量进展付费即可，节约了本钱。平安可靠OOS采用多级加密数据，对用户数据进展分片加密保存，保证用户数据的平安性。性能可靠OOS采用高可用的效劳集群及动态负载均衡，保证用户顺利度过访问顶峰。快速部署，便捷接入用户只需在天翼云注册即可使用OOS效劳，部署便捷。同时，OOS采用统一的应用程序编程接口为用户访问OOS资源提供了便捷的接入通道。1.4OOS适合哪方面的应用？OOS主要适合以下类型的应用：〔1〕企业、财务数据的存储、备份和归档。〔2〕交通录像、监控录像、呼叫中心的效劳录音、档案管理、信息存储、托管效劳等。〔3〕互联网在线视频、网络游戏、电子商务、门户及社交类应用的文件、音视频、图片存储。〔4〕中小型企业的静态托管。1.5OOS适合存储哪些文件？OOS适合存储论坛与软件应用中的附件、高清图片、音视频、备份文件等，及各种APP应用、多终端同步软件、网盘下载站的文件存储，更详细信息参考：oos.ctyun./oos/product/e*ample.html1.6可对OOS的数据做哪些操作？1〕创立、查看、罗列、删除Bucket。2〕修改、获取Bucket的访问权限。3〕上传、查看、罗列、删除Object。4〕访问时支持If-Modified-Since和If-Match等HTTP参数。1.8如何订购OOS？您只需在天翼云官方上注册账号即可使用OOS效劳，进入【产品中心】，选择【对象存储】，点击【我要开通】，即可收到开通成功的短信确认。进入控制台后即可使用oos。1.9OOS怎么收费，有哪些计费项？收费项包括：存储容量、流出流量和请求次数。1〕存储容量计费：按用户数据占用的存储空间容量收取费用；2〕流出流量计费：按用户存储数据被调用或下载产生的流量收取费用；3〕请求次数计费：按照各种请求的次数收取费用。扣费方式：按天扣费，每晚12：00按用户的使用量进展扣费。欠费说明：OOS为每位用户提供一定的信用额度，当您处于欠费状态，但未超过信用额度时，OOS会发提醒您进展充值。当您欠费金额超过信用额度时，假设您24小时之内仍未进展充值，OOS效劳将自动停顿。而您所占用的存储空间的这局部资源仍会继续按日扣费，因此欠费余额会累计。您可以在30天内充值补足欠费后，效劳会自动开启，可以继续使用。欠费超过30天，将视为您主动放弃OOS存储效劳，存储空间将被回收，存储空间内的数据会被清理，数据不可恢复。价格列表容量价格规格标准价格元/G/天元/G/月1GB0.022约0.65流量价格规格标准价格〔元/GB〕1GB0.55请求次数标准规格标准价格〔元/GB〕GET/HEAD请求0.01元/万次请求其它请求0.01元/千次请求1.10OOS数据访问方式有哪些？1〕通过OOS门户进展访问；2〕通过HttpRESTAPI接口进展访问；3〕通过OOSSDK进展编程；4〕通过OOS备份客户端进展访问；5〕通过OOS推荐的第三方工具〔如webdrive,s3fs等〕进展访问；1.11OOS对文件格式有无要求？对文件格式没有要求1.12OOS平安性怎么保障？1〕在用户访问层面，所有针对OOS的数据请求都需要进展签名验证，OOS提供全方位的访问控制策略，使对象的拥有者对该对象有灵活的访问控制权。2〕在数据传输层面，不管是通过Web门户还是REST接口，用户的数据访问和操作都可以通过HTTPS协议进展，以确保数据传输中没有平安死角。3〕在数据存储层面，OOS将用户数据自动切片，进展分布式保存，并且对每片数据进展签名，即使数据被盗，没有用户的账号信息依然无法对数据进展破解，这样就充分保证了数据在存储层面的平安性。4〕在OOS系统的运维层面，通过利用中国电信的"虚拟云桌面〞技术，运维人员无法直接访问生产系统，而必须一个可录像的"虚拟桌面〞才能访问，运维人员的一举一动都将被记录在案。5〕在数据中心的运维层面，中国电信具备全球最先进的数据中心管理和运营能力。OOS部署在8级抗震、一级耐火、一级防水、通过ISO27001认证的的数据中心内部，与中国电信通信枢纽数据中心〔武警守卫〕同级别，具备完善的门禁制度、人员访控制度、设备巡检制度，确保物理层面的万无一失。1.13OOS试用时间多长？我们通过给客户提供信用额的方式让用户免费试用OOS，试用时间不受限制，直到用户消费完信用额度为止，信用额度的消费跟OOS计费方式一样。目前的初始信用额度是100元。1.14OOS与自建效劳器存储比照弹性扩展云存储按使用量计费，用户无需考虑由于业务需求的增长而扩大初期投资本钱。降低本钱使用OOS，您可以根据业务需求确定资源投入，防止投资和运营本钱〔电费、维护本钱等〕浪费。平安可靠云存储通过以下几种方式来保证数据平安：通过SSL加密技术和MD5校验技术，保障数据传输的平安通过数据自动切片、分布保存、每片签名等技术，保障数据存储的平安通过用户鉴权、ACL访问控制等方式，保障数据使用的平安通过7*24的专业运维团队、原厂的金牌效劳，保障数据运维的平安自建存储需要开发者自己从技术角度去实现平安防护，比方防火墙配置、加密技术等，对开发者要求较高，而且容易出现平安漏洞。而OOS有专业的技术平安团队进展平安防护，同时运维团队7*24小时的平安监控也能及时得弥补平安漏洞。2、OOSFAQ2.1OOSAPI文档"Date〞字段的GMT格式说明？在OOSAPI文档中，使用到"DATE〞表示时间的字段，必须为HTTP1.1中支持的GMT格式。有四种格式：EEE,dMMMyyyyHH:mm:ss'GMT'EEE,dMMMyyyyHH:mm:ssZEEE,dMMMyyyyHH:mm:ss'GMT'ZEEE,dMMMyyyyHH:mm:ssz字母日期或时间元素表示例如y年没有JSON格式的，返回结果是*ML格式的。2.14如何进展大文件上传？1〕有开发能力的用户可以通过OOSAPI或SDK来操作。•5GB以下文件或网络速度好的用户，可以使用PUTobject。•5GB以上或网络速度不好并且文件在100M以上的用户推荐使用MultipartUpload2〕无开发根底客户可下载OOS客户端，请参考oos.ctyun./oos/product/tools.html2.15object怎么改名"两种方法可以实现：1.您可以删除原来的文件，上传新命名的文件也能到达改名的效果。2.您可以通过copyobjcet源文件复制成为一个新名字的文件，再把源文件删除即可。2.16OOS中可以重命名bucket吗？OOS暂不支持bucket的重命名，假设需要其他名称，建议您重新创立bucket。OOS是否支持object迁移？OOS提供了COPYobjcet的功能，您可以将原bucekt下的文件COPY到新bucket即可。2.18javasdk中的OOSclient对象是否是线程平安的？是线程平安的2.19OOS是否支持多个object打包下载？目前OOS不支持多个object打包下载。2.20OOS返回的文件网络路径，域名都是ctyun的吗"可以把bucketname设置为域名，配置DNS，把域名指向oos.ctyunapi.，这样就可以通过域名访问object了。2.21OOS中url中可以实现授权文件上传吗？目前没有此功能2.22如何使用JAVASDK源代码？上提供了sdk的源码下载，可以将其导入的Eclipse等IDE工具中。2.23为什么bucket下的文件都删除了，却还能查看到占用的空间，并且bucket也删除不了？请确认您是否使用过UploadMultipart

的功能，如使用过，建议您可以通过UploadsList

Multipart

查看是否存在已经被初始化但是未被plete或者Abort的

Multipart

Upload的part。如果有，则需再执行Abort

Multipart

Upload〔来终止上次操作的

Multipart

Upload，该命令会自动删除未完成的part〕。因为未完成合并的part，无法形成objcet,所以通过objectlist是看不到这些残留的part，但这些都会产生占用空间量。2.24OOS支持bucket作为三级域名的访问方式吗？支持，三级域名外链访问方式：bucketname.oos.ctyunapi./object例如：cloudstorage.oos.ctyunapi./pujing.jpg普通外链访问方式：oos.ctyunapi./bucketname/object例如：oos.ctyunapi./cloudstorage/pujing.jpg注：如果你的bucket里面有下划线"_"，则由于不符合规*，无法做为三级域名使用，只能使用普通外链访问方式。2.25OOS中有好几个bucket，是否可以实现不同域名ame到不同bucket，如何操作？可以，配DNS就可以，AME方法：例如:您的bucket名为cloudstorage，您的objcet为"image/pujing.jpg"外链访问地址：oos.ctyunapi./cloudstorage/image/pujing.jpg您的AME

：

.myweb.

ame

oos.ctyunapi.

即可访问地址就可以映射：.myweb./cloudstorage/image/pujing.jpg2.26什么是API密钥OOS的API密钥是用来请求OOS资源时做验证用的，您可以在OOS账户中心的密钥管理模块查看和修改。2.27可以绑定域名吗？可以2.28是否防盗链有，您可以通过配置Bucket的Policy〔平安策略〕来实现，具体参见这里2.29OOS能否解决互联互通问题？1、OOS暂不支持互联互通，但支持电信/联通双线网络；2、后期会解决互联互通问题。2.30存储容量上限？一个Object最大支持5T，您也可以通过分段上传来实现超大文件的上传，文件大小没有限制。2.31是否支持压缩图片？OOS目前暂不支持图片压缩，后期会考虑提供支持。2.32是否支持批量上传您可以再OOS自效劳门户的控制台中进展文件批量上传，也可以通过编写程序或使用第三方支持工具〔s3fs，crOOSftp等〕实现批量上传。2.33OOS效劳是否限制用户的并发请求数？OOS不会限制用户的并发请求数2.34OOS接口能否在pad，android使用OOS提供基于HTTP的的标准REST接口，可以跨平台使用。2.35OOS是否可以挂载到云效劳器当硬盘用"可以，您可以通过第三方软件工具s3fs将OOS挂载到云效劳器。2.36最小计费单位"OOS的最小计量单位是"分〞2.37OOS支持FTP吗？支持，您可以使用第三方工具crOOSFtp来访问OOS；2.38oos数据怎么备份？OOS底层默认对数据进展三次备份，您也可以通过将数据迁移到不同的bucket来进展备份；2.39支持的开发规*？接口规*？OOS采用兼容亚马逊S3的应用程序编程接口，支持通过基于Http的RESTAPI来访问OOS效劳。详情请参见OOS开发者文档；2.40云存储计算器效劳上有：.ctyun./product/oos3、工具下载地址OOS客户端工具论坛上：bbs.ctyun./forum.php"mod=viewthread&tid=21&e*tra=page%3D1oos.ctyun./oos/product/bpinfo.html4、OOS的错误响应当用户访问OOS出现错误时，OOS会返回给用户相应的错误码和错误信息，便于用户定位问题，并做出适当的处理。错误代码列表错误码描述HTTP状态码NotVerify用户未激活403ForbiddenInvalidArgument无效的请求参数400BucketAlreadE*ists请求的bucket的name已经不可用，请选择不同的名字尝试。409ConflictBucketNotEmpty试图删除的的bucket非空409ConflictInvalidAccessKeyId你使用的OOSID不存在403ForbiddenInvalidBucketName指定的bucket无效400BadRequestInvalidURI无法解析指定的URL400BadRequestMethodNotAllowed指定的方法不允许操作该资源405MethodNotAllowedMissingContentLength在HTTP头中必须提供ContentLength411lengthrequiredRequestTimeTooSkewed请求的时间和效劳器时间相差15分钟以上403BadRequestNoSuchBucket指定的bucket不存在404NotFoundNoSuchKey指定对象的Key不存在404NotFoundSignatureDoesNotMatch我们计算出的请求中的签名与用户提供的签名不一致。检查OOS账户平安403ForbiddenTooManyBuckets你试图创立的bucket超出允许*围dRequest5、开放接口规*5.1、关于Service的操作GetService(ListBucket)对于做Get请求的效劳，返回请求者拥有的所有Bucket，其中"/〞表示根目录。该API只对验证用户有效，用户需要使用有效的KeyID在OOS中注册，匿名用户不能执行该操作。GET/HTTP/1.1Host:oos.ctyunapi.GET/HTTP/1.1Host:oos.ctyunapi.Date:Wed,01Mar201212:00:00GMTAuthorization:AWSmailaddressemail.:*QE0diMbLRepdf3YB+FIE*AMPLE=返回例如<"*mlversion="1.0"encoding="UTF-8""><ListAllMyBucketsResult*mlns="doc.oos.ctyun.c/2012-09-01"><Owner><ID>bcaf1ffd86f461ca5fb16fd081034f</ID>返回例如<"*mlversion="1.0"encoding="UTF-8""><ListAllMyBucketsResult*mlns="doc.oos.ctyun.c/2012-09-01"><Owner><ID>bcaf1ffd86f461ca5fb16fd081034f</ID><DisplayName>displayName</DisplayName></Owner><Buckets><Bucket><Name>sample1</Name><CreationDate>2012-09-01T16:45:09.000Z</CreationDate></Bucket><Bucket><Name>sample2</Name><CreationDate>2012-09-01T16:41:58.000Z</CreationDate></Bucket></Buckets></ListAllMyBucketsResult>Object的操作有：PutObject、GetObject、HeadObject、DeleteObject。PutObjectPutObject用于上传文件。请求例如在名叫myBucket的bucket中，存储一*叫my-image.jpg的图片。PUT/my-image.jpgHTTP/1.1PUT/my-image.jpgHTTP/1.1Host:myBucket.oos.ctyunapi.Date:Mon,03Sep201217:50:00GMTAuthorization:AWSmailaddressemail.:*QE0diMbLRepdf3YB+FIE*AMPLE=Content-Type:image/ipegContent-Length:11434[11434bytesofobjectdata]返回例如HTTP/1.1100ContinueHTTP/1.1100ContinueHTTP/1.1200OK*-amz-request-id:0A49CE4060975EACDate:Mon,03Sep201217:50:00GMTETag:"1b2cf535f27731c974343645a3985328"Content-Length:0Connection:closeServer:CTYUN如果Head中没有参加Contentlength参数，会返回411LengthRequired错误。返回例如：如果试图添加的Object所在的Bucket不存在，返回404NotFound错误。如果试图添加的Object所在的Bucket没有访问权限，返回403Forbidden错误。注意：如果试图添加的Object的同名文件已经存在，并且有访问权限。新添加的文件将覆盖原来的文件，成功返回200OK。如果添加文件长度超过5T，返回错误消息400BadRequest。如果在PutObject的时候，携带以*-amz-meta-为前缀的参数，则视为usermeta，比方*-amz-meta-location。一个Object可以有多个类似的参数，但所有的usermeta总大小不能超过2k。如果传入的Objectkey长度大于1023，返回400BadRequest。GetObject用于获取*个Object，此操作要求用户对该Object有读权限。下面例如中返回对象my-image.jpgGET/my-image.jpgHTTP/1.1GET/my-image.jpgHTTP/1.1Host:bucket.oos.ctyunapi.Date:Mon,03Sep201222:32:00GMTAuthorization:AWSmailaddressemail.:*QE0diMbLRepdf3YB+FIE*AMPLE=返回例如HTTP/1.1200OKHTTP/1.1200OK*-amz-request-id:318BC8BC148832E5Date:Mon,03Sep201222:32:00GMTLast-Modified:Sat,01Sep201217:50:00GMTETag:"fba9dede5f27731c9771645a39863328"Content-Length:434234Content-Type:image/ipegConnection:closeServer:CTYUN[434234bytesofobjectdata]如果文件不存在返回404NotFound错误。错误例如：GetObject时可以设定文件传送*围，在头中以Range设定。例如，设定bytes=0-9，表示传送第0到第9这10个字符。注意：在返回消息中会包含整个文件的长度和此次返回的*围，例如：Content-Range:bytes0-9/44，表示整个文件长度为44，此次返回的*围为0-9。如果不符合*围规*，则传送整个文件，并且不在结果中提及Content-Range。如果设定If-Modified-Since，并传入上次修改时间，如果参数中的时间早于实际修改时间，正常传送文件，并返回200OK。如果参数中的时间和实际修改时间一样或者更晚，会返回304notmodified。2.如果设定If-Unmodified-Since，如果传入参数中的时间等于或者晚于文件实际修改时间，传送文件并返回200OK，如果早于实际修改时间，会返回412preconditionfailed错误。如果设定If-Match，并传入期望的ETag，假设和object的ETag匹配，正常的发送文件。如果不符合，返回412preconditionfailed错误。如果设定If-None-Match来检查文件是否有更新，需要传入ETag，如果传入值和Object的一样，返回304NotModified。GetObject操作支持包含If-Modified-Since，If-Unmodified-Since，If-Match和If-None-Match中多个条件查询，其中If-Modified-Since和If-Unmodified-Since可以同时存在，If-Match和If-None-Match也可以同时存在。在多条件查询时，遵循以下规则：1.如果包含If-Unmodified-Since并且不符合或者包含If-Match并且不符合，返回412preconditionfailed。2.如果包含If-Modified-Since并且不符合或者包含If-None-Match并且不符合，返回304NotModified。3.返回200OK，并传输文件。HeadObjectHeadObject只返回*个Object的meta信息，不返回文件内容。注意：不管正常返回200OK还是非正常返回，HeadObject都不返回消息体。请求例如：• HEAD/bucket/my-image.jpgHTTP/1.1• HEAD/bucket/my-image.jpgHTTP/1.1• Host:oos.ctyunapi.• Date:Wed,28May201122:32:00GMT• HTTP/1.1200OK• *-amz-request-id:318BC8BC143432E5• HTTP/1.1200OK• *-amz-request-id:318BC8BC143432E5• Date:Wed,28May201122:32:00GMT• Last-Modified:Sun,1Jan201112:00:00GMT• ETag:"fba9dede5f27731c9771645a39863328"• Content-Length:434234• Content-Type:te*t/plain• Connection:close• Server:CTYUN如果文件不存在返回404NotFound错误。HeadObject支持在头中设定If-Modified-Since,If-Unmodified-Since,If-Match，If-None-Match，具体规则请参见GetObject中对应的选项。如果没有修改，返回304NotModified。HeadObject支持在头中设定If-Modified-Since,If-Unmodified-Since,If-Match，If-None-Match，具体规则请参见GetObject中对应的选项。如果没有修改，返回304NotModified。HeadObject和GetObject操作类似，支持包含If-Modified-Since，If-Unmodified-Since，If-Match和If-None-Match中多个条件查询，其中If-Modified-Since和If-Unmodified-Since可以同时存在，If-Match和If-None-Match也可以同时存在。在多条件查询时，遵循以下规则。如果包含If-Unmodified-Since并且不符合或者包含If-Match并且不符合，返回412preconditionfailed。如果包含If-Modified-Since并且不符合或者包含If-None-Match并且不符合，返回200OK，并传输文件，返回304NotModified。如果用户在PutObject的时候传入以*-OOS-meta-为开头的usermeta，比方*-OOS-meta-location，返回消息时，返回这些usermeta。DeleteObjectDeleteObject用于删除*个Object注意：如果文件不存在，也返回204NoContentDELETE/my-image.jpgHTTP/1.1Host:bucket.oos.ctyunapi.DELETE/my-image.jpgHTTP/1.1Host:bucket.oos.ctyunapi.Date:Mon,03Sep201217:50:00GMTAuthorization:AWSmailaddressemail.:*QE0diMbLRepdf3YB+FIE*AMPLE=Content-Type:image/ipeg下一个例子中删除一个叫my-image.jpg的图片对象返回例如HTTP/1.1204NoContentHTTP/1.1204NoContent*-amz-request-id:0A49CE4060975EACDate:Mon,03Sep201217:50:00GMTContent-Length:0Connection:closeServer:CTYUN如果Bucket不存在，返回404NotFound5.3关于Bucket的操作Bucket的操作有：PutBucket、GetBucket、DeleteBucket、GetBucketACL、PutBucketACL。1、PutBucketPutBucket用于创立Bucket〔不支持匿名访问〕。请求例如请求创立一个名叫picture的bucket：PUT/HTTP/1.1PUT/HTTP/1.1Host:picture.oos.ctyunapi.Content-Length:0Date:Mon,03Sep201212:00:00GMTAuthorization:AWSmailaddressemail.:*QE0diMbLRepdf3YB+FIE*AMPLE=返回例如HTTP/1.1200OKHTTP/1.1200OK*-amz-request-id:236A8905248E5A01Date:Mon,03Sep201212:00:00GMTLocation:/pictureContent-Length:0Connection:closeServer:CTYUN如果请求的Bucket已经存在，并且请求者是所有者，同样返回200OK成功。如果请求的Bucket已经存在，但是不是请求者所拥有的，返回409Conflict。如果想创立的Bucket不符合命名规*，返回400BadRequest消息：如果用户发起PUTBucket请求的时候，没有传入用户验证信息，返回403Forbidden消息。如果PutBucket的时候发现已经超过bucket最大创立数—10时，返回400BadRequest消息。GetBucket(ListObject)GetBucket操作可用来listBucket中所有Object的信息。请求例如GET/HTTP/1.1Host:BucketName.oos.ctyunapi.GET/HTTP/1.1Host:BucketName.oos.ctyunapi.Date:Mon,03Sep201217:50:00GMTAuthorization:AWSmailaddressemail.:*QE0diMbLRepdf3YB+FIE*AMPLE=Content-Type:te*t/plain<"*mlversion="1.0"encoding="UTF-8""><"*mlversion="1.0"encoding="UTF-8""><ListBucketResult*mlns="oos.ctyunapi./doc/2012-09-31"><Name>bucket</Name><Prefi*/><Marker/><Ma*Keys>1000</Ma*Keys><IsTruncated>false</IsTruncated><Contents><Key>my-image.jpg</Key><LastModified>2012-09-03T17:50:30.000Z</LastModified><ETag>"fba9dede5f27731c9771645a39863328"</ETag><Size>434234</Size><StorageClass>STANDARD</StorageClass><Owner><ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID><DisplayName>yourmailmail.</DisplayName></Owner></Contents><Contents><Key>my-third-image.jpg</Key><LastModified>2012-09-03T17:50:30.000Z</LastModified><ETag>"1b2cf535f27731c974343645a3985328&<Size>64994</Size><StorageClass>STANDARD</StorageClass><Owner><ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID><DisplayName>yourmailmail.</DisplayName></Owner></Contents></ListBucketResult>使用请求变量的例如：注意：

1.文件中自定义的meta，在GetBucket请求时不会返回。

2.List的结果中会标识出那些keys是ObjectGroup。如果访问的Bucket不存在，包括试图访问因为命名不规*无法创立的Bucket，返回404NotFound错误。如果没有访问该Bucket的权限，返回403Forbidden错误。GetBucket〔ListObject〕时，也可以通过prefi*，marker，delimiter和ma*-keys对list做限定，返回局部结果。

1.prefi*限定返回的objectkey必须以prefi*作为前缀。注意使用prefi*查询时，返回的key中仍会包含prefi*。

2.ma*-keys用于限定此次返回object的最大数，如果不设定，默认为100，ma*-keys取值不能大于100。

3.maker用户设定结果从marker之后按字母排序的第一个开场返回。

4.prefi*，marker用来实现分页显示效果，参数的长度必须小于256字节。

5.delimiter是一个用于对Object名字进展分组的字符。所有名字包含指定的前缀且第一次出现delimiter字符之间的object作为一组元素——monPrefi*es。利用delimiter这个参数，可以方便地实现出文件夹的功能，如一个bucket存在object:fun/test.jpg，fun/movie/001.avi，fun/movie/007.avi。假设设定prefi*为〞fun/〞，则返回三个object；如果增加设定delimiter为"/〞，则返回〞fun/test.jpg〞和〞fun/movie/〞；即实现了文件夹的逻辑。如果把prefi*设为*个文件夹名，例如/bucketName/folder1/，就可以罗列以此prefi*开头的文件，即该文件夹下递归的所有的文件和子文件夹。如果再把delimiter设置为/时，返回值就只罗列该文件夹下的文件，该文件夹下的子文件名返回在monPrefi*es局部，子文件夹下递归的文件和文件夹不被显示。如果因为ma*-keys的设定无法一次完成listing，返回结果会附加一个<Ne*tMarker>，提示继续listing可以以此为marker。Ne*tMarker中的值仍在list结果之中。即使marker实际在列表中不存在，返回也从符合marker字母排序的下一个开场打印。如果ma*-keys小于0或者大于100，将返回400BadRequest错误。假设prefi*，marker，delimiter参数不符合长度要求，返回400BadRequest。Prefi*不符合规*返回消息例如：(maker，delimiter参数不符合长度要求返回消息同prefi*)。DeleteBucketDeleteBucket用于删除*个Bucket。请求例如：删除名叫doc的bucket：DELETE/HTTP/1.1DELETE/HTTP/1.1Host:doc.oos.ctyunapi.Date:Mon,03Sep201212:00:00GMTAuthorization:AWSmailaddressemail.:*QE0diMbLRepdf3YB+FIE*AMPLE=返回例如HTTP/1.1204NoContentHTTP/1.