名称 描述 trailList.Name 跟踪的名称。 trailList.S3BucketName OOS Bucket名称。 trailList.S3KeyPrefix 跟踪日志的名称前缀。 trailList.TrailARN 跟踪的ARN。

请求示例 获取跟踪名为testcloudtrail的跟踪状态信息。 POST / HTTP/1.1 Host:ooscncloudtrail.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190423T021257Z XAmzTarget:cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.GetTrailStatus ContentType:application/json {"Name":"testcloudtrail"} 响应示例 HTTP/1.1 200 OK xamznRequestId:12feb8d48aa84d09 ContentType:application/json;charsetUTF8 ContentLength:386 Date:Tue, 23 Apr 2019 02:12:57 GMT Server:CTYUN {"IsLogging":true,"LatestDeliveryTime":1555985394434,"StartLoggingTime":1555984663079,"StopLoggingTime":1555987231038}

本节主要介绍策略中的Version元素。 Version策略元素用在策略之中，用于定义策略语言的版本，包含在所有策略中的Statement元素之前。 目前OOS IAM在用的策略版本为：20121017，兼容AWS最新策略版本。 如果未包含Version元素，则此值默认为20121017。

响应码 错误码(code) 错误信息(message) 错误描述 403 AccessDenied User: user is not authorized to perform: action on resource: resource . 没有查询统计信息的权限。 405 MethodNotAllowed Method does not exist or is not attachable. 方法不被允许。 500 InternalError We encountered an internal error. Please try again. 发生内部错误。 400 InvalidArgument Invalid BeginDate or EndDate on querying by day 按天查询时，时间请求参数不合法。 400 InvalidArgument Invalid BeginDate or EndDate. 时间请求参数格式无效。 400 InvalidArgument Invalid BeginDate and EndDate. beginDate不早于endDate。 400 InvalidArgument Invalid EndDate. （旧接口）结束时间请求参数不合法，时间点不是整5分钟或EndDate晚于当前时刻。 400 InvalidArgument Invalid BeginDate. （旧接口）开始时间请求参数不合法，时间点不是整5分钟或BeginDate早于一个月前。 400 InvalidArgument Invalid BeginDate and EndDate. Too large time gap. beginDate和endDate之间时间间隔不能大于5分钟（旧api获取连接数）。 400 InvalidArgument Invalid Freq. 频率Freq请求参数格式不正确。 400 InvalidArgument Invalid NetType. 网络类型（精品网/普通网）请求参数不合法。 400 InvalidArgument Missing Freq. 没有输入参数Freq。

名称 描述 是否必须 Host 操作跟踪访问域名。 对象存储网络：ooscncloudtrail.ctyunapi.cn。 对象存储网络2：ooscn2cloudtrail.ctyunapi.cn。 香港精品网和香港普通网：ooscnhkcloudtrail.ctyunapi.cn。 是 Authorization V4请求头签名。 类型：字符串 是 XAmzDate 日期和时间格式必须遵循ISO 8601标准，并且必须使用“yyyyMMddT HHmmssZ”格式进行格式化。例如，如果日期和时间是“08/01/2018 15：32：41.982700”，则必须首先将其转换为UTC（协调世界时），然后提交为“20180801T083241Z”。 是 XAmzTarget 操作跟踪请求目标，格式为cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.Target。 例如创建操作跟踪的请求为： XAmzTarget:cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.CreateTrail 是 ContentType 请求内容类型。 类型：字符串 取值：application/json。 是 Connection 客户端与OOS服务器之间的连接状态。 取值： keepalive：长连接，请求结束后继续保持连接。 close：短连接，请求结束后关闭连接。 默认值为：keepalive。 否

名称 描述 Name 跟踪的名称。 S3BucketName OOS Bucket名称。 S3KeyPrefix 跟踪日志的名称前缀。 TrailARN 跟踪的ARN。

名称 描述 是否必须 Action GetConcurrentConnection。 是 BeginDate 指定查询并发连接数的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询并发连接数的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 EndDate与BeginDate的间隔小于1天。 是 Bucket 指定查询并发连接数Bucket的名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的并发连接数之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询并发连接数的数据位置。如果不指定数据位置名称，则查询账户名下所有数据位置的并发连接数之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1。 香港节点：HongKong。 否 InternetType 指定返回并发连接数的网络类型互联网/非互联网。 类型：字符串 取值： all：指定返回互联网并发连接数和非互联网并发连接数。 internet：指定返回互联网的并发连接数。 noninternet：指定返回非互联网的并发连接数。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值：by5min：统计数据的采样粒度为5分钟。 默认值为by5min。 否

