响应码 错误码(code) 错误信息(message) 错误描述 400 InvalidTrailNameException Trail name too short. Minimum allowed length: 3 characters. Specified name length: 2 characters. 跟踪的名称非法，字符长度不足。 400 InvalidTrailNameException Trail name too long. Maximum allowed length: 128 characters. Specified name length: 140 characters. 跟踪的名称非法，超过最大字符长度。 400 TrailAlreadyExistsException Trail trailName already exists for the customer: accountId 跟踪已经存在。 400 TrailNotFoundException Unknown trail: arn:ctyun:CloudTrail:ctyun:accountId:trail/ trailName for the customer: accountId 跟踪不存在。 400 MaximumNumberOfTrailsExceededException User: accountId already has 10 trails. 跟踪超过最大数量限制。 400 S3BucketDoesNotExistException Bucket name does not exist: bucketName 创建跟踪时，BucketName不存在。 400 InvalidTrailNameException Trail name cannot be blank! 跟踪名称为空。 400 InvalidS3PrefixException S3 prefix is longer than maximum length: s3Prefix 前缀超过长度限制。 400 InvalidLookupAttributesException Lookup attribute key is not valid. Lookup属性key非法。 400 InvalidLookupAttributesException Lookup attribute value is not valid. Lookup属性值非法。 400 InvalidMaxResultsException A max results value of {maxNumber} is invalid. Specify max results between 1 and 50. 设置的lookupEvents返回的最大结果数超过限制。 400 InvalidEventSelectorsException Specify a valid number of selectors for your trail 一个管理事件追踪的筛选器只能有一个。 403 AccessDenied Access Denied 权限认证不通过。 403 AccessDenied Can not access bucket {bucketName} 创建trail时，指定的Bucket不是当前账户下的Bucket。 400 InvalidTrailNameException Trail name must not be formatted as an IP address. trail名称不合法，是ip格式。 400 InvalidTrailNameException Trail name must end with a letter or number. trail名称不合法，不是以数字或字母结尾。 400 InvalidTrailNameException Trail name must start with a letter or number. trail名称不合法，不是以数字或字母开头。 400 InvalidTrailNameException Trail name or ARN cannot have adjacent periods (.), hyphens (), or underscores ()." tail名称不合法，包含连续的“.”“”“”。 400 InvalidEventSelectorsException Value {ReadWriteType} for ReadWriteType is invalid. 创建筛选器时，ReadWriteType的值不正确。 400 InvalidTimeRangeException The start time precedes the end time. Lookup时，起始时间晚于结束时间。 500 InternalError We encountered an internal error. Please try again. 发生内部错误，请重试。 405 MethodNotAllowed Method is not allowed. 操作不能被识别。 400 InvalidTrailNameException Trail name or ARN can only contain uppercase letters, lowercase letters, numbers, periods (.), hyphens (), and underscores (). trail名称不合法，包含非法字符。 400 InvalidS3BucketNameException Bucket name cannot be blank! 创建trail时，Bucket名称不能为空。 400 InvalidLookupAttributesException Lookup attribute key can not be multiple. lookup属性key只能设置一个。

本节主要介绍OOS数据迁移工具运行环境。 迁移工具支持部署在Windows或Linux客户端，运行环境要求如下： Windows7及以上版本或Linux CentOS 7.x及以上版本。 Java 1.8及以上版本。 迁移工具所在的服务器可以访问源云存储资源池和OOS资源池。

本节主要介绍IAM用户登录。 1. 根用户或有管理用户权限的IAM用户，通过“用户管理”>“用户”，进入具体用户页面，在用户详细信息页面，点击“安全”，复制“控制台登录链接”，即得到该IAM用户的登录链接。 2. 输入上一步骤中复制的控制台链接，进入子用户登录页面。根据提示，输入IAM用户名和登录密码，进行登录。 说明 IAM用户名为“@”前面的部分。 IAM子用户与根用户的页面基本一致，子用户的功能根据授权而定。如果需要更多权限，可以向根用户进行申请。

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

操作权限 涉及资源 API 列表 DescribeTrails trail（trail/或） DescribeTrails 列表 LookupEvents trail（trail/或） LookupEvents 读取 GetEventSelectors trail（trail/ trailname 、trail/或） GetEventSelectors 读取 GetTrailStatus trail（trail/ trailname 、trail/或） GetTrailStatus 写入 PutEventSelectors trail（trail/ trailname 、trail/或） PutEventSelectors 写入 StopLogging trail（trail/ trailname 、trail/或） StopLogging 写入 CreateTrail trail（trail/ trailname 、trail/或） CreateTrail 写入 UpdateTrail trail（trail/ trailname 、trail/或） UpdateTrail 写入 DeleteTrail trail（trail/ trailname 、trail/或） DeleteTrail 写入 StartLogging trail（trail/ trailname 、trail/或） StartLogging

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

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

