项目 描述 当前位置 文件上传的位置。 存储类型 文件的存储类型： 标准存储：访问时延低、吞吐量高，能够有效支持各种热点类型数据频繁访问。适用于各种音视频服务、图片服务、大型网站、大数据分析等应用的数据存储。标准存储是默认的存储类型。如果上传文件时未指定存储类型，OOS默认使用标准存储。 低频访问存储：适合长期保存不经常访问的数据。对于不经常访问但仍需要实时访问的数据，可以采用低频访问存储，例如各类移动应用、智能设备、企业数据的长期备份。 最短存储时间：低频访问存储的文件有最短存储时间，存储时间短于30天的文件被提前删除或变更时，会产生一定费用。 最小计费大小：低频访问存储文件有最小计费大小，即如果文件大小低于64KiB，会按照64KiB计算收费，文件大于等于64KiB按照实际存储收费。 数据取回：获取低频访问存储文件时会产生数据取回费用。 选择文件 可以通过将目录或文件拖到浮窗上传文件，也可以点击添加文件、添加文件夹按钮上传文件。 上传的文件中如果想移除的，可以勾选对应的文件，点击“移除”按钮，进行文件移除。 说明 在查找框中可以模糊匹配查找上传的文件。 元数据 用户可以编辑上传文件的文件元数据信息，具体元数据信息详见

本节主要介绍怎么在控制台进行文件预览。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以预览对象。 点击文件“操作”列的“预览”按钮，可以预览该文件。 注意 基于安全合规要求，禁止通过OOS默认域名预览后缀为apk、ipa的文件，在Header中包含签名或者通过自定义域名方式下载此类文件不受影响。 预览的文件为图片或网页时，会以附件的形式下载到本地。

名称 描述 是否必须 Action TagUser。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 UserName IAM用户名。 类型：字符串 取值：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 Tags.member.N.Key 用户标签键。 类型：字符串 取值：由1~128个字符组成，字符串符合表达式[p{L}p{Z}p{N}.:/+@]+。 注意 一个用户最多包含10个标签。如果标签总数超过10个，则本次请求失败。 如果新添加的标签键与原有标签重复，新添加的标签会覆盖原有标签值。 是 Tags.member.N.Value 用户标签值。 类型：字符串 取值：由0~256个字符组成。字符串符合表达式[p{L}p{Z}p{N}.:/+@]。 是

请求示例 创建用户名为testuser，标签键为testkey，标签值为testvalue的IAM用户。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190131T012759Z ContentType: application/octetstream ContentLength: 129 ActionCreateUser&Version20100508&UserNametestuser&Tags.member.1.Keytestkey&Tags.member.1.Valuetestvalue 响应示例 HTTP/1.1 200 OK xamzrequestid:3dcc0919e80b422c ContentType:text/xml;charsetUTF8 ContentLength:489 Date:Thu, 31 Jan 2019 01:27:59 GMT Server: CTYUN arn:ctyun:iam::10rc2arpn6306:user/testuser testuser 623387e786314d3f973359c9de61a39d testvalue testkey 20190131T01:28:00Z 3dcc0919e80b422c

项目 描述 Date 统计时间。 StorageClass 存储类型： STANDARD：标准存储。 STANDARDIA：低频访问存储。 BilledStorageUsage 计费容量，单位是Byte。 SampleCapacity 实时值，单位是Byte。 MaxCapacity 峰值，单位是Byte。 AverageCapacity 平均值，单位是Byte。 RemainderChargeStorageUsage 补齐容量之和，包括时长补齐和大小补齐，单位是Byte。 RemainderChargeOfDuration 时长补齐容量，单位是Byte。 RemainderChargeOfSize 大小补齐容量，单位是Byte。

