本节主要介绍PUT Bucket Logging。 此操作用来添加/修改/删除logging的操作。如果Bucket已经存在了logging，此操作会替换原有logging。只有根用户和拥有PUT Bucket Logging权限的子用户才能执行此操作，否则会返回403 AccessDenied错误。 请求语法 PUT /?logging HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue Request elements vary depending on what you're setting. 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 BucketLoggingStatus 请求的容器。 类型：容器。 子节点：LoggingEnabled。 是 LoggingEnabled 日志信息的容器，当启动日志时，需要包含这个元素。 类型：容器。 父节点：BucketLoggingStatus。 子节点：TargetBucket、TargetPrefix。 否 TargetBucket 指定要保存log的Bucket，OOS会向此Bucket存储日志。可以设置任意一个你拥有的bucket作为TargetBucket，包括启动日志的bucket本身。你也可以设置将多个Bucket的日志存放到一个TargetBucket中，在这种情况下，你需要为每个源bucket设置不同的TargetPrefix，以便不同Bucket的log可以被区分出来。 类型：字符串。 父节点：LoggingEnabled。 否 TargetPrefix 生成的log文件将以此为前缀命名。 类型：字符串。 父节点：LoggingEnabled。 否 请求示例1 启动日志 PUT /?logging HTTP/1.1 Host: docs.ooscn.ctyunapi.cn ContentType: application/xml; charsetutf8 Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: SignatureValue examplebucket mybucketaccesslog/

响应示例 HTTP/1.1 200 OK xamzrequestid: 0f512a6284004715f16457665b686a702f313a2527292b2d2f Date: Sun, 28 Apr 2024 02:02:22 GMT ContentLength: 0 Server: CTYUN

本节主要介绍GET Bucket ACI。 此操作用来获取Bucket ACL信息，只有拥有GET Bucket ACL权限的用户才可以执行此操作。 请求语法 GET /?acl HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求参数 请求参数 描述 是否必须 BucketName 存储桶名称。 是 响应结果 名称 描述 :: AccessControlPolicy 响应的容器。 类型：容器。 子节点：Owner、AccessControlList。 Owner 存储Bucket所属账户信息的容器。 类型：容器。 父节点：AccessControlPolicy。 子节点：ID、DisplayName。 ID Bucket所属账户的ID信息。 类型：字符串。 父节点：Owner。 AccessControlList 存储ACL信息的容器。 类型：容器。 父节点：AccessControlPolicy。 子节点：Grant。 Grant 存储Permission和Grantee的容器。 类型：容器。 父节点：AccessControlList。 子节点：Grantee。 Grantee 用来存储Display和拥有ID的用户被承认的许可的容器。 Permission 对一个Bucket认可的许可信息。 类型：字符串。 父节点：Grant。 有效值：READ（公共读）、FULLCONTROL（公共读写）、空（私有）。 请求示例 请求返回docs的ACL信息 GET /?acl HTTP/1.1 Host: docs.ooscn.ctyunapi.cn Date: Mon, 01 Nov 2021 06:31:14 GMT ContentType: application/octetstream Connection: Keepalive Authorization: SignatureValue 响应示例 HTTP/1.1 200 OK LastModified: Mon, 13 Sep 2021 07:51:46 GMT ContentType: application/xml;charsetUTF8 Date: Mon, 01 Nov 2021 06:31:04 GMT xamzrequestid: 23ee087970af44915ecaced5ddd5d7dd9c9ea4929496989a9c ContentLength: 392 Server: CTYUN ctyuntest@ctyun.cn .........

