名称 描述 IsTruncated 是否已经返回所有的用户或用户组： true：有未返回的用户或用户组。 false：已经返回所有的用户和用户组。 Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。 PolicyUsers.member.UserName 关联该权限策略的IAM用户名。 PolicyUsers.member.UserID 关联该权限策略的IAM用户ID。 PolicyGroups.member.GroupID 关联该权限策略的IAM用户组ID。 PolicyGroups.member.GroupName 关联该权限策略的IAM用户组名。

本节主要介绍UntagUser。 此操作用来删除用户的指定标签。 说明 如果删除的标签不存在时，返回状态200（成功）。 请求参数 名称 描述 是否必须 ::: Action UntagUser。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 UserName IAM用户名。 类型：字符串 取值：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 TagKeys.member.N 用户标签键。 类型：字符串 取值：由1~128个字符组成，字符串符合表达式[p{L}p{Z}p{N}.:/+@]+。 是 请求示例 删除IAM用户testuser的标签键testkey1和testkey2。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190325T030013Z ContentType: application/octetstream ContentLength: 79 ActionUntagUser&Version20100508&UserNametestuser&TagKeys.member.1testkey1&TagKeys.member.2tagkey2 响应示例 HTTP/1.1 200 OK xamzrequestid:aa4347cbcabb4f95 ContentType:text/xml;charsetUTF8 ContentLength:198 Date:Mon, 25 Mar 2019 03:00:13 GMT Server: CTYUN aa4347cbcabb4f95

本节主要介绍操作跟踪记录事件。 操作跟踪记录的事件如下表。 类别 事件 :: Bucket DeleteBucket Bucket DeleteBucketLifecycle Bucket GetBucketLifecycle Bucket GetBucketLocation Bucket CreateBucket Bucket PutBucketLifecycle Bucket PutBucketLogging Bucket GetBucketAcl Bucket PutBucketAcl Bucket GetBucketPolicy Bucket PutBucketPolicy Bucket DeleteBucketPolicy Bucket GetBucketWebsite Bucket PutBucketWebsite Bucket DeleteBucketWebsite Bucket GetBucketLogging Bucket GetBucketCors Bucket PutBucketCors Bucket DeleteBucketCors Bucket PutBucketObjectLockConfiguration Bucket GetBucketObjectLockConfiguration Bucket DeleteBucketObjectLockConfiguration Services GetService Services GetRegions 统计 GetCapacity 统计 GetBilledStorageUsage 统计 GetRestoreCapacity 统计 GetDeleteCapacity 统计 GetTraffics 统计 GetRequests 统计 GetReturnCode 统计 GetConcurrentConnection 统计 GetUsage 统计 GetBandwidth 控制台 ConsoleLogin 控制台 LogoutUser 控制台 CheckMfa 操作跟踪 CreateTrail 操作跟踪 DeleteTrail 操作跟踪 DescribeTrails 操作跟踪 GetTrailStatus 操作跟踪 PutEventSelectors 操作跟踪 GetEventSelectors 操作跟踪 UpdateTrail 操作跟踪 StartLogging 操作跟踪 StopLogging 操作跟踪 LookupEvents 访问控制 CreateGroup 访问控制 DeleteGroup 访问控制 GetGroup 访问控制 ListGroups 访问控制 AddUserToGroup 访问控制 RemoveUserFromGroup 访问控制 CreateUser 访问控制 DeleteUser 访问控制 GetUser 访问控制 ListUsers 访问控制 ListUserTags 访问控制 ListGroupsForUser 访问控制 CreateAccessKey 访问控制 DeleteAccessKey 访问控制 ListAccessKeys 访问控制 GetAccessKeyLastUsed 访问控制 UpdateAccessKey 访问控制 GetSessionToken 访问控制 TagUser 访问控制 ChangePassword 访问控制 CreateLoginProfile 访问控制 CreateVirtualMFADevice 访问控制 DeactivateMFADevice 访问控制 DeleteAccountPasswordPolicy 访问控制 GetAccountLoginSecurityPolicy 访问控制 UpdateAccountLoginSecurityPolicy 访问控制 DeleteAccountLoginSecurityPolicy 访问控制 DeleteLoginProfile 访问控制 DeleteVirtualMFADevice 访问控制 EnableMFADevice 访问控制 GetAccountPasswordPolicy 访问控制 GetLoginProfile 访问控制 ListVirtualMFADevices 访问控制 UpdateAccountPasswordPolicy 访问控制 UpdateLoginProfile 访问控制 CreatePolicy 访问控制 DeletePolicy 访问控制 AttachGroupPolicy 访问控制 DetachGroupPolicy 访问控制 GetPolicy 访问控制 ListAttachedUserPolicies 访问控制 AttachUserPolicy 访问控制 ListAttachedGroupPolicies 访问控制 ListPolicies 访问控制 GetAccountSummary 访问控制 DetachUserPolicy 访问控制 ListEntitiesForPolicy 访问控制 UnTagUser 访问控制 ListMFADevices

