名称 描述 Name 跟踪的名称。 S3BucketName OOS Bucket名称。 S3KeyPrefix 跟踪日志的名称前缀。 TrailARN 跟踪的ARN。

生成签名的示例 通过创建预签名URL的方式，与其他人共享examplebucket中test.txt文件，过期时间设置为7天（604800秒）。以GET请求为例： GET ?XAmzAlgorithmAWS4HMACSHA256 &XAmzCredential2a948fd3f00ba0925806/20240906/cn/s3/aws4request&XAmzDate20240906T235141Z&XAmzExpires604800 &XAmzSignedHeadershost &XAmzSignature 以下步骤首先说明如何计算签名和构建预签名URL。示例中使用的访问密钥如下： 参数 值 AccessKeyID 2a948fd3f00ba0925806 SecretAccessKey ef2017c2e5ffa0b1761717ecbca021da16501384 1. StringToSign 1. 创建规范请求（以GET请求为例） GET /examplebucket/test.txt XAmzAlgorithmAWS4HMACSHA256&XAmzCredential2a948fd3f00ba0925806%2F20240906%2Fcn%2Fs3%2Faws4request&XAmzDate20240906T235141Z&XAmzExpires604800&XAmzSignedHeadershost host:ooscn.ctyunapi.cn host UNSIGNEDPAYLOAD 2. 待签名字符串 AWS4HMACSHA256 20240906T235141Z 20240906/cn/s3/aws4request 9e0b6407d893f03ea8ed79710b98a0b19bf9060b744f0e14212f32d1ac04ba62 2. StringKey signing key HMACSHA256(HMACSHA256(HMACSHA256(HMACSHA256("AWS4" + " ","20240906"),"cn"),"s3"),"aws4request") 3. 签名 66628b60cb4cc78d37c76b204d6a019572ed3887d84488c72f0643d850ad4915 4. 将签名信息添加到请求头

修改跟踪 在“跟踪列表”页面，点击跟踪“操作”列的“开启”/“关闭 ”、“管理”和“删除”按钮，可以对操作跟踪进行相应的修改。 点击“管理”，进入具体跟踪的详细页面，点击“编辑日志跟踪规则”，可以重新设置管理事件、存储位置、日志前缀和跟踪状态。

本节主要介绍怎么在控制台创建IAM用户。 登录“访问控制”>“概览”，在“账户概览”区域下，点击“创建用户”；或者登录“访问控制”>“用户管理”>“用户”，点击“创建”。 按照下列步骤创建IAM用户： 1. 设置用户 根据页面提示添加用户名，可以添加一个或多个用户，并为新创建的用户设置访问方式。 2. 设置权限 为IAM用户设置权限。 有三种添加权限的方式（只能选择一种）： 1. 将用户添加到组 （前提：已经有用户组）：用户将继承该用户组的所有权限，一个用户最多可以加入10个组。 2. 从现有用户复制 （前提：现有用户有通过直接附加的方式被授权的策略），每次只能复制一个用户的权限。只能复制现有用户直接附加的策略，不能复制用户所在组的策略。 3. 附加现有策略 ：直接为用户添加现有的策略，每个用户最多可以直接添加10个策略。 用户设置权限时，只能选择以上三种方式中的一种为用户授权，当用户已经选择某一种权限设置方式，并进行了必要的勾选后，再切换其他授权方式会弹出提示框。 说明 可以创建用户时为用户添加策略，也可以用户创建完成后，再为其添加策略。 注意 每个用户最多可以直接附加10条策略，不包含随组附加的策略。 3. 设置标签 管理员可以为IAM用户设置标签，标签为IAM用户的附加属性。一个用户最多可以添加10个标签。 说明 不能为单个标签指定多个值，但多个标签键可以有相同的标签值。 项目 描述 :: 标签键 可以包含字母、数字、空格以及加号(+)、等号()、句点(.)、at符号(@)、下划线()、连字符()、冒号(:)、正斜杠(/)符号的任意组合。 标签键不区分大小写，但保留大小写。例如不能同时存在Department和department标签键，如果使用Departmentfoo标签标记用户后又添加departmentbar标签，则它会替换第一个标签，标签值变为bar。 标签值 可以为空。 4. 信息审核 对新建用户的信息进行审核，如果需要更改，可以在此页面点击对应的编辑标识，然后到对应的页面进行修改。 5. 完成 点击“下载凭证”，保存新建用户的密钥和密码。 注意 安全凭证仅能下载一次，务必妥善保管。如果某一用户的密钥丢失，可以在该用户详情页，先对原密钥进行删除，然后通过“创建密钥”的方式重新获取新的密钥。如果密码丢失，需要有修改密码权限的用户在控制台进行对该用户密码重置。

