名称 描述 IsTruncated 策略是否已经都返回： true：有未返回的策略。 false：已经返回所有的策略。 Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。 Policies.member.UpdateDate 最近一次更新策略的时间。 Policies.member.PolicyId 策略ID。 Policies.member.IsAttachable 策略是否可以附加到IAM用户或者IAM用户组： true：策略可以附加到IAM用户或IAM用户组。 false：策略不能附加到IAM用户或IAM用户组。 Policies.member.PolicyName 策略名称。 Policies.member.AttachmentCount 关联IAM用户和IAM用户组的个数。 Policies.member.Arn 策略的资源名称。 Policies.member.CreateDate 策略创建的时间。 Policies.member.Scope 策略类型： Local：用户自定义策略。 OOS：系统策略。 Policies.member.Description 策略的描述。

请求示例 列出策略的资源名称为arn:ctyun:iam::10rc2arpn6306/policy/testpolicy0的所有IAM用户和IAM用户组。 POST / HTTP/1.1 Host: ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190214T060233Z Contenttype: application/octetstream ContentLength: 115 ActionListEntitiesForPolicy&Version20100508&PolicyArnarn%3Actyun%3Aiam%3A%3A10rc2arpn6306%3Apolicy%2Ftestpolicy0 响应示例 HTTP/1.1 200 OK xamzrequestid:c65c1442fd4f43b3 ContentType:text/xml;charsetUTF8 ContentLength:635 Date:Thu, 14 Feb 2019 06:02:33 GMT Server: CTYUN test1 dd3cf79eda454f04871a87386792914f 514648bfbc4e423f867a25281642cdfc testgroup false c65c1442fd4f43b3

对象存储网络是天翼云推出的最新对象存储服务。对象存储网络中包含分布在全国多个省、市、自治区及直辖市的资源池，这些资源池间的存储桶（Bucket）、文件（Object）、访问密钥（AccessKeyId和SecretAccessKey）信息互通，可以实现全国数据的就近读取和写入。您可以在控制台页面右上角的地域切换下拉菜单中，选择“对象存储网络”。OOS推荐您使用“对象存储网络”来进行文件的管理。除对象存储网络之外的其他地域，存储桶、文件、访问密钥信息是不互通的。

名称 描述 是否必须 Action UntagUser。 是 Version 请求版本。 取值：20100508。默认值为20100508。 否 UserName IAM用户名。 类型：字符串 取值：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 TagKeys.member.N 用户标签键。 类型：字符串 取值：由1~128个字符组成，字符串符合表达式[p{L}p{Z}p{N}.:/+@]+。 是

类别 事件 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

本节主要介绍购买OOS相关问题。 如何开通OOS服务？ 开通OOS服务，请参照开通OOS服务。 说明 只有实名认证并且绑定了邮箱的，才能开通OOS服务。 OOS开通时，默认按照按需计费（使用量按小时计费），根据资源使用量按天计费，不使用不计费；同时也支持包年包月（资源包）的方式提前购买使用额度和时长，获取更多的优惠。 是否支持试用订购OOS服务？ 支持试用订购。如果有试用需求，可以联系您的客户经理为账号发放至少100元按需试用体验券，由客户经理进行试用按需服务的订购。 如何订购OOS资源包？ 可以通过OOS控制台或者OOS帮助中心进行订购OOS资源包，详见资源包订购。 OOS支持哪些类型的资源包？ OOS提供多种类型的资源包，用于抵扣用户在使用过程中产生的各部分费用。但是请注意，一种类型的资源包只能抵扣一种计费项，并且超出了资源包的额度之后，仍会产生按需计费。 资源包按照存储类型，可以分为：存储包、流出流量包和请求次数包。 为什么购买的资源包没有享受包年优惠? 目前只有固定规格的资源包才有包年优惠。如果您购买的是自定义规格的资源包，是无法享受包年优惠的。OOS资源包支持叠加使用，可以购买多个固定规格资源包来抵扣用量。