响应结果 名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 指定查询的存储类型： ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 TimeZone 返回数据的时区，统一为UTC +0800。 InternetType 返回的返回码类型互联网/非互联网: all:互联网返回码和非互联网返回码。 internet：互联网返回码。 noninternet：非互联网返回码。 RequestsType 返回码次数的请求类型，当返回多个时，用分隔符“+”连接： all：所有请求类型的返回码次数。 get：get类型的返回码次数。 head：head类型的返回码次数。 put：put类型的返回码次数。 post：post类型的返回码次数。 delete：delete类型的返回码次数。 others：除上述外的其他类型的返回码次数。 ResponseType 返回的返回码类型，当返回多个时，用分隔符“+”连接： all：所有类型的返回码。 Response200。 Response204。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Freq 返回统计数据的采样粒度： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 BucketName 请求的Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 RegionName 数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 Statistics.Date 返回结果对应的时间： 当请求参数Freq为by5min或byHour时，返回格式为yyyyMMdd HH:mm。 当请求参数Freq为byDay时，返回格式为yyyyMMdd。 Statistics.Data.Internet.Get 标准存储数据互联网Get类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Head 标准存储数据互联网Head类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Put 标准存储数据互联网Put类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Post 标准存储数据互联网Post类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Delete 标准存储数据互联网Delete类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response204。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Others 标准存储数据互联网Others类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Get 标准存储数据非互联网Get类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Head 标准存储数据非互联网Head类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Put 标准存储数据非互联网Put类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Post 标准存储数据非互联网Post类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Delete 标准存储数据非互联网Delete类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response204。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Others 标准存储数据非互联网Others类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Get 低频访问存储数据互联网Get类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Head 低频访问存储数据互联网Head类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Put 低频访问存储数据互联网Put类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Post 低频访问存储数据互联网Post类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Res ponse503。 Statistics.Standardia.Internet.Delete 低频访问存储数据互联网Delete类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response204。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Others 低频访问存储数据互联网Others类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Get 低频访问存储数据非互联网Get类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Head 低频访问存储数据非互联网Head类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Put 低频访问存储数据非互联网Put类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Post 低频访问存储数据非互联网Post类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Delete 低频访问存储数据非互联网Delete类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response204。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Others 低频访问存储数据非互联网Others类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。

生成签名的示例 通过创建预签名URL的方式，与其他人共享examplebucket中test.txt文件，过期时间设置为7天（604800秒）。以GET请求为例： GET ?XAmzAlgorithmAWS4HMACSHA256 &XAmzCredential2a948fd3f00ba0925806/20240906/cn/s3/aws4request&XAmzDate20240906T235141Z&XAmzExpires604800 &XAmzSignedHeadershost &XAmzSignature 以下步骤首先说明如何计算签名和构建预签名URL。示例中使用的访问密钥如下： 参数 值 AccessKeyID 2a948fd3f00ba0925806 SecretAccessKey ef2017c2e5ffa0b1761717ecbca021da16501384 1. StringToSign 1. 创建规范请求（以GET请求为例） GET /examplebucket/test.txt XAmzAlgorithmAWS4HMACSHA256&XAmzCredential2a948fd3f00ba0925806%2F20240906%2Fcn%2Fs3%2Faws4request&XAmzDate20240906T235141Z&XAmzExpires604800&XAmzSignedHeadershost host:ooscn.ctyunapi.cn host UNSIGNEDPAYLOAD 2. 待签名字符串 AWS4HMACSHA256 20240906T235141Z 20240906/cn/s3/aws4request 9e0b6407d893f03ea8ed79710b98a0b19bf9060b744f0e14212f32d1ac04ba62 2. StringKey signing key HMACSHA256(HMACSHA256(HMACSHA256(HMACSHA256("AWS4" + " ","20240906"),"cn"),"s3"),"aws4request") 3. 签名 66628b60cb4cc78d37c76b204d6a019572ed3887d84488c72f0643d850ad4915 4. 将签名信息添加到请求头