响应示例 HTTP/1.1 200 OK xamzrequestid:1d1089f15291424a ContentType:text/xml;charsetUTF8 ContentLength:3297 vary:acceptencoding Date:Mon, 15 Apr 2019 02:56:03 GMT Server: CTYUN Policies 150 GroupsPerUserQuota 10 AttachedPoliciesPerUserQuota 10 Users 392 PoliciesQuota 150 AccessKeysPerUserQuota 2 AttachedPoliciesPerGroupQuota 10 Groups 29 UsersQuota 500 MFADevices 8 MFADevicesInUse 1 AccountAccessKeysPresent 1 GroupsQuota 30 1d1089f15291424a

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

本节主要介绍GetAccountLoginSecurityPolicy。 此操作用来获取IAM用户登录安全策略。 请求参数 名称 描述 是否必须 ::: Action GetAccountLoginSecurityPolicy。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 响应结果 名称 描述 :: LoginSecurityPolicy.PeriodWithLoginFailures 登录失败次数的限定时间。单位为分钟。 LoginSecurityPolicy.LoginFailedTimes IAM用户在限定时间内允许连续登录失败的次数。 LoginSecurityPolicy.LockoutDuration IAM用户被锁定的时间。单位为分钟。 LoginSecurityPolicy.AllowSingleUsersSimultaneousLogin 是否允许IAM用户同一时刻在多个客户端登录： true：允许IAM用户同一时刻在多个客户端登录。 false：不允许IAM用户同一时刻在多个客户端登录。IAM用户同一时刻在多个客户端登录时，最后一次的登录会保持，之前的登录将被强制下线。 LoginSecurityPolicy.SessionDuration IAM用户登录控制台后，在无任何操作时，保存会话的时长。单位为分钟。 请求示例 获取IAM用户的登录安全策略。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn Connection: KeepAlive xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20211214T023208Z ContentType: application/octetstream ContentLength: 55 ActionGetAccountLoginSecurityPolicy&Version20100508 响应示例 HTTP/1.1 200 OK xamzrequestid: 3d49e20c3e544ec3 Date: Tue, 14 Dec 2021 02:32:08 GMT ContentType: text/xml;charsetUTF8 ContentLength: 513 Server: CTYUN 15 5 15 true 30 3d49e20c3e544ec3

请求示例 更新IAM用户登录安全策略设置。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn Connection: KeepAlive xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20211214T024257Z ContentType: application/octetstream ContentLength: 124 ActionUpdateAccountLoginSecurityPolicy&Version20100508&PeriodWithLoginFailures20&AllowSingleUsersSimultaneousLogintrue 响应示例 HTTP/1.1 200 OK xamzrequestid: 9f1f4d6e6d1d4ab8 Date: Tue, 14 Dec 2021 02:42:57 GMT ContentType: text/xml;charsetUTF8 ContentLength: 161 Server: CTYUN 9f1f4d6e6d1d4ab8

本节主要介绍DELETE Bucket CORS。 删除Bucket的跨域配置信息。只有根用户和拥有DELETE Bucket CORS权限的子用户才能执行此操作，否则会返回403 AccessDenied错误。 如果Bucket配置了CORS，删除成功，返回200 OK。 如果Bucket没有配置CORS，返回204 No Content。 请求语法 DELETE /?cors HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 请求示例 DELETE /?cors HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Tue, 13 Dec 2011 19:14:42 GMT Authorization: SignatureValue 响应示例 HTTP/1.1 204 No Content xamzrequestid: a22e2ec7cee74e8874eef0e7e9efaeb0b3a4a6a8aaacaeb0b2 Date: Tue, 13 Dec 2011 19:14:42 GMT Server: CTYUN

名称 描述 是否必须 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

公共响应头 每个统计响应结果中都会包含公共响应头。 名称 描述 :: xamzrequestid 服务端生成的用于标识请求的ID。 ContentType 响应内容类型。 Date 响应日期。 Server 服务器名。 Connection 客户端与OOS服务器之间的连接状态。 如果请求时Connection值为keepalive，请求结束后继续保持连接，不返回此响应头。 如果请求时Connection值为close，请求结束后关闭连接，返回此响应头Connection: close。

项目 描述 时间选择 流量查询的时间段，可以选择查看下列时间段的流量： 今日。 昨日。 近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符号（@）和冒号（:）。 是