名称 描述 CompleteMultipartUploadResult 包含整个响应的容器。 类型：容器。 子节点：Location、 Bucket、Key、ETag。 Location 新创建文件的URI地址。 类型：URI。 父节点：CompleteMultipartUploadResult。 Bucket 分片上传对应的存储桶。 类型：字符串。 父节点：CompleteMultipartUploadResult。 Key 新创建的文件的Key。 类型：字符串。 父节点：CompleteMultipartUploadResult。 ETag ETag用来标识新创建的文件数据。 类型：字符串。 父节点：CompleteMultipartUploadResult。

存储容量如何换算？ 存储容量换算如下：1EiB 1024PiB，1PiB1024TiB，1TiB1024GiB，1GiB1024MiB，1MiB1024KiB，1KiB1024B。 如何查看资源使用情况？ 可以使用以下方式查看资源使用情况： 在控制台“统计概览”页面，可以查看资源使用情况，包括容量、流量、请求次数、带宽、并发连接数等信息。可以按照5分钟、一天等粒度进行查询。详见控制台指南统计概览。 使用API查看资源使用情况，详见API参考统计API。 OOS的费用是如何计算 OOS支持按需付费和按资源包付费两种计费方式，默认按需付费： 按需付费：按照各计费项的实际用量结算费用，先使用，后付费。 按资源包付费：针对不同的计费项，推出使用额度和时长不同的资源包，在费用结算时，优先从资源包抵扣用量，先购买，后抵扣，超出资源包的部分自动转按需计费。 详细的价格信息参见计费说明。 请求次数是如何计算的？ 通过控制台、工具、API、SDK、生命周期转储/删除等任意方式对OOS进行操作，都是对OOS API的调用，每调用一次API都计算一次请求次数。请求次数支持按需计费和资源包计费。除了服务端返回的状态码为5XX或403错误的请求外，其余的请求均会计费。

图片格式 只能转换图片文件格式的文件，支持的原图片格式为：jpg、 png、 bmp、 webp。 转换后的图片格式支持jpg、png、bmp和webp。其中： jpg、 png、 bmp、 webp的图片可以保存为jpg、png、bmp和webp中的任意一种格式； 图片如果不指定保存格式，默认保存为原格式。例如：格式为png的图片，默认保存为png格式的图片。 原图片的大小不能超过20MiB。 缩略后的图片的大小有限制，目标缩略图的宽与高的乘积不能超过4096 4096， 而且单边的长度不能超过4096 4。 一次转换请求最多支持4个管道处理。 存储桶属性限制 处理的图片所在存储桶（Bucket）的“存储桶属性”>“访问权限”不可以设置为私有。存储桶的访问权限修改详见查看/修改存储桶属性。