API 描述 GetCapacity 此操作用来查询用户的容量。 GetBilledStorageUsage 此操作用来查询收费容量。 GetRestoreCapacity 此操作用来查询数据取回量。 GetDeleteCapacity 此操作用来查询用户删除的容量。 GetTraffics 此操作用来查询用户的流量。 GetRequests 此操作用来查询用户请求次数。 GetReturnCode 此操作用来查询用户请求返回码次数。 GetConcurrentConnection 此操作用来查询用户的并发连接数。 GetUsage 此操作用来查询用户Bucket的使用情况。 GetBandwidth 此操作用来查询用户的已用带宽。

本文为您介绍CC攻击防护最佳实践。 当客户发现网站处理速度下降，网络带宽占用过高时，很有可能已经遭受CC攻击，此时可查看Web服务器的访问日志或网络连接数量，如果访问日志或网络连接数量显著增加，则可确定网站已遭受CC攻击，可以利用WAF阻断CC攻击，保障网站业务的正常运行。 CC攻击防护策略 在大规模CC攻击中，单台傀儡机发包的速率往往远超过正常用户的请求频率。针对这种场景，直接对请求源设置限速规则是最有效的办法。推荐您自定义CC防护策略，对具体的访问源配置限速策略，具体操作，请参见CC防护。 在实际场景中，您需要根据自身业务需求调整防护路径和触发防护的阈值，并选择合适的处置动作，以达到更有针对性、更精细化的防护效果。 例如：为了预防登录接口受到恶意高频撞库攻击的影响，您可以配置登录接口的地址（示例：使用path字段作为匹配条件，将匹配内容设置为/login.php），并设置30秒内超过10次请求则进行封禁。

本节主要介绍删除用户组。 选择需要删除的用户组，点击“删除”，可以删除多个用户组；或者点击对应用户组“操作”列的“删除”，删除用户组。

策略名 描述 AdministratorAccess 所有权限，与根用户的权限一样多。 IAMReadOnlyAccess IAM相关的get和list权限。 OOSCloudTrailFullAccess 操作跟踪需要的相关权限，包括： OOS：PutBucket、GetRegions、DeleteBucket、ListAllMyBucket、ListBucket、GetObject。 ClouldTrail：所有操作。 OOSCloudTrailReadOnlyAccess 操作跟踪读相关的权限，包括： OOS: GetObject、ListBucket、ListAllMyBucket。 CloudTrail: GetTrailStatus、DescribeTrails、LookupEvents、GetEventSelectors。 OOSFullAccess OOS的所有权限，包括Bucket和Object的所有操作。 OOSIAMFullAccess IAM所有权限。 OOSReadOnlyAccess OOS只读权限，包括Bucket和Object的GET、List相关操作。

请求示例 浏览器可以向OOS发送预检请求，来判断其是否可以从源 OPTIONS /exampleobject HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Origin: AccessControlRequestMethod: PUT 响应示例 HTTP/1.1 200 OK xamzrequestid: 0e66553608684ccf0b7e71807582848a494b543f4143454749 Date: Wed, 21 Aug 2012 23:09:55 GMT AccessControlAllowOrigin: AccessControlAllowMethods: PUT AccessControlExposeHeaders: xamzrequestid Server: CTYUN