本节主要介绍GetRequests。 此操作用来查询用户的请求次数。 请求参数 名称 描述 是否必须 Action GetRequests。 是 BeginDate 指定查询请求次数的起始时间，统计数据的起始时间（时区为：UTC+8）为开始日期的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate EndDate 指定查询请求的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值: ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 默认值为STANDARD。 否 Bucket 指定查询请求次数的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有的Bucket的请求次数之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询请求次数的数据位置。如果不指定数据位置，则查询账户名下所有数据位置的请求次数之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1。 香港节点：HongKong。 否 InternetType 指定返回的请求次数网络类型互联网/非互联网。 类型：字符串 取值： all：指定返回互联网请求次数和非互联网请求次数。 internet：指定返回互联网的请求次数。 noninternet：指定返回非互联网的请求次数。 默认值为all。 否 RequestsType 指定返回的请求类型。 类型：字符串 取值： all：指定返回所有类型的请求次数。 get：指定返回get类型的请求次数。 head：指定返回head类型的请求次数。 put：指定返回put类型的请求次数。 post：指定返回post类型的请求次数。 delete：指定返回delete类型的请求次数。 others：指定返回除上述外的其他类型的请求次数。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

本节主要介绍GetRestoreCapacity。 此操作用来查询数据取回量。用户可以根据需求，查询指定存储桶、指定存储类型的数据取回量。 请求参数 名称 描述 是否必须 Action GetRestoreCapacity。 是 BeginDate 指定查询数据取回量的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询数据取回量的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值： ALL：所有存储类型。 STANDARADIA：低频访问类型。 默认值为ALL。 否 Bucket 指定查询数据取回量的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的数据取回量之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询数据取回量的数据位置。如果不指定数据位置名称，则表示查询账户下所有数据位置的数据取回量之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1。 香港节点：HongKong。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

修改跟踪 在“跟踪列表”页面，点击跟踪“操作”列的“开启”/“关闭 ”、“管理”和“删除”按钮，可以对操作跟踪进行相应的修改。 点击“管理”，进入具体跟踪的详细页面，点击“编辑日志跟踪规则”，可以重新设置管理事件、存储位置、日志前缀和跟踪状态。

本节主要介绍怎么在控制台创建IAM用户。 登录“访问控制”>“概览”，在“账户概览”区域下，点击“创建用户”；或者登录“访问控制”>“用户管理”>“用户”，点击“创建”。 按照下列步骤创建IAM用户： 1. 设置用户 根据页面提示添加用户名，可以添加一个或多个用户，并为新创建的用户设置访问方式。 2. 设置权限 为IAM用户设置权限。 有三种添加权限的方式（只能选择一种）： 1. 将用户添加到组 （前提：已经有用户组）：用户将继承该用户组的所有权限，一个用户最多可以加入10个组。 2. 从现有用户复制 （前提：现有用户有通过直接附加的方式被授权的策略），每次只能复制一个用户的权限。只能复制现有用户直接附加的策略，不能复制用户所在组的策略。 3. 附加现有策略 ：直接为用户添加现有的策略，每个用户最多可以直接添加10个策略。 用户设置权限时，只能选择以上三种方式中的一种为用户授权，当用户已经选择某一种权限设置方式，并进行了必要的勾选后，再切换其他授权方式会弹出提示框。 说明 可以创建用户时为用户添加策略，也可以用户创建完成后，再为其添加策略。 注意 每个用户最多可以直接附加10条策略，不包含随组附加的策略。 3. 设置标签 管理员可以为IAM用户设置标签，标签为IAM用户的附加属性。一个用户最多可以添加10个标签。 说明 不能为单个标签指定多个值，但多个标签键可以有相同的标签值。 项目 描述 :: 标签键 可以包含字母、数字、空格以及加号(+)、等号()、句点(.)、at符号(@)、下划线()、连字符()、冒号(:)、正斜杠(/)符号的任意组合。 标签键不区分大小写，但保留大小写。例如不能同时存在Department和department标签键，如果使用Departmentfoo标签标记用户后又添加departmentbar标签，则它会替换第一个标签，标签值变为bar。 标签值 可以为空。 4. 信息审核 对新建用户的信息进行审核，如果需要更改，可以在此页面点击对应的编辑标识，然后到对应的页面进行修改。 5. 完成 点击“下载凭证”，保存新建用户的密钥和密码。 注意 安全凭证仅能下载一次，务必妥善保管。如果某一用户的密钥丢失，可以在该用户详情页，先对原密钥进行删除，然后通过“创建密钥”的方式重新获取新的密钥。如果密码丢失，需要有修改密码权限的用户在控制台进行对该用户密码重置。

请求 StringToSign GET /photos/puppy.jpg HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Tue, 11 Jun 2024 01:32:55 GMT ContentType: application/octetstream Authorization: AWS 3a7451ae6b635b4f5ded:icJnqU3Zfm1sEOBCBwJPKymwWds GETn n application/octetstreamn Tue, 11 Jun 2024 01:32:55 GMTn /examplebucket/photos/puppy.jpg