本节主要介绍如何将数据从阿里云OSS迁移到OOS中。 应用场景 将数据从阿里云OSS的Bucket迁移到OOS的Bucket。 注意 在线迁移会占用源地址和目的地址的网络资源。若您的业务比较重要，建议您对迁移任务设置限速（设置system.conf中的maxThroughput），或在空闲时间启动迁移任务。 从阿里云OSS迁移到OOS的文件，仅迁移当前可读取到的文件，不支持按object version Id 迁移。 前提条件 Windows7 及以上版本或 Linux CentOS 7.x 及以上版本。 Java 1.8 及以上版本。 迁移工具所在的服务器可以访问阿里云OSS资源池和OOS资源池。 具体操作 确定目标Bucket 在OOS中创建目标Bucket，具体操作请参见创建存储桶（Bucket）或PUT Bucket，用于存放迁移的数据。也可以使用已存在的Bucket。 下载安装迁移工具 1. 下载数据迁移工具。 2. 解压缩安装包 对于Windows客户端，直接解压缩迁移工具zip 包即可。 对于Linux客户端，执行 unzip 解压缩安装包。 迁移工具解压后的目录结果如下： CTYUNOOSImportversionid config log4j2.xml migrate.conf system.conf lib import.sh import.bat 修改配置文件 更新迁移任务配置文件 migrate.conf，配置源和目的资源池信息、迁移配置项。您可根据需要配置system.conf和 log4j2.xml文件，具体参数介绍参见常用工具OOS数据迁移工具迁移步骤。其中： srcType需填写为：OSS，代表阿里云。 srcEndpoint为阿里云Bucket的Endpoint，您可在阿里云控制台Bucket概览中进行查看。 OSS AccessKey和SecretKey需要至少拥有源Bucket的读权限，OOS的AccessKeyID和SecretAccessKey需要至少拥有目的Bucket的写权限。 migrate.conf配置示例如下： { "srcType":"OSS", 从阿里云迁移文件 "srcEndpoint":"osscnhangzhou.aliyuncs.com", 阿里云的Endpoint，请根据实际填写 "srcAccessKey":"your oss accessKey",阿里云的AccessKey "srcSecretKey":"your oss secretKey", 阿里云的SecretKey "srcBucket":"ossbucket", 阿里云的Bucket "srcPrefix":"logs/", 阿里云上要迁移文件的前缀，请根据实际填写 "srcMarker":"", 从第一个文件开始迁移 "srcStopObject":"", 阿里云上要迁移的截止文件 "destEndpoint":"ooscn.ctyunapi.cn", OOS的Endpoint "destAccessKey":"AccessKeyID", OOS的AccessKeyID "destSecretKey":"SecretAccessKey", OOS的SecretAccessKey "destBucket":"BucketName", OOS的Bucket名称 "isSkipExistFile":false 是否跳过目标资源池中已有的文件 }

本节主要介绍List Bucket Inventory Configuration。 此操作用来查看某Bucket的所有Bucket清单的配置。 请求语法 不带continuationtoken参数 GET /?inventory HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 带continuationtoken参数 GET /?inventory&continuationtokencontinuationtoken HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求头 名称 描述 是否必须 continuationtoken 指定List操作需要从此token开始，前一次响应中返回的NextContinuationToken值。 若上一次请求无法返回全部清单配置项，则会返回NextContinuationToken，后一次请求需要输入返回的NextContinuationToken参数作为continuationtoken的值。 否 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 响应结果 名称 描述 :: ListInventoryConfigurationsResult 整个响应的容器。 类型：容器。 子节点：ContinuationToken、InventoryConfiguration、IsTruncated、NextContinuationToken。 ContinuationToken 本次请求的continuationtoken参数。 类型：字符串。 父节点：ListInventoryConfigurationsResult。 InventoryConfiguration 清单配置的容器。 类型：容器。 父节点：ListInventoryConfigurationsResult 子节点：Destination、IsEnabled、Filter、Id、OptionalFields、Schedule。 Destination 存放清单结果的容器。 类型：容器。 父节点：InventoryConfiguration。 子节点：OOSBucketDestination。 OOSBucketDestination 存放清单结果的Bucket信息。 类型：容器。 父节点：Destination。 子节点：Bucket、Format、Prefix。 Bucket 存放清单结果文件的Bucket。 类型：字符串。 父节点：OOSBucketDestination。 Format 清单结果文件的类型。 类型：字符串。 父节点：OOSBucketDestination。 Prefix 清单结果的存储路径前缀。 类型：字符串。 父节点：OOSBucketDestination。 IsEnabled 清单功能是否启用： true：启用清单功能。 false：不启用清单功能。 类型：布尔型。 父节点：InventoryConfiguration。 Filter 清单筛选的前缀。 类型：容器。 父节点：InventoryConfiguration。 子节点：Prefix。 Prefix 筛选规则的匹配前缀。 类型：字符串。 父节点：Filter。 Id 清单名称。 类型：字符串。 父节点：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：按周导出清单结果文件。 类型：字符串。 父节点：Schedule。 IsTruncated 是否还有未列举的清单： true：表示还有未列举的清单。您可以将NextContinuationToken字段的值作为下一次list请求的continuationtoken参数，以获取下一页的清单配置列表。 false：表示本次已列举完成所有清单。 类型：布尔型。 父节点：ListInventoryConfigurationsResult。 NextContinuationToken 当响应中的IsTruncated为true，且NextContinuationToken非空时，使用该字段作为下一次list请求的continuationtoken参数。 类型：字符串。 父节点：ListInventoryConfigurationsResult。