存储容量：指用户数据占用的存储空间，会根据存储的文件类型、大小和时长收取存储费用。 注意 如果是低频访问型文件：最短存储期限为30天，早于30天删除、修改文件（Object）时，需要补足剩余天数的容量补齐费用。最小计量大小是64KiB，上传的文件小于64KiB时，按照64KiB计算存储空间进行收费，超过64KiB的文件按照实际大小进行收费。 流出流量：指从OOS获取数据时产生的数据流的累计值，根据实际产生的流量计算流量费用。如果同一个文件多次执行下载操作，会产生流量累加。 所以流出流量和存储容量没有绝对的关系，两者都和存储的文件大小有关系。

名称 描述 是否必须 CompleteMultipartUpload 请求的容器。 类型：容器。 子节点：1个或多个Part元素。 是 Part 一个片段的容器。 类型：容器。 父节点：CompleteMultipartUpload。 子节点：PartNumber、Etag。 是 PartNumber 标识片段的分片号。 类型：Integer。 父节点：Part。 是 ETag 片段上传完成时返回的Etag内容。 类型：字符串。 父节点：Part。 是

OOS提供多种类型的资源包，用于抵扣用户在使用过程中产生的各部分费用。但是请注意，一种类型的资源包只能抵扣一种计费项，并且超出了资源包的额度之后，仍会产生按需计费。 以下排查思路根据原因的出现概率进行排序，建议您从高频率原因往低频率原因排查，从而帮助您快速找到问题根因。 如果处理完某个可能原因仍未解决问题，请继续排查其他可能原因。 1. 判断是否已经购买了对应的资源包：目前支持的资源包有标准（低频）存储空间包、标准（低频）公网流出流量包、标准（低频）请求次数包、标准（低频）CN2流出流量包。不同资源包抵扣的费用不同，请确认是否已经购买了产生按需费用的计费项所对应的资源包。如果未购买，产生按需计费的费用为正常现象；如果已购买，请继续按照下面的思路排查。 2. 判断资源包额度是否超出：如果当月使用量超出已购买资源包的额度，超出部分将自动转为按需计费。资源包支持叠加使用，您可以购买新的资源包进行补充，但新购买的资源包不能抵扣已产生的资源用量。如果资源包额度已超出，产生按需计费的费用为正常现象；如果资源包额度未超出，请继续按照下面的思路排查。 3. 判断资源包属性与按需计费资源的属性是否匹配：对于支持包年包月的资源包，只有当资源包的区域（中国大陆通用和中国香港）、存储类别（标准型和低频访问型）与按需计费资源的属性完全一致时，才会抵扣资源包，否则会按需计费。需要依次排查以下属性： 区域匹配 ：资源包仅支持抵扣同区域桶的费用，请确保存储桶（Bucket）所在区域和资源包所属区域一致，否则请重新创建存储桶（Bucket）或重新购买资源包，使其区域属性匹配。 存储包类型匹配 ：OOS提供标准存储资源包和低频访问型资源包，分别用于抵扣标准存储类别文件和低频访问类别文件的费用。 如果上述要求有一项不满足，产生按需计费的费用为正常现象；如果上述要求均满足，请继续按照下面的思路排查。 4. 判断是否产生了资源包未涵盖的计费项：OOS的计费项分为存储空间费用、公网流出流量费用、请求费用、数据取回费用。而资源包只有资源包有标准（低频）存储空间包、标准（低频）公网流出流量包、标准（低频）请求次数包、标准（低频）CN2流出流量包。如果存在低频的数据取回费用，产生按需计费的费用属于正常现象。 5. 提交工单：如果上述方法均不能解决您的疑问，请提交工单，联系天翼云客服为您解答。