API 描述 GetCapacity 此操作用来查询用户的容量。 GetBilledStorageUsage 此操作用来查询收费容量。 GetRestoreCapacity 此操作用来查询数据取回量。 GetDeleteCapacity 此操作用来查询用户删除的容量。 GetTraffics 此操作用来查询用户的流量。 GetRequests 此操作用来查询用户请求次数。 GetReturnCode 此操作用来查询用户请求返回码次数。 GetConcurrentConnection 此操作用来查询用户的并发连接数。 GetUsage 此操作用来查询用户Bucket的使用情况。 GetBandwidth 此操作用来查询用户的已用带宽。

本文为您介绍CC攻击防护最佳实践。 当客户发现网站处理速度下降，网络带宽占用过高时，很有可能已经遭受CC攻击，此时可查看Web服务器的访问日志或网络连接数量，如果访问日志或网络连接数量显著增加，则可确定网站已遭受CC攻击，可以利用WAF阻断CC攻击，保障网站业务的正常运行。 CC攻击防护策略 在大规模CC攻击中，单台傀儡机发包的速率往往远超过正常用户的请求频率。针对这种场景，直接对请求源设置限速规则是最有效的办法。推荐您自定义CC防护策略，对具体的访问源配置限速策略，具体操作，请参见CC防护。 在实际场景中，您需要根据自身业务需求调整防护路径和触发防护的阈值，并选择合适的处置动作，以达到更有针对性、更精细化的防护效果。 例如：为了预防登录接口受到恶意高频撞库攻击的影响，您可以配置登录接口的地址（示例：使用path字段作为匹配条件，将匹配内容设置为/login.php），并设置30秒内超过10次请求则进行封禁。

本节主要介绍删除用户组。 选择需要删除的用户组，点击“删除”，可以删除多个用户组；或者点击对应用户组“操作”列的“删除”，删除用户组。

策略名 描述 AdministratorAccess 所有权限，与根用户的权限一样多。 IAMReadOnlyAccess IAM相关的get和list权限。 OOSCloudTrailFullAccess 操作跟踪需要的相关权限，包括： OOS：PutBucket、GetRegions、DeleteBucket、ListAllMyBucket、ListBucket、GetObject。 ClouldTrail：所有操作。 OOSCloudTrailReadOnlyAccess 操作跟踪读相关的权限，包括： OOS: GetObject、ListBucket、ListAllMyBucket。 CloudTrail: GetTrailStatus、DescribeTrails、LookupEvents、GetEventSelectors。 OOSFullAccess OOS的所有权限，包括Bucket和Object的所有操作。 OOSIAMFullAccess IAM所有权限。 OOSReadOnlyAccess OOS只读权限，包括Bucket和Object的GET、List相关操作。

请求示例 浏览器可以向OOS发送预检请求，来判断其是否可以从源 OPTIONS /exampleobject HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Origin: AccessControlRequestMethod: PUT 响应示例 HTTP/1.1 200 OK xamzrequestid: 0e66553608684ccf0b7e71807582848a494b543f4143454749 Date: Wed, 21 Aug 2012 23:09:55 GMT AccessControlAllowOrigin: AccessControlAllowMethods: PUT AccessControlExposeHeaders: xamzrequestid Server: CTYUN

