Resource Resource是指Policy覆盖的文件或文件集合，可以使用通配符和？。 当Action中有桶级别权限时（如oos:ListBucket），Resource需配置到具体Bucket名称，如"Resource":"arn:ctyun:oos:::examplebucket"。 当Action中有文件级别权限时（如oos:GetObject），Resource需配置到具体Bucket下的文件，如"Resource":"arn:ctyun:oos:::examplebucket/objectname"、"Resource":"arn:ctyun:oos:::examplebucket/"。 例如要使Policy对于所有以image开头的Object生效，可以这样配置： "Resource":"arn:ctyun:oos:::examplebucket/image" Condition Condition是Statement中最复杂的一个元素，我们把它称之为condition块，虽然只有一个condition元素，但是它可以包含多个conditions，而且每个condition可以包含多个keyvalue对。如下图所示，condition块中的各个condition之间是逻辑与关系，condition key之间也是逻辑与关系，各个value之间是逻辑或关系。 条件运算符 条件运算符是条件的“动词”形式，可指定OOS执行的比较类型。条件运算符可分为以下类别：String Conditions、布尔值条件运算符、IP Address Conditions。 String Conditions String conditions可以允许设置string的匹配规则。 Condition 描述 StringEquals 精准匹配指定的值，区分大小写。 StringNotEquals 与指定的值不匹配，区分大小写。 StringEqualsIgnoreCase 与指定的值精准匹配，不区分大小写。 StringNotEqualsIgnoreCase 与指定的值不匹配，不区分大小写。 StringLike 与指定的值精准匹配。或通过填充通配符，与指定的值相似，可以包括多字符匹配的通配符 ()或单字符匹配的通配符 (?)。区分大小写。 StringNotLike 与指定的值不匹配，区分大小写的无效匹配。或通过填充通配符，与指定的值也不匹配。 例如，要匹配HTTP Referer头是以“ "StringLike":{ "ctyun:Referer":[ " ] }

本节主要介绍CreateAccessKey。 此操作用来为指定的IAM用户创建新的AccessKey。 说明 新密钥的默认状态是Active。 如果未指明IAM用户名，则为请求者创建新的AccessKey。 请求参数 名称 描述 是否必须 ::: Action CreateAccessKey。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 否 响应结果 名称 描述 :: UserName IAM用户名。 AccessKeyId 访问密钥的ID。 Status 访问密钥的状态： Active：密钥启用，可以使用该密钥调用API。 Inactive：密钥禁用，不可以使用该密钥调用API。 SecretAccessKey 用于签名请求的密钥。 CreateDate 密钥的创建时间。 请求示例 为用户名为testuser2的用户创建AccessKey。 POST / HTTP/1.1 Host:ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190131T091759Z ContentType: application/octetstream ActionCreateAccessKey&UserNametestuser2&Version20100508 响应示例 HTTP/1.1 200 OK xamzrequestid:865ffbe722704365 ContentType:text/xml;charsetUTF8 ContentLength:603 Date:Thu, 31 Jan 2019 09:17:59 GMT Server: CTYUN 535d97103885f22be7a1 9e2cde278d6eeac48f50a5d276381379478c0169 testuser2 20190131T09:18:00Z Active 865ffbe722704365

简要介绍Bucket Policy。 Bucket Policy用于定义OOS资源的访问权限。Bucket Policy可以用于： 允许/拒绝Bucket级别的权限。 允许/拒绝Object级别的权限。 Policy本身是一个JSON字符串，限制在20KiB。一个Bucket Policy包括： 可选的Bucket Policy基本信息。 一个或多个独立的statements。 每个statement包括一个权限的核心信息。如果一个Bucket Policy包括多个statements，那么statements之间是逻辑或关系。 注意 ：如果多个statement之间有重叠或者冲突，那么含deny语句优先级最高。

本节主要介绍ListUserTags。 此操作用来列出指定IAM用户的标签。 请求参数 名称 描述 是否必须 ::: Action ListUserTags。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 查询用户的用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 Marker 分页标识。还有需要返回的标签时，上条响应结果中会返回该参数。查看未显示标签时，请求参数中需要携带此参数。 类型 ：字符串 取值 ：与上条响应中返回的结果值相同。 否 MaxItems 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示需要再次发送请求查看未显示的项。查看未显示的项时，需要携带响应参数Marker的值。 类型 ：整型 取值 ：1~1000，默认值为100。 否 响应结果 名称 描述 :: IsTruncated 标签是否已经都返回： true：有未返回的标签。 false：已经返回所有的标签。 Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。 Tags.member.Key 标签键。 Tags.member.Value 标签值。

名称 描述 是否必须 Action ListUsers。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 Marker 分页标识。还有需要返回的用户时，上条响应结果中会返回该参数。查看未显示项时，请求参数中需要携带此参数。 类型 ：字符串 取值 ：与上条响应中返回的结果值相同。 否 MaxItems 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示需要再次发送请求查看未显示的项。查看未显示的项时，需要携带响应参数Marker的值。 类型 ：整型 取值 ：1~1000，默认值为100。 否 UserName 查询IAM用户的用户名，进行模糊匹配搜索。如果请求参数中同时出现UserName、AccessKeyId，查询的结果需要同时满足这两个条件。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 否 AccessKeyId 按指定的AccessKeyId，进行模糊匹配搜索。 UserName、AccessKeyId共用时，查询出同时满足多个查询条件的结果。 否

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

名称 描述 是否必须 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}.:/+@]。 是