本节主要介绍请求次数的统计信息。 进入“统计”页面，点击“请求次数”，可以查看请求次数及对应返回码统计信息，包括标准存储和低频访问存储的请求次数。 请求次数和返回码次数统计信息描述 项目 描述 时间选择 请求次数和返回码次数查询的时间段，可以选择查看下列时间段的请求次数和返回码次数： 今日。 昨日。 近7日。 近30日。 根据日历按钮，选择查询任意90天请求次数和返回码次数。 时间粒度 请求次数和返回码次数查询的时间粒度，可以选择： 按五分钟查询：统计信息按每5分钟展示，可以选择查询今日、昨日或按日历选择任意1天的数据。 按小时查询：统计信息按每小时展示，可以查询今日、昨日、近7日或按日历选择任意7天内的数据。 按天查询：统计信息按天展示，可以查询今日、昨日、近7日、近30天或按日历按钮选择任意90天内的数据。 数据位置 请求次数和返回码次数查询数据位置，可以选择： 全部数据位置：展示所有数据位置的请求次数之和、返回码次数之和。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的请求次数和返回码次数。 存储桶 请求次数和返回码次数查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的请求次数之和、返回码次数和值。 具体存储桶：根据显示的存储桶，选择查看对应存储桶的请求次数和返回码次数。 请求类型 请求次数和返回码次数的请求类型： 全部请求。 GET。 HEAD。 PUT。 POST。 DELETE。 OTHERS。 存储类型 选择请求次数查询的存储类型： 全部存储类型：分别展示标准存储和低频访问存储的请求次数。 标准类型：标准存储的请求次数。 低频访问存储：低频访问存储的请求次数。 可以点击“下载”按钮，将请求次数和返回码次数的统计信息下载到本地查看。 项目 描述 Date 统计时间。 StorageClass 存储类型。 Requests 请求次数。 Response200 返回码200的次数。 Response204 返回码204的次数。 Response206 返回码206的次数。 Response403 返回码403的次数。 Response404 返回码为404的次数。 Response4XX 除返回码403和404外的其他返回码4xx的次数。

项目 名称 存储桶名称 存储桶的名称。 区域 存储桶所属的区域，包括对象存储网络、对象存储网络2、其他区域，详见 创建时间 存储桶创建的时间。 操作 可以查看修改存储桶的属性，对存储桶进行删除，清空存储桶。 存储桶的属性包括：存储桶属性、区域属性、安全策略、网站、日志、生命周期、跨域设置、合规保留、清单配置。

本节主要介绍DELETE Bucket Policy。 在DELETE操作的url中加上Policy，可以删除指定Bucket的Policy。只有根用户和拥有DELETE Bucket Policy权限的子用户才能执行此操作，否则会返回403 AccessDenied错误。如果Bucket配置了Policy，删除成功，返回200 OK。如果Bucket没有配置Policy，返回204 No Content。 请求语法 DELETE /?policy HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 请求示例 DELETE /?policy HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn ContentMD5: 1B2M2Y8AsgTpgAmY7PhCfg ContentType: application/octetstream XAmzContentSha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 Date: Sun, 28 Apr 2024 06:37:14 GMT Authorization: SignatureValue Connection: keepalive 响应示例 HTTP/1.1 204 No Content xamzrequestid: b10f8d28916049988bfef100f502040ac9cbd5bfc1c3c5c7c9 Date: Sun, 28 Apr 2024 06:37:14 GMT Server: CTYUN

本节主要介绍GetEventSelectors。 此操作用来查看管理事件筛选器的设置信息。 请求参数 名称 描述 是否必须 ::: TrailName 跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾；不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 响应结果 名称 描述 :: EventSelectors.ReadWriteType 管理事件的读写类型： ReadOnly：只读。 WriteOnly：只写。 All：所有管理事件。 TrailARN 跟踪的ARN。 请求示例 查看名称为testcloudtrail的跟踪管理事件筛选器信息。 POST / HTTP/1.1 Host:ooscncloudtrail.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190422T053340Z XAmzTarget:cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.GetEventSelectors ContentType:application/json {"TrailName":"testcloudtrail"} 响应示例 HTTP/1.1 200 OK xamzrequestid:a97ab880f40c4242 ContentType:application/json;charsetUTF8 ContentLength:231 Date:Mon, 22 Apr 2019 05:33:40 GMT Server:CTYUN {"EventSelectors":[{"ReadWriteType":"WriteOnly"}],"TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/testcloudtrail"}

名称 描述 是否必须 Name 跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（ ）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（ ）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 S3BucketName OOS Bucket名称。 否 S3KeyPrefix 指定跟踪日志的名称前缀。 类型：字符串 取值：0~200个字符。 否