访问控制 操作 需具备的权限 ::: IAM用户 创建IAM用户 iam:CreateUser、iam:CreateAccessKey、iam:CreateLoginProfile、iam:GetAccountPasswordPolicy、iam:GetUser 建议同时赋予的权限：iam:AddUserToGroup、iam:AttachUserPolicy、iam:ListUsers、iam:ListGroups、iam:ListPolicies IAM用户 删除IAM用户 iam:ListUsers、iam:DeleteAccessKey、iam:DeleteUser、iam:RemoveUserFromGroup、iam:DeactivateMFADevice、iam:DeleteLoginProfile、iam:DetachUserPolicy IAM用户 查看IAM用户信息 iam:ListAccessKeys、iam:ListUsers、iam:ListUserTags、iam:ListGroupsForUser、iam:ListAttachedUserPolicies、iam:ListEntitiesForPolicy、iam:ListMFADevices、iam:GetUser IAM用户 安全 iam:GetLoginProfile、iam:ListUsers、iam:GetUser、iam:GetAccountPasswordPolicy、iam:CreateLoginProfile、iam:DeleteLoginProfile、iam:UpdateLoginProfile IAM用户 密钥 iam:ListAccessKeys、iam:ListUsers、iam:GetUser、iam:CreateAccessKey、iam: GetAccessKeyLastUsed、iam:DeleteAccessKey、iam:UpdateAccessKey IAM用户 权限 iam:ListUsers、iam:ListGroupsForUser、iam:ListPolicies、iam:ListAttachedGroupPolicies、iam:ListAttachedUserPolicies、iam:GetUser、iam:RemoveUserFromGroup、iam:AttachUserPolicy、iam:DetachUserPolicy IAM用户 用户组 iam:ListUsers、iam:ListGroups、iam:ListGroupsForUser、iam:GetUser、iam:GetGroup、iam:AddUserToGroup、iam:RemoveUserFromGroup IAM用户 标签 iam:ListUsers、iam:GetUser、iam:TagUser、iam:UntagUser 用户组 创建用户组 iam:CreateGroup 建议同时赋予的权限：iam:ListGroups、iam:ListPolicies、iam:AttachGroupPolicy 用户组 查看用户组信息 iam:ListGroups、iam:ListAttachedGroupPolicies、iam:GetGroup 用户组 修改用户组 iam:ListUsers、iam:ListGroups、iam:ListGroupsForUser、iam:ListPolicies、iam:ListAttachedGroupPolicies、iam:GetGroup、iam:AddUserToGroup、iam:RemoveUserFromGroup、iam:AttachGroupPolicy、iam:DetachGroupPolicy 用户组 删除用户组 iam:ListGroups、iam:DeleteGroup、iam:RemoveUserFromGroup、iam:DetachGroupPolicy 策略 查看策略 iam:ListPolicies、iam:ListEntitiesForPolicy、iam:GetPolicy 策略 新建自定义策略 iam:CreatePolicy、iam:GetPolicy 建议同时赋予的权限：iam:ListPolicies 策略 修改自定义策略 iam:CreatePolicy、iam:GetPolicy、iam:ListPolicies 策略 删除自定义策略 iam:ListPolicies、iam:DeletePolicy、iam:DetachUserPolicy、iam:DetachGroupPolicy 策略 授权/移除 用户/用户组 iam:ListUsers、iam:ListGroups、iam:ListPolicies、iam:ListAttachedGroupPolicies、iam:ListAttachedUserPolicies、iam:ListEntitiesForPolicy、iam:AttachUserPolicy、iam:DetachUserPolicy、iam:AttachGroupPolicy、iam:DetachGroupPolicy 安全设置 编辑密码规则 iam:GetAccountPasswordPolicy、iam:UpdateAccountPasswordPolicy 安全设置 清除密码规则 iam:GetAccountPasswordPolicy、iam:DeleteAccountPasswordPolicy 安全设置 编辑登录规则 iam:GetAccountLoginSecurityPolicy、iam:UpdateAccountLoginSecurityPolicy 安全设置 清除登录规则 iam:UpdateAccountLoginSecurityPolicy、iam:DeleteAccountLoginSecurityPolicy 安全凭证 密钥 iam:ListAccessKeys、iam:GetUser、iam:CreateAccessKey、iam:DeleteAccessKey、iam:UpdateAccessKey 安全凭证 密码 iam:GetLoginProfile、iam:GetUser、iam:ChangePassword 安全凭证 MFA iam:ListMFADevices、iam:GetUser、iam:CreateVirtualMFADevice、iam:DeleteVirtualMFADevice、iam:EnableMFADevice、iam:DeactivateMFADevice

本节主要介绍GET Bucket Location。 此操作用来获取Bucket的索引位置和数据位置，只有根用户和拥有GET Bucket location权限的子用户才能执行此操作。 注意 香港节点不支持此接口。 请求语法 plaintext GET /?location HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 响应结果 名称 描述 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

名称 描述 BucketRegions Bucket的索引位置和数据位置。 类型：容器 MetadataRegions Bucket的索引位置。 类型：容器 DataRegions Bucket的数据位置。 类型：容器 Region 索引位置或数据位置的值。 类型：字符串

公共响应头 每个OOS API响应结果中都包含公共响应头。 名称 描述 :: ContentLength 响应体的长度。 ContentType 响应内容的MIME类型。 Date OOS返回响应的日期和时间。 ETag 文件的哈希值。ETag只反映了文件的内容，而不是其元数据。此响应头可以用作数据完整性检查，以验证数据是否与客户端发送的数据相同。 Server 服务端名称，默认值是CTYUN。 xamzrequestid 用于唯一标示请求的ID。 Connection 客户端与OOS服务器之间的连接状态。 如果请求时Connection值为keepalive，请求结束后继续保持连接，不返回此响应头。 如果请求时Connection值为close，请求结束后关闭连接，返回此响应头Connection: close。

简要介绍合规保留。 OOS提供合规保留功能，即开启Bucket合规保留功能后，任何用户（包括根用户）都不能对此Bucket内处于合规保留期的文件进行修改和删除。 可以根据需求，对Bucket级别开启合规保留功能，以天（Days）或者以年（Years）为单位设置合规保留时长，1年365天。 注意 合规保留一旦开启，不能关闭，不能缩短合规保留时长，但可以延长合规保留时长。 合规保留的时间精确到秒，例如对Bucket A设置合规保留时长为10天，文件A1属于Bucket A，A1的最后更新时间为201931 12:00:00，该文件会在2019311 12:00:01过合规保留期。 任何用户（包括根用户）都不能修改、覆盖、删除处于合规保留期的文件。 处于合规保留期的文件，无法通过调用API、控制台修改文件的存储类型，只能通过设置的生命周期规则修改存储类型。 文件处于合规保留期：如果生命周期规则为修改文件存储类型，则生命周期规则可以生效；如果生命周期规则为到期删除文件，则文件必须过了合规保留期后，生命周期规则才能生效。