FFFFFF), 文字阴影是50, 文字水印内容是：Hello 图片服务！，水印位置是：右中，水平边距是：10，中线垂直偏移是：20 is.getObject(bucket, objectName, "@oosImagewatermark2&typed3F5LXplbmhlaQ&size20&textSGVsbG8g5Zu54mH5pyN5YqhIQ&colorI0ZGRkZGRg&s50&t90&p6&x10&voffset20", new File("wartermark.jpg")); } private String authorize(String httpVerb, String date, String bucket, String objectName) throws Exception { String stringToSign httpVerb + "nnn" + date + "n/" + bucket + "/" + objectName; Mac mac Mac.getInstance("HmacSHA1"); mac.init(new SecretKeySpec(sk.getBytes("UTF8"), "HmacSHA1")); byte[] macResult mac.doFinal(stringToSign.getBytes("UTF8")); String signature new String(Base64.encodeBase64(macResult), "UTF8"); String authorization "AWS " + ak + ":" + signature; return authorization; } public static void downloadInputStream(InputStream input, File file) throws IOException { int c; FileOutputStream fos new FileOutputStream(file); byte[] buff new byte[1024 4]; try { while ((c input.read(buff)) ! 1) { fos.write(buff, 0, c); } input.close(); fos.flush(); } finally { fos.close(); } } public void getObject(String bucketName, String objectName, String imageParams, File destFile) throws Exception { String date DATEFMT.format(new Date()); String authorization authorize("GET", date, bucketName, objectName + imageParams); URL url new URL("https", host, "/" + bucketName + "/" + objectName + imageParams); HttpURLConnection conn (HttpURLConnection) url.openConnection(); conn.setUseCaches(false); conn.setRequestProperty("Date", date); conn.setRequestProperty("Authorization", authorization); conn.setConnectTimeout(CONNTIMEOUT); conn.setReadTimeout(READTIMEOUT); conn.setDoInput(true); conn.setRequestMethod("GET"); conn.connect(); downloadInputStream(conn.getInputStream(), destFile); } }

本节主要介绍图片处理的一些规则。 顺序无关 转换参数中键值对是顺序无关的，即"120w120h90q"和"90q120w120h"都能取到想要的图片，系统会对参数按照本规范以下定义的顺序重新排序后再处理。（由于参数的顺序不同有时会表达不同的语义，如“100w100h200p”表达的是“先缩放到100100，再放大2倍”，即得到200200的图片；而"200p100w100h"按照字面顺序理解是“先放大2倍再缩放到100100”，即得到100100的图片，为了避免这样的理解误差，同时简化处理方式，OOS会对参数按照文档中出现的顺序排序后处理。上例中的"200p100w100h"会被理解为“100w100h200p”，得到200200的图片。） 覆盖处理 如果转换参数中出现多个相同“键”，后面定义的覆盖前面定义。如“120w120h240w”等同于“120h240w”。 长边与短边 关于“长边”和“短边”的定义需要特别注意，它们表达的是在缩放中相对比例的长或短。“长边”是指原尺寸与目标尺寸的比值大的那条边；“短边”是指原尺寸与目标尺寸的比值小的那条边如原图400200，缩放为800100，（400/8000.5，200/1002，0.5 < 2），所以在这个缩放中200那条是长边，400是短边。

执行迁移 对于 Windows 客户端，执行 import.bat 启动迁移。 1.打开开始菜单，搜索cmd，打开命令提示符窗口。 2.cd到压缩工具所在的目录下，例如 cd c:CTYUNOOSImport versionid 。 3.执行import.bat。 对于Linux客户端，进入CTYUNOOSImport versionid ，执行命令./import.sh启动迁移。 查看迁移状态 迁移任务创建后，会生成相应日志记录迁移情况： 迁移日志：migratelog文件夹下生成四种日志：异常日志、成功日志、跳过文件日志、其他日志。 运行日志：在logs/migrate文件夹下，根据log4j2.xml配置可生成server.log、error.log、dubug.log等。默认未开启debug， 不记录debug.log。 您可通过日志查看迁移失败的文件，并且可以配置migrate.conf文件中的migrateLogFile参数实现对失败文件的再次迁移。 说明 数据迁移工具支持断点续传，如果迁移过程中程序被终止了，可以重新启动迁移任务，从之前中断的位置继续开始迁移。继续迁移的步骤如下： 1. 保留上次迁移执行过程中产生的backup文件。如果是在另外一台服务器上重新开始迁移任务，需要将backup文件拷贝到新服务器的迁移工具所在目录下。 2. （可选）查看nextMarker.txt文件中记录的上次数据迁移位置。修改migrate.conf，设置srcMarker为上次迁移位置，如果不修改，则可能会造成文件重复迁移。