请求示例1 下面的生命周期只包含一个规则，这个规则指定所有以logs/为前缀的文件将在创建后的30天过期。因为生命周期规则的状态是Enabled，OOS会每隔一段时间来评估这个规则，删除过期的文件。 PUT /?lifecycle HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Tue, 13 Dec 2011 17:54:50 GMT ContentMD5: 8dYiLewFWZyGgV2Q5FNI4W ContentLength: 207 Authorization: SignatureValue deletelogsin30daysrule logs Enabled 30 响应示例1 HTTP/1.1 200 OK xamzrequestid: 8911108cf1b04a9234a79aa99eabadb3727478686a6c6e7072 Date: Tue, 13 Dec 2011 19:14:41 GMT Server: CTYUN 请求示例2 指定存储文件在创建10天后转换为低频访问存储，创建20天后删除。 PUT /?lifecycle HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Mon, 29 Jul 2019 05:08:31 GMT ContentType: application/xml ContentMD5: ouPJihB832ZHNLZNyl2Ccw ContentLength: 175 Authorization: SignatureValue logs Enabled 10 STANDARDIA 20 响应示例2 HTTP/1.1 200 OK xamzrequestid: 08979294ca514b044ec1b4c3b8c5c7cd8c8e91828486888a8c Date: Mon, 29 Jul 2019 05:10:33 GMT Server: CTYUN

本节主要介绍PUT Bucket Website。 此操作用来配置网站托管属性。如果Bucket已经存在了website，此操作会替换原有website。只有根用户和拥有PUT Bucket Website权限的子用户才能执行此操作。 注意 如果配置静态网站托管后，当匿名用户直接访问Bucket的域名，会将静态网站文件下载到本地。如果要实现访问静态网站时是预览网站内容，而非下载静态网站文件，静态网站域名须是Bucket绑定的已备案自定义域名，为Bucket绑定自定义域名请联系天翼云客服申请。 OOS自有网站托管域名不支持HTTPS访问，用户自定义域名支持HTTPS访问。如果需要支持通过HTTPS访问，请联系天翼云客服，提供域名证书，证书支持格式：crt+key或者PEM，请确保提供的证书在有效期内，建议证书有效期至少1年及以上，避免使用免费证书。 设置Bucket的网络配置请求消息体的上限是10KiB。 尽量避免目标Bucket名中带有“.”，否则通过HTTPS访问时可能出现客户端校验证书出错。 网站托管配置步骤如下： 1. 创建一个公共读属性的存储桶（Bucket）。 2. 向天翼云客服提交工单，申请客户自定义域名添加白名单。 3. 在域名管理中添加别名。 如果不使用CDN加速，将Bucket的CNAME Record Value（BuckeNname.ooswebsitecn.oosxx.ctyunapi.cn）作为别名添加到域名管理系统中。 如果使用CDN加速，将CDN厂商提供的别名添加到域名管理系统中，然后在CDN回源地址中配置OOS侧的CNAME Record Value，并将回源host配置为您的自定义域名（如yourdomain.com）。 说明 创建Bucket时显示的Endpoint为ooscn.ctyunapi.cn，该Endpoint是针对整个对象存储网络的域名，该域名在解析时，会根据用户地理位置的不同解析到不同的资源池地址。如果创建Bucket时有多个数据位置，系统默认选取创建时第一个有效数据位置作为CNAME Record Value（BucketName.ooswebsitecn.oosxx.ctyunapi.cn）。CNAME Record Value可以通过控制台Bucket属性中的网站查看。如果创建Bucket时，只有一个数据位置可用，则在Bucket区域中展示的CNAME Record Value为BucketName.ooswebsitecn.ooscn.ctyunapi.cn。所以如果使用静态网站托管，建议您根据Bucket区域属性中的数据位置，选择您想使用的数据位置的CNAME Record Value作为域名管理系统中的别名。例如您创建Bucket时有效数据位置为沈阳、兰州、成都、贵阳，则Bucket中展示的CNAME Record Value为BucketName.ooswebsitecn.ooslnsy.ctyunapi.cn，您可以将BucketName.ooswebsitecn.ooslnsy.ctyunapi.cn作为别名，也可以将兰州、成都或者贵阳为域名的CNAME Record Value作为您的别名。 4. 上传文件。 将网站的所有文件（html、CSS、js、图片等）上传到之前创建的Bucket中， 注意要保持文件之间的相对路径。 5. 配置Bucket网站属性：可以通过控制台或者调用本接口配置。

