图片格式 只能转换图片文件格式的文件，支持的原图片格式为：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

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

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

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

名称 描述 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） }

本节主要介绍操作跟踪的错误码。 响应码 错误码(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字符集进行编码。

操作权限 涉及资源 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

请求语法 PUT /?cors HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn ContentLength: length Date: date Authorization: SignatureValue ContentMD5: MD5 Origin you want to allow crossdomain requests from ... ... HTTP method ... ... Time in seconds your browser to cache the preflight OPTIONS response for a resource Headers that you want the browser to be allowed to send ... ... Headers in the response that you want accessible from client application ... ... ... 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 CORSConfiguration 最多包含100个CORSRule元素的容器。 类型：容器。 子节点：CORSRule。 是 CORSRule 用户允许跨域的源和方法。 类型：容器。 子节点：AllowedOrigin、AllowedMethod、AllowedHeader、MaxAgeSeconds、ExposeHeader、ID。 父节点：CORSConfiguration。 是 ID 规则的唯一标识。最长255个字符。 类型：字符串。 父节点：CORSRule。 否 AllowedMethod 允许跨域的HTTP方法。每个CORSRule应至少包含一个源和一个方法。 类型: 枚举 (GET, PUT, HEAD, POST, DELETE)。 父节点：CORSRule。 是 AllowedOrigin 允许跨域的源。每个CORSRule应至少包含一个源和一个方法。 可以包含通配符，但最多只能包含一个，比如： 表示允许所有源跨域访问。 类型：字符串。 父节点：CORSRule。 是 AllowedHeader 控制在预检OPTIONS请求中AccessControlRequestHeaders头中指定的header是否允许。AccessControlRequestHeaders 中的每个请求头名称，必须在规则中有匹配的条目。 规则中的每个 AllowedHeader最多可以包含一个 通配符字符。例如，xamz。 类型：字符串。 父节点：CORSRule。 否 MaxAgeSeconds 指定浏览器对特定资源的预检（OPTIONS）请求返回结果的缓存时间，单位为秒。通过缓存响应，在需要重复原始请求时，浏览器无需向 OOS 发送预检请求。 一个CORSRule最多包含一个MaxAgeSeconds元素。 类型：整型。 取值：大于等于1的整数。1表示禁用缓存。 父节点：CORSRule。 否 ExposeHeader 指定客户应用程序(例如，JavaScript XMLHttpRequest文件)能够访问的响应头。 类型：字符串。 父节点: CORSRule。 否

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

请求示例 GET /?website HTTP/1.1 xamzcontentsha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 xamzdate: 20220718T091530Z Host: examplebucket.ooscn.ctyunapi.cn Accept: text/html, image/gif, image/jpeg, ; q.2, /; q.2 Connection: keepalive Authorization: SignatureValue 响应示例 HTTP/1.1 200 OK ContentType: application/xml;charsetUTF8 Date: Mon, 18 Jul 2022 09:15:30 GMT xamzrequestid: 88d52b33bef4440b3a867d8e9491947396a0828487828b9778 ContentLength: 430 Server: CTYUN index.html error.html images/ errorpage.html

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

本节主要介绍流量的统计信息。 进入“统计”页面，点击“流量”，可以查看上行流量和下行流量的统计信息，包括标准存储和低频访问存储的流量。 流量统计信息描述 项目 描述 时间选择 流量查询的时间段，可以选择查看下列时间段的流量： 今日。 昨日。 近7日。 近30日。 根据日历按钮，选择查询任意90天内的流量。 时间粒度 流量查询的时间粒度，可以选择： 按五分钟查询：统计信息按每5分钟展示，可以选择查询今日、昨日或按日历选择任意1天的数据。 按小时查询：统计信息按每小时展示，可以查询今日、昨日、近7日或按日历选择任意7天内的数据。 按天查询：统计信息按天展示，可以查询今日、昨日、近7日、近30天或按日历按钮选择任意90天内的数据。 数据位置 流量查询数据位置，可以选择： 全部数据位置：展示所有数据位置的流量之和。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的流量。 存储桶 容量查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的流量之和。 具体存储桶：根据显示的存储桶，选择查看对应存储桶的流量。 流量类型 选择流量统计的类型（所有流量均为累计值）： 全部流量：所有流量和值，包括互联网直接流量、互联网漫游流量、非互联网直接流量、非互联网漫游流量。 互联网直接流量：从互联网上传下载文件，并且未经对象存储网络内部调度产生的流量。 互联网漫游流量：从互联网上传下载文件，并且经过对象存储网络内部调度产生的流量。 非互联网直接流量：从非互联网（例如内网）上传下载文件，并且未经对象存储网络内部调度产生的流量。 非互联网漫游流量：从非互联网（例如内网）上传下载文件，并且经过对象存储网络内部调度产生的流量。 存储类型 选择流量查询的存储类型： 全部存储类型：分别展示标准存储和低频访问存储的流量。 标准类型：标准存储的流量。 低频访问存储：低频访问存储的流量。 可以点击“下载”按钮，将流量统计信息下载到本地查看。 项目 描述 Date 统计时间。 Region 数据位置。 Bucket 存储桶。 StorageClass 存储类型。 InternetDirectInbound 互联网直接上行流量，单位是Byte。 InternetRoamInbound 互联网漫游上行流量，单位是Byte。 NonInternetDirectInbound 非互联网直接上行流量，单位是Byte。 NonInternetRoamInbound 非互联网漫游上行流量，单位是Byte。 InternetDirectOutbound 互联网直接下行流量，单位是Byte。 InternetRoamOutbound 互联网漫游下行流量，单位是Byte。 NonInternetDirectOutbound 非互联网直接下行流量，单位是Byte。 NonInternetRoamOutbound 非互联网漫游下行流量，单位是Byte。

本节主要介绍统计概览中的概览页面。 点击“统计概览”>“概览”，可用查看存储桶当日统计，包括：标准存储、低频访问存储、互联网下行流量、互联网上行流量、Get类请求和Put类请求。 点击该页面的“昨日关键数据”（统计时间范围为北京时间当前时刻的前一天00:0024:00的数据），可用查看各数据位置昨日的标准存储（峰值）、低频访问存储（峰值）、互联网下行流量、请求次数、数据取回。 项目 描述 当日统计 当日的存储容量，包括标准存储和低频访问存储。 当日流量 当日的流量统计，可以选择互联网下行流量（下载量）、互联网上行流量（上传量）。 当日请求次数 当日的请求次数，可以选择： 全部：包括所有的Put类请求和Get类请求。 Put类请求。 Get类请求。 昨日关键数据 统计时间范围为北京时间当前时刻的前一天00:0024:00的数据。 数据位置 存放文件的位置。 标准存储（峰值） 标准存储类型的文件的容量峰值。 低频访问存储（峰值） 低频访问存储类型的文件的容量峰值。 互联网下行流量 从互联网下载文件的数据流量。 请求次数 统计产生的GET请求、HEAD请求、PUT请求、POST请求、DELETE请求、OTHERS的次数，以及所有请求的次数总和。统计产生返回码200、204、206、403、404、4xx的次数，以及所有返回码返回次数的总和。 数据取回 低频访问存储类型的文件在查看和下载时产生的从OOS服务端读取数据的数据量。 点击该页面的“当月关键数据”（统计时间范围为北京时间当前月份的1号00：00至当前时刻的能获取到的最后一个数据），可用查看各数据位置当月的标准存储（峰值）、低频访问存储（峰值）、互联网下行流量、请求次数、数据取回。

请求示例 查询Bucket名为examplebucket，20181224的流量。 GET /?ActionGetUsage&BucketNameexamplebucket&EndDate20181224&BeginDate20181224 HTTP/1.1 Host: ooscnmg.ctyunapi.cn Authorization: SignatureValue Date: Wed, 26 Dec 2018 09:01:30 GMT ContentType: application/xml; charsetutf8 响应示例 HTTP/1.1 200 OK xamzrequestid: 236A8905248E5A01 Date: Wed, 26 Dec 2018 09:01:30 GMT ContentLength:1200 ContentType: application/xml; charsetutf8 Server: CTYUN test@ctyun.cn examplebucket ZhengZhou 20181224 3048576 40000 60000 0 20 30 60 60 60 60 60 80 0 0 0 0 0 0 0 0 0 0 0 global ...

API 描述 CreateTrail 此操作用来创建一个跟踪，并将跟踪日志保存到指定的OOS Bucket。 DeleteTrail 此操作用来删除指定的跟踪。 DescribeTrails 此操作用来获取跟踪的设置信息。 GetTrailStatus 此操作用来获取跟踪状态信息。 PutEventSelectors 此操作用来配置跟踪的管理事件筛选器。 GetEventSelectors 此操作用来查看管理事件筛选器的设置信息。 UpdateTrail 此操作用来更新跟踪设置参数。 StartLogging 此操作用来开启跟踪。 StopLogging 此操作用来停止跟踪。 LookupEvents 此操作用来查看账户中的管理事件。

主要介绍授权用户/用户组。 查看授权用户/用户组 在“权限策略”页，点击对应策略名或者“操作”列的“管理”，进入对应策略详情页，可以在“用户/组”页，查看当前策略已关联的用户和用户组，同时可以为用户或用户组进行授权和移除授权。 授权用户/用户组 在“权限策略”页面，点击“授权”，弹出“授权用户/组”页面。选择需要授权的用户或用户组，可以为其进行授权。弹框中灰色的用户/组表示已关联该策略的用户或用户组。

名称 描述 ObjectLockConfiguration 合规保留配置信息的容器。 类型：容器。 子节点：ObjectLockEnabled、Rule。 ObjectLockEnabled Bucket是否开启合规保留功能： Enabled：开启合规保留。 Disabled：不开启合规保留。 类型：枚举。 父节点：ObjectLockConfiguration。 Rule 合规保留的规则。 类型：容器。 父节点：ObjectLockConfiguration。 子节点：DefaultRetention。 DefaultRetention 默认的合规保留配置。 类型：容器。 父节点：Rule。 子节点：Mode、Days或Years二选一。。 Mode 合规保留模式。 COMPLIANCE：合规保留。 类型：枚举 父节点：DefaultRetention Days 合规保留的天数。 类型：整型。 父节点：DefaultRetention。 Years 合规保留的年数。 类型：整型。 父节点：DefaultRetention。

名称 描述 GetSessionTokenResult.Credentials.SessionToken 安全令牌。 GetSessionTokenResult.Credentials.AccessKeyId 临时访问AccessKeyId。 GetSessionTokenResult.Credentials.SecretAccessKey 临时访问SecretAccessKey。 GetSessionTokenResult.Credentials.Expiration 过期时间。 ResponseMetadata.RequestId 请求ID。

本节主要介绍怎么退订OOS资源包。 资源包退订的步骤： 1. 进入资源包退订页面。 2. 资源包退订。 进入资源包退订页面 进入资源包退订页面有两种方式： 方式1：通过官网管理中心 点击“管理中心”>“资源管理”>“资源包”>“OOS资源包”，选择需要退订的资源包，点击“操作”列的“退订”，即可跳转到退订页。 方式2：通过OOS控制台 登录OOS控制台，点击“资源包管理”按钮，即可看到已订购的资源包。选择需要退订的资源包，点击“操作”列的“退订”，即可跳转到退订页。 资源包退订 进入退订页后，核对需要退订的资源包，选择退订原因，并勾选“我已确认本次退订金额和相关费用”，点击“退订”。 点击“退订”后，弹出提示框，可以根据提示框，点击“查看订单”或者“返回列表”。

布尔值条件运算符 利用布尔值条件，用户可以通过与“正确”或“错误”的对比，来设置Condition元素。 条件运算符 描述 Bool 布尔值匹配。 例如，下列声明使用 Bool 条件运算符与 ctyun:SecureTransport 键来指定必须使用 SSL 发出请求。 { "Version": "20121017", "Statement": [ { "Effect": "Allow", "Principal":{ "CTYUN": [""] }, "Action": "oos:GetObject", "Resource": "arn:ctyun:oos:::examplebucket/", "Condition": {"Bool": {"ctyun:SecureTransport": "true"}} } ] } IP Address Conditions IP address conditions允许设置IP地址的匹配规则，与ctyun:SourceIp key配合使用。此项的值必须符合标准的CIDR格式（例如：10.52.176.0/24），参考RFC 4632。 Condition 描述 IpAddress IP地址或范围的白名单。 NotIpAddress IP地址或范围的黑名单。 条件键 条件键 描述 ctyun:Referer 与字符串运算符结合使用。用于检查请求中的Referer请求头。 ctyun:SecureTransport 与布尔值运算符结合使用。检查请求是否是使用SSL发送的。 ctyun:SourceIp 与IP地址运算符结合使用。用于检查请求者的IP地址。 ctyun:UserAgent 与字符串运算符结合使用。用于检查请求者的客户端应用程序。

本节主要介绍欠费问题。 欠费原因 未购买资源包，在按需计费的模式下帐号的余额不足。 已购买资源包，但使用量超出资源包额度，或者产生了与资源包属性不符的其他计费项金额，进而产生按需计费，同时帐号中的余额不足以抵扣产生的按需费用。 欠费说明 欠费后OOS服务会自动停止，您所占用的存储空间资源仍会继续扣费，因此欠费余额会累计。 如果您在15天内充值补足欠款，服务会自动启用。 当欠费超过15天，将视为您主动放弃该服务，您保存在OOS的全部数据将会被销毁，销毁后数据不可恢复。因此请您及时关注账户余额并及时续费以保证您的服务不受到影响。 若您不再继续使用OOS，为防止持续扣费导致帐号欠费，请将您帐号下所有资源（存储桶和文件）删除，同时请不要再使用您的帐号及帐号下的IAM用户访问您的OOS。 查看欠费资源 如果您想查询哪些资源的扣费导致帐户欠费，可以在“费用中心”>“账单管理”>“账单概览“查询在天翼云的消费概况。 续费说明 若是已购买资源包后欠费，请在15天内再次订购相应的资源包或保证帐号中的余额充足。 若是未购买资源包后欠费，请在15天内充值补足欠款并保证帐号中的余额充足。

项目 描述 当前位置 文件上传的位置。 存储类型 文件的存储类型： 标准存储：访问时延低、吞吐量高，能够有效支持各种热点类型数据频繁访问。适用于各种音视频服务、图片服务、大型网站、大数据分析等应用的数据存储。标准存储是默认的存储类型。如果上传文件时未指定存储类型，OOS默认使用标准存储。 低频访问存储：适合长期保存不经常访问的数据。对于不经常访问但仍需要实时访问的数据，可以采用低频访问存储，例如各类移动应用、智能设备、企业数据的长期备份。 最短存储时间：低频访问存储的文件有最短存储时间，存储时间短于30天的文件被提前删除或变更时，会产生一定费用。 最小计费大小：低频访问存储文件有最小计费大小，即如果文件大小低于64KiB，会按照64KiB计算收费，文件大于等于64KiB按照实际存储收费。 数据取回：获取低频访问存储文件时会产生数据取回费用。 选择文件 可以通过将目录或文件拖到浮窗上传文件，也可以点击添加文件、添加文件夹按钮上传文件。 上传的文件中如果想移除的，可以勾选对应的文件，点击“移除”按钮，进行文件移除。 说明 在查找框中可以模糊匹配查找上传的文件。 元数据 用户可以编辑上传文件的文件元数据信息，具体元数据信息详见

本节主要介绍怎么在控制台进行文件预览。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以预览对象。 点击文件“操作”列的“预览”按钮，可以预览该文件。 注意 基于安全合规要求，禁止通过OOS默认域名预览后缀为apk、ipa的文件，在Header中包含签名或者通过自定义域名方式下载此类文件不受影响。 预览的文件为图片或网页时，会以附件的形式下载到本地。

项目 描述 Date 统计时间。 StorageClass 存储类型： STANDARD：标准存储。 STANDARDIA：低频访问存储。 BilledStorageUsage 计费容量，单位是Byte。 SampleCapacity 实时值，单位是Byte。 MaxCapacity 峰值，单位是Byte。 AverageCapacity 平均值，单位是Byte。 RemainderChargeStorageUsage 补齐容量之和，包括时长补齐和大小补齐，单位是Byte。 RemainderChargeOfDuration 时长补齐容量，单位是Byte。 RemainderChargeOfSize 大小补齐容量，单位是Byte。

本节主要介绍请求次数的统计信息。 进入“统计”页面，点击“请求次数”，可以查看请求次数及对应返回码统计信息，包括标准存储和低频访问存储的请求次数。 请求次数和返回码次数统计信息描述 项目 描述 时间选择 请求次数和返回码次数查询的时间段，可以选择查看下列时间段的请求次数和返回码次数： 今日。 昨日。 近7日。 近30日。 根据日历按钮，选择查询任意90天请求次数和返回码次数。 时间粒度 请求次数和返回码次数查询的时间粒度，可以选择： 按五分钟查询：统计信息按每5分钟展示，可以选择查询今日、昨日或按日历选择任意1天的数据。 按小时查询：统计信息按每小时展示，可以查询今日、昨日、近7日或按日历选择任意7天内的数据。 按天查询：统计信息按天展示，可以查询今日、昨日、近7日、近30天或按日历按钮选择任意90天内的数据。 数据位置 请求次数和返回码次数查询数据位置，可以选择： 全部数据位置：展示所有数据位置的请求次数之和、返回码次数之和。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的请求次数和返回码次数。 存储桶 请求次数和返回码次数查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的请求次数之和、返回码次数和值。 具体存储桶：根据显示的存储桶，选择查看对应存储桶的请求次数和返回码次数。 请求类型 请求次数和返回码次数的请求类型： 全部请求。 GET。 HEAD。 PUT。 POST。 DELETE。 OTHERS。 存储类型 选择请求次数查询的存储类型： 全部存储类型：分别展示标准存储和低频访问存储的请求次数。 标准类型：标准存储的请求次数。 低频访问存储：低频访问存储的请求次数。 可以点击“下载”按钮，将请求次数和返回码次数的统计信息下载到本地查看。 项目 描述 Date 统计时间。 StorageClass 存储类型。 Requests 请求次数。 Response200 返回码200的次数。 Response204 返回码204的次数。 Response206 返回码206的次数。 Response403 返回码403的次数。 Response404 返回码为404的次数。 Response4XX 除返回码403和404外的其他返回码4xx的次数。

项目 名称 存储桶名称 存储桶的名称。 区域 存储桶所属的区域，包括对象存储网络、对象存储网络2、其他区域，详见 创建时间 存储桶创建的时间。 操作 可以查看修改存储桶的属性，对存储桶进行删除，清空存储桶。 存储桶的属性包括：存储桶属性、区域属性、安全策略、网站、日志、生命周期、跨域设置、合规保留、清单配置。