本节主要列举Bucket Policy示例。 下面是一个定义Referer Policy的例子 配置 Bucket（名为 examplebucket） 的访问策略： 允许特定子用户（test1，其根用户 ID为 32fefj64y54gc）访问此 Bucket 资源，并且要求请求包含特定的 Referer 头（“ 。 { "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":[ " " ] } } } ] } 下面是一个定义IP Policy的例子 配置 Bucket（名为 examplebucket） 的访问策略： 允许特定子用户（test2，其根用户 ID为 32fefj64y54gc）在特定网段（192.168.143.0/24，但排除 192.168.143.188）内进行访问。 { "Version": "20121017", "Id": "PolicyId1", "Statement": [ { "Sid": "IPAllow", "Effect": "Allow", "Principal": { "CTYUN": "arn:ctyun:iam::32fefj64y54gc:user/test2" }, "Action": "oos:GetObject", "Resource": "arn:ctyun:oos:::examplebucket/", "Condition" : { "IpAddress" : { "ctyun:SourceIp": "192.168.143.0/24" }, "NotIpAddress" : { "ctyun:SourceIp": "192.168.143.188/32" } } } ] } 下面的例子可向匿名用户授予公共读权限 配置 Bucket（名为 examplebucket） 的访问策略：允许任何人读取文件数据。 { "Version":"20121017", "Statement":[ { "Sid":"AddPerm", "Effect":"Allow", "Principal":{ "CTYUN": [""] }, "Action":["oos:GetObject"], "Resource":["arn:ctyun:oos:::examplebucket/"] } ] }

本节主要介绍Bucket权限限制。 OOS提供Bucket级别的权限控制，Bucket目前有3种访问权限：private（私有）、publicread（公共读）和publicreadwrite（公共读写）： private（私有） 只有根用户和具有相应权限的子用户可以对该存储桶内的文件进行读/写/删除操作（包括Get、Put和Delete Object），其他人（包括匿名访问）只有通过Bucket Policy授权或分享链接才可访问该存储桶内的文件。 publicread（公共读） 只有根用户和具有相应权限的子用户可以对该存储桶内的文件进行写/删除操作（包括Put和Delete Object）。任何人（包括匿名访问）都可以对该存储桶内的文件进行读操作，这有可能造成您数据的外泄以及费用激增，请慎用该权限。 publicreadwrite（公共读写） 任何人（包括匿名访问）都可以对该存储桶内的文件进行读/写/删除操作（包括Get、Put和Delete Object）。这有可能造成您数据的外泄以及费用激增，若被人恶意写入违法信息还可能会侵害您的合法权益，除特殊场景外，不建议您配置公共读写权限。 注意 如果想使用访问权限为公共读写的存储桶，请联系天翼云客服评估审核后开通此功能。 说明 新建Bucket时，默认权限是private，用户可以根据需要修改为公共读或公共读写。

地区 OOS API Endpoint 北京2 oosbj2.ctyunapi.cn 内蒙2 oosnm2.ctyunapi.cn 杭州 ooshz.ctyunapi.cn 江苏 oosjs.ctyunapi.cn 北京 ooshqbj.ctyunapi.cn 上海 ooshqsh.ctyunapi.cn

本节主要介绍系统策略和自定义策略的概念。 策略是以JSON格式描述权限的信息。管理员创建的IAM用户在没有授权策略前是没有任何权限的。只有将策略授权给用户组或者用户，用户才拥有对应的权限。 IAM支持系统策略和自定义策略： 系统策略：OOS预先创建好的策略，用户可以根据自身需求，直接引用。对于系统策略，用户只能使用，不能修改。 自定义策略：用户自己创建的策略，用户可以对该类型策略进行修改和删除。 点击菜单栏中的“访问控制”>“权限策略”，进入权限策略，可以查看策略列表、创建自定义策略、删除自定义策略、对策略进行管理等。

本节主要介绍怎么删除IAM用户。 选择需要删除的用户，点击“删除”，可以删除多个用户；或者点击对应用户“操作”列的“删除”，删除用户。 说明 删除用户时，会弹出对话框，确认是否删除选中用户。

添加标签 点击“添加标签”，填写标签键和标签值。标签值可为空，一个用户最多添加10个标签。 删除标签 选择需要删除的标签，点击“删除标签”，可以将多个标签删除；或者点击标签“操作”列的“删除”，可以将该标签删除。 编辑标签 点击标签“操作”列的“编辑”，可以修改标签值。