名称 描述 Arn IAM用户的资源名称。 UserName IAM用户的名称。 UserId IAM用户ID。 Tags.member.Key IAM用户标签键。 Tags.member.Value IAM用户标签值。 CreateDate IAM用户创建时间。

项目 容量 时间选择 容量查询的时间段，可以选择查看下列时间段的容量： 今日。 昨日。 近7日。 近30日。 根据日历按钮，选择查询任意90天内容量。 时间粒度 容量查询的时间粒度，可以选择： 按五分钟查询：统计信息按每5分钟展示，可以选择查询今日、昨日或按日历选择任意1天的数据。 按小时查询：统计信息按每小时展示，可以查询今日、昨日、近7日或按日历选择任意7天内的数据。 按天查询：统计信息按天展示，可以查询今日、昨日、近7日、近30天或按日历按钮选择任意90天内的数据。 数据位置 容量查询的数据位置，可以选择： 全部数据位置：展示所有数据位置的容量和值。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的容量。 存储桶 容量查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的容量之和。 具体存储桶：根据显示的存储桶，选择查看对应存储桶的容量。 取值类型 选择容量查询的数值类型： 平均值：选择时间段的容量平均值，只能按小时查询或按天查询。 实时值：选择时间段的容量实时值，可以选择按五分钟查询、按小时查询或按天查询。 峰值：选择时间段的容量峰值，只能按小时查询或按天查询。 存储类型 选择容量查询的存储类型： 全部存储类型：分别展示标准存储和低频访问存储的容量。 标准类型：标准存储的容量。 低频访问存储：低频访问存储的容量。

项目 描述 时间选择 请求次数和返回码次数查询的时间段，可以选择查看下列时间段的请求次数和返回码次数： 今日。 昨日。 近7日。 近30日。 根据日历按钮，选择查询任意90天请求次数和返回码次数。 时间粒度 请求次数和返回码次数查询的时间粒度，可以选择： 按五分钟查询：统计信息按每5分钟展示，可以选择查询今日、昨日或按日历选择任意1天的数据。 按小时查询：统计信息按每小时展示，可以查询今日、昨日、近7日或按日历选择任意7天内的数据。 按天查询：统计信息按天展示，可以查询今日、昨日、近7日、近30天或按日历按钮选择任意90天内的数据。 数据位置 请求次数和返回码次数查询数据位置，可以选择： 全部数据位置：展示所有数据位置的请求次数之和、返回码次数之和。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的请求次数和返回码次数。 存储桶 请求次数和返回码次数查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的请求次数之和、返回码次数和值。 具体存储桶：根据显示的存储桶，选择查看对应存储桶的请求次数和返回码次数。 请求类型 请求次数和返回码次数的请求类型： 全部请求。 GET。 HEAD。 PUT。 POST。 DELETE。 OTHERS。 存储类型 选择请求次数查询的存储类型： 全部存储类型：分别展示标准存储和低频访问存储的请求次数。 标准类型：标准存储的请求次数。 低频访问存储：低频访问存储的请求次数。