本节主要介绍StartLogging。 此操作用来开启跟踪。 说明 使用CreateTrail创建跟踪后，跟踪默认是关闭状态，需要调用StartLogging开启跟踪。 请求参数 名称 描述 是否必须 ::: Name 跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。不能包含相邻句点（.）、下划线（）、短划线（）任意组合。 如不能包含类似点点（..）,点下划线（.）的组合。 是 请求示例 启动名为testcloudtrail的跟踪。 POST / HTTP/1.1 Host:ooscncloudtrail.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190422T054520Z XAmzTarget:cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.StartLogging ContentType:application/json {"Name":"testcloudtrail"} 响应示例 HTTP/1.1 200 OK xamzrequestid:e543b10f6249483c Date:Mon, 22 Apr 2019 05:45:20 GMT Server:CTYUN

响应示例 HTTP/1.1 200 OK xamzrequestid:771c9193addb4861 ContentType:application/json;charsetUTF8 ContentLength:231 Date:Mon, 22 Apr 2019 03:28:47 GMT Server:CTYUN {"EventSelectors":[{"ReadWriteType":"WriteOnly"}],"TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/testcloudtrail"}

项目 勾选用户自主管理密码 不勾选用户自主管理密码 限制用户登录，允许用户重置密码 任何时候，IAM用户都可以自己修改密码。 只能密码过期后，允许IAM修改一次密码。 限制用户登录，不允许用户重置密码 任何时候，控制台用户无法修改密码，可以通过API进行修改。 IAM用户任何时候都不能自行修改密码。

IfExists条件运算符 IfExists：如果请求的内容中存在关键字，则依照策略所述的条件来处理关键字。如果该关键字不存在，则条件元素的计算结果将为true。 目前仅Bool型和数字类型的运算符支持使用IfExists条件运算符，表达形式：运算符IfExists，例如BoolIfExists、NumericEqualsIfExists。对于…IfExists的使用见示例1和示例2。 示例1 拒绝没有使用MFA认证的控制台请求，不拒绝使用MFA认证的控制台请求和使用密钥的API请求。但如果允许使用MFA认证的控制台请求和使用密钥的API请求，需要再写显性允许语句。 "Effect" : "Deny", "Condition" : { "Bool" : { "ctyun:MultiFactorAuthPresent" : false } } 拒绝没有使用MFA认证的控制台请求及使用密钥的API请求，不拒绝MFA认证的控制台请求。但如果允许MFA认证的控制台请求，需要再写显性允许语句。 "Effect" : "Deny", "Condition" : { "BoolIfExists" : { "ctyun:MultiFactorAuthPresent" : false } } 示例2 允许使用MFA认证在1800秒内的请求及使用密钥的API请求。 "Effect" : "Allow", "Condition" : { " NumericLessThanEqualsIfExists" : { "ctyun:MultiFactorAuthAge " : 1800 } } 允许使用MFA认证在1800秒内的请求，但不允许MFA认证超过1800秒以上及没有使用MFA的请求（包括API请求）。 "Effect" : "Allow", "Condition" : { " NumericLessThanEquals" : { "ctyun:MultiFactorAuthAge " : 1800 } }

响应示例 HTTP/1.1 200 OK xamzrequestid:570a1b70a73f4b3c ContentType:application/json;charsetUTF8 ContentLength:325 Date:Fri, 19 Apr 2019 07:33:39 GMT Server:CTYUN {"trailList":[{"Name":"testcloudtrail","S3BucketName":"examplebucket","TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/testcloudtrail"}]}

本节主要介绍GetTrailStatus。 此操作用来获取跟踪状态信息。 请求参数 名称 描述 是否必须 ::: Name 指定跟踪的名称。 类型：字符串。 取值：3~128个字符。 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 响应结果 名称 描述 :: IsLogging 是否开启跟踪： true：已经开启跟踪。 false：未开启跟踪。 LatestDeliveryTime 跟踪最近一次向Bucket保存日志的时间。 说明 如果没有开启过跟踪，则不会返回此字段。 StartLoggingTime 最后一次跟踪的起始时间。unix时间戳（UTC），时间精确到毫秒。 说明 如果没有开启过跟踪，则不会返回此字段。 StopLoggingTime 最后一次跟踪的停止时间。unix时间戳（UTC），时间精确到毫秒。 说明 如果没有开启过跟踪，则不会返回此字段。 LatestDeliveryError 最近一次向Bucket保存日志时遇到的错误。如果没有错误，不返回此项。 当目标Bucket不存在时，返回：NoSuchBucket。 当目标Bucket已无权访问，返回：AccessDenied。

