本节主要介绍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

本节主要介绍文件元数据信息。 元数据是对文件的属性描述，包括系统定义元数据（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

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

响应示例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

名称 描述 BucketConfiguration 设置Bucket索引位置和数据位置的容器。 类型：容器。 子节点：MetadataLocationConstraint、DataLocationConstraint。 MetadataLocationConstraint 设置Bucket的索引位置。 类型：容器。 父节点：CreateBucketConfiguration。 子节点：Location。 DataLocationConstraint 设置Bucket的数据位置。 类型：容器。 父节点：CreateBucketConfiguration。 子节点：Type、LocationList、ScheduleStrategy。 Type 数据位置的类型。 类型：枚举。 取值： Local：本地。 Specified：指定位置。 默认Local。 父节点：DataLocationConstraint。 LocationList 指定的数据位置。 类型：容器。 父节点：DataLocationConstraint。 子节点：Location。 Location 索引位置或数据位置。 类型：字符串。 取值： 父节点为MetadataLocationConstraint，表示索引位置，有效值为：ChengDu、FuZhou、GuiYang、HangZhou、LaSa、LanZhou、QingDao、ShenYang、ShenZhen、WuHan、WuHu、WuLuMuQi、ZhengZhou、SH2、SuZhou 父节点为LocationList，表示数据位置，有效值为：ChengDu、GuiYang、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou 父节点：MetadataLocationConstraint或LocationList。 ScheduleStrategy 指定数据时的调度策略 类型：枚举 取值： Allowed：允许OOS自动调度。 NotAllowed：不允许OOS自动调度。 父节点：DataLocationConstraint

本节主要介绍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。 否

本节主要介绍在控制台怎么进行OOS域名（Endpoint）切换。 用户可以在OOS控制台对OOS地域（Endpoint）进行切换，根据选择跳转到不同的地域。 可以选择“中国大陆区域”的“对象存储网络”、“对象存储网络2”、其他地域 。 对象存储网络 ：包含分布在全国多个省、市、自治区及直辖市的资源池，这些资源池间的存储桶（Bucket）、对象（Object）、访问密钥（AccessKeyID和SecretAccessKey）信息互通，可以实现全国数据的就近读取和写入。 对象存储网络2：包含分布在全国多个省、市、自治区及直辖市的资源池，这些资源池间的存储桶（Bucket）、文件（Object）、访问密钥（AccessKeyId和SecretAccessKey）信息互通，可以实现全国数据的就近读取和写入。 其他地域 ：存储桶、对象、访问密钥信息是不互通的。

本节简要介绍访问控制。 访问控制（Identity and Access Management，简称IAM）是OOS为用户提供的用户身份与权限管理服务，您可以使用IAM创建、管理用户账号，并对这些账号进行权限分配，方便资源管理。 天翼云账号管理员可以： 创建、管理子用户账号。 控制子用户账号内资源具有的操作权限。 按需为子用户分配不同权限，从而避免与其他子用户共享资源使用、访问密钥的使用等，降低账号的信息安全风险。 多重身份认证：通过多因子操作认证（MFA），在进行IAM相关操作时，可以使用MFA，为操作增加一份安全保障。

字段 描述 AWS4HMACSHA256 用于签名的算法，固定值。 Credential 用户AccessKeyID和范围信息，范围信息包括请求日期、区域、服务、终止字符串aws4request，格式如下： AccessKeyID / date / region / service /aws4request 其中： date格式为 YYYYMMDD 。 region： 对于oos api：访问域名为oosxx.ctyunapi.cn，region为xx。 对于统计api：访问域名为oosxxmg.ctyunapi.cn，region为xxmg。 对于操作跟踪api：访问域名为oosxxcloudtrail.ctyunapi.cn，region为xx。 对于iam api：访问域名为oosxxiam.ctyunapi.cn，region为xx。 各资源池的详细访问域名详见 SignedHeaders 已签名请求头的列表。该列表只需包含请求头名字，用分号分隔，必须全部小写，并按字符顺序对其进行排序，示例如下： host;range;xamzdate。 Signature 计算出的256位签名信息，以64个小写十六进制字符串形式表示。