项目 描述 请求时间 事件发生的时间。 事件ID 由跟踪生成的用来唯一标识每个事件的ID。 事件源 处理请求的服务端。 如果是对象存储网络： OOS：ooscn.ctyunapi.com。 操作跟踪：ooscncloudtrail.ctyunapi.cn。 IAM：ooscniam.ctyunapi.cn。 统计API：ooscnmg.ctyunapi.cn。 自服务门户：ooscn.ctyun.cn。 如果是对象存储网络2： OOS：ooscn2.ctyunapi.com。 操作跟踪：ooscn2cloudtrail.ctyunapi.cn。 IAM：ooscn2iam.ctyunapi.cn。 统计API：ooscn2mg.ctyunapi.cn。 自服务门户：ooscn2.ctyun.cn。 用户 用户名。 资源类型 操作涉及的资源模块： OOS Bucket：存储桶。 CloudTrail：操作跟踪。 IAM User：IAM用户。 IAM Group：IAM用户组。 IAM Policy：IAM权限策略。 IAM AccessKey：IAM密钥。 IAM MfaDevice：IAM MFA。 ：事件对应资源类型的所有资源，或者不涉及。 源IP地址 用户发起请求的源IP地址。 访问密钥 用户发起操作使用的密钥ID： ：表示控制台访问。 请求ID 发送请求后，服务端返回的xamzrequestid响应。 事件名称 请求操作的名称。 操作类型 操作类型： 读操作。 写操作。 资源名称 操作访问的资源： ：表示事件对应的所有资源。 错误代码 产生的错误码： ：表示正确访问，无错误码。

服务限制 IAM中的用户、用户组等有限定的配额。 项目 限额 账户中的IAM用户数量 500 账户中可存在的自定义策略数量 150 账户中可存在的组数量 30 附加到IAM用户的策略数量 10 账户根用户的访问密钥数量 2 IAM用户的访问密钥数量 2 IAM用户可加入的用户组数量 10 附加到IAM用户的标签数量 10 附加到IAM组的策略数量 10

本节主要介绍怎么复制文件名称。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以复制文件名。 当需要复制文件名称时，可以将鼠标放到需要复制的文件上，文件名称旁会出现一个复制按钮（），点击该按钮，即可复制该文件名称。

本节主要介绍怎么在控制台删除文件/文件夹。 通过控制台删除文件或文件夹有两种方式： 通过控制台手动删除：在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以删除文件或文件夹。选择需要删除的文件或文件夹，点击“删除”。删除文件或文件夹时，需要用户的二次确认，防止误删。 说明 删除文件夹时，会弹出文件夹的删除状态。如果删除失败，会给出失败原因。 通过配置生命周期规则进行删除文件或文件夹，详见生命周期。

名称 描述 文件名称 要分享的文件名称。 过期时间（天） 设置的过期时间。 取值：[1, 9999999]，单位是天。如果不填写，默认分享链接15分钟过期。 限制下载速度 是否开启下载速度限制。 下载速度（KiB/s） 下载速度限制。 取值：[1, 2147483647]，单位是KiB/s。 限制下载并发数 是否开启下载并发数限制。 下载并发数 下载并发数。 取值：[1，2147483647]。 链接 文件的共享链接。

本节主要介绍查看文件的详细信息。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”。点击具体的文件，可以查看文件的详细信息。 名称 描述 文件概览 可以查看下列信息： 存储区域：文件存储的数据位置。 文件名。 上次修改时间：文件最近一次的修改时间。 文件URI：文件具体的URI。 大小：文件的大小。 存储类型 文件的存储类型： 标准存储。 低频访问存储。 说明 点击“了解更多”，可以了解存储类型更多信息。 元数据 文件的具体元数据信息。详细参见管理文件元数据。