本节主要介绍统计的错误码。 响应码 错误码(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。

本节主要介绍操作跟踪API请求结构。 接入地址 对象存储网络：ooscncloudtrail.ctyunapi.cn，对象存储网络2：ooscn2cloudtrail.ctyunapi.cn，香港精品网和香港普通网：ooscnhkcloudtrail.ctyunapi.cn。 通信协议 为了保证通信的安全性，操作跟踪仅支持HTTPS。 HTTP请求方法 操作跟踪支持HTTP POST请求方法发送请求。 请求参数 每个请求都需要指定如下信息： 每个操作接口都需要包含的公共请求参数。 操作接口所特有的请求参数。 本节主要描述公共请求参数和请求结果。 说明 在后续提到具体操作跟踪API时，举例中都会有公共请求头 、 公共响应头 ，但是不对其进行描述和解释。 公共请求头 在每个请求中，都需要携带公共参数和对应的接口参数。公共请求参数如表所示： 名称 描述 是否必须 ::: 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 指定跟踪的名称。 类型：字符串 取值：3~128个字符： 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（ ）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（ ）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 S3BucketName 指定OOS Bucket名称。 是 S3KeyPrefix 指定跟踪日志的名称前缀。 指定日志前缀的存储路径为： BucketName /<日志的名称前缀>/OOSLogs/<账号ID>/CloudTrail/<年>/<月>/<日>/<日志数据文件>。 未指定日志前缀的存储路径为： BucketName /OOSLogs/<账号ID>/CloudTrail/<年>/<月>/<日>/<日志数据文件>。 类型：字符串 取值：0~200个字符。 否

签名过程 下图说明了签名计算过程。 下表描述了图中显示的功能。用户需要为这些功能实现代码。 功能 描述 :: Lowercase() 将字符串转换为小写。 Hex() 小写十六进制编码。 SHA256Hash() 安全散列算法（SHA）加密散列函数。 HMACSHA256() 使用提供的签名密钥的SHA256算法计算HMAC。这是最终的签名。 Trim() 删除任何前导或尾随空格。 UriEncode() URI编码每个字节。UriEncode（）必须强制执行以下规则： URI编码除了下面字符之外的每个字节：'A' 'Z'，'a' 'z'，'0' '9'，' '，'.'，''和'〜'。 空格字符是保留字符，必须编码为“％20”（而不是“+”）。 每个URI编码字节由'％'和两位十六进制值组成。 十六进制值中的字母必须为大写，例如“％1A”。 除了文件名之外，对正斜杠字符'/'进行编码。例如，如果文件名称为photos/Jan/sample.jpg，则不对键名称中的正斜杠进行编码。 说明 建议您编写自己的自定义UriEncode函数，以确保您的编码可以正常工作。 以下是Java中的示例UriEncode（）函数。 public static String UriEncode(CharSequence input, boolean encodeSlash) { StringBuilder result new StringBuilder(); for (int i 0; i 'A' && ch 'a' && ch '0' && ch < '9') ch '' ch '' ch '~' ch '.') { result.append(ch); } else if (ch '/') { result.append(encodeSlash ? "%2F" : ch); } else { result.append(toHexUTF8(ch)); } } return result.toString(); } 使用参数的签名过程与使用请求头的签名过程类似，如下所示： 由于创建预签名URL的时候，并不知道有效负载的内容，所以设置常量UNSIGNEDPAYLOAD。 规范查询字符串（Canonical Query String）必须包括除了XAmzSignature之外的所有上述查询字符串。 规范标头必须包括HTTP Host标头。如果用户想包含xamz请求头，这些标头都将参与签名计算。用户可以选择其他的请求头是否参与签名计算。安全起见，尽可能多的请求头参与签名计算。

本节主要介绍V4签名步骤。 客户端按照如下步骤创建签名： 1. 创建规范请求。 2. 使用规范请求和其他信息创建待签名的字符串。 3. 使用SecretAccessKey派生签名密钥。然后将该签名密钥与在上一步中创建的字符串结合使用来创建签名。 4. 将生成的签名添加到HTTP请求头中或者作为参数添加到URL中。 OOS服务收到请求后，将执行相同步骤来计算请求中发送的签名。之后，OOS会将计算得到的签名与用户在请求中发送的签名进行比较。如果签名匹配，则处理请求。如果签名不匹配，则拒绝请求。