本节主要介绍生成共享链接。 生成共享链接 可以通过生成Object的共享链接的方式，将Object分享给其他人，同时可以在链接中设置限速以对下载速度进行控制。例如在JAVA SDK中调用AmazonS3中的generatePresignedUrl ( GeneratePresignedUrlRequest )方法生成共享链接， GeneratePresignedUrlRequest的参数包含了BucketName，ObjectName，并且可以设置过期时间和下载速度；如果过期时间传Null的话，默认的过期时间是15分钟。超出过期时间后，共享链接失效，不能再通过链接下载 Object。 说明 如果使用V2签名，共享链接过期时间最大可以设置为9223372036854775秒。如果使用V4签名，共享链接过期时间最大可以设置为7天（604800秒）。 生成共享链接示例： public static void generatePresignedUrl(AmazonS3 oosClient) { GeneratePresignedUrlRequest shareUrlRequest new GeneratePresignedUrlRequest( BUCKETNAME, OBJECTNAME); java.util.Date now new java.util.Date(); java.util.Date expire new Date(now.getTime() + 24 3600 1000); //2436001000 shareUrlRequest.setExpiration(expire); //shareUrlRequest.addRequestParameter("xamzlimitrate", "2048"); URL url1 oosClient.generatePresignedUrl(shareUrlRequest); System.out.println(url1.toString()); } 以下是一个生成的共享链接： 共享链接限速 如果需要为链接设置下载速度限制，需要新增加自定义参数“xamzlimitrate”，调用GeneratePresignedUrlRequest.addRequestParameter("xamzlimitrate", value)方法，value 值为限速带宽(单位 KiB/s)，将参数加到 GeneratePresignedUrlRequest 文件中，参与共享链接生成，以下为增加了下载速度限制生成的共享链接的示例：

名称 描述 是否必须 Delete 包含整个请求的容器。 类型：容器。 子节点：Quiet、Object。 是 Quiet 使用简明信息模式来返回响应。 类型：Boolean。 取值： true：使用简明信息模式返回响应。 false：采用详细信息模式返回响应。 默认值为false。 父节点：Delete。 否 Object 包含被删除object的容器。 类型：容器。 父节点：Delete。 子节点：Key。 是 Key 被删除object名。 类型：字符串。 父节点：Object。 是

本节主要介绍怎么在控制台创建文件夹。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以创建文件夹。 点击“创建文件夹”，在弹窗中设置要创建的文件夹名称，创建后的文件夹可以包含文件（Object）。 这里的文件夹并不是文件系统中文件夹的概念。为了方便用户进行数据管理，OOS提供了一种方式模拟文件夹。实际上OOS内部是通过在文件名称中增加“/”，将该文件在管理控制台上模拟成一个文件夹的形式展现。通过API列举文件，获取到的文件名以“/”分隔的，最后一个“/”后的内容就是文件名。如果最后一个“/”后没有内容，则表示一个文件夹路径。文件夹的层级结构深度不会影响访问文件的性能。 其中文件夹名称： 不为空 。 不包含 ？" : / ' 。 不能以 开头并且不能以结尾。 不能为：.或者+。

本节主要介绍Copy Part。 可以将已经存在的Object作为分段上传的片段，拷贝生成一个新的片段。需要指定请求头xamzcopysource来定义拷贝源。如果只拷贝源Object中的一部分，需要增加请求头xamzcopysourcerange。PartNumber为新文件分片号，UploadId为新文件的分片上传ID。 在上传任何一个分片之前，必须执行Initial Multipart Upload操作来初始化分片上传操作，初始化成功后，OOS会返回一个上传ID，这是一个唯一的标识，用户必须在调用Copy Part接口时加入该ID。 请求语法 PUT /ObjectName?partNumberPartNumber&uploadIdUploadId HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn xamzcopysource: /sourcebucket/sourceObject xamzcopysourcerange:bytesfirstlast xamzcopysourceifmatch: etag xamzcopysourceifnonematch: etag xamzcopysourceifunmodifiedsince: timestamp xamzcopysourceifmodifiedsince: timestamp Date: Date Authorization: SignatureValue 请求头 名称 描述 是否必须 xamzcopysource 指定源bucketname和objectname，用斜杠/分隔。 类型：字符串。 是 xamzcopysourcerange 要从源object拷贝的bytes范围。Range值的格式是bytes第一个字节最后一个字节。第一个字节从0开始。例如要拷贝前10个字节，bytes09。只允许对大于5G的源object进行部分拷贝的操作。如果要拷贝整个object，不需要这个头。复制整个源文件时不需要此请求标头。 类型：字符串。 否 xamzcopysourceifmatch 只有文件的实体Etag与给定Etag匹配，才执行拷贝文件的操作；否则，返回412HTTP状态码错误。 类型：字符串。 否 xamzcopysourceifnonematch 只有文件实体Etag和指定实体Etag不同，才执行拷贝操作；否则，返回412错误。 类型：字符串。 否 xamzcopysourceifunmodifiedsince 只有文件在指定时间点之后没有修改过，才执行拷贝操作；否则，返回412错误。格式为EEE, d MMM yyyy HH:mm:ss 'GMT'。 类型：字符串。 否 xamzcopysourceifmodifiedsince 只有文件在指定时间点之后被修改过，才执行拷贝操作；否则，返回412错误。格式为EEE, d MMM yyyy HH:mm:ss 'GMT'。 类型：字符串。 否

本节主要介绍Abort Multipart Upload。 该接口用于终止一次分片上传操作。分片上传操作被终止后，用户不能再通过上传ID上传其它片段，之前已上传完成的片段所占用的存储空间将被释放。如果此时任何片段正在上传，该上传过程可能会也可能不会成功。所以，为了释放所有片段所占用的存储空间，可能需要多次终止分片上传操作。 请求语法 DELETE /ObjectName?uploadIdUploadId HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: Date Authorization: SignatureValue 请求示例 下面的请求通过指定上传ID来终止一次分片上传操作。 DELETE /exampleobject?uploadId658428231343369399 HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Mon, 1 Nov 2010 20:34:56 GMT Authorization: SignatureValue 响应示例 HTTP/1.1 204 No Content Date: Mon, 1 Nov 2010 20:34:56 GMT xamzrequestid: cafd93679f174e05428e85969c999c7b9f968d9ba0aca2a080 Server: CTYUN

名称 描述 是否必须 uploadId 该ID用来标识一个分片上传过程。 类型：字符串。 是 maxparts 设置响应体中返回的片段的最大数目。 类型：字符串。 取值：[1, 1000]，默认值为1000。 否 partnumbermarker 指定此次列表的起始片段的分片号，只有比该片段的分片号更高的片段才会被列举出来。 类型：字符串。 否 encodingtype 指定响应中Key的编码类型。如果Key包含xml 1.0标准不支持的控制字符，可通过设置该参数对响应中的Key进行编码。 类型：字符串。 取值：url，字母不区分大小写。 否

本节主要介绍DELETE Object。 此操作用来移除指定的文件，要求用户要对文件所在的Bucket拥有写权限。 请求语法 DELETE /ObjectName HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date ContentLength: length Authorization: SignatureValue 请求示例 删除一个叫myimage.jpg的图片文件。 DELETE /myimage.jpg HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Mon, 03 Sep 2012 17:50:00 GMT Authorization: SignatureValue ContentType: application/xml; charsetutf8 响应示例 HTTP/1.1 204 No Content xamzrequestid: 5d5becc10cdd4f25047e8077797f3e40443436383a3c3e4042 Date: Mon, 03 Sep 2012 17:50:00 GMT Server: CTYUN

名称 描述 InventoryConfiguration 清单配置的容器。 类型：容器。 子节点：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。

本节主要介绍文件元数据信息。 元数据是对文件的属性描述，包括系统定义元数据（System Meta）和用户自定义元数据（User Meta）两种。您可以通过编辑元数据来管理文件的属性。 用户可以修改的系统定义元数据 注意 系统定义元数据取值请按照HTTP标准进行填写。 字段 描述 CacheControl 指定文件的缓存行为。 取值： nocache：不直接使用缓存，而是先去服务端验证文件是否已更新。如果文件已更新，说明本地缓存已过期，需从服务端重新下载文件；如果文件未更新，表明本地缓存未过期，此时使用本地缓存。 nostore：文件不会被缓存。 public：文件允许被任何中间者（可能是代理服务器、类似于 cdn 网络）缓存。 private：文件只能被获取它的终端缓存。它不允许任何中间者（intermediate）缓存响应的资源。 maxage：缓存文件的相对过期时间，单位为秒。此选项仅在HTTP 1.1中可用。 ContentDisposition 指定文件的展示形式。 取值： ContentDisposition:inline：直接预览文件内容。 ContentDisposition:attachment：以原文件名的形式下载到浏览器指定路径。 ContentDisposition:attachment; filename"FileName"：以自定义文件名的形式下载到浏览器指定路径。 FileName：用于自定义下载后的文件名称，例如example.jpg。 将文件下载到浏览器指定路径时： 如果文件名称包含星号（）、正斜线（/）等特殊字符时，可能会出现特殊字符转义的情况。例如，下载test.jpg"到本地时，test.jpg"可能会转义为test .jpg"。若需确保下载名称中包含中文字符的文件到本地指定路径后，文件名称不出现乱码的现象，您需要将名称中包含的中文字符进行URL编码。例如，将“中文.txt”从OOS下载到本地后，需要保留文件名为中文.txt，需按照"attachment;filename"+URLEncoder.encode("中文","UTF8")+".txt;filenameUTF8''"+URLEncoder.encode("中文","UTF8")+".txt")的格式设置ContentDisposition，即attachment;filename%E4%B8%AD%E6%96%87.txt;filename%E4%B8%AD%E6%96%87.txt。 ContentEncoding 指定文件的编码方式。需要按照文件的实际编码类型填写，否则可能造成客户端（浏览器）解析编码失败或文件下载失败。若文件未编码，不增加此项。 取值： identity：表示文件未经过压缩或编码。 gzip：表示文件采用LempelZiv（LZ77）压缩算法以及32位CRC校验的编码方式。 compress：表示文件采用LempelZivWelch（LZW）压缩算法的编码方式。 deflate：表示文件采用zlib结构和deflate压缩算法的编码方式。 br：表示文件采用Brotli算法的编码方式。 默认值为identity。 关于ContentEncoding的更多信息参见RFC2616。 ContentType 指定文件的内容类型。 用于定义文件的类型和网页的编码。如果没有指定文件类型，则根据文件的扩展名生成。如果文件没有扩展名，则文件类型的默认值application/octetstream。 ContentLanguage 声明文件内容使用的语言。例如某个文件使用简体中文编写，则此项可设置为zhCN。 Expires 缓存内容的绝对过期时间，格式是格林威治时间（GMT）。 例如Wed, 22 Nov 2023 14:18:58 +0800。如果CacheControl设置了maxage，以maxage为准。 xamzwebsiteredirectlocation 将相关联文件的请求重定向到同一存储桶中的其他文件或外部 URL。此值对于每个单独文件都是唯一的，原定设置情况下不会复制该值。更多信息请参考的POST Object。 可以修改的用户定义元数据 字段 描述 xamzmeta 用户自定义元数据。键（key）必须为ASCII中可打印字符的部分值，不支持的字符详见下表。值（Value）为除（space）外的ISO 88591以内的字符。 用户定义元数据取值： 95个可打印字符中不可取的值 ASCII十进制 图形 ASCII十进制 图形 32 （space） 61 34 " 62 > 40 ( 63 ? 41 ) 64 @ 44 , 91 [ 47 / 92 58 : 93 ] 59 ; 123 { 60 “编辑元数据”，或点击具体文件“操作”列的“更多”>“编辑元数据”，可以进行对文件的元数据进行编辑。 说明 如果同时选择多个文件编辑元数据，则不会显示文件的原有元数据信息。如果文件存在已有元数据的键（key）与本次添加元数据的键（key）相同，则其值（value）会更新为最新的值，该文件其他历史元数据均会保留。 点击“添加元数据”，可以修改文件的系统定义元数据或用户定义元数据。 名称 描述 类型 元数据的类型： 系统定义 用户定义 键 具体元数据名称。 元数据为系统定义时，取值： CacheControl ContentDisposition ContentEncoding ContentType ContentLanguage Expires xamzwebsiteredirectlocation 元数据为用户定义时，取值：xamzmeta。 值 对应元数据的具体取值。 操作 点击“删除”按钮，可以删除该元数据。

请求示例 GET /?cors HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Wed, 13 Dec 2017 19:14:42 GMT Authorization: SignatureValue 响应示例 HTTP/1.1 200 OK xamzrequestid: 2c3ee2045e7f4839c03a3c33353bfafc04f0f2f4f6f8fafcfe Date: Wed, 13 Dec 2017 19:14:42 GMT Server: CTYUN ContentLength: 288 GET 3000 xamzserversideencryption

本节主要介绍PUT Bucket Object Lock。 使用此操作可以开启合规保留功能，开启后将对Bucket中所有文件生效。只有根用户和有权限的子用户才可以进行此操作，匿名用户不能进行此操作。 开启Bucket合规保留功能后，任何用户（包括根用户）都不能对此Bucket内处于合规保留期的文件进行修改和删除。 可以重复调用此接口： 如果已经开启合规保留策略：设置合规保留时长大于或等于上次设置的时长，才能生效。如果使用Years和Days两种方式设置合规保留时长，年与天的换算关系为：1年等于365天。 如果未开启合规保留策略：设置合规保留时长可以大于、等于或小于上次设置的时长。 注意 合规保留一旦开启，不能关闭，不能缩短合规保留时长，但可以延长合规保留时长。 合规保留的时间精确到秒，例如对Bucket A设置合规保留时长为10天，文件A属于Bucket A，A1的最后更新时间为201931 12:00:00，该文件会在2019311 12:00:01过合规保留期。 任何用户（包括根用户）都不能修改、覆盖、删除处于合规保留期的文件。 处于合规保留期的文件，无法通过调用API、控制台修改文件的存储类型，只能通过生命周期修改存储类型。 处于合规保留期的文件，如果设置了生命周期规则，则修改存储类型的生命周期规则可以生效，设置删除操作的生命周期规则待文件过了合规保留期后才能生效。 请求语法 PUT /?objectlock HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date ContentMD5:md5 ContentLength:length Authorization: SignatureValue Enabled COMPLIANCE days years

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

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

响应示例1 HTTP/1.1 200 OK xamzrequestid: 0275747fbe8742a179ecdfeee3f0f2f8b7b9c3adafb1b3b5b7 Date: Mon, 03 Sep 2012 12:00:00 GMT Server: CTYUN 请求示例2 以下是取消日志的示例： PUT /?logging HTTP/1.1 Host: docs.ooscn.ctyunapi.cn Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: SignatureValue /UTCYYYYMMDDhhmmss唯一字符串id 其中YYYY，MM，DD，hh，mm，ss分别代表日志发送时的年，月，日，小时，分钟，秒。TargetPrefix是用户在启动Bucket日志时配置的，如果未配置，则该项不存在。唯一字符串是服务端生成的，某些场景下不会生成。id表示日志服务器序号。 系统不会删除旧的日志文件。用户可以自己删除以前的日志文件，可以在List Objects时指定prefix参数，挑选出旧的日志文件，然后删除。 当客户端的请求到达后，日志记录不会被立刻推送到TargetBucket中，会延迟一段时间。 日志名称 字段名称 示例 备注 ::: BucketOwner mailaddress@ctyun.cn 源Bucket的Owner。 Bucket名称 mybucket 请求的bucket，如果OOS收到一个错误的bucket名称，那么这个请求不会出现在任何log中。 Time 04/08/2012 22:34:02 zz 请求到达的时间格式是dd/MM/yyyy HH:mm:ss zz。 Remote IP 72.21.206.5 请求者的IP地址。中间的代理和防火墙可能会隐藏实际发出请求的机器的地址。 Requester 根用户邮箱：mailaddress@ctyun.cn。 子用户：arn:ctyun:iam::10rc2arpn6306:user/testuser。 匿名用户：Anonymous。 如果是根用户，显示根用户的邮箱，如：mailaddress@ctyun.cn。 如果是子用户，显示子用户的ARN，如：arn:ctyun:iam::10rc2arpn6306:user/testuser。 如果是匿名访问，显示“Anonymous”。 Request ID e4dd82b2f0994896 Request ID是OOS生成的一个字符串，用于唯一标示每个请求。 Operation REST.PUT.OBJECT REST.HTTPmethod. resourcetype。 Key /photos/2012/08/puppy.jpg 请求的“Key”部分，URL编码。如果请求中没有指定文件，显示“”。 RequestURI "GET /mybucket/photos/2012/08/puppy.jpg HTTP/1.1" HTTP请求中的RequestURI部分。 HTTP status 200 响应的HTTP状态码。 Error Code NoSuchBucket OOS错误码，如果没有错误，显示“”。 Bytes Sent 2662992 写请求或读响应发送的字节数，不包括HTTP协议的头。如果是0，显示“”。 Object Size 3462992 Object的总大小。 Time 70 从收到请求到发出响应的时间，单位是ms。 Referer " HTTP Referer请求头的值。 UserAgent "curl/7.15.1" HTTP UserAgent请求头的值。 Version Id 3HL4kqtJvjVBH40Nrjfkd 请求中的versionId参数，如果没有，显示“”。 TurnAround Time 1024 OOS处理请求的时间，单位毫秒。即OOS接到客户端请求最后一个字节的时间，至OOS向客户端发送第一个响应字节的时间。 响应码为200和206的GET Object请求显示处理请求时间，其他操作显示“ ”。

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

本节主要介绍怎么在控制台修改文件的存储类型。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以修改文件类型。 选择需要修改的文件，点击“更多”>“修改存储类型”，弹出“修改存储类型”窗口，对文件的存储类型进行修改。 标准存储：访问时延低、吞吐量高，能够有效支持各种热点类型数据频繁访问。适用于各种音视频服务、图片服务、大型网站、大数据分析等应用的数据存储。标准存储是默认的存储类型。如果上载文件时未指定存储类型，OOS默认使用标准存储。 低频访问存储：适合长期保存不经常访问的数据。对于不经常访问但仍需要实时访问的数据，可以采用低频访问存储，例如各类移动应用、智能设备、企业数据的长期备份。 最短存储时间：低频访问存储的文件有最短存储时间，存储时间短于30天的文件被提前删除或变更时，会产生一定费用。 最小计费大小：低频访问存储文件有最小计费大小，即如果文件大小低于64KiB，会按照64KiB计算收费，文件大于等于64KiB按照实际存储收费。 数据取回：获取低频访问存储文件时会产生数据取回费用。

本节简要介绍操作跟踪。 操作跟踪用于记录OOS账户的管理事件，并将产生的跟踪日志保存到指定的OOS存储桶中。记录的信息包括用户的身份，API调用的开始时间，源IP地址，请求参数以及服务返回的响应元素等。 操作跟踪功能主要包括： 管理事件记录：用户通过操作跟踪功能可以查看近6个月内的管理事件，包括：登录，退出，查看、创建、修改和删除资源。 跟踪日志：当账户中发生一个管理事件时，OOS会根据配置的跟踪参数与事件进行匹配，当与跟踪参数相匹配时，事件会以日志的形式存储到用户配置的存储桶中，即跟踪日志。 基本概念 管理事件：在账户中执行的Bucket操作、统计操作、IAM操作、跟踪操作均属于管理事件。 读事件：读事件为可以查看和获取资源但不进行更改的操作。 写事件：写事件为可以修改资源的操作，包括创建、修改和删除操作。

本节主要介绍PUT Bucket Policy。 在PUT操作的url中加上Policy，可以进行添加或修改Policy的操作。如果Bucket已经存在了Policy，此操作会替换原有Policy。只有根用户和拥有PUT Bucket Policy权限的用户才能执行此操作，否则会返回403 AccessDenied错误。 注意 如果Bucket的属性为私有或者公共读，使用该接口配置允许任何用户可以向该Bucket写文件的策略时，请联系天翼云客服评估审核后开通。 请求语法 PUT /?policy HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue Policy written in JSON 请求的内容是一个包含Policy语句的JSON串，详见Bucket Policy安全策略。 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 请求示例 PUT /?policy HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Sun, 28 Apr 2024 02:02:21 GMT ContentMD5: +nl0RJvKLaXlRhwFXiBLVw ContentType: application/octetstream XAmzContentSha256: c71bbdea6d26f41a56ce0312bfeadffa06718956c925dbc82af5df7bbad6a58f Authorization: SignatureValue Connection: keepalive ContentLength: 465 { "Version":"20121017", "Id":"", "Statement":[ { "Sid":"", "Effect":"Allow", "Principal":{ "CTYUN": "arn:ctyun:iam::32fefj64y54gc:user/test1" }, "Action":"oos:", "Resource":"arn:ctyun:oos:::examplebucket/", "Condition":{ "StringLike":{ "ctyun:Referer":[ " " ] } } } ] }

请求参数 描述 是否必须 BucketName 存储桶名称。 是

本节主要介绍IAM用户操作控制台时需具备的权限。 用户身份管理和访问控制（Identity and Access Management，简称IAM）是OOS为用户提供的用户身份与权限管理服务，您可以使用IAM创建、管理用户账号，并对这些账号进行权限分配，方便资源管理。 在OOS控制台，使用访问控制创建的用户为IAM用户，也称子用户。对于IAM用户，拥有相应的权限才可以对控制台进行操作，各项操作需要的权限详见下面各表。 统计 操作 需具备的权限 统计 statistics:GetAccountStatistcsSummary 存储桶管理 操作 需具备的权限 创建存储桶 oos:PutBucket、oos:GetRegions 建议同时赋予的权限：oos:ListAllMyBucket 存储桶列表 oos:ListAllMyBucket 删除存储桶 oos:ListAllMyBucket、oos:DeleteBucket 清空存储桶 oos:ListAllMyBucket、oos:DeleteMultipleObjects 查看/修改存储桶属性 oos:ListAllMyBucket、oos:GetBucketAcl、oos:PutBucket 区域属性 oos:ListAllMyBucket、oos:GetBucketLocation、oos:PutBucket、oos:GetRegions、oos:GetBucketAcl 安全策略 oos:ListAllMyBucket、oos:GetBucketPolicy、oos:PutBucketPolicy、oos:DeleteBucketPolicy 网站管理 oos:ListAllMyBucket、oos:GetBucketWebSite、oos:PutBucketWebSite、oos:DeleteBucketWebSite、oos:GetRegions 日志 oos:ListAllMyBucket、oos:GetBucketLogging、oos:PutBucketLogging 生命周期 oos:ListAllMyBucket、oos:GetLifecycleConfiguration、oos:PutLifecycleConfiguration 跨域设置 oos:ListAllMyBucket、oos:GetBucketCORS、oos:PutBucketCORS 合规保留 oos:ListAllMyBucket、oos:GetBucketObjectLockConfiguration、oos:PutBucketObjectLockConfiguration、oos:DeleteBucketObjectLockConfiguration 清单配置 oos:ListAllMyBucket、oos:PutBucketInventoryConfiguration、oos:GetBucketInventoryConfiguration

本节主要介绍Get Regions。 获取资源池中的索引位置和数据位置列表。 注意 香港节点不支持此接口。 请求语法 GET /?regions HTTP/1.1 HOST:ooscn.ctyunapi.cn Date:date Authorization: SignatureValue 请求参数 名称 描述 是否必须 regions 表示要获取索引位置和数据位置的列表。 是 响应结果 名称 描述 BucketRegions Bucket的索引位置和数据位置。 类型：容器 MetadataRegions Bucket的索引位置。 类型：容器 DataRegions Bucket的数据位置。 类型：容器 Region 索引位置或数据位置的值。 类型：字符串 请求示例 GET /?regions HTTP/1.1 Host: ooscn.ctyunapi.cn Date: Fri, 29 Oct 2021 06:49:13 GMT ContentType: application/octetstream Connection: KeepAlive Authorization: SignatureValue 响应示例 HTTP/1.1 200 OK ContentType: application/xml;charsetUTF8 Date: Fri, 29 Oct 2021 06:49:12 GMT xamzrequestid: 79a75e2d5bc54d4ffc686c737b73757b3a3c4030323436383a Server: CTYUN ContentLength: 281 ShenYang ChengDu ZhengZhou ShenYang ChengDu ZhengZhou

本节主要介绍Get Service。 此操作用来返回请求者拥有的读权限的所有Bucket，其中“/”表示根目录。该API只对验证用户有效，匿名用户不能执行该操作。 请求语法 GET / HTTP/1.1 Host: ooscn.ctyunapi.cn Date: Date Authorization: SignatureValue 响应结果 名称 描述 Owner Bucket所属账户的信息。 ID Bucket所属账户的ID。 Buckets 存储一个或多个Bucket的容器。 Bucket 存储Bucket信息的容器。 Name Bucket的名称。 CreationDate Bucket的创建日期。 请求示例 GET / HTTP/1.1 Host: ooscn.ctyunapi.cn Date: Thu, 28 Oct 2021 06:06:32 GMT ContentType: application/octetstream Connection: KeepAlive Authorization: SignatureValue 响应示例 HTTP/1.1 200 OK ContentType: application/xml;charsetUTF8 Date: Thu, 28 Oct 2021 06:06:32 GMT xamzrequestid: 8ec6af80431f4f0281edf1f800f8fa00bfc1c7b5b7b9bbbdbf Server: CTYUN ContentLength: 369 xxxxxxxxxx@ctyun.cn docs 20210710T17:52:34.949Z examplebucket 20211028T06:06:19.309Z

本节主要介绍OOS API请求结构。 接入地址 对象存储网络接入地址为：ooscn.ctyunapi.cn。对象存储网络2接入地址为：ooscn2.ctyunapi.cn。香港精品网接入地址为：ooscnhkhqnet.ctyunapi.cn。香港普通网接入地址为：ooscnhknqnet.ctyunapi.cn。 注意 对于对象存储网络、对象存储网络2中的OOS API，如果您的数据存储在某个资源池，建议您直接使用该资源池的Endpoint，详见 通信协议 为了保证通信的安全性，同时支持HTTP和HTTPS。 请求方法 OOS API支持GET、POST、PUT、HEAD、DELETE和OPTION请求方法发送请求。 请求参数 每个请求都需要指定如下信息： 每个操作接口都需要包含的公共请求参数。 操作接口所特有的请求参数。 本节主要描述公共请求参数和请求结果。 说明 在后续提到具体API时，举例中都会有 公共请求头、 公共响应头 ，但是不对其进行描述和解释。 公共请求头 以下是OOS API的公共请求头。 名称 描述 是否必须 ::: BucketName Bucket名称。 除GET Service (List Bucket)、GET Regions外，其他Bucket、Object操作都需要该参数。 是 Authorization 用于身份验证的请求头。Authorization的构造方式请参考安全策略部分，请先确定使用V2还是V4版本的签名方式，再按照对应的计算方式生成Authorization。 是 ContentLength 请求体的长度。 否 ContentMD5 按照RFC 1864，使用base64编码格式生成信息的128位MD5值。此请求头可以用作数据完整性检查，以验证数据是否与客户端发送的数据相同。 否 xamzcontentsha256 当使用V4签名对请求进行身份验证时，此请求头提供请求有效负载的哈希。 V4签名必填。 ContentType 描述请求内容的标准MIME类型。 否 Date 请求的日期和时间，GMT时间。 V2签名可以填写xAmzDate或Date。 xamzdate 请求的日期和时间。日期和时间格式必须遵循ISO 8601标准，并且必须使用“yyyyMMddT HHmmssZ”格式进行格式化。例如，如果日期和时间是“08/01/2018 15：32：41.982700”，则必须首先将其转换为UTC（协调世界时），然后提交为“20180801T083241Z”。 V4签名必填。 Host 请求的域名。 对象存储网络的请求域名为：ooscn.ctyunapi.cn。 对象存储网络2的请求域名为：ooscn2.ctyunapi.cn。 香港精品网的请求域名为：ooscnhkhqnet.ctyunapi.cn。 香港普通网的请求域名为：ooscnhknqnet.ctyunapi.cn。 是 Connection 客户端与OOS服务器之间的连接状态。 取值： keepalive：长连接，请求结束后继续保持连接。 close：短连接，请求结束后关闭连接。 默认值为：keepalive。 否