清单结果文件 存储桶清单配置后，清单结果文件会按指定的周期输出，按下列目录结构输出： destbucket └──destinationprefix └──srcbucket └──inventoryid ├──YYYYMMDDTHHMMZ │ ├──manifest.json │ └──manifest.checksum └──data └──UUID.csv.gz 名称 描述 :: destbucket 该目录为清单的目标存储桶，清单结果将存储在此存储桶。 destinationprefix 该目录为清单结果的存储路径前缀。如果清单规则配置的时候未指定该前缀，则省略该目录。 srcbucket 该目录为源存储桶，即配置清单的存储桶。 inventoryid 该目录为清单名称。 YYYYMMDDTHHMMZ 该目录为开始扫描源存储桶的时间，格林威治时间戳，如20230824T1600Z。该目录下包含了manifest.json和manifest.checksum文件。 manifest.json 提供了有关清单的元数据和其他基本信息，其中包含清单结果压缩文件的MD5值，待清单结果文件生成后，才会生成汇总清单结果文件的manifest文件。 manifest.checksum 包含manifest.json文件MD5值的文件。 data 该目录下存放了清单结果文件，清单结果文件格式为使用GZIP压缩的CSV文件。 注意 当源存储桶中文件数量较多时，为方便用户下载和处理数据，程序会自动将清单文件切分成多个CSV压缩文件。CSV压缩文件按照uuid.csv.gz、uuid1.csv.gz、uuid2.csv.gz的顺序依次递增。您可以从manifest.json文件中获取CSV文件列表，然后按照以上顺序依次解压CSV文件并读取清单数据。每个文件只会出现在一个清单结果文件中。 UUID.csv.gz 清单结果文件，存储在data文件夹中，包含清单功能导出的文件信息。报告以.csv.gz的格式进行存储，可能存在多个清单结果文件，每生成一个，就在data目录下新增一个文件。 manifest.json：提供了有关清单的元数据和其他基本信息。示例如下： { "destinationBucket": "testbucket1", "fileSchema": "Bucket, Key, Size, StorageClass, LastModifiedDate, ETag, IsMultipartUploaded", "creationTimestamp": "1692856559088", "files": [ { "MD5checksum": "3970e82605c7d109bb348fc94e9eecc0", "size": 20, "key": "abc/testbucket2/bucketempty/data/8b87dce026a54377ab6370e484764ba5.csv.gz" } ], "sourceBucket": "testbucket2", "version": "20230830", "fileFormat": "CSV" } manifest.json描述 名称 描述 :: destinationBucket 存放清单结果的目标存储桶。 fileSchema 清单结果包含的字段： Bucket：清单文件所在的存储桶。 Key：清单文件名称。 Size：文件大小。 StorageClass：文件存储的类型。 LastModifiedDate：文件最后一次修改日期。 ETag：文件的ETag值。 IsMultipartUploaded：文件是否通过分片上传生成。如果是，则该字段值为TRUE，否则为FALSE。 说明 用户在“清单内容可选信息”配置了Size、StorageClass、LastModifiedDate、ETag、IsMultipartUploaded，fileSchema中才会出现对应字段。 creationTimestamp 扫描源存储桶的时间，UNIX时间戳，精确到毫秒。 files 清单结果文件的内容： MD5checksum：清单结果文件的MD5。 size：清单结果文件的大小，单位字节。 key：清单结果文件的名称，格式为：destinationprefix /srcbucket/inventoryid /data/文件名，用户配置了destinationprefix ，destinationprefix 才会出现在路径中。 sourceBucket 源存储桶，即配置清单规则的存储桶。 version 清单版本号，值为20230830。 fileFormat 清单结果文件格式。 清单结果输出内容如下例所示，该例为“清单内容可选信息”中选择了所有可选信息输出的示例： 清单结果从左到右字段分别是： 字段名称 描述 :: Bucket 清单文件所在的存储桶。 Key 清单文件名称 文件名称使用URL编码，需要用户自行解码查看。 Size 文件大小。 StorageClass 文件存储的类型： Standard：标准存储。 StandardIA：低频访问存储。 LastModifiedDate 文件最后一次修改日期。 ETag 文件的ETag值。 文件创建的时会生成一个ETag值，用于标识Object的内容。 IsMultipartUploaded 文件是否通过分片上传生成： TRUE：通过分片上传。 FALSE：不是通过分片上传。

本节主要介绍合规保留功能。 在“存储桶列表”页面点击“属性”>“合规保留”，进入“合规保留”页面。在该页面，可以添加合规保留规则，为存储桶开启合规保留功能。合规保留开启后，对存储桶（Bucket）内的所有文件生效。 项目 描述 :: 规则类型 项目类型为合规保留。 适用范围 合规保留规则的适用范围，目前为整个存储桶。 规则 合规保留的天数。 状态 合规保留规则的启用状态： 启用。 禁用。 操作 可以对合规保留规则进行操作。未启用前，可以对规则进行启用、编辑和删除。启用后只能对规则进行编辑，设置合规保留时长大于或等于上次设置的时长，才能生效。 注意 启用存储桶合规保留功能后，任何用户（包括根用户）都不能对此存储桶内处于合规保留期的文件进行修改和删除。 可以按照下列步骤启用合规保留规则： 1. 点击“添加规则”，添加合规保留。如果已经添加了合规保留且未启用，可以点击“操作”列的“编辑”，进行修改，如果不修改，直接跳到步骤3启用合规保留。 2. 输入保留周期，点击“确认”后，会进行二次确认，是否要创建合规保留。 3. 点击“确认”后，合规保留规则创建成功。 说明 合规保留创建后，默认是禁用状态，需要用户启用后，才能生效。合规保留未启用时，可以对合规保留时长进行编辑。 4. 点击“启用”后，输入启用合规保留的存储桶名称，为该存储桶启用合规保留。 5. 点击“确认”后，合规保留启用成功。 注意 合规保留一旦启用，不能关闭，不能缩短合规保留时长，但可以通过编辑延长合规保留时长。 合规保留的时间精确到秒，例如对Bucket A设置合规保留时长为10天，文件A属于Bucket A，A的最后更新时间为201931 12:00:00，该文件会在2019311 12:00:01过合规保留期。 任何用户（包括根用户）都不能修改、覆盖、删除处于合规保留期的文件。 处于合规保留期的文件，无法通过调用API、控制台修改文件的存储类型，只能通过生命周期修改存储类型。 处于合规保留期的文件，如果设置了生命周期规则，则修改存储类型的生命周期规则可以生效，设置删除操作的生命周期规则需过了合规保留期后才能生效。