本节主要介绍跟踪列表。 进入“操作跟踪”>“跟踪列表”页面，可以查看目前账户下的所有跟踪信息，包括： 跟踪名称、日志所在存储桶、日志文件前缀、状态、操作 。 创建跟踪 可以按照下列步骤进行创建跟踪： 1. 在“管理事件记录”页面点击“创建跟踪”，或在“跟踪列表”页面点击“创建”，进入“创建跟踪”页面。 2. 根据提示创建跟踪： 设置基本信息： 填写跟踪名称 ，跟踪名称的规则如下： 3~128位字符串。 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（. ）的组合。 设置管理事件 ：可以将管理事件设置为下面三种类型中的一种： 所有操作：包括读操作和写操作。 读操作。 写操作。 设置存储位置 ：设置跟踪日志存储的存储位置、日志前缀和跟踪状态 。 项目 描述 :: 存储位置 操作跟踪事件存储的位置。 可以存储到现有存储桶（用户需要有对应的存储桶权限），也可以在账户中新建存储桶（用户需要有新建存储桶的权限），并将跟踪日志存储至新建的存储桶。 日志前缀 操作跟踪存储日志的前缀，0200个字符串。 指定日志前缀的存储路径为：BucketName / /OOSLogs/ /CloudTrail/ / / / 。 未指定日志前缀的存储路径为：BucketName /OOSLogs/ /CloudTrail/ / / / 。 跟踪状态 创建的跟踪状态： ON：表示跟踪日志开启。 OFF：表示跟踪日志未开启。

本节主要介绍怎么快速创建子用户。 进入“访问控制”>“概览”，点击“创建用户”，进入“创建用户”页面，启动创建用户。可以按照下列步骤创建子用户： 1. 设置用户 ：根据页面提示添加用户名，可以添加一个或多个用户，并为新创建的用户设置访问方式。 2. 设置权限 （可选）：为用户添加权限，有三种添加权限的方式（只能选择一种）： 将用户添加到组 （前提：已经有用户组）：用户将继承该用户组的所有权限。 从现有用户复制 （前提：现有用户有通过直接附加的方式被授权的策略），每次只能复制一个用户的权限。只能复制现有用户直接附加的策略，不能复制用户所在组的策略。 附加现有策略 。 3. 设置标签（可选） ：可以为新建用户添加标签键和标签值。每个用户最多可添加10个标签。 4. 信息审核 ：对新建用户的信息进行审核，如果需要更改，可以在此页面点击对应的编辑标识，然后到对应的页面进行修改。 5. 完成 ：可以在完成页面查看用户名、访问密钥、用户登录密码。也可以通过“下载凭证 ”，查看用户名、访问密钥、密码、子用户登录链接。 注意 凭证信息仅可下载一次，页面跳转后无法再次获取，请妥善保存相关访问密钥ID及私有密钥。

本节主要介绍IAM用户绑定MFA。 对于IAM用户，点击“访问控制”>“安全凭证”>“MFA”，可以绑定MFA。 注意 MFA认证仅IAM用户支持，但是如果没有授权使用MFA认证，则IAM用户无法进行MFA认证。 点击“绑定”，进行MFA绑定，步骤如下： 1. 安装应用 在手机端下载安装基于时间的一次性密码（TOTP）口令认证工具。 2. 绑定MFA 可以使用扫码获取和手动获取两种方式获取验证码。 注意 输入的“第一组验证码”和“第二组验证码”必须是连续的。 3. 完成 注意 如果您后续不再使用 MFA ，并希望卸载已安装的动态口令工具，请先解绑已绑定的MFA设备。如果您在未解绑MFA的情况下卸载动态口令工具，可能会造成相关用户不可用，请慎重操作。