请求示例 GET /?inventory HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Thu, 24 Aug 2023 02:16:10 GMT Connection: keepalive Authorization: SignatureValue 响应示例 HTTP/1.1 200 OK ContentType: application/xml;charsetUTF8 Date: Thu, 24 Aug 2023 02:16:10 GMT xamzrequestid: 3332f358e09a430ce53128393f3c3f1e3a362a3e33344d1587 ContentLength: 3938 Server: CTYUN arn:ctyun:oos:::docs CSV 0 0 true Size Daily arn:ctyun:oos:::docs CSV 1 1 true Size Daily ...... arn:ctyun:oos:::docs CSV 9 9 true Size Daily false

本节主要介绍PUT Bucket Inventory Configuration。 此操作用来为Bucket配置Bucket清单规则。 通过OOS Bucket清单功能可以获取Bucket中指定文件（Object）的大小、存储类型等信息。相对于GET Bucket (List Objects)接口，Bucket清单结果文件可以按天或者按周以CSV的形式输出指定文件的相关信息，且不会影响Bucket的请求速率。在需要列举海量Object的场景中，推荐使用Bucket清单功能。 说明 每个Bucket最多可以配置10条Bucket清单规则。 请求语法 PUT /?inventory&idid HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date ContentMD5:md5 ContentLength:length Authorization: SignatureValue BucketName format prefix IsEnabled prefix Id field …… field frequency 请求头 名称 描述 是否必须 id 指定的清单名称，清单名称在当前Bucket下必须唯一。 类型：字符串。 取值：只允许使用小写字母、数字、短横线（）和下划线（），且不能以短横线（）或下划线（）开头或结尾，1~64个字符。 是 请求参数 名称 描述 是否必须 ::: InventoryConfiguration 清单配置的容器。 类型：容器。 子节点：Destination、IsEnabled、Filter、Id、OptionalFields、Schedule。 是 Destination 存放清单结果的容器。 类型：容器。 父节点：InventoryConfiguration。 子节点：OOSBucketDestination。 是 OOSBucketDestination 存放清单结果的Bucket信息。 类型：容器。 父节点：Destination。 子节点：Bucket、Format、Prefix。 是 Bucket 指定存放清单结果文件的Bucket。 类型：字符串。 取值：格式为arn:ctyun:oos:::bucketname，bucketname为已经创建的Bucket名字。 父节点：OOSBucketDestination。 是 Format 指定清单结果文件的类型。 类型：字符串。 取值：CSV。 父节点：OOSBucketDestination。 是 Prefix 指定清单结果文件的存储路径前缀。 类型：字符串。 取值：0~512个字符。 父节点：OOSBucketDestination。 否 IsEnabled 指定清单功能是否启用。 类型：布尔型 取值： true：启用清单功能。 false：不启用清单功能。 父节点：InventoryConfiguration。 是 Filter 清单筛选的前缀。 说明 指定前缀后，清单将筛选出符合前缀设置的文件。 类型：容器。 父节点：InventoryConfiguration。 子节点：Prefix。 否 Prefix 指定筛选规则的匹配前缀。 类型：字符串。 取值：0~1024个字符。 说明 如果未指定筛选规则的匹配前缀，则匹配源Bucket中的所有文件。如果源Bucket没有任何文件，或清单设置的前缀没有匹配到任何文件，则会生成相应文件和文件夹，但清单结果文件中无内容。 父节点：Filter。 否 Id 指定的清单名称，清单名称在当前Bucket下必须全局唯一。 注意 必须与请求头中的Id相同。 类型：字符串。 取值：只允许使用小写字母、数字、短横线（）和下划线（），且不能以短横线（）或下划线（）开头或结尾，1~64个字符。 父节点：InventoryConfiguration。 是 OptionalFields 清单结果配置项的容器。 类型：容器。 父节点：InventoryConfiguration。 子节点：Field。 否 Field 设置清单结果中包含配置项，可以设置多个配置项。 类型：字符串。 取值： Size：Object的大小。 LastModifiedDate：Object最后一次修改时间。 ETag：Object的ETag值，用于标识Object的内容。 StorageClass：Object的存储类型。 IsMultipartUploaded：是否为通过分片上传方式上传的Object。 说明 如果未设置配置项，清单默认输出源Bucket和Key（文件名称）。 父节点：OptionalFields。 否 Schedule 存放清单结果导出周期的容器。 类型：容器。 父节点：InventoryConfiguration。 子节点：Frequency。 是 Frequency 指定清单结果文件导出的周期。 类型：字符串。 取值： Daily：按天导出清单结果文件。 Weekly：按周导出清单文件。清单规则开启当天会根据清单规则启动一次清单导出任务，第二天启动周期性清单导出任务。例如周一开启清单规则，周一当天会启动清单导出任务，后期会按每周二启动清单导出任务。 说明 当前的清单结果文件导出完成后，才会创建新的清单任务。如果Object较多时（数量大于10亿），建议按周导出清单结果文件。 父节点：Schedule。 是

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