本节简要介绍文件（Object）信息。 用户存储在OOS上的每个文件都是一个Object，也被称为OOS的文件。文件可以是文本、图片、音频、视频或者网页。OOS支持的单个文件的大小从1字节到5T字节。用户可以上传、下载、删除和共享文件，还可以对文件的组织形式进行管理，将文件（Object）移动或者复制到目标目录下。 文件包含以下信息： Key：文件名称。 Data：存储的文件数据内容。 MetaData：文件元数据，表示文件的一些属性信息，如文件的最后一次修改的时间、文件大小等信息。 说明 在存储桶（Bucket）中可以创建文件夹，这里的文件夹并不是文件系统中文件夹的概念。为了方便用户进行数据管理，OOS提供了一种模拟文件夹。实际上OOS内部是通过在文件（Object）名称中增加“/”，将该文件（Object）在控制台上模拟成一个文件夹的形式展现。例如在OOS的某一存储桶中创建名为A的文件夹，待上传的文件为B.txt，将B.txt上传到A内，则文件名称（Key值）为：A/B.txt。

本节主要介绍静态网站托管。 在“存储桶列表”页面点击“属性”>“网站”，进入“网页”页面。在该页面，用户可以配置存储桶（Bucket）的网站托管属性，配置完成后，可以使用已经备案的静态网站域名访问存放在存储桶内的数据。 注意 如果配置静态网站托管后，当匿名用户直接访问Bucket的域名，会将静态网站文件下载到本地。如果要实现访问静态网站时是预览网站内容，而非下载静态网站文件，静态网站域名须是Bucket绑定的已备案自定义域名，为Bucket绑定自定义域名请联系天翼云客服申请。 OOS自有网站托管域名不支持HTTPS访问，用户自定义域名支持HTTPS访问。如果需要支持HTTPS访问，请联系天翼云客服，提供域名证书，证书支持格式：crt+key或者PEM，请确保提供的证书在有效期内，建议证书有效期至少1年及以上，避免使用免费证书。 尽量避免目标Bucket名中带有“.”，否则通过HTTPS访问时可能出现客户端校验证书出错。 网站托管配置步骤如下： 1. 创建一个公共读属性的存储桶（Bucket） 。 2. 向天翼云客服提交工单，申请客户自定义域名添加白名单 。 3. 在域名管理中添加别名 。 如果不使用CDN加速，将Bucket的CNAME Record Value（BucketName.ooswebsitecn.oosxx.ctyunapi.cn）作为别名添加到域名管理系统中。 如果使用CDN加速，将CDN厂商提供的别名添加到域名管理系统中，然后在CDN回源地址中配置OOS侧的CNAME Record Value，并将回源host配置为您的自定义域名（如yourdomain.com）。 说明 创建Bucket时显示的Endpoint为ooscn.ctyunapi.cn，该Endpoint是针对整个对象存储网络的域名，该域名在解析时，会根据用户地理位置的不同解析到不同的资源池地址。如果创建Bucket时有多个数据位置，系统默认选取创建时第一个有效数据位置作为CNAME Record Value（BucketName.ooswebsitecn.oosxx .ctyunapi.cn）。如果创建Bucket时，只有一个数据位置可用，则在Bucket区域中展示的CNAME Record Value为BucketName.ooswebsitecn.ooscn.ctyunapi.cn。所以如果使用静态网站托管，建议您根据Bucket区域属性中的数据位置，选择您想使用的数据位置的CNAME Record Value作为域名管理系统中的别名。例如您创建Bucket时有效数据位置为沈阳、兰州、成都、贵阳，则Bucket中展示的CNAME Record Value为BucketName.ooswebsitecn.ooslnsy.ctyunapi.cn，您可以将BucketName.ooswebsitecn.ooslnsy.ctyunapi.cn作为别名，也可以将兰州、成都或者贵阳为域名的CNAME Record Value作为您的别名。 4. 上传文件 。 将网站的所有文件（html、CSS、js、图片等）上传到之前创建的Bucket中，注意保持文件之间的相对路径。 5. 配置Bucket网站属性。 进入“网站属性”，选择“启用”，进行网站托管配置： 托管模式为配置到当前存储桶： 配置首页：首页指访问网站时跳转到的页面。例如将 配置错误页（可选）：错误页指当访问网站时，出现错误跳转到的页面。例如将 重定向规则（可选）：可以通过制定重定向规则，将满足条件的请求重定向到指定主机或页面。控制台支持配置JSON格式的重定向规则。可以配置多条重定向规则，每条重定向规则一个Condition和一个Redirect。例如： [ { "Condition": { "HttpErrorCodeReturnedEquals": "string", "KeyPrefixEquals": "string" }, "Redirect": { "HostName": "string", "Protocol": "Protocol", "ReplaceKeyPrefixWith": "string" } } ] 重定向规则描述 项目 描述 :: Condition Condition元素可以不配置，若配置，则包含元素不能为空。 Condition中可包含的元素：KeyPrefixEquals（重定向请求时匹配的文件名前缀）、HttpErrorCodeReturnedEquals（重定向请求时匹配的HTTP错误码）。 当某一元素存在多条值时以最后一条为准。 当KeyPrefixEquals和HttpErrorCodeReturnedEquals存在时，需要同时匹配时才生效。 如果Condition未配置，相当于匹配所有规则。 Redirect Redirect必须配置。Redirect可以为空，可以包含元素。 Redirect中可包含的元素：Protocol（重定向请求时使用的协议，取值http或https）、HostName（重定向请求时使用的站点名）、ReplaceKeyPrefixWith（描述重定向请求时使用的文件名前缀）、ReplaceKeyWith（重定向请求时使用的文件名）。 当某一元素存在多条值时，以最后一条为准。 ReplaceKeyPrefixWith和ReplaceKeyWith不能同时存在。 托管模式为重定向请求：需要设置重定向的存储桶访问域名或者URL，所有到达该存储桶的请求将被重定向到该地址。例如，你将重定向页面配置为www.ctyun.cn，所有到您域名（如