对象存储网络2 对象存储网络2中的各个地区，使用统一的OOS API、统计、操作跟踪和IAM API的Endpoint。对象存储网络2 Endpoint列表如下： OOS API Endpoint: ooscn2.ctyunapi.cn，支持HTTP和HTTPS。 统计API Endpoint: ooscn2mg.ctyunapi.cn，支持HTTPS。 操作跟踪API Endpoint：ooscn2cloudtrail.ctyunapi.cn，支持HTTPS。 IAM Endpoint: ooscn2iam.ctyunapi.cn，支持HTTPS。 说明 对于对象存储网络2中的OOS API，如果您的数据存储在某个资源池，建议您直接使用该资源池的Endpoint。Endpoint列表如下（Endpoint列表仅为资源池Endpoint访问信息描述，与资源状态无关联）。 地区 OOS API Endpoint 内蒙古1 oosnm1.ctyunapi.cn 杭州1 ooshz1.ctyunapi.cn 香港节点（仅支持API） 香港节点分为香港精品网络 和香港普通网络两种方式，精品网和普通网OOS API的Endpoint不同，统计、操作跟踪和IAM API的Endpoint相同： 香港精品网OOS API Endpoint: ooscnhkhqnet.ctyunapi.cn，香港普通网OOS API Endpoint：ooscnhknqnet.ctyunapi.cn。支持HTTP和HTTPS。 统计API Endpoint: ooscnhkmg.ctyunapi.cn，支持HTTP和HTTPS。 操作跟踪API Endpoint：ooscnhkcloudtrail.ctyunapi.cn，支持HTTPS。 IAM Endpoint：ooscnhkiam.ctyunapi.cn，支持HTTPS。 其他地域 除对象存储网络、对象存储网络2和香港节点外，其他地域的Endpoint列表如下。 地区 OOS API Endpoint 北京2 oosbj2.ctyunapi.cn 内蒙2 oosnm2.ctyunapi.cn 杭州 ooshz.ctyunapi.cn 江苏 oosjs.ctyunapi.cn 北京 ooshqbj.ctyunapi.cn 上海 ooshqsh.ctyunapi.cn

本节主要介绍查看已订购的OOS资源包。 根据用量需求，您可以订购OOS资源包，订购须知请参见快速入门服务开通订购须知。 在“资源包管理”页面，可以查看已经订购的OOS资源包，订购新的资源包，或者对已有资源包进行续订、退订操作。具体操作参见快速入门服务开通。

项目 描述 AccessKeyID 密钥ID。点击编辑按钮，可以对密钥ID进行复制。 SecretAccessKey 密钥值，点击查看按钮，可以查看密钥值的明文形式。 说明 在IAM上线之前创建的密钥才有此项。 创建时间 密钥创建时间。 无：表示该密钥是在IAM功能上线前创建的。 最后使用时间 密钥最后一次使用的时间。 密钥类型 主密钥。 普通密钥。 说明 在IAM上线之前创建的密钥才有此项。 状态 密钥启用状态： 启用。 禁用。 超期标记 密钥创建时间超过90天后，会有超期标记。建议及时删除超期密钥，并创建新的密钥。 ：表示未超期。 操作 可以对密钥进行操作： 启用。 禁用。 删除。

本节主要介绍删除自定义策略。 点击导航栏的“权限策略”，进入“权限策略”页面。可以通过两种方式删除自定义的策略： 选择需要删除的策略进行勾选，点击“删除”，可以删除对应的策略。 点击策略“操作”中的“删除”，可以删除该策略。

本节主要介绍查看和修改用户组信息。 点击导航栏中“访问控制”>“用户管理”>“用户组”，可以查看和维护用户组信息。 为用户组设置权限 添加权限 可以使用下列方法为用户组添加权限： 在“用户组”页面，点击对应用户组操作中的“添加权限”，弹出“添加权限”页面，为用户组添加策略。弹框中灰色的策略表示用户组已关联的策略。 点击对应的用户组名，进入用户组详细信息页，点击“权限”>“添加权限”，为用户组添加策略。 移除权限 在用户组详细信息页，点击“权限”，选择需要移除的策略，点击“移除权限”，可以为用户组删除多条策略；或者点击对应策略“操作”列的“移除权限”，可以为用户组删除对应的策略。 为用户组添加或移除用户 添加用户 可以使用下列方法为用户组添加用户： 在“用户组”页面，点击对应用户组操作中的“添加用户”，弹出“添加用户”页面，为用户组添加用户。 点击对应的用户组名或者“管理”，进入用户组详细信息页，点击“用户”>“添加用户”，为用户组添加用户。 移除用户 点击对应的用户组名或者“管理”，进入用户组详细信息页，点击“用户”，选择需要移出的用户，点击“移除用户”，可以为用户组删除多个用户；或者点击对应用户“操作”列的“移除用户”，为用户组移出对应用户。