本节主要介绍统计API概览。 API 描述 GetCapacity 此操作用来查询用户的容量。 GetBilledStorageUsage 此操作用来查询收费容量。 GetRestoreCapacity 此操作用来查询数据取回量。 GetDeleteCapacity 此操作用来查询用户删除的容量。 GetTraffics 此操作用来查询用户的流量。 GetRequests 此操作用来查询用户请求次数。 GetReturnCode 此操作用来查询用户请求返回码次数。 GetConcurrentConnection 此操作用来查询用户的并发连接数。 GetUsage 此操作用来查询用户Bucket的使用情况。 GetBandwidth 此操作用来查询用户的已用带宽。 说明 对象存储网络、对象存储网络2和香港节点是相互独立的。如果使用的是对象存储网络的Host，只能查询对象存储网络内的Region的统计信息。如果使用的是对象存储网络2的Host，只能查询对象存储网络2内的Region的统计信息。如果是香港节点的Host，只能查询香港节点内的Region统计信息。 本节举例中的域名均以对象存储网络的统计API域名ooscnmg.ctyunapi.cn为例。如果是对象存储网络2，请使用域名ooscn2mg.ctyunapi.cn。如果是香港精品网和香港普通网，请使用域名ooscnhkmg.ctyunapi.cn。 不建议使用GetUsage和 GetBandwidth，建议根据要查询的项，使用下列API：GetCapacity、GetDeleteCapcity、GetRequests、GetReturnCode、GetConcurrentConnection。

限速配置 基于IP的限速配置 当WAF与客户端之间并无代理设备时，通过源IP来检测攻击行为较为精确，建议直接使用IP限速的方式进行访问频率限制。 基于session的频率限制 当黑客控制多台肉鸡，模仿普通访问者，共用同一IP，或通过代理频繁更换源IP持续向站点发起请求，通过IP进行频率限制无法准确识别恶意访问源。因此建议通过配置session，通过会话区分单个访问者，实现更细粒度的限速。 SESSION配置项： SESSION位置：可选则GET、POST、COOKIE、HEADER。 SEESION标识：取值标识，通过配置唯一可识别Web访问者的某属性变量名（Key），系统将根据此标识匹配到的内容识别访问者。

策略名 描述 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相关操作。

名称 描述 是否必须 Origin 标示访问OOS的跨域请求的源。 例如： 类型：字符串。 是 AccessControlRequestMethod 标示在实际请求中，将被用到的HTTP方法。 类型：字符串。 是 AccessControlRequestHeaders 在实际请求中将被发送的HTTP请求头，用逗号分隔。 类型：字符串。 否