合规保留 OOS支持WORM（Write Once Read Many）特性，允许用户以“不可删除、不可篡改”方式保存和使用数据。当开启合规保留策略后，您可以在存储桶中上传和读取文件（Object），但是在Object的保留时间到期之前，任何用户都无法删除Object和策略。Object的保留时间到期后，才可以删除Object。 注意 合规保留一旦开启，不能关闭，不能缩短合规保留时长，但可以延长合规保留时长。 合规保留的时间精确到秒，例如对Bucket A设置合规保留时长为10天，文件A1属于Bucket A，A1的最后更新时间为201931 12:00:00，该文件会在2019311 12:00:01过合规保留期。 任何用户（包括根用户）都不能修改、覆盖、删除处于合规保留期的文件。 处于合规保留期的文件，无法通过调用API、控制台修改文件的存储类型，只能通过设置的生命周期规则修改存储类型。 文件处于合规保留期：如果生命周期规则为修改文件存储类型，则生命周期规则可以生效；如果生命周期规则为到期删除文件，则文件必须过了合规保留期后，生命周期规则才能生效。在客户销户、欠费超期情况下，合规保留未到期数据会被删除而不做保留。 清单配置 通过OOS Bucket清单功能可以获取Bucket中指定文件（Object）的大小、存储类型等信息。相对于GET Bucket (List Objects)接口，Bucket清单可以按每天或者每周以CSV的形式输出指定文件的相关信息，且不会影响Bucket的请求速率。在需要列举海量Object的场景中，推荐使用Bucket清单功能。

本节主要介绍存储桶列表。 在“存储桶列表”页可以查看存储桶信息，包括存储桶名称、区域、创建时间。 用户可以根据需求，在右上角的搜索框内输入需要查询的存储桶名称进行查询，支持模糊查询。 项目 名称 存储桶名称 存储桶的名称。 区域 存储桶所属的区域，包括对象存储网络、对象存储网络2、其他区域，详见域名（Endpoint）列表。 创建时间 存储桶创建的时间。 操作 可以查看修改存储桶的属性，对存储桶进行删除，清空存储桶。 存储桶的属性包括：存储桶属性、区域属性、安全策略、网站、日志、生命周期、跨域设置、合规保留、清单配置。

本节主要介绍怎么清空存储桶。 在“存储桶列表”页，点击存储桶“操作”列的“清空存储桶”按钮，可以清空该存储桶数据。 注意 清空存储桶将永久删除存储桶中的所有文件，已删除的文件无法恢复。在执行清空存储桶过程中，可通过关闭任务方式进行终止，但是已经发送的任务无法终止。 执行清空存储桶时，添加文件到存储桶，文件可能会被删除。 为了防止在执行清空存储桶时将新文件添加到此存储桶，建议您更新存储桶策略，禁止将文件添加到存储桶。 如果存储桶包含大量文件，建议您创建生命周期规则来删除存储桶中的文件。 当点击“清空存储桶”后，弹出“清空存储桶确认”弹窗，填入存储桶名称后，才可以清空存储桶数据。 清空过程中，刷新或者关闭页面可能导致无法完全清空存储桶。

