名称 描述 是否必须 Action DeleteAccountPasswordPolicy。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否

请求示例 第一个规则允许来自 PUT、POST和DELETE请求。该规则还通过AccessControlRequestHeaders标头允许预检OPTIONS请求中的所有标头。作为对任何预检 OPTIONS 请求的响应，OOS 将返回请求的任意请求头。 第二个规则允许与第一个规则具有相同的跨源请求，但第二个规则应用于另一个源 第三个规则允许来自所有源的跨源GET请求。“”通配符字符是指所有的源。 PUT /?cors HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn xamzdate: Tue, 21 Aug 2012 17:54:50 GMT ContentMD5: 8dYiLewFWZyGgV2Q5FNI4W Authorization: SignatureValue ContentLength: 445 PUT POST DELETE PUT POST DELETE GET 响应示例 HTTP/1.1 200 OK xamzrequestid: 8859db542a32455738b2b4abadb3727479686a6c6e70727476 Date: Tue, 21 Aug 2012 17:54:50 GMT Server:CTYUN

名称 描述 是否必须 Action DetachGroupPolicy。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 GroupName IAM用户组名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 PolicyArn 权限策略的资源名称。 类型 ：字符串 取值 ：20~2048个字符。 是

本节主要介绍GET Bucket Logging。 此操作用来获得指定Bucket的logging。只有根用户和拥有GET Bucket Logging权限的子用户才能执行此操作，否则会返回403 AccessDenied错误。 请求语法 GET /?logging HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 响应结果 名称 描述 BucketLoggingStatus 响应的容器。 类型：容器。 子节点：LoggingEnabled。 LoggingEnabled 日志信息的容器，当启动日志时，包含这个元素；否则此元素及其子元素都不显示。 类型：容器。 父节点：BucketLoggingStatus。 子节点：TargetBucket、TargetPrefix。 TargetBucket 保存log的bucket，OOS会向此Bucket存储日志。 类型：字符串。 父节点：LoggingEnabled。 TargetPrefix 生成的log文件将以此为前缀命名。 类型：字符串。 父节点：LoggingEnabled。 请求示例 GET /?logging HTTP/1.1 Host: docs.ooscn.ctyunapi.cn Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: SignatureValue 响应示例 以下是设置了日志的响应示例。 HTTP/1.1 200 OK xamzrequestid: 7b6bfbc182504e46f26558675c696b7130323c26282a2c2e30 Date: Mon, 03 Sep 2012 12:00:00 GMT Server: CTYUN examplebucket mybucketaccesslog/ 以下是没有设置日志时的响应示例。 HTTP/1.1 200 OK xamzrequestid: ef00a70d4f2b43416ee1d4e3d8e5e7edacaeb7a2a4a6a8aaac Date: Mon, 03 Sep 2012 12:00:00 GMT Server: CTYUN

来自：

帮助文档

对象存储（经典版）I型

API参考

