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

本节主要介绍Backoff。 当OOS系统服务繁忙，暂时不可使用时，OOS会向客户端返回503响应码和RetryAfter响应头。示例如下： HTTP/1.1 503 Service Unavailable xctyunrequestid: abdcf4945d14406a30383a4b4e4948542d6b6e696854 RetryAfter: 90 Date: Tue, 6 May 2014 08:02:58 GMT ContentLength: 133 ContentType: text/xml Server: CTYUN SlowDown Please reduce your request rate.

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

名称 描述 是否必须 BucketName 存储桶名称。 是 delimiter 分隔符，一个用来对关键字们进行分组的字符。所有的关键字都包含delimiter和prefix间的相同子串，prefix之后第一个遇到delimiter的字符串都会加到一个叫CommonPrefix的组中。如果没有特别定义prefix，所有的关键字都会被返回，但不会有CommonPrefix。delimiter只支持”/”，不支持其他分隔符。 类型：字符串。 否 maxuploads 设置返回的分片上传过程的最大数目。 类型：整型。 取值：[1, 1000]。 默认值：1000。 否 keymarker 与uploadidmarker参数一起，该参数指定列表操作从什么位置后面开始。如果uploadidmarker参数没有被指定，那么只有比keymarker参数指定的key更大的key会被列出。如果uploadidmarker参数被指定，任何包含与keymarker指定值相等或大于key的分片上传过程都会被包括，假设这些分片上传过程包含了比uploadidmarker指定值更大的ID。 类型：字符串。 否 prefix 该参数用于列出那些以prefix为前缀的正在进行的上传过程，用户可以使用多个prefix来把一个bucket分成不同的组（可以考虑采用类似文件系统中的文件夹的作用那样，使用prefix来对key进行分组）。 类型：字符串。 否 encodingtype 指定响应中KeyMarker、NextKeyMarker、Key、Prefix、Delimiter的编码类型。如果KeyMarker、NextKeyMarker、Key、Prefix、Delimiter包含xml 1.0标准不支持的控制字符，可通过设置该参数对响应中的KeyMarker、NextKeyMarker、Key、Prefix、Delimiter进行编码。 类型：字符串。 取值：url，字母不区分大小写。 否 uploadidmarker 与keymarker参数一起，指定列表操作从什么位置后面开始。如果keymarker没有被指定，uploadidmarker参数也会被忽略。否则，任何key值等于或大于keymarker的上传过程都会被包含在列表中，只要ID大于uploadidmarker指定的值。 否

本节主要介绍DELETE Bucket。 此操作用来删除Bucket，但要求被删除Bucket中无Object，即该Bucket中的所有Object都已被删除。 请求语法 DELETE / HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 请求示例 删除名叫docs的Bucket。 DELETE / HTTP/1.1 Host: docs.ooscn.ctyunapi.cn Date: Mon, 03 Sep 2012 12:00:00 GMT ContentType: application/xml;charsetutf8 Authorization: SignatureValue 响应示例 HTTP/1.1 204 No Content xamzrequestid: 4f549138d7bc46c4ce4134433845474d0c0e18020406080a0c Date: Mon, 03 Sep 2012 12:00:00 GMT Server: CTYUN

数据从S3迁移至OOS示例 { "srcType":"S3", 从S3迁移文件（Object） "srcEndpoint":"s3.amazonaws.com", S3的Endpoint "srcAccessKey":"your s3 accessKey", S3的AccessKey "srcSecretKey":"your s3 secretKey", S3的SecretKey "srcBucket":"s3bucket", S3的Bucket "srcRegionName":"useast1",S3的region "destEndpoint":"ooscn.ctyunapi.cn", OOS的Endpoint "destAccessKey":"your oos accesKey", OOS的AccessKey "destSecretKey":"your oos secretKey", OOS的SecretKey "destBucket":"oosbucket", OOS的Bucket "srcPrefix":"logs/", S3上要迁移文件（Object）的前缀 "srcMarker":"", 从第一个文件（Object）开始迁移 "srcStopObject":"", S3上要迁移的截止文件（Object） "isSkipExistFile":false 是否跳过目标资源池中已有的文件（Object） } 数据从LOCAL迁移至OOS { "srcType":"LOCAL", 从LOCAL迁移文件（Object） "localFolderPath":"F:/test/test1/", 本地目录 "destEndpoint":"ooscn.ctyunapi.cn", OOS的Endpoint "destAccessKey":"your oos accesKey", OOS的AccessKey "destSecretKey":"your oos secretKey", OOS的SecretKey "destBucket":"oosbucket", OOS的Bucket "isSkipExistFile":false 是否跳过目标资源池中已有的文件（Object） } 根据日志文件迁移源文件至OOS（以LOCAL迁移至OOS为例） { "srcType":"LOCAL", 从LOCAL迁移文件（Object） "localFolderPath":"F:/test/test1/", 本地目录 "destEndpoint":"ooscn.ctyunapi.cn", OOS的Endpoint "destAccessKey":"your oos accesKey", OOS的AccessKey "destSecretKey":"your oos secretKey", OOS的SecretKey "destBucket":"oosbucket", OOS的Bucket "isSkipExistFile":false 是否跳过目标资源池中已有的文件（Object） "migrateLogFile":true, "logFile":"F:/errorlog.txt" } 系统配置文件（system.conf）示例 { "threadNum":1, 迁移时的读写并发数 "maxSimpleObjectSizeM":100, 超过文件（Object）大小限制时，将被拆分成分段文件（Object）迁移 "partSizeM":50, 拆分为分段文件（Object）时的分片大小 "maxThroughput":1, 对源端流量进行限制，负数表示不限流量 "stopScan":false 是否终止遍历源文件（Object） }

本节主要介绍GetUser。 此操作用来获取IAM用户信息。 请求参数 名称 描述 是否必须 ::: Action GetUser。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 查询用户的用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 否 响应结果 名称 描述 :: Arn IAM用户的资源名称。 UserName IAM用户名。 UserId IAM用户ID。 CreateDate 创建IAM用户的时间，采用ISO 8601日期时间格式。 PasswordLastUsed 上次使用用户密码登录OOS网站，采用ISO 8601日期时间格式。 说明 如果从未使用密码登录，不返回此字段。 如果用户当前没有密码，但过去有密码，则此字段包含最近使用密码的时间。 IPLastUsed 最近一次登录控制台的IP。 Tags.member.Key 标签键。 Tags.member.Value 标签值。 请求示例 获取IAM用户信息。 POST / HTTP/1.1 Host:ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190131T020935Z ContentType: application/octetstream ActionGetUser&Version20100508 响应示例 HTTP/1.1 200 OK xamzrequestid:c8ea4d156d0f44aa ContentType:text/xml;charsetUTF8 ContentLength:638 Date:Thu, 31 Jan 2019 02:09:35 GMT Server: CTYUN 20190107T05:57:35Z testuser arn:ctyun:iam::10rc2arpn6306:user/testuser dd3cf79eda454f04871a87386792914f 10.1.1.1 testvalue testtag 20190107T05:53:20Z c8ea4d156d0f44aa

响应码 错误码(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符号（@）。 是

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

公共响应头 每个统计响应结果中都会包含公共响应头。 名称 描述 :: 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个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否