请求示例 PUT /?inventory&id1 HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Wed, 23 Aug 2023 07:14:20 GMT Connection: keepalive ContentLength: 466 Authorization: SignatureValue arn:ctyun:oos:::docs CSV Inventory 1 true Size Daily 响应示例 HTTP/1.1 200 OK Date: Wed, 23 Aug 2023 07:14:20 GMT xamzrequestid: 16b538e3df744c04e02c23343a373a19353125392e2f48341e ContentLength: 0 Server: CTYUN

响应示例 HTTP/1.1 200 OK xamzrequestid:999e8e61dc9049bc ContentType:text/xml;charsetUTF8 ContentLength:210 Date:Sat, 02 Feb 2019 01:56:03 GMT Server: CTYUN 999e8e61dc9049bc

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

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

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

本节主要介绍IAM用户密码。 对于IAM用户，点击“访问控制”>“安全凭证”>“密码”，可以修改登录密码。 注意 只有具有更改密码权限用户的子用户才能进行更改密码。根用户的密码通过天翼云页面修改。

名称 描述 IsTruncated 用户是否已经都返回： true：有未返回的用户。 false：已经返回所有的用户。 Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。 Users.member.PasswordLastUsed 上次使用用户密码登录OOS网站时间，采用ISO 8601日期时间格式。 说明 如果从未使用密码登录，不返回此字段。 如果用户当前没有密码，但过去有密码，则此字段包含最近使用密码的时间。 Users.member.UserName IAM用户名。 Users.member.Arn IAM用户的资源名称。 Users.member.UserId IAM用户ID。 Users.member.CreateDate IAM用户创建时间。 Users.member.JoinDate IAM用户加入该用户组的时间。 Group.GroupName IAM用户组名。 Group.Arn IAM用户组的资源名称。 Group.GroupId IAM用户组ID。 Group.CreateDate IAM用户组创建的时间。

本节主要介绍REST错误响应。 当请求出错时，OOS返回以下格式的错误响应信息。 NoSuchKey The resource you requested does not exist. /mybucket/myfoto.jpg 4442587FB7D0A2F9 响应元素说明如下。 名称 描述 :: Code 错误码是描述出错信息的字符串。 Message 错误信息的简单描述。 RequestId 请求的ID。 Resource 出错相关的Bucket或Object信息。

响应示例 HTTP/1.1 200 OK xamzrequestid:46951e81d14e4da7 ContentType:text/xml;charsetUTF8 ContentLength:466 Date:Fri, 15 Mar 2019 08:16:54 GMT Server: CTYUN testchpasswd true 20190315T08:16:55Z 46951e81d14e4da7