本节主要介绍日志功能。 在“存储桶列表”页面点击“属性”>“日志”，进入“日志”页面。在该页面，用户可以为存储桶配置日志功能。 日志功能可以帮助您记录所有操作记录， 您可以选择“启用”或“禁用”用户日志功能，同时还可以通过设置目标存储桶和路径来指定日志的存储位置。日志记录的格式，请参见API参考HTTP REST（OOS API）关于Bucket的操作PUT Bucket Logging。 项目 描述 : 日志类型 日志类型为本地日志。 状态 是否启用日志功能记录对该存储桶的所有操作： 启用。 禁用。 前缀 日志的前缀名称。 目标存储桶 日志存储的目标存储桶，可以根据下拉框进行选择目标存储桶。

本节主要介绍存储桶的安全策略。 安全策略定义OOS资源的访问权限，作用于所配置的存储桶及存储桶内文件（Object）。OOS存储桶拥有者通过安全策略可为IAM用户或其他帐号授权存储桶及存储桶内文件的操作权限，具体包括： 允许/拒绝Bucket级别的权限。 允许/拒绝Object级别的权限。 存储桶的安全策略是由效果、被授权用户、资源、动作和条件5个桶策略基本元素共同决定，详细的Bucket Policy格式请参见Bucket Policy元素。 说明 如果存储桶（Bucket）的属性为私有或者公共读，配置允许任何用户可以向该Bucket写文件的策略时，需要联系天翼云客服评估审核后开通此功能。 在“存储桶列表”页面点击“属性”>“安全策略”，进入“安全策略”页面，在该页面点击“编辑策略”，可以添加Bucket Policy。 Policy示例如下： Referer设置（防盗链设置） 如果要配置名称为"examplebucket"的Bucket的访问策略，只允许Referer头为以“ { "Version":"20121017", "Id":"", "Statement":[ { "Sid":"", "Effect":"Allow", "Principal":{ "CTYUN": [""] }, "Action":"oos:GetObject", "Resource":"arn:ctyun:oos:::examplebucket/", "Condition":{ "StringLike":{ "ctyun:Referer":[ " " ] } } } ] } IP设置 如果只允许IP地址在192.168.143.0/24范围内的IP访问存储桶examplebucket，不允许IP地址192.168.143.188/32访问，那么可以采用如下的配置方式。 { "Version": "20121017", "Id": "OOSPolicyId1", "Statement": [ { "Sid": "IPAllow", "Effect": "Allow", "Principal": { "CTYUN": "" }, "Action": "oos:GetObject", "Resource": "arn:ctyun:oos:::examplebucket/", "Condition" : { "IpAddress" : { "ctyun:SourceIp": "192.168.143.0/24" }, "NotIpAddress" : { "ctyun:SourceIp": "192.168.143.188/32" } } } ] }

项目 描述 时间选择 数据取回量查询的时间段，可以选择查看下列时间段的数据取回量： 今日。 昨日。 近7日。 近30日。 根据日历按钮，选择查询任意90天数据取回量。 数据位置 数据取回量查询的数据位置，可以选择： 全部数据位置：展示所有数据位置的数据取回量之和。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的数据取回量。 存储桶 数据取回量查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的数据取回量之和。 指定存储桶：根据显示的存储桶，选择查看对应存储桶的数据取回量。 存储类型 选择数据的存储类型： 全部存储类型：分别展示不同存储类型的数据取回量。 低频访问存储：低频访问存储的数据取回量。

项目 描述 时间选择 并发连接数查询的时间段，可以选择查看下列时间段的并发连接数： 今日。 昨日。 根据日历按钮，选择查询任意1天的并发连接数。 数据位置 并发连接数查询的数据位置，可以选择： 全部数据位置：展示所有数据位置的并发连接数之和。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的并发连接数。 存储桶 并发连接数数查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的并发连接数之和。 具体存储桶：根据显示的存储桶，选择查看对应存储桶的并发连接数。 连接类型 选择并发连接数的连接类型： 全部连接类型：包含互联网连接数和非互联网连接数。 互联网连接数。 非互联网连接数。