存储桶（Bucket）和文件(Object）

关于Bucket的操作

GET Bucket Logging

本节主要介绍HEAD Bucket。 此操作用于判断Bucket是否存在，而且用户是否有权限访问。如果Bucket存在，而且用户有权限访问时，此操作返回200 OK。否则，返回404不存在，或者403没有权限。 请求语法 HEAD / HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求参数 名称 描述 是否必须 ::: BucketName 存储桶名称。 是 请求示例 HEAD / HTTP/1.1 Host: docs.ooscn.ctyunapi.cn Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: SignatureValue 响应示例 HTTP/1.1 200 OK xamzrequestid: d7a3025538f74a8fa4170a190e1b1d23e2e4e8d8dadcdee0e2 Date: Mon, 03 Sep 2012 12:00:00 GMT Server: CTYUN

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

名称 描述 是否必须 Action AttachGroupPolicy。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 PolicyArn 权限策略的资源名称。 类型 ：字符串 取值 ：20~2048个字符。 是 GroupName IAM用户组名。 类型 ：字符串 取值 ：1~128个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是

请求示例1 GET / HTTP/1.1 Host: docs.ooscn.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD XAmzDate: 20200304T070632Z ContentType: application/xml; charsetutf8 Authorization: SignatureValue 响应示例1 HTTP/1.1 200 OK Date: Wed, 04 Mar 2020 07:06:40 GMT xamzrequestid: b13be3abf4db4af33eaaaeb5bdb5b7bd7c7e82727476787a7c ContentLength: 538 ContentType: application/xml; charsetutf8 Server: CTYUN docs 1000 false 1.png 20200304T07:04:48.135Z "01fa001a4c65b834696c5e0049fd5004" 25348 STANDARD 使用请求变量的示例 假设数据库中存储数据如下所示： docs/sample.pdf docs/Ant/sample.doc docs/Feb/sample2.doc docs/Feb/sample3.doc docs/Feb/sample4.doc 要查询prefix为docs/,delimiter为/，同时marker为docs/F，maxkeys为40的结果，请求头为 GET /?prefixdocs/&markerdocs/F&maxkeys40&delimiter/ HTTP/1.1 Host: docs.ooscn.ctyunapi.cn Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: AWS 81ebc16ddc8d2af82c90:thdUi9VAkzhkniLj96JIrOPGi0g 返回的结果集为： docs docs/ docs/F 40 / false sample.pdf 20120901T01:56:20.000Z "bf1d737a4d46a19f3bced6905cc8b902" 142863 STANDARD Feb/ Ant/

名称 描述 Events 根据查询条件，返回的管理事件。 NextToken 分页标识。如果没有返回该值，则说明已经返回所有的查询结果。

响应结果 名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 存储类型： ALL：所有存储。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 TimeZone 返回数据的时区，统一为UTC +0800。 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.DeleteCapacity 删除标准存储数据的容量。 Statistics.Standardia.DeleteCapacity 删除低频访问存储数据的容量。 请求示例 按天（byDay）查询Bucket名为examplebucket、数据位置为ZhengZhou、20191015至20191016标准存储数据的删除容量。 plaintext GET /?ActionGetDeleteCapacity&BeginDate20191015&EndDate20191016&Bucketexamplebucket&FreqbyDay&RegionZhengZhou HTTP/1.1 Date: Wed, 16 Oct 2019 06:38:27 GMT Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn 响应示例 plaintext HTTP/1.1 200 OK Date: Wed, 16 Oct 2019 06:38:28 GMT xamzrequestid: da66aa927f744dc1 ContentLength: 440 ContentType: application/xml; charsetutf8 Server: CTYUN test@ctyun usertest1 STANDARD UTC +0800 byDay examplebucket ZhengZhou 20191015 1641600 20191016 1641600

项目 描述 时间选择 流量查询的时间段，可以选择查看下列时间段的流量： 今日。 昨日。 近7日。 近30日。 根据日历按钮，选择查询任意90天内的流量。 时间粒度 流量查询的时间粒度，可以选择： 按五分钟查询：统计信息按每5分钟展示，可以选择查询今日、昨日或按日历选择任意1天的数据。 按小时查询：统计信息按每小时展示，可以查询今日、昨日、近7日或按日历选择任意7天内的数据。 按天查询：统计信息按天展示，可以查询今日、昨日、近7日、近30天或按日历按钮选择任意90天内的数据。 数据位置 流量查询数据位置，可以选择： 全部数据位置：展示所有数据位置的流量之和。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的流量。 存储桶 容量查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的流量之和。 具体存储桶：根据显示的存储桶，选择查看对应存储桶的流量。 流量类型 选择流量统计的类型（所有流量均为累计值）： 全部流量：所有流量和值，包括互联网直接流量、互联网漫游流量、非互联网直接流量、非互联网漫游流量。 互联网直接流量：从互联网上传下载文件，并且未经对象存储网络内部调度产生的流量。 互联网漫游流量：从互联网上传下载文件，并且经过对象存储网络内部调度产生的流量。 非互联网直接流量：从非互联网（例如内网）上传下载文件，并且未经对象存储网络内部调度产生的流量。 非互联网漫游流量：从非互联网（例如内网）上传下载文件，并且经过对象存储网络内部调度产生的流量。 存储类型 选择流量查询的存储类型： 全部存储类型：分别展示标准存储和低频访问存储的流量。 标准类型：标准存储的流量。 低频访问存储：低频访问存储的流量。

响应示例 HTTP/1.1 200 OK xamzrequestid:2f6014be663b4a06 ContentType:text/xml;charsetUTF8 ContentLength:789 Date:Thu, 14 Feb 2019 05:14:40 GMT Server: CTYUN 20190213T06:59:13Z 52cc325781954fff9069aec37c9b038a true testpolicy0 testdes 2 arn:ctyun:iam::10rc2arpn6306:policy/testpolicy0 20190212T06:56:26Z %7B%0A%20%20%20%20%22Version%22%3A%20%2220121017%22%2C%0A%20%20%20%20%22Statement%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Sid%22%3A%20%22VisualEditor0%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Effect%22%3A%20%22Allow%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Action%22%3A%20%22oos%3AHeadBucket%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Resource%22%3A%20%22%2A%22%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%5D%0A%7D Local 2f6014be663b4a06

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

名称 描述 是否必须 Action GetUsage。 是 BeginDate 指定查询的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值： 若以格式YYYYMMDD查询，返回以天为单位的数据。 若以格式YYYYMMDDhhmm查询，返回以5分钟为单位的数据，mm只能取00、05、10.......55。 注意 若以格式YYYYMMDDhhmm查询，日期不能早于当前时间一个月。 是 EndDate 指定查询的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：EndDate既不能早于BeginDate，也不能晚于当前时间。 若以格式YYYYMMDD查询，返回以天为单位的数据。 若以格式YYYYMMDDhhmm查询，返回以5分钟为单位的数据，mm只能取00、05、10.......55。 是 Bucket 指定查询使用情况的Bucket的名称，如果不指定Bucket名称，则表示查询账户下所有的Bucket的统计信息之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否

本节主要介绍操作跟怎API概览。 API 描述 CreateTrail 此操作用来创建一个跟踪，并将跟踪日志保存到指定的OOS Bucket。 DeleteTrail 此操作用来删除指定的跟踪。 DescribeTrails 此操作用来获取跟踪的设置信息。 GetTrailStatus 此操作用来获取跟踪状态信息。 PutEventSelectors 此操作用来配置跟踪的管理事件筛选器。 GetEventSelectors 此操作用来查看管理事件筛选器的设置信息。 UpdateTrail 此操作用来更新跟踪设置参数。 StartLogging 此操作用来开启跟踪。 StopLogging 此操作用来停止跟踪。 LookupEvents 此操作用来查看账户中的管理事件。 说明 本节举例中的域名均以对象存储网络的操作跟踪API域名ooscncloudtrail.ctyunapi.cn为例。如果是对象存储网络2，请使用域名ooscn2cloudtrail.ctyunapi.cn。如果是香港精品网和香港普通网，请使用域名ooscnhkcloudtrail.ctyunapi.cn。

本节主要介绍AddUserToGroup。 此操作用来将指定的IAM用户加入到指定的IAM用户组，每次只能将一个用户加入到指定用户组。 说明 多次执行此操作将加同一个用户加入同一个组，不会报错。 请求参数 名称 描述 是否必须 ::: Action AddUserToGroup。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 GroupName 指定IAM用户组名。 类型 ：字符串 取值 ：1~128个字符组成，字符只能包含字母、数字或特殊字符。字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 请求示例 将用户名为testuser的用户加入到IAM用户组testgroup中。 POST / HTTP/1.1 Host:ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190130T075254Z Contenttype: application/octetstream ActionAddUserToGroup&Version20100508&UserNametestuser&GroupNametestgroup 响应示例 HTTP/1.1 200 OK xamzrequestid:cf637e45e05745b3 ContentType:text/xml;charsetUTF8 ContentLength:208 Date:Wed, 30 Jan 2019 07:52:54 GMT Server: CTYUN cf637e45e05745b3

本节主要介绍GetBilledStorageUsage。 此操作用来查询收费容量。用户可以根据需求，查询指定存储桶、指定数据位置、指定存储类型的容量。 请求参数 名称 描述 是否必须 Action GetBilledStorageUsage。 是 BeginDate 指定查询容量的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询容量的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值： ALL：所有存储类型。 STANDARAD：标准类型。 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 取值： byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

本节主要介绍CreateGroup。 此操作用来创建新的IAM用户组。 请求参数 名称 描述 是否必须 ::: Action CreateGroup。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 GroupName IAM用户组名，用户组名在账户中必须唯一。 类型：字符串 取值：1~128个字符组成，字符只能包含字母、数字或特殊字符。字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 响应结果 名称 描述 :: Arn IAM用户组的资源名称。 GroupName IAM用户组的名称。 GroupId IAM用户组ID。 CreateDate IAM用户组创建的时间。 请求示例 创建一个组名为testgroup的IAM用户组。 POST / HTTP/1.1 Host:ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190130T060830Z Contenttype: application/octetstream ActionCreateGroup&Version20100508&GroupNametestgroup 响应示例 HTTP/1.1 200 OK xamzrequestid:f56d2b8cbdf24617 ContentType: text/xml;charsetUTF8 ContentLength:510 Date:Wed, 30 Jan 2019 06:08:32 GMT Server: CTYUN testgroup arn:ctyun:iam::10rc2arpn6306:group/testgroup 514648bfbc4e423f867a25281642cdfc 20190130T06:08:33Z f56d2b8cbdf24617

名称 描述 是否必须 Action DeleteVirtualMFADevice。 是 Version 请求版本。 取值 ：20100508，默认值为20100508。 否 SerialNumber 唯一标识虚拟MFA设备的序列号。虚拟MFA设备序列号是设备的ARN。 类型 ：字符串 取值 ：字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、右斜线（/）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）、at符号（@）和冒号（:）。 是

名称 描述 是否必须 Action ListVirtualMFADevices。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 AssignmentStatus 指定需要列出的虚拟MFA设备状态。 类型：字符串 取值： Assigned：已分配给IAM用户的虚拟MFA设备。 Unassigned：未分配给IAM用户的虚拟MFA设备。 Any：所有虚拟MFA设备。 默认值为Any。 否 Marker 分页标识。还有需要返回的虚拟MFA设备时，上条响应结果中会返回该参数。查看未显示项时，请求参数中需要携带此参数。 类型：字符串 取值：与上条响应中返回的结果值相同。 否 MaxItems 设置响应中最多返回的条数。 如果存在超出您指定的返回项，则IsTruncated响应结果为true，表示还有未返回项。查看未显示的项时，需要携带响应参数Marker的值。 类型：整型 取值：1~1000，默认值为100。 否

本节主要介绍修改自定义策略。 点击“权限策略”>“策略名称”>“策略内容”>“编辑策略”，弹出“编辑策略”页面，可以通过可视化策略编辑器或JSON对策略进行编辑，具体编辑方法可以参考新建自定义策略中的“可视化策略编辑”和“JSON编程授权”。

响应示例 HTTP/1.1 200 OK xamzrequestid:55fdaf68adb34476 ContentType:text/xml;charsetUTF8 ContentLength:210 Date:Fri, 22 Mar 2019 02:39:11 GMT Server: CTYUN 55fdaf68adb34476

本节主要介绍GET Bucket Object Lock。 使用此操作可以获取Bucket合规保留的配置信息。只有根用户和有权限的子用户才可以进行此操作。 请求语法 GET /?objectlock HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求示例 名称 描述 是否必须 BucketName 存储桶名称。 是 响应结果 名称 描述 :: ObjectLockConfiguration 合规保留配置信息的容器。 类型：容器。 子节点：ObjectLockEnabled、Rule。 ObjectLockEnabled Bucket是否开启合规保留功能： Enabled：开启合规保留。 Disabled：不开启合规保留。 类型：枚举。 父节点：ObjectLockConfiguration。 Rule 合规保留的规则。 类型：容器。 父节点：ObjectLockConfiguration。 子节点：DefaultRetention。 DefaultRetention 默认的合规保留配置。 类型：容器。 父节点：Rule。 子节点：Mode、Days或Years二选一。。 Mode 合规保留模式。 COMPLIANCE：合规保留。 类型：枚举 父节点：DefaultRetention Days 合规保留的天数。 类型：整型。 父节点：DefaultRetention。 Years 合规保留的年数。 类型：整型。 父节点：DefaultRetention。 请求示例 GET /?objectlock HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: 20200514T020802Z Authorization: SignatureValue 响应示例 HTTP/1.1 200 OK xamzrequestid: bda73fc9ada1433b54ced0c7c9cf8e90948486888a8c8e9092 Date: Thu, 14 May 2020 02:08:15 GMT ContentLength:50 Server: CTYUN Enabled COMPLIANCE 1

本节主要介绍UpdateLoginProfile。 此操作用来更改指定IAM用户控制台的登录密码。 请求参数 名称 描述 是否必须 ::: Action UpdateLoginProfile。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 UserName 需要更改控制台登录密码的IAM用户名。 类型：字符串 取值：1~64位个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 Password 指定用户控制台登录的新密码。 类型：字符串 取值：新密码必须符合OOS账户的密码策略（如果存在）。默认密码规则为8128位密码，必须是小写字母和数字的组合。 否 PasswordResetRequired IAM用户使用初始密码登录控制台后是否需要重置密码。 类型：布尔型 取值： true：使用初始密码登录后，需要重置密码后才可以执行操作。 false：使用初始密码登录后，无需重置密码也可以执行操作。 默认值为false。 否 请求示例 修改IAM用户testchpasswd控制台的登录密码为a12345678。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190315T024705Z ContentType: application/octetstream ContentLength: 68 ActionUpdateLoginProfile&Version20100508&UserNametestchpasswd&Passworda12345678

名称 描述 UserName IAM用户名。 PasswordResetRequired IAM用户使用初始密码登录控制台后是否需要重置密码： true：使用初始密码登录后，需要重置密码后才可以执行操作。 false：使用初始密码登录后，无需重置密码也可以执行操作。 CreateDate IAM用户控制台密码创建的时间。

本节主要介绍怎么创建用户组。 点击“访问控制”>“用户管理”>“用户组”>“创建”，进入“创建用户组”页面，按照下列步骤创建用户组： 1. 设置用户组 设置用户组名：用户组名创建成功后，不可进行修改。用户组命名需遵守以下规则： 用户组名必须唯一。 1~128位字符组成，字符只能包含字母、数字或特殊字符，不包含空格。字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 2. 设置权限 可以在搜索框中搜索匹配策略，搜索出的匹配策略以列表的形式展现出来，可以通过勾选对应策略，为用户组附加策略。 说明 可以创建用户组时为用户组添加策略，也可以在用户组创建完成后，再为其添加策略。 注意 每个用户组最多添加10条策略。 3. 信息审核 对于新建用户组的信息，可以进行审核。如果有需要修改的地方，可以点击编辑图标进行修改。 4. 完成 完成用户组创建后，可以将IAM用户添加到组，以便管理。

本节主要介绍GetSessionToken。 OOS为用户提供临时授权访问。此操作用来获取临时访问密钥。子用户默认拥有调用此接口的权限。如果配置了禁止子用户调用该接口的IAM策略，该策略不会生效。 STS（Security Token Service）是为云计算用户提供临时访问令牌的Web服务。通过STS，可以为第三方应用或用户颁发一个自定义时效的访问凭证。第三方应用或用户可以使用该访问凭证直接调用OOS API，或者使用OOS提供的SDK来访问OOS API。 使用临时授权访问OOS API时，用户需要将安全令牌（SessionToken）携带在请求header中或者预签名URL中。携带在请求header中，V4和V2签名的XAmzSecurityToken请求头不区分大小写。携带在预签名URL中，V4签名的标头为“XAmzSecurityToken”，V2签名的标头为“xamzsecuritytoken”。 注意 使用临时访问令牌（AccessKeyId、SecretAccessKey、SessionToken）的用户不能调用该接口；使用临时访问令牌调用其他接口时，权限同生成该临时访问令牌的用户。为了安全起见，不建议根用户调用该接口。 请求语法 plaintext POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn Date: Date Authorization: SignatureValue ContentType：application/octetstream ActionGetSessionToken&DurationSecondsseconds 请求参数 名称 描述 是否必须 Action GetSessionToken。 是 DurationSeconds 令牌的有效期限。 类型：整型 取值：[900, 129600]，单位是秒。 是 PolicyDocument 用JSON语言描述的策略内容，为临时访问密钥增加权限策略限制。 携带该权限策略时：生成的临时访问密钥的权限等于调用此接口用户的权限策略和该权限策略的交集。 未携带该权限策略时：生成的临时访问密钥的权限等于调用此接口用户的权限策略。 注意 该参数仅对IAM用户生效，对根用户不生效。PolicyDocument的赋值需要做urlencode处理。 类型：字符串 取值：长度为1~2048的字符串。可以包含以下字符： 任何可打印的ASCII字符，范围从空格字符（u0020）到ASCII字符范围的结尾。 Basic Latin和Latin1 Supplement字符集中的可打印字符（到u00FF）。 特殊字符Tab（u0009），换行符（u000A）和回车符（u000D）。 说明 各操作权限对应的具体资源、API详见操作权限与API对应关系。 否

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共用时，查询出同时满足多个查询条件的结果。 否