名称 描述 ListMultipartUploadsResult 包含整个响应的容器。 类型：容器。 子节点：Bucket、KeyMarker、UploadIdMarker、NextKeyMarker、NextUploadIdMarker、Maxuploads、Delimiter、Prefix、CommonPrefixes、IsTruncated、EncodingType、Upload。 Bucket 分片上传对应的容器名称。 类型：字符串。 父节点：ListMultipartUploadsResult。 KeyMarker 指定key值，在这个key当前位置或它之后开始列表操作。 类型：字符串。 父节点：ListMultipartUploadsResult。 UploadIdMarker 指定分片上传ID，在这个ID所在位置之后开始列表操作。 类型：字符串。 父节点：ListMultipartUploadsResult。 NextKeyMarker 当此次列表不能将所有正在执行的分片上传过程列举完成时，NextKeyMarker作为下一次列表请求的keymarker参数的值。 类型：字符串。 父节点：ListMultipartUploadsResult。 NextUploadIdMarker 当此次列表不能将所有正在执行的分片上传过程列举完成时，NextKeyMarker作为下一次列表请求的uploadidmarker参数的值。 类型：字符串。 父节点：ListMultipartUploadsResult。 MaxUploads 响应中包含的上传过程的最大数目。 类型：字符串。 父节点：ListMultipartUploadsResult。 IsTruncated 标识此次分片上传过程中的所有片段是否全部被列出，如果为true则表示没有全部列出。如果分片上传过程的片段数超过了MaxParts元素指定的最大数，则会导致一次列表请求无法将所有片段数列出。 类型：Boolean。 父节点：ListMultipartUploadsResult。 EncodingType KeyMarker、NextKeyMarker、Key、Prefix、Delimiter的编码类型。 类型：字符串。 父节点：ListMultipartUploadsResult。 Upload 某个分片上传过程的容器，响应体中可能包含0个或多个Upload元素。 类型: 容器。 父节点: ListMultipartUploadsResult。 子节点: Key、UploadId、Initiator、Owner、StorageClass、Initiated。 Key 分片上传过程起始位置文件的Key值。 类型: String。 父节点: Upload。 UploadId 分片上传过程的ID号。 类型: 整型。 父节点: Upload。 Initiator 指定执行此次分片上传过程的用户账户。 类型：容器。 父节点：Upload。 子节点：ID，DisplayName。 ID OOS账户的ID。 类型：字符串。 父节点：Initiator。 StorageClass 文件的存储类型： STANDARD STANDARDIA 类型：字符串。 父节点：Upload。 Initiated 分片上传过程启动的时间。 类型：Date。 父节点：Upload。 Prefix 如果请求中包含了Prefix参数，则这个字段会包含Prefix的值。返回的结果只包含那些key值以Prefix开头的文件。 类型：字符串。 父节点：ListMultipartUploadsResult。 Delimiter 分割符，用来对关键字们进行分组的字符。所有的关键字都包含delimiter和prefix间的相同子串，prefix之后第一个遇到delimiter的字符串都会加到一个叫CommonPrefix的组中。如果没有特别定义prefix，所有的关键字都会被返回，但不会有CommonPrefix。 类型：字符串。 父节点：ListMultipartUploadsResult。 CommonPrefixes 当定义delimiter之后，返回结果中会包含CommonPrefixes，CommonPrefix中包含以prefix开头，delimiter结束的字符串组合，例如prefix是note/，同时delimiter是斜杠（/），结果中的note/summer/july/lotus.jpg将返回note/summer/，其余结果将按照maxuploads要求返回。 类型：容器。 父节点：ListMultipartUploadsResult。 子节点：Prefix。 CommonPrefixes.Prefix 如果请求中不包含Prefix参数，那么这个元素只显示那些在delimiter字符第一次出现之前的key的子字符串，且这些key不在响应的其它位置出现。 如果请求中包含Prefix参数，那么这个元素显示在prefix之后，到第一次出现delimiter之间的子串。 类型：字符串。 父节点：CommonPrefixes。

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