查看和修改权限 点击“权限”，可以查看用户权限，为用户添加权限、移除权限和从组移出。 添加权限 点击“添加权限”，弹出“添加权限”弹框，可以为用户关联新的策略，弹框中灰色的策略表示用户已关联的策略。 移除权限 选择需要移除的策略，点击“移除权限”，可以为用户删除多条策略。点击对应策略的“移除权限”，可以解除已关联的策略。 从组移出 点击“从组移出”，该用户将移出对应的组，并解除随组关联的策略。 查看和修改用户组 点击“用户组”，可以查看用户所在的组，将用户加入到组或移出组。 加入到组 点击“加入到组”，弹出“加入到组”弹框，选择用户需要加入的组，点击“确认”。弹框中灰色的用户组表示用户已加入的用户组。 移出组 选择需要移出的组，点击“移出组”，可以将用户移出多个组；或者点击对应组“操作”列的“移出组”，可以将用户从该组移出。 查看和修改标签 点击“标签”，可以为查看用户标签信息、编辑标签信息、为用户添加标签或删除标签 。

字段 描述 eventId 事件ID。 resource 资源信息。 eventVersion 操作跟踪版本。 eventSource 事件源。 requestParameters 请求参数。 userAgent 用户代理。 发送API请求的客户端代理标识，除控制台外，都按照客户端API发出的UserAgent请求头展示，如无法获取到则不展示。 请求由用户通过控制台发出，显示ooscn.ctyun.cn。 readOnly 是否为只读操作： true：读操作。 false：写操作。 userIdentity 用户信息。 eventType 事件请求类型。 serviceName 服务名称。 sourceIp 源IP。 requestId 请求ID。 requestURL 请求URL。 eventTime 事件发生的时间。 eventName 事件名称。 requestRegion 请求区域。 managementEvent 是否为管理事件： true：是管理事件。 false：非管理事件。

本节主要介绍怎么进行文件排序。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，将鼠标放在“文件名”、“大小”或者“修改日期”上，可以对存储桶内已经列举出的文件根据文件名、文件大小或修改日期进行排序，每次只能选择一种排序方式。

本节主要介绍怎么通过控制台下载文件。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以下载文件。 点击操作列的“下载”，可以下载单个文件。选中一个或者多个文件，点击上方导航的“下载”，可以批量下载文件。 注意 基于安全合规要求，禁止通过OOS默认域名以匿名或者URL签名方式下载后缀为apk、ipa的文件，在Header中包含签名或者通过自定义域名方式下载此类文件不受影响。

本节主要介绍怎么在控制台进行对象分享。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以分享文件。 对于私有存储桶（Bucket）内的文件（Object），用户可以创建临时的“共享链接”，以便在不破坏存储桶的私有属性的前提下，与他人分享文件。 注意 严禁传播诈骗、色情、暴力及其他侵犯他人权利或违反法律及公序良俗内容。 基于安全合规要求，禁止通过OOS默认域名以匿名或者URL签名方式下载后缀为apk、ipa的文件，在Header中包含签名或者通过自定义域名方式下载此类文件不受影响。 在分享图片或者网页时，访问者会下载到本地查看。 通过文件分享，可以分享单个文件或者多个文件。 单个文件分享 分享单个文件，选择需要分享的文件，点击“更多”>“分享”，或则点击对应文件后的“操作”列的“更多”>“分享”，即可对该文件进行分享。 点击“分享”按钮，弹出“文件分享”对话框。 名称 描述 文件名称 要分享的文件名称。 过期时间（天） 设置的过期时间。 取值：[1, 9999999]，单位是天。如果不填写，默认分享链接15分钟过期。 限制下载速度 是否开启下载速度限制。 下载速度（KiB/s） 下载速度限制。 取值：[1, 2147483647]，单位是KiB/s。 限制下载并发数 是否开启下载并发数限制。 下载并发数 下载并发数。 取值：[1，2147483647]。 链接 文件的共享链接。 点击“生成”按钮，即可生成一个带有签名认证的URL。用户可以直接将该URL分享给其他人，在有效期内，通过该URL可以访问此文件。

名称 描述 文件概览 可以查看下列信息： 存储区域：文件存储的数据位置。 文件名。 上次修改时间：文件最近一次的修改时间。 文件URI：文件具体的URI。 大小：文件的大小。 存储类型 文件的存储类型： 标准存储。 低频访问存储。 说明 点击“了解更多”，可以了解存储类型更多信息。 元数据 文件的具体元数据信息。详细参见