本节主要介绍断点续传。 通过MultipleUpload类以及文件上传请求UploadFileRequest类，实现基于分段上传的断点续传的功能。 参数设置 名称 描述 :: EnableCheckpoint 是否开启断点续传功能。 取值： true：开启。 false：关闭。 默认值为false。 PartSize 每个分段的大小partSize，若partSize小于5MiB，则会将partSize调整至5MiB。 默认：5MiB。 UploadFile 上传的本地文件路径。 checkpointFile 记录本地分片上传结果的文件。如果未指定checkpointFile，默认为uploadFile.ucp，与上传的本地文件同路径。 objectMetadata 文件的元数据。 ProgressListener 上传状态监听器。 TaskNum 分片上传并发线程数，默认为1，最多为1000。 用checkpointFile来记录所有分片的状态。上传过程中的进度信息会保存在该文件中，如果某一分片上传失败，再次上传时会根据文件中记录的点继续上传。上传完成后，该文件会被删除。checkpointfile默认与待上传的本地文件同目录，为uploadFile.ucp。 Java上传代码示例 public static void multiUpload(AmazonS3 ossClient) { try { String bucketName "examplebucket"; String key "objecttest1.pdf" ; String uploadFile "D:tmp2.txt"; // 通过UploadFileRequest设置多个参数 UploadFileRequest request new UploadFileRequest(bucketName, key); // 上传的本地文件 request.setUploadFile(uploadFile); // 分片上传并发线程数，默认为1，最多为1000 request.setTaskNum(2); /每个分片的大小，默认5MiB，若partSize小于5MiB，除了最后一个分片以外，会将partSize调整至5MiB / request.setPartSize(5 1024 1024); // 开启断点续传功能，默认关闭 request.setEnableCheckpoint(true); /记录本地分片上传结果的文件。开启断点续传功能时需要设置此参数，上传过程中的进度信息会保存在该文件中，如果某一分片上传失败，再次上传时会根据文件中记录的点继续上传。/ // 上传完成后，该文件会被删除。默认与待上传的本地文件同目录，为uploadFile.ucp // request.setCheckpointFile(" "); MultipleUpload multiUpload new MultipleUpload(request, ossClient); // 断点续传上传 CompleteMultipartUploadResult result multiUpload.upload(); //System.out.println("location: "+result.getLocation()); System.out.println("Upload complete. Upload object name:" + result.getKey()); } catch (AmazonServiceException ase) { System.out.println("Caught an AmazonServiceException, which means your request made it " + "to OOS, but was rejected with an error response for some reason."); System.out.println("Error Message: " + ase.getMessage()); System.out.println("HTTP Status Code: " + ase.getStatusCode()); System.out.println("OOS Error Code: " + ase.getErrorCode()); System.out.println("Request ID: " + ase.getRequestId()); } catch (AmazonClientException ace) { System.out.println("Caught an AmazonClientException, which means the client encountered " "a serious internal problem while trying to communicate with OOS, " "such as not being able to access the network."); System.out.println("Error Message: " + ace.getMessage()); } }

名称 描述 是否必须 ContentMD5 Base64编码，128位的MD5，这个请求头必须被使用，以保证数据在传输过程中没有被篡改。参考RFC1864。 类型：字符串。 是 ContentLength 请求体的长度。 类型：字符串。 取值：大于等于0，小于等于2 1024 1024的整数。 是

响应结果 名称 描述 :: ContentLength 响应体的长度。只有客户端携带Expect: 102processing请求头，才会返回该响应头。 CopyPartResult 包含整个响应的容器。 类型：容器。 子节点：LastModified、ETag。 LastModified 分片的最后修改时间。 类型：字符串。 父节点：CopyPartResult。 ETag 新分片的ETag。 类型：字符串。 父节点：CopyPartResult。 请求示例 通过从源Object中指定范围，拷贝生成一个新片段。 PUT /newobject?partNumber2&uploadId738428231343369398 HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Mon, 11 Apr 2011 20:34:56 GMT xamzcopysource: /sourcebucket/sourceobject xamzcopysourcerange:bytes5006291456 Authorization: SignatureValue 响应示例 HTTP/1.1 200 OK xamzrequestid: fd02454b7a5143db239689988d9a9ca261636b57595b5d5f61 Date: Mon, 11 Apr 2011 20:34:56 GMT Server: CTYUN 20091028T22:32:00 9b2cf535f27731c974343645a3985328

名称 描述 ListPartsResult 包含整个响应的容器。 类型：容器。 子节点：Bucket、EncodingType、Key、UploadId、Initiator、Owner、StorageClass、PartNumberMarker、NextPartNumberMarker、MaxParts、IsTruncated、Part。 Bucket 分片上传对应的bucket名称。 类型：字符串。 父节点：ListPartsResult。 EncodingType Key的编码类型。 类型：字符串。 父节点：ListPartsResult。 Key 新创建的文件的Key。 类型：字符串。 父节点：ListPartsResult。 UploadId 分片上传ID。 类型：字符串。 父节点：ListPartsResult。 Initiator 指定执行此次分片上传过程的用户账户。 类型：容器。 父节点：ListPartsResult。 子节点：ID、DisplayName。 ID OOS账户的ID。 类型：字符串。 父节点：Initiator。 DisplayName OOS账户的账户名。 类型：字符串。 父节点：Initiator。 StorageClass 文件的存储类型： STANDARD：标准存储。 STANDARDIA：低频访问存储。 类型：字符串。 父节点：ListPartsResult。 PartNumberMarker 列表起始位置的片段的分片号。 类型：整型。 父节点：ListPartsResult。 NextPartNumberMarker 当此次请求没有将所有片段列举完时，此元素指定列表中的最后一个片段的分片号。此分片号用于作为下一次连续列表请求的partnumbermarker参数的值。 类型：整型。 父节点：ListPartsResult。 MaxParts 响应中片段的最大数目。 类型：整型。 父节点：ListPartsResult。 IsTruncated 标识此次分片上传过程中的所有片段是否全部被列出，如果为true则表示没有全部列出。如果分片上传过程的片段数超过了MaxParts元素指定的最大数，则会导致一次列表请求无法将所有片段数列出。 类型：Boolean。 父节点：ListPartsResult。 Part 与某个片段对应的容器，响应中可能包含0个或多个Part元素。 类型：容器。 父节点：ListPartsResult。 子节点：PartNumber、LastModified、ETag、Size。 PartNumber 标识片段的分片号。 类型：整型。 父节点：Part。 LastModified 片段上传完成的日期。 类型：Date。 父节点：Part。 ETag 片段上传完成时返回的ETag值。 类型：字符串。 父节点：Part。 Size 片段的数据大小。 类型：整型。 父节点：Part。