本节主要介绍存储桶的生命周期规则。 在“存储桶列表”页面点击“属性”>“生命周期”，进入“生命周期”页面。在该页面，用户可以配置生命周期规则。 通过设置存储桶（Bucket）的生命周期规则，可以： 删除与生命周期规则匹配的文件。当文件的生命周期到期时，OOS会异步删除它们。生命周期中配置的到期时间和实际删除时间之间可能会有一段延迟。文件到期被删除后，用户将不需要为到期的文件付费。OOS删除到期文件后，会在Bucket log中记录一条日志，操作项是"OOS.EXPIRE.OBJECT"。 注意 如果文件的生命周期规则设置的是到期后删除，文件到期后将被永久删除，无法恢复。 将与生命周期规则匹配的文件由标准存储转换为低频访问存储，可以根据需要设置生命周期规则从文件最后一次修改生效，还是从文件最后一次访问时间生效。OOS转换存储类型为低频访问存储后，会在Bucket log中记录一条日志，操作项是"OOS.TRANSITIONSIA.OBJECT"。 项目 描述 :: 规则名称 生命周期规则名称。 适用范围 生命周期规则适用的范围。 规则 生命周期规则详情。 状态 生命周期规则的状态： 启用。 禁用。 操作 可以启用/禁用、编辑、删除指定的生命周期规则。 点击“添加规则”后，在弹窗中添加新的生命周期规则。 添加规则描述 项目 描述 :: 规则名称 生命周期规则名称。 文件转换策略 文件按生命周期规则转换的策略： 天数：生命周期规则在匹配文件最后一次修改时间或最后一次访问时间多少天后生效。 日期：生命周期规则生效日期，对于最后一次修改时间在此日期之前的文件执行生命周期规则。 适用范围 生命规则适用的范围： 按前缀匹配：输入生命周期规则匹配前缀，符合该前缀的文件执行生命周期规则。不符合的不执行生命周期规则。 整个存储桶：创建的生命周期规则适用该Bucket内的所有文件。 前缀 输入生命周期规则要匹配的文件名字的前缀。 前缀设置为example，表示匹配名字以example开头的所有文件，如example1.txt、example/test.png等。 前缀设置为example/，表示匹配名字以example/开头的所有文件，如example/test.png、example/abc/1.txt等。 转换到低频访问型文件 匹配生命周期规则的文件，到期后转换成低频访问型文件。 如果“文件转换策略”为“天数”，可以选择文件： 最后一次修改时间：指定在文件最后一次修改后多少天，根据生命周期规则，文件转为低频访问存储。 最后一次访问时间：指定在文件最后一次访问后多少天，根据生命周期规则，文件转为低频访问存储。 如果“文件转换策略”为“日期”，则在此日期之前修改的文件，将在此日期转换为低频访问存储。 删除文件 匹配生命周期规则的文件，到期后删除。 如果“文件转换策略”为“天数”，指定在文件最后一次修改后多少天，文件被删除。 如果“文件转换策略”为“日期”，则在此日期之前修改的文件，将在此日期被删除。 注意 如果存储桶没有配置过生命周期规则，执行该操作将创建新的生命周期规则。 如果存储桶内的生命周期规则正在执行时被修改配置，则修改后的配置并不立即生效，需等原生命周期规则执行完成后才能生效。 每个存储桶最多创建1000条生命周期规则。 同一存储桶，同一类型（到期删除或者到期转成低频访问存储）的生命周期规则不能存在叠加前缀，例如已创建到期删除文件的生命周期规则的前缀是ABC，则无法再创建前缀为ABCD或AB或A的到期删除文件的生命周期规则。 当用户为存储桶设置了生命周期规则，这些规则将同时应用于已有文件和后续新创建的文件。例如，用户今天增加了一个生命周期，指定过期时间为30天，那么OOS将会将最后修改时间在30天前的文件都加入到待删除队列中。 OOS通过将文件的最后一次修改时间或者最后一次访问时间加上生命周期时间来计算到期时间，并且将时间近似到下一天的GMT零点时间。例如，一个文件的最后修改时间为GMT 2016年1月15日10:30，生命周期为3天，那么文件的到期时间是GMT 2016年1月19日00:00。如果文件在上传之后没有修改过，则最后修改时间为该文件的上传时间。

名称 描述 EventSelectors.ReadWriteType 管理事件的读写类型： ReadOnly：只读。 WriteOnly：只写。 All：所有管理事件。 TrailARN 跟踪的ARN。

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

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

本节主要介绍PutEventSelectors。 此操作用来配置跟踪的管理事件筛选器。 默认情况下，未设置管理事件筛选器的跟踪，会记录所有的管理事件，每个跟踪最多创建1个管理事件筛选器。 请求参数 名称 描述 是否必须 ::: TrailName 指定跟踪的名称。 类型：字符串 取值：3~128个字符。 可以包含ASCII字母（az，AZ），数字（09），句点（.），下划线（）或短划线（）。 必须以字母或数字开头，以字母或数字结尾。 不能是IP地址格式（例如：192.168.5.4）。 不能包含相邻句点（.）、下划线（）、短划线（）任意组合。如不能包含类似点点（..）,点下划线（.）的组合。 是 EventSelectors 指定管理事件筛选器。 取值：ReadWriteType。 是 ReadWriteType 指定管理事件的读写类型。 类型：字符串 取值： ReadOnly：只读。 WriteOnly：只写。 All：所有管理事件。 默认值为All。 否 响应结果 名称 描述 :: EventSelectors.ReadWriteType 管理事件的读写类型： ReadOnly：只读。 WriteOnly：只写。 All：所有管理事件。 TrailARN 跟踪的ARN。 请求示例 为跟踪testcloudtrail创建只写（WriteOnly）类型跟踪的管理事件筛选器。 POST / HTTP/1.1 Host:ooscncloudtrail.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190422T032847Z XAmzTarget:cn.ctyunapi.ooscncloudtrail.v20131101.CloudTrail20131101.PutEventSelectors ContentType:application/json {"TrailName":"testcloudtrail","EventSelectors":[{"ReadWriteType":"WriteOnly"}]}