本节主要介绍删除量的统计信息。 进入“统计”页面，点击“删除量”，可以查看删除量的统计信息，包括标准类型的删除量、低频访问存储的删除量。 删除量的统计信息描述 项目 描述 :: 时间选择 删除量查询的时间段，可以选择查看下列时间段的删除量： 今日。 昨日。 近7日。 近30日。 根据日历按钮，选择查询任意90天内删除量。 时间粒度 删除量查询的时间粒度，可以选择： 按五分钟查询：统计信息按每5分钟展示，可以选择查询今日、昨日或按日历选择任意1天的数据。 按小时查询：统计信息按每小时展示，可以查询今日、昨日、近7日或按日历选择任意7天内的数据。 按天查询：统计信息按天展示，可以查询今日、昨日、近7日、近30天或按日历按钮选择任意90天内的数据。 数据位置 删除量查询的数据位置，可以选择： 全部数据位置：展示所有数据位置的删除量之和。 具体数据位置：根据显示的数据位置进行选择，查看对应数据位置的删除量。 存储桶 删除量查询的存储桶，可以选择： 全部存储桶：展示所有存储桶的删除量之和。 具体存储桶：根据显示的存储桶，选择查看对应存储桶的删除量。 存储类型 选择删除量查询的类型： 全部存储类型：分别展示标准存储和低频访问存储的删除量。 标准类型：标准存储的删除量。 低频访问存储：低频访问存储的删除量。 可以点击“下载”按钮，将统计信息下载到本地查看。 项目 描述 :: Date 统计时间。 StorageClass 存储类型，即产生删除量的存储类型。 DeleteStorageUsage(Bytes) 用户删除及生命周期删除产生的删除量，单位是Bytes。

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

本节主要介绍怎么创建存储桶（Bucket）。 点击“存储桶列表”>“创建存储桶（Bucket）”，输入存储桶名称，并设置访问权限、数据位置、索引位置 、数据调度策略。 命名规范 存储桶（Bucket）的命名规范是： 存储桶名称必须全局唯一。 存储桶名称长度介于3到63字节之间。 存储桶名称可以由一个或者多个小节组成，小节之间用点（.）隔开，各个小节需要： 只能包含小写字母、数字和短横线（）。 必须以小写字母或者数字开始。 必须以小写字母或者数字结束;Bucket名称不能是IP地址形式（如192.162.0.1）。 存储桶名称不能是一组或多组“数字.数字”的组合。 存储桶名称中不能包含双点（..）、横线点（.）和点横线（.）。 不允许使用非法敏感字符，例如暴恐涉政相关信息等。 访问权限 对象存储系统提供Bucket级别的权限控制，Bucket目前有3种访问权限：私有、公共读、公共读写。各自的含义如下： 私有：只有根用户和具有相应权限的子用户可以对该存储桶内的文件进行读/写/删除操作（包括Get、Put和Delete Object），其他人（包括匿名访问）只有通过Bucket Policy授权或分享链接才可访问该存储桶内的文件。 公共读：只有根用户和具有相应权限的子用户可以对该存储桶内的文件进行写/删除操作（包括Put和Delete Object）。任何人（包括匿名访问）都可以对该存储桶内的文件进行读操作，这有可能造成您数据的外泄以及费用激增，请慎用该权限。 公共读写：任何人（包括匿名访问）都可以对该存储桶内的文件进行读/写/删除操作（包括Get、Put和Delete Object）。 注意 配置公共读写权限可能造成您数据的外泄以及费用激增，若被人恶意写入违法信息还可能会侵害您的合法权益，除特殊场景外，不建议您配置公共读写权限。 如果想使用访问权限为公共读写的存储桶，请联系天翼云客服评估审核后开通此功能。

本节主要介绍OOS涉及到的相关术语。 账户（ Account ） 在使用OOS之前，需要在天翼云网站www.ctyun.cn注册一个Account（账户）。注册时邮箱、密码和手机号码是必填项。正确填写所需信息并进行实名认证之后，联系天翼云客服人员（客服电话：4008109889）申请开通OOS服务。开通OOS服务成功之后，用户可以用该账户登录并使用OOS服务。 服务（ Service ） Service是OOS为注册成功的用户提供的服务，该服务为用户提供弹性可扩展的存储空间，用户可以根据自己的业务需要建立1至10个存储桶（Bucket）。 存储桶（ Bucket ） 存储桶（Bucket）是存储文件（Object）的容器。对象存储系统的每个文件（Object）都必须包含在一个存储桶中。对象存储提供的是基于桶和文件的扁平化存储方式，桶中的所有文件都处于同一逻辑层级，去除了文件系统中的多层级树形目录结构。 您可以设置存储桶的属性，用来控制数据存储位置、访问权限、生命周期等，这些属性设置直接作用于该存储桶内的所有文件，因此您可以通过灵活的属性设置，来创建不同的存储桶，完成不同的管理功能。每个用户最多可以建立10个存储桶。用户只有对Bucket拥有相应的权限，才可以对其进行操作，这样保证了数据的安全性，防止非授权用户的非法访问。 对象（ Object ） 对象（Object）是用户存储在OOS上的数据基本单元，也被称为OOS的文件。文件可以是文本、图片、音频、视频或者网页。OOS支持的单个文件的大小从1字节到5T字节。 用户可以上传、下载、删除和共享文件。同时用户还可以对文件的组织形式进行管理，将文件移动或者复制到目标目录下。