本节主要介绍生成共享链接。 生成共享链接 可以通过生成Object的共享链接的方式，将Object分享给其他人，同时可以在链接中设置限速以对下载速度进行控制。例如在JAVA SDK中调用AmazonS3中的generatePresignedUrl ( GeneratePresignedUrlRequest )方法生成共享链接， GeneratePresignedUrlRequest的参数包含了BucketName，ObjectName，并且可以设置过期时间和下载速度；如果过期时间传Null的话，默认的过期时间是15分钟。超出过期时间后，共享链接失效，不能再通过链接下载 Object。 说明 如果使用V2签名，共享链接过期时间最大可以设置为9223372036854775秒。如果使用V4签名，共享链接过期时间最大可以设置为7天（604800秒）。 生成共享链接示例： public static void generatePresignedUrl(AmazonS3 oosClient) { GeneratePresignedUrlRequest shareUrlRequest new GeneratePresignedUrlRequest( BUCKETNAME, OBJECTNAME); java.util.Date now new java.util.Date(); java.util.Date expire new Date(now.getTime() + 24 3600 1000); //2436001000 shareUrlRequest.setExpiration(expire); //shareUrlRequest.addRequestParameter("xamzlimitrate", "2048"); URL url1 oosClient.generatePresignedUrl(shareUrlRequest); System.out.println(url1.toString()); } 以下是一个生成的共享链接： 共享链接限速 如果需要为链接设置下载速度限制，需要新增加自定义参数“xamzlimitrate”，调用GeneratePresignedUrlRequest.addRequestParameter("xamzlimitrate", value)方法，value 值为限速带宽(单位 KiB/s)，将参数加到 GeneratePresignedUrlRequest 文件中，参与共享链接生成，以下为增加了下载速度限制生成的共享链接的示例：

本节主要介绍怎么在控制台创建文件夹。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以创建文件夹。 点击“创建文件夹”，在弹窗中设置要创建的文件夹名称，创建后的文件夹可以包含文件（Object）。 这里的文件夹并不是文件系统中文件夹的概念。为了方便用户进行数据管理，OOS提供了一种方式模拟文件夹。实际上OOS内部是通过在文件名称中增加“/”，将该文件在管理控制台上模拟成一个文件夹的形式展现。通过API列举文件，获取到的文件名以“/”分隔的，最后一个“/”后的内容就是文件名。如果最后一个“/”后没有内容，则表示一个文件夹路径。文件夹的层级结构深度不会影响访问文件的性能。 其中文件夹名称： 不为空 。 不包含 ？" : / ' 。 不能以 开头并且不能以结尾。 不能为：.或者+。

本节主要介绍Abort Multipart Upload。 该接口用于终止一次分片上传操作。分片上传操作被终止后，用户不能再通过上传ID上传其它片段，之前已上传完成的片段所占用的存储空间将被释放。如果此时任何片段正在上传，该上传过程可能会也可能不会成功。所以，为了释放所有片段所占用的存储空间，可能需要多次终止分片上传操作。 请求语法 DELETE /ObjectName?uploadIdUploadId HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: Date Authorization: SignatureValue 请求示例 下面的请求通过指定上传ID来终止一次分片上传操作。 DELETE /exampleobject?uploadId658428231343369399 HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Mon, 1 Nov 2010 20:34:56 GMT Authorization: SignatureValue 响应示例 HTTP/1.1 204 No Content Date: Mon, 1 Nov 2010 20:34:56 GMT xamzrequestid: cafd93679f174e05428e85969c999c7b9f968d9ba0aca2a080 Server: CTYUN

本节主要介绍DELETE Object。 此操作用来移除指定的文件，要求用户要对文件所在的Bucket拥有写权限。 请求语法 DELETE /ObjectName HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date ContentLength: length Authorization: SignatureValue 请求示例 删除一个叫myimage.jpg的图片文件。 DELETE /myimage.jpg HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Mon, 03 Sep 2012 17:50:00 GMT Authorization: SignatureValue ContentType: application/xml; charsetutf8 响应示例 HTTP/1.1 204 No Content xamzrequestid: 5d5becc10cdd4f25047e8077797f3e40443436383a3c3e4042 Date: Mon, 03 Sep 2012 17:50:00 GMT Server: CTYUN

本节主要介绍文件元数据信息。 元数据是对文件的属性描述，包括系统定义元数据（System Meta）和用户自定义元数据（User Meta）两种。您可以通过编辑元数据来管理文件的属性。 用户可以修改的系统定义元数据 注意 系统定义元数据取值请按照HTTP标准进行填写。 字段 描述 CacheControl 指定文件的缓存行为。 取值： nocache：不直接使用缓存，而是先去服务端验证文件是否已更新。如果文件已更新，说明本地缓存已过期，需从服务端重新下载文件；如果文件未更新，表明本地缓存未过期，此时使用本地缓存。 nostore：文件不会被缓存。 public：文件允许被任何中间者（可能是代理服务器、类似于 cdn 网络）缓存。 private：文件只能被获取它的终端缓存。它不允许任何中间者（intermediate）缓存响应的资源。 maxage：缓存文件的相对过期时间，单位为秒。此选项仅在HTTP 1.1中可用。 ContentDisposition 指定文件的展示形式。 取值： ContentDisposition:inline：直接预览文件内容。 ContentDisposition:attachment：以原文件名的形式下载到浏览器指定路径。 ContentDisposition:attachment; filename"FileName"：以自定义文件名的形式下载到浏览器指定路径。 FileName：用于自定义下载后的文件名称，例如example.jpg。 将文件下载到浏览器指定路径时： 如果文件名称包含星号（）、正斜线（/）等特殊字符时，可能会出现特殊字符转义的情况。例如，下载test.jpg"到本地时，test.jpg"可能会转义为test .jpg"。若需确保下载名称中包含中文字符的文件到本地指定路径后，文件名称不出现乱码的现象，您需要将名称中包含的中文字符进行URL编码。例如，将“中文.txt”从OOS下载到本地后，需要保留文件名为中文.txt，需按照"attachment;filename"+URLEncoder.encode("中文","UTF8")+".txt;filenameUTF8''"+URLEncoder.encode("中文","UTF8")+".txt")的格式设置ContentDisposition，即attachment;filename%E4%B8%AD%E6%96%87.txt;filename%E4%B8%AD%E6%96%87.txt。 ContentEncoding 指定文件的编码方式。需要按照文件的实际编码类型填写，否则可能造成客户端（浏览器）解析编码失败或文件下载失败。若文件未编码，不增加此项。 取值： identity：表示文件未经过压缩或编码。 gzip：表示文件采用LempelZiv（LZ77）压缩算法以及32位CRC校验的编码方式。 compress：表示文件采用LempelZivWelch（LZW）压缩算法的编码方式。 deflate：表示文件采用zlib结构和deflate压缩算法的编码方式。 br：表示文件采用Brotli算法的编码方式。 默认值为identity。 关于ContentEncoding的更多信息参见RFC2616。 ContentType 指定文件的内容类型。 用于定义文件的类型和网页的编码。如果没有指定文件类型，则根据文件的扩展名生成。如果文件没有扩展名，则文件类型的默认值application/octetstream。 ContentLanguage 声明文件内容使用的语言。例如某个文件使用简体中文编写，则此项可设置为zhCN。 Expires 缓存内容的绝对过期时间，格式是格林威治时间（GMT）。 例如Wed, 22 Nov 2023 14:18:58 +0800。如果CacheControl设置了maxage，以maxage为准。 xamzwebsiteredirectlocation 将相关联文件的请求重定向到同一存储桶中的其他文件或外部 URL。此值对于每个单独文件都是唯一的，原定设置情况下不会复制该值。更多信息请参考的POST Object。 可以修改的用户定义元数据 字段 描述 xamzmeta 用户自定义元数据。键（key）必须为ASCII中可打印字符的部分值，不支持的字符详见下表。值（Value）为除（space）外的ISO 88591以内的字符。 用户定义元数据取值： 95个可打印字符中不可取的值 ASCII十进制 图形 ASCII十进制 图形 32 （space） 61 34 " 62 > 40 ( 63 ? 41 ) 64 @ 44 , 91 [ 47 / 92 58 : 93 ] 59 ; 123 { 60 “编辑元数据”，或点击具体文件“操作”列的“更多”>“编辑元数据”，可以进行对文件的元数据进行编辑。 说明 如果同时选择多个文件编辑元数据，则不会显示文件的原有元数据信息。如果文件存在已有元数据的键（key）与本次添加元数据的键（key）相同，则其值（value）会更新为最新的值，该文件其他历史元数据均会保留。 点击“添加元数据”，可以修改文件的系统定义元数据或用户定义元数据。 名称 描述 类型 元数据的类型： 系统定义 用户定义 键 具体元数据名称。 元数据为系统定义时，取值： CacheControl ContentDisposition ContentEncoding ContentType ContentLanguage Expires xamzwebsiteredirectlocation 元数据为用户定义时，取值：xamzmeta。 值 对应元数据的具体取值。 操作 点击“删除”按钮，可以删除该元数据。

本节主要介绍怎么在控制台移动文件。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以移动文件到其他存储桶。 选择需要移动的文件，点击“更多 ”>“ 移动” ，弹出“文件移动”窗口，用户可以通过文件移动功能将文件移动到其他存储桶（Bucket）中。 注意 使用控制台操作，移动的单个文件不大于5GiB。如果超过5GiB，请调用API的PUT Object Copy或Copy Part、DELETE Object接口进行操作。

名称 描述 是否必须 BucketName 存储桶名称 是

本节主要介绍怎么在控制台修改文件的存储类型。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以修改文件类型。 选择需要修改的文件，点击“更多”>“修改存储类型”，弹出“修改存储类型”窗口，对文件的存储类型进行修改。 标准存储：访问时延低、吞吐量高，能够有效支持各种热点类型数据频繁访问。适用于各种音视频服务、图片服务、大型网站、大数据分析等应用的数据存储。标准存储是默认的存储类型。如果上载文件时未指定存储类型，OOS默认使用标准存储。 低频访问存储：适合长期保存不经常访问的数据。对于不经常访问但仍需要实时访问的数据，可以采用低频访问存储，例如各类移动应用、智能设备、企业数据的长期备份。 最短存储时间：低频访问存储的文件有最短存储时间，存储时间短于30天的文件被提前删除或变更时，会产生一定费用。 最小计费大小：低频访问存储文件有最小计费大小，即如果文件大小低于64KiB，会按照64KiB计算收费，文件大于等于64KiB按照实际存储收费。 数据取回：获取低频访问存储文件时会产生数据取回费用。

本节简要介绍操作跟踪。 操作跟踪用于记录OOS账户的管理事件，并将产生的跟踪日志保存到指定的OOS存储桶中。记录的信息包括用户的身份，API调用的开始时间，源IP地址，请求参数以及服务返回的响应元素等。 操作跟踪功能主要包括： 管理事件记录：用户通过操作跟踪功能可以查看近6个月内的管理事件，包括：登录，退出，查看、创建、修改和删除资源。 跟踪日志：当账户中发生一个管理事件时，OOS会根据配置的跟踪参数与事件进行匹配，当与跟踪参数相匹配时，事件会以日志的形式存储到用户配置的存储桶中，即跟踪日志。 基本概念 管理事件：在账户中执行的Bucket操作、统计操作、IAM操作、跟踪操作均属于管理事件。 读事件：读事件为可以查看和获取资源但不进行更改的操作。 写事件：写事件为可以修改资源的操作，包括创建、修改和删除操作。

本节主要介绍PUT Bucket Policy。 在PUT操作的url中加上Policy，可以进行添加或修改Policy的操作。如果Bucket已经存在了Policy，此操作会替换原有Policy。只有根用户和拥有PUT Bucket Policy权限的用户才能执行此操作，否则会返回403 AccessDenied错误。 注意 如果Bucket的属性为私有或者公共读，使用该接口配置允许任何用户可以向该Bucket写文件的策略时，请联系天翼云客服评估审核后开通。 请求语法 PUT /?policy HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue Policy written in JSON 请求的内容是一个包含Policy语句的JSON串，详见Bucket Policy安全策略。 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 请求示例 PUT /?policy HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Sun, 28 Apr 2024 02:02:21 GMT ContentMD5: +nl0RJvKLaXlRhwFXiBLVw ContentType: application/octetstream XAmzContentSha256: c71bbdea6d26f41a56ce0312bfeadffa06718956c925dbc82af5df7bbad6a58f Authorization: SignatureValue Connection: keepalive ContentLength: 465 { "Version":"20121017", "Id":"", "Statement":[ { "Sid":"", "Effect":"Allow", "Principal":{ "CTYUN": "arn:ctyun:iam::32fefj64y54gc:user/test1" }, "Action":"oos:", "Resource":"arn:ctyun:oos:::examplebucket/", "Condition":{ "StringLike":{ "ctyun:Referer":[ " " ] } } } ] }

本节主要介绍IAM用户操作控制台时需具备的权限。 用户身份管理和访问控制（Identity and Access Management，简称IAM）是OOS为用户提供的用户身份与权限管理服务，您可以使用IAM创建、管理用户账号，并对这些账号进行权限分配，方便资源管理。 在OOS控制台，使用访问控制创建的用户为IAM用户，也称子用户。对于IAM用户，拥有相应的权限才可以对控制台进行操作，各项操作需要的权限详见下面各表。 统计 操作 需具备的权限 统计 statistics:GetAccountStatistcsSummary 存储桶管理 操作 需具备的权限 创建存储桶 oos:PutBucket、oos:GetRegions 建议同时赋予的权限：oos:ListAllMyBucket 存储桶列表 oos:ListAllMyBucket 删除存储桶 oos:ListAllMyBucket、oos:DeleteBucket 清空存储桶 oos:ListAllMyBucket、oos:DeleteMultipleObjects 查看/修改存储桶属性 oos:ListAllMyBucket、oos:GetBucketAcl、oos:PutBucket 区域属性 oos:ListAllMyBucket、oos:GetBucketLocation、oos:PutBucket、oos:GetRegions、oos:GetBucketAcl 安全策略 oos:ListAllMyBucket、oos:GetBucketPolicy、oos:PutBucketPolicy、oos:DeleteBucketPolicy 网站管理 oos:ListAllMyBucket、oos:GetBucketWebSite、oos:PutBucketWebSite、oos:DeleteBucketWebSite、oos:GetRegions 日志 oos:ListAllMyBucket、oos:GetBucketLogging、oos:PutBucketLogging 生命周期 oos:ListAllMyBucket、oos:GetLifecycleConfiguration、oos:PutLifecycleConfiguration 跨域设置 oos:ListAllMyBucket、oos:GetBucketCORS、oos:PutBucketCORS 合规保留 oos:ListAllMyBucket、oos:GetBucketObjectLockConfiguration、oos:PutBucketObjectLockConfiguration、oos:DeleteBucketObjectLockConfiguration 清单配置 oos:ListAllMyBucket、oos:PutBucketInventoryConfiguration、oos:GetBucketInventoryConfiguration

本节主要介绍OOS API请求结构。 接入地址 对象存储网络接入地址为：ooscn.ctyunapi.cn。对象存储网络2接入地址为：ooscn2.ctyunapi.cn。香港精品网接入地址为：ooscnhkhqnet.ctyunapi.cn。香港普通网接入地址为：ooscnhknqnet.ctyunapi.cn。 注意 对于对象存储网络、对象存储网络2中的OOS API，如果您的数据存储在某个资源池，建议您直接使用该资源池的Endpoint，详见 通信协议 为了保证通信的安全性，同时支持HTTP和HTTPS。 请求方法 OOS API支持GET、POST、PUT、HEAD、DELETE和OPTION请求方法发送请求。 请求参数 每个请求都需要指定如下信息： 每个操作接口都需要包含的公共请求参数。 操作接口所特有的请求参数。 本节主要描述公共请求参数和请求结果。 说明 在后续提到具体API时，举例中都会有 公共请求头、 公共响应头 ，但是不对其进行描述和解释。 公共请求头 以下是OOS API的公共请求头。 名称 描述 是否必须 ::: BucketName Bucket名称。 除GET Service (List Bucket)、GET Regions外，其他Bucket、Object操作都需要该参数。 是 Authorization 用于身份验证的请求头。Authorization的构造方式请参考安全策略部分，请先确定使用V2还是V4版本的签名方式，再按照对应的计算方式生成Authorization。 是 ContentLength 请求体的长度。 否 ContentMD5 按照RFC 1864，使用base64编码格式生成信息的128位MD5值。此请求头可以用作数据完整性检查，以验证数据是否与客户端发送的数据相同。 否 xamzcontentsha256 当使用V4签名对请求进行身份验证时，此请求头提供请求有效负载的哈希。 V4签名必填。 ContentType 描述请求内容的标准MIME类型。 否 Date 请求的日期和时间，GMT时间。 V2签名可以填写xAmzDate或Date。 xamzdate 请求的日期和时间。日期和时间格式必须遵循ISO 8601标准，并且必须使用“yyyyMMddT HHmmssZ”格式进行格式化。例如，如果日期和时间是“08/01/2018 15：32：41.982700”，则必须首先将其转换为UTC（协调世界时），然后提交为“20180801T083241Z”。 V4签名必填。 Host 请求的域名。 对象存储网络的请求域名为：ooscn.ctyunapi.cn。 对象存储网络2的请求域名为：ooscn2.ctyunapi.cn。 香港精品网的请求域名为：ooscnhkhqnet.ctyunapi.cn。 香港普通网的请求域名为：ooscnhknqnet.ctyunapi.cn。 是 Connection 客户端与OOS服务器之间的连接状态。 取值： keepalive：长连接，请求结束后继续保持连接。 close：短连接，请求结束后关闭连接。 默认值为：keepalive。 否

本节主要介绍在控制台怎么进行OOS域名（Endpoint）切换。 用户可以在OOS控制台对OOS地域（Endpoint）进行切换，根据选择跳转到不同的地域。 可以选择“中国大陆区域”的“对象存储网络”、“对象存储网络2”、其他地域 。 对象存储网络 ：包含分布在全国多个省、市、自治区及直辖市的资源池，这些资源池间的存储桶（Bucket）、对象（Object）、访问密钥（AccessKeyID和SecretAccessKey）信息互通，可以实现全国数据的就近读取和写入。 对象存储网络2：包含分布在全国多个省、市、自治区及直辖市的资源池，这些资源池间的存储桶（Bucket）、文件（Object）、访问密钥（AccessKeyId和SecretAccessKey）信息互通，可以实现全国数据的就近读取和写入。 其他地域 ：存储桶、对象、访问密钥信息是不互通的。