本节主要介绍UpdateAccessKey。 此操作用来更新指定访问密钥（AK）的状态，从Active到Inactive，或者从Inactive到Active。 说明 如果请求中未携带IAM用户名，则更新请求者的密钥状态。 此操作可以管理根用户的密钥。 请求参数 名称 描述 是否必须 ::: Action UpdateAccessKey。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 UserName 指定需要更新密钥状态用户的用户名。 类型：字符串 取值：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 否 AccessKeyId 需要更新的访问密钥ID。 类型：字符 是 Status 访问密钥的状态。 类型：字符串 Active：密钥启用，可以使用该密钥调用API。 Inactive：密钥禁用，不可以使用该密钥调用API。 是 请求示例 将AccessKeyId535d97103885f22be7a1的用户AK状态修改为Inactive。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190202T015600Z ContentType: application/octetstream ActionUpdateAccessKey&StatusInactive&Version20100508&AccessKeyId535d97103885f22be7a1

本节主要介绍DeleteAccessKey。 此操作用来删除指定IAM用户关联的AccessKey。 说明 如果未指定用户名，IAM将根据签名请求的OOS AccessKeyID确定用户名。 此操作也可以用来删除根用户的AccessKey。 请求参数 名称 描述 是否必须 ::: Action DeleteAccessKey。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 指定删除密钥的用户名。 类型 ：字符串 取值 ：1~64位字符串组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 否 AccessKeyId 需要删除的访问密钥ID。 类型 ：字符串 是 请求示例 删除AccessKeyId535d97103885f22be7a1对应用户的AccessKey。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190202T011219Z ContentType: application/octetstream ActionDeleteAccessKey&Version20100508&AccessKeyId535d97103885f22be7a1 响应示例 HTTP/1.1 200 OK xamzrequestid:66375df54d24461d ContentType:text/xml;charsetUTF8 ContentLength:210 Date:Sat, 02 Feb 2019 01:12:20 GMT Server: CTYUN 66375df54d24461d

项目 描述 限定登录时长 登录失败次数的限定时间。如果在限定登录时长内IAM用户达到登录失败次数后，会被锁定一段时间，锁定时间结束后，才能重新登录。 取值：整数形式，[15, 60]，单位是分钟。 登录失败次数 IAM用户在限定时间内允许连续登录失败的次数。 取值：整数形式，[5, 10]。 锁定时间长度 IAM用户被锁定的时间。 取值：整数形式，[15, 60]，单位是分钟。 是否允许单用户同时多点登录 是否允许IAM用户同一时刻在多个客户端登录。当配置为不允许时，则IAM用户不能同时在多个客户端登录，即最后一次的登录会保持，之前的登录将被强制下线。系统默认配置为允许。 登录Session过期时间长度 IAM用户登录控制台后，在无任何操作时，保存会话的时间长度。 取值：整数形式，[10, 30]，单位是分钟。

本节主要介绍V4签名认证方法。 用户可以使用以下方法来发送身份验证信息： HTTP授权请求头 使用HTTP Authorization请求头是验证OOS请求的最常用方法。所有OOS REST操作（使用POST请求的基于浏览器的上传除外）都需要此请求头。 查询字符串参数 使用URL查询参数来提供请求信息，包括身份验证信息。由于请求签名是URL的一部分，因此这种类型的URL通常称为预签名URL。 OOS还支持使用基于浏览器的HTTP POST请求的上传方式。通过HTTP POST请求，用户可以直接通过浏览器将内容上传到OOS。

请求示例 按天（byDay）查询Bucket为examplebucket、数据位置为ZhengZhou、20191015至20191016标准存储数据的流量。 plaintext GET /?ActionGetTraffics&BeginDate20191015&EndDate20191016& StorageClassSTANDARD&Bucketexamplebucket&FreqbyDay&RegionZhengZhou HTTP/1.1 Date: Wed, 16 Oct 2019 06:41:57 GMT Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn 响应示例 plaintext HTTP/1.1 200 OK Date: Wed, 16 Oct 2019 06:41:57 GMT xamzrequestid: c1bd7162b01e4a45 ContentLength: 1316 ContentType: application/xml; charsetutf8 Server: CTYUN test@ctyun.cn usertest1 STANDARD UTC +0800 all all all byDay examplebucket ZhengZhou 20191015 86400 259200 432000 604800 172800 345600 518400 691200 ...

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