本节主要介绍策略基本信息。 在“权限策略”页面，点击具体策略名或者“操作”列的“管理”，可以进入具体策略页面，在该页面可以查看策略的基本信息和修改策略。 策略基本信息包含：策略名称、策略类型、创建时间、最近修改时间、描述。

清除密码规则 在“密码安全设置”处点击“清除密码规则”，改为默认密码规则，默认密码规则为： 密码长度：8128位。 密码中必须包含元素：小写字母、数字。 密码有效期：永久。 自主管理密码：允许用户自主管理密码。 密码过期后：不需要管理员重置。 历史密码检查策略：不启用历史密码检查策略，但用户更改密码时，新密码不能与当前密码相同，因为当前密码不属于历史密码。

参数 含义 值 Version 策略的版本。 20121017。 Statement：策略的授权语句。Statement可以有多个，表示不同的授权结构。 Effect：效果。 定义操作的选择效果。 Allow：允许执行。 Deny：拒绝执行。 说明 当同一个Action中的Effect同时包含Allow和Deny时，遵循Deny优先的原则。 Statement：策略的授权语句。Statement可以有多个，表示不同的授权结构。 Action：对操作的类别显性匹配。 NotAction：与指定的操作之外的其他操作显性匹配。 说明 对于一个Statement，Action和NotAction二选一。 定义操作的类别。 格式为“ 服务名 : 操作 ”。 服务名： oos：对象存储。 cloudtrail：操作跟踪。 statistics：管理API。 iam：访问控制。 操作详见“操作列表”。 Statement：策略的授权语句。Statement可以有多个，表示不同的授权结构。 Resource：策略生效的资源。 NotResource：除指定资源外，策略生效。 资源类别。 格式可以为 arn:ctyun: service :: accountid : resource arn:ctyun: service :: accountid : resourcetype/resource 其中： service：服务名。 accountid：账户ID。 resource：具体资源。在指定资源时，可以使用通配符，其中表示字符的任意组合，？表示任何单个字符。例如oos可以表示为：arn:ctyun:oos::accountID:bucket/object，其中bucket和object为用户实际的资源名称。 resourcetype：资源类型。可以使用表示所有资源类型。根据服务不同，对应的resourcetype不同：iam的resourcetype可以为：user、group、policy、mfa或；cloudtrail的resourcetype可以为：trail或；statistics的resourcetype可以为： 。 Statement：策略的授权语句。Statement可以有多个，表示不同的授权结构。 Condition：条件。 策略生效的条件。 Condition的语法结构如下： "Condition": {"条件运算符A": {"条件键A":["条件值A1", "条件值A2"，…]}, "条件运算符B": {"条件键B":["条件值B1", "条件值B2"，…] } } 注意 Condition元素可以由多个条件组成。条件包括：条件运算符、条件键和条件值组成，一个条件键可以对应多个条件值。

名称 描述 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。

请求示例1 请求创建一个名叫docs的Bucket，索引位置设置为WuHu，数据位置设置为优先本地，Bucket权限设置为私有。 plaintext PUT / HTTP/1.1 Host: docs.ooscn.ctyunapi.cn ContentLength:200 ContentType: application/xml;charsetutf8 Date: Mon, 03 Sep 2012 12:00:00 GMT xamzacl: private Authorization: SignatureValue WuHu Local 响应示例1 plaintext HTTP/1.1 200 OK xamzrequestid: c962c64b9f294f7b14877a897e8b8d9352545d484a4c4e5052 Date: Mon, 03 Sep 2012 12:00:00 GMT Location: /docs ContentLength: 0 Server: CTYUN 请求示例2 请求创建一个名叫docs的Bucket，索引位置设置为WuHu，数据位置设置为芜湖、成都，调度策略是允许OOS自动调度。 plaintext PUT / HTTP/1.1 Host: docs.ooscn.ctyunapi.cn ContentLength:200 ContentType: application/xml; charsetutf8 Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: SignatureValue WuHu Specified WuHu ChengDu Allowed 响应示例2 plaintext HTTP/1.1 200 OK xamzrequestid: c962c64b9f294f7b14877a897e7b8d9352545d484a4c4e6879 Date: Mon, 03 Sep 2012 12:00:00 GMT Location: /docs ContentLength: 0 Server: CTYUN

响应码 错误码(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。