数据从COS迁移至OOS示例 { "srcType":"COS", 从COS迁移文件（Object） "srcAccessKey":"your cos accessKey", COS的AccessKey "srcSecretKey":"your cos secretKey", COS的SecretKey "srcBucket":"cosbucket", COS的Bucket "srcRegionName":"apbeijing", COS的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/", COS上要迁移文件（Object）的前缀 "srcMarker":"", 从第一个文件（Object）开始迁移 "srcStopObject":"", COS上要迁移的截止文件（Object） "isSkipExistFile":false 是否跳过目标资源池中已有的文件（Object） } 数据从OBS迁移至OOS示例 { "srcType":"OBS", 从OBS迁移文件（Object） "srcEndpoint":"obs.cnnorth4.myhuaweicloud.com", OBS的Endpoint "srcAccessKey":"your obs accessKey",OBS的AccessKey "srcSecretKey":"your obs secretKey", OBS的SecretKey "srcBucket":"obsbucket", OBS的bucket "destEndpoint":"ooscn.ctyunapi.cn", OOS的Endpoint "destAccessKey":"your oos accesKey", OOS的AccessKey "destSecretKey":"your oos secretKey", OOS的SecretKey "destBucket":"oosbucket", OOS的Bucket "srcPrefix":"logs/", OBS上要迁移文件（Object）的前缀 "srcMarker":"", 从第一个文件（Object）开始迁移 "srcStopObject":"", OBS上要迁移的截止文件（Object） "isSkipExistFile":false 是否跳过目标资源池中已有的文件（Object） }

名称 描述 Arn IAM用户的资源名称。 UserName IAM用户名。 UserId IAM用户ID。 CreateDate 创建IAM用户的时间，采用ISO 8601日期时间格式。 PasswordLastUsed 上次使用用户密码登录OOS网站，采用ISO 8601日期时间格式。 说明 如果从未使用密码登录，不返回此字段。 如果用户当前没有密码，但过去有密码，则此字段包含最近使用密码的时间。 IPLastUsed 最近一次登录控制台的IP。 Tags.member.Key 标签键。 Tags.member.Value 标签值。

本节主要介绍操作跟踪的错误码。 响应码 错误码(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 TrailtrailName 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只能设置一个。

响应结果 说明 调用IAM API后返回数据采用统一格式，响应结果格式为XML格式。本文档中的响应示例为了便于用户查看，做了格式化处理，实际返回结果是没有进行换行、缩进等处理的。 公共响应头 说明 在后续提到具体IAM API时，举例中都会有公共响应头，但是不对其进行描述和解释。 每个IAM API响应结果中都会包含公共响应头。公共响应头如下： 名称 描述 :: xamzrequestid 服务端生成的用于标识请求的ID。 ContentType 响应内容类型。 Date 响应日期。 Server 服务器名。 ContentLength 响应体的长度，单位为Byte。 Connection 客户端与OOS服务器之间的连接状态。 如果请求时Connection值为keepalive，请求结束后继续保持连接，不返回此响应头。 如果请求时Connection值为close，请求结束后关闭连接，返回此响应头Connection: close。 成功响应结果 调用IAM API成功后，如果响应结果HTTP状态为：200 OK，代表IAM API调用成功。示例如下： HTTP/1.1 200 OK 具体响应结果><> 失败响应结果 调用IAM API失败后，如果响应结果HTTP状态为：4xx或者5xx，代表调用失败。示例如下： HTTP/1.1 4xx或者5xx 具体响应结果><> 字符编码 请求及返回结果都使用UTF8字符集进行编码。

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

操作权限 涉及资源 API Bucket列表 ListBucket Bucket（ BucketName 或） GET Bucket（List Objects）、HEAD Bucket Bucket列表 ListAllMyBucket 所有（） GET Service Bucket列表 GetRegions 所有（） GET Regions Bucket读取 ListBucketMultipartUploads Bucket（ BucketName 或） List Multipart Uploads Bucket读取 GetBucketAcl Bucket（ BucketName 或） GET Bucket acl Bucket读取 GetBucketLocation Bucket（ BucketName 或） GET Bucket location Bucket读取 GetBucketPolicy Bucket（ BucketName 或） GET Bucket policy Bucket读取 GetLifecycleConfiguration Bucket（ BucketName 或） GET Bucket lifecycle Bucket读取 GetBucketWebsite Bucket（ BucketName 或） GET Bucket website Bucket读取 GetBucketCORS Bucket（ BucketName 或） GET Bucket CORS Bucket读取 GetBucketLogging Bucket（ BucketName 或） GET Bucket logging Bucket读取 GetBucketObjectLockConfiguration Bucket（ BucketName 或） GET Bucket Object Lock Bucket读取 GetBucketInventoryConfiguration Bucket（ BucketName 或） GET Bucket Inventory Configuration、List Bucket Inventory Configuration Bucket写入 PutBucket Bucket（ BucketName 或） PUT Bucket Bucket写入 DeleteBucket Bucket（ BucketName 或） DELETE Bucket Bucket写入 DeleteMultipleObjects Bucket（ BucketName 或） DELETE Multiple Objects Bucket写入 PutLifecycleConfiguration Bucket（ BucketName 或） PUT Bucket lifecycle、DELETE Bucket lifecycle Bucket写入 PutBucketWebsite Bucket（ BucketName 或） PUT Bucket website Bucket写入 DeleteBucketWebsite Bucket（ BucketName 或） DELETE Bucket website Bucket写入 PutBucketCORS Bucket（ BucketName 或） PUT Bucket CORS、DELETE Bucket CORS Bucket写入 PutBucketLogging Bucket（ BucketName 或） PUT Bucket Logging Bucket写入 PutBucketObjectLockConfiguration Bucket（ BucketName 或） PUT Bucket Object Lock Bucket写入 DeleteBucketObjectLockConfiguration Bucket（ BucketName 或） DELETE Bucket Object Lock Bucket写入 PutBucketInventoryConfiguration Bucket（ BucketName 或） PUT Bucket Inventory Configuration、DELETE Bucket Inventory Configuration Bucket权限 PutBucketPolicy Bucket（ BucketName 或） PUT Bucket policy Bucket权限 DeleteBucketPolicy Bucket（ BucketName 或） DELETE Bucket policy Object读取 ListMultipartUploadParts Object（ BucketName / ObjectName 、 BucketName /或） List Parts Object读取 GetObject Object（ BucketName / ObjectName 、 BucketName /或） GET Object、HEAD Object Object写入 PutObject Object（ BucketName / ObjectName 、 BucketName /或） PUT Object、PUT ObjectCopy、POST Object、Initiate Mulitipart Upload、Upload Part、Compelete Multipart Upload、Upload Part Copy Object写入 DeleteObject Object（ BucketName / ObjectName 、 BucketName /或） DELETE Object Object写入 AbortMultipartUpload Object（ BucketName / ObjectName 、 BucketName /或） Abort Multipart Upload

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

名称 描述 Policies 账户中已有的策略个数。 GroupsPerUserQuota IAM用户加入到IAM用户组的数量限制。 AttachedPoliciesPerUserQuota 每个IAM用户关联的策略数量限制。 Users 账户中已有的IAM用户数。 PoliciesQuota 账户中的策略数量限制。 AccessKeysPerUserQuota 每个IAM用户的AccessKey数量限制。 AttachedPoliciesPerGroupQuota 每个IAM用户组关联的策略数量限制。 Groups 账户中已有的用户组数量。 UsersQuota 账户中的IAM用户数量限制。 MFADevices 账户中已有的虚拟MFA设备总数。 MFADevicesInUse 账户中已使用的虚拟MFA设备数量。 AccountAccessKeysPresent 根用户已有的AccessKey数量。 GroupsQuota 账户中的IAM用户组数量限制。

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

名称 描述 LoginSecurityPolicy.PeriodWithLoginFailures 登录失败次数的限定时间。单位为分钟。 LoginSecurityPolicy.LoginFailedTimes IAM用户在限定时间内允许连续登录失败的次数。 LoginSecurityPolicy.LockoutDuration IAM用户被锁定的时间。单位为分钟。 LoginSecurityPolicy.AllowSingleUsersSimultaneousLogin 是否允许IAM用户同一时刻在多个客户端登录： true：允许IAM用户同一时刻在多个客户端登录。 false：不允许IAM用户同一时刻在多个客户端登录。IAM用户同一时刻在多个客户端登录时，最后一次的登录会保持，之前的登录将被强制下线。 LoginSecurityPolicy.SessionDuration IAM用户登录控制台后，在无任何操作时，保存会话的时长。单位为分钟。