华为云用户手册

请求示例 创建模板名称为confirm_message，且模板支持的协议类型为https的消息模板 POST https://{SMN_Endpoint}/v2/{project_id}/notifications/message_template{ "message_template_name" : "confirm_message", "protocol" : "https", "content" : "(1/2)You are invited to subscribe to topic({topic_id}). Click the following URL to confirm subscription:(If you do not want to subscribe to this topic, ignore this message.)"}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 message_template_name 是 String 创建模板的名称。只能包含大写字母、小写字母、数字、-和_，且必须由大写字母、小写字母或数字开头，长度在1到64个字符之间。 protocol 是 String 模板支持的协议类型。 目前支持的协议包括： “default”：默认协议。 “email”：邮件传输协议。 “sms”：短信传输协议。 “functionstage”：FunctionGraph（函数）传输协议。 “dms”：DMS传输协议。 “http”、“https”：HTTP/HTTPS传输协议。 content 是 String 模板内容，模板目前仅支持纯文本模式。模板内容不能空，最大支持256KB。

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 message_template_id String 模板唯一的资源标识。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 403 表6 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 404 表7 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 500 表8 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。

URI DELETE /v2/{project_id}/notifications/applications/{application_urn} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取项目ID请参考 获取项目ID。 application_urn 是 String Application的唯一资源标识，可通过查询Application获取该标识。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 403 表5 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 404 表6 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 value 是 String 当请求参数name为access_policy时，value为Topic属性值，最大支持30KB。 当请求参数name为introduction时，value为topic简介，最大长度120B。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 403 表6 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 404 表7 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 500 表8 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。

URI PUT /v2/{project_id}/notifications/topics/{topic_urn}/attributes/{name} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取项目ID请参考 获取项目ID。 topic_urn 是 String Topic的唯一的资源标识，可通过查询主题列表获取该标识。 name 是 String 主题策略名称。只支持特定的策略名称，请参见Topic属性表。

请求示例 更新主题策略 PUT https://{SMN_Endpoint}/v2/{project_id}/notifications/topics/{topic_urn}/attributes/access_policy{ "value" : "{ \"Version\": \"2016-09-07\", \"Id\": \"__default_policy_ID\", \"Statement\": [ { \"Sid\": \"__user_pub_0\", \"Effect\": \"Allow\", \"Principal\": { \"CSP\": [ \"urn:csp:iam::{domainID}:root\" ] }, \"Action\": [\"SMN:Publish\",\"SMN:QueryTopicDetail\"], \"Resource\": \"{topic_urn}\" }, { \"Sid\": \"__service_pub_0\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [\"obs\"] }, \"Action\": [\"SMN:Publish\",\"SMN:QueryTopicDetail\"], \"Resource\": \"{topic_urn}\" } ] }"} 更新主题策略 PUT https://{SMN_Endpoint}/v2/{project_id}/notifications/topics/{topic_urn}/attributes/introduction{ "value" : ""}

异常响应 异常响应要素说明 名称 参数类型 说明 request_id String 请求的ID code String 参考错误码 message String 参考错误码 异常响应举例 { "request_id": "aad0860d089c482b943971f802a6718e", "code": "SMN.0006", "message": "Topic not found."} 父主题： 通用请求返回值

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": "********", //IAM用户密码 "domain": { "name": "domainname" //IAM用户所属帐号名 } } } }, "scope": { "project": { "name": "xxxxxxxx" //项目名称 } } }} 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 123 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projectsContent-Type: application/jsonX-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

application消息体格式 表1 application消息体格式 类型 样例 备注 华为透传消息 "hps": { "msg" : { "type" : 1, "body" : {"key":"value"} } } body为用户自定义格式。 说明： 推荐使用JSON格式，如样例所示 对于纯文本可以将body设置为字符串(采用UTF-8编码) 消息体最大2K 详细的字段介绍及其使用请参见华为推送平台的接口定义。 华为系统通知栏消息 "hps": { "msg": { "type": 3, "body": { "content": "Push message content", "title": "Push message content" }, "action": { "type": 1, "param": { "intent":"#Intent;compo=com.rvr/.Activity;S.W=U;end" } } }, "ext": { "biTag": "Trump", "icon": "http://upload.w.org/00/150pxsvg.png" } } 苹果平台消息格式 { "aps": { "alert": "hello world" } } 消息体最大4K。 详细的字段介绍及其使用参见苹果推送平台的接口定义。 父主题： 公共参数

请求示例 删除订阅URN为urn:smn:regionId:762bdb3251034f268af0e395c53ea09b:test_topic_v1:2e778e84408e44058e6cbc6d3c377837的订阅者 DELETE https://{SMN_Endpoint}/v2/{project_id}/notifications/subscriptions/urn:smn:regionId:762bdb3251034f268af0e395c53ea09b:test_topic_v1:2e778e84408e44058e6cbc6d3c377837null

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 403 表5 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 404 表6 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。 message String 服务异常错误信息描述。

使用场景 用户可以根据需要将存储在OBS上的对象复制到其他路径下。复制对象操作将创建需要复制的对象的副本。在单次操作中，您可以创建最大5GB的对象副本。对于复制大于5GB的对象副本，请您使用多段上传API。通过使用copy操作，您可以： 创建对象的其他副本。 通过复制对象并删除原始对象来重命名它们。 更改对象元数据。每个OBS对象都带有元数据，它是一组名称值对，您可以在上传对象时对其进行设置。上传对象后，您可以通过接口修改元数据，详情请参见修改对象元数据。也可以创建对象的副本并设置元数据，在复制操作中，设置与源和目标相同的对象。 每个对象都带有元数据。有些是系统元数据，而另外一些则是用户定义的元数据。用户可以控制某些系统元数据。复制对象时，还会复制用户控制的系统元数据和用户定义的元数据。OBS将重设系统控制的元数据。例如，在复制对象时，OBS将重设已复制的对象的创建日期。在复制请求中，您无需设置这些值。 复制对象时，您可能会决定更新某些元数据值。例如，如果您的源对象被配置为使用标准存储，您可能会为对象复制选择低频访问存储。您可能还会决定更改源对象上某些用户定义的元数据值。请注意，如果您选择在复制期间更新任意对象的用户可配置元数据（系统或用户定义的），则您必须显式地指定所有的用户可配置元数据，即使您只更改一个元数据的值（显示在请求中源对象上）。 如果您想将对象自动复制到其他区域，可以创建跨区域复制规则，以满足异地容灾等需求，详情请参见跨区域复制。 OBS帮助您将存储于华为云对象存储的业务数据复制到指定Region，但华为云并不感知您的数据的具体内容，也不对您使用本服务的合法合规性负责。如果您的复制涉及跨境传输，请确保您使用本服务符合法律法规的要求。 在桶没有开启多版本的情况下，将源对象objecta复制为目标对象objectb，如果在复制操作之前对象objectb已经存在，复制操作执行之后老对象objectb则会被新复制对象objectb覆盖，复制成功后，只能下载到新的对象objectb，老对象objectb将会被删除。因此在使用copy接口时请确保目标对象不存在或者已无价值，避免因copy导致数据误删除。复制过程中源对象objecta无任何变化。 复制对象的结果不能仅根据HTTP返回头域中的status_code来判断请求是否成功，头域中status_code返回200时表示服务端已经收到请求，且开始处理复制对象请求。复制是否成功会在响应消息的body中，只有body体中有ETag标签才表示成功，否则表示复制失败。

拷贝段 多段上传任务创建后，用户可以通过指定多段上传任务号，为特定的任务上传段。添加段的方式还包括调用段拷贝接口。允许客户将已上传对象的一部分或全部拷贝为段。 拷贝段的结果不能仅根据HTTP返回头域中的status_code来判断请求是否成功，头域中status_code返回200时表示服务端已经收到请求，且开始处理拷贝段请求。拷贝是否成功会在响应消息的body中，只有body体中有ETag标签才表示成功，否则表示拷贝失败。 将源对象object拷贝为一个段part1，如果在拷贝操作之前part1已经存在，拷贝操作执行之后老段数据part1会被新拷贝的段数据覆盖。拷贝成功后，只能列举到最新的段part1，老段数据将会被删除。因此在使用拷贝段接口时请确保目标段不存在或者已无价值，避免因拷贝段导致数据误删除。拷贝过程中源对象object无任何变化。

列举已上传的段 您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回您已为特定多段上传任务而上传的段信息。对于每个列举已上传的段请求，OBS将返回有关特定多段上传任务的分段信息，最多为1000个分段。如果多段上传中的段超过1000个，您必须发送一系列列举已上传的段请求以检索所有段。请注意，返回的分段列表不包括已合并的分段。 仅使用返回的列表进行验证。发送完成多段上传请求时，您不应使用此列表的结果。但是，当上传段和OBS返回的相应的ETag值时，将保留您自己的指定段编号的列表。

使用场景 云审计服务（Cloud Trace Service，CTS），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。 用户开通云审计服务并创建和配置追踪器后，CTS可记录OBS的管理事件和数据事件用于审计。 CTS的详细介绍和开通配置方法，请参见CTS快速入门。 CTS支持追踪的OBS管理事件和数据事件列表，请参见审计。 图1 云审计示意图

合并段和取消多段上传任务 合并段时，OBS通过按升序的段编号规范化多段来创建对象。如果在初始化上传段任务中提供了任何对象元数据，则OBS会将该元数据与对象相关联。成功完成请求后，段将不再存在。合并段请求必须包括上传ID以及段编号和相应的ETag值的列表。OBS响应包括可唯一地识别组合对象数据的ETag。此ETag无需成为对象数据的MD5哈希。您可以选择取消多段上传任务，取消多段上传任务之后无法再次使用该上传ID上传任何段。然后，OBS将释放被取消的多段上传任务中的每个段数据的所有存储。如果任何多段上传已在进行中，即使您已执行中止操作，它们仍可以上传成功或失败。若要释放所有分段使用的所有存储，必须在完成所有多段上传后再取消多段上传任务。 如果上传了10个段，但合并时只选择了9个段进行合并，那么未被合并的段将会被系统自动删除，未被合并的段删除后不能恢复。在进行合并之前请使用列出已上传的段接口进行查询，仔细核对所有段，确保没有段被遗漏。

列举多段上传任务 通过列举桶中的多段上传任务，您可以获得已初始化多段上传任务的列表，已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多1000个多段上传任务，如果正在进行的多段上传任务超过1000个，您需要发送其他请求以检索剩余的多段上传任务。 列举多段上传任务的限制如表1所示： 表1 列举多段上传任务的限制 项目 限制 对象大小 最大48.8TB 每次上传的段的数量 最大10000 段编号 1到10000（含） 段大小 100KB到5GB，最后一个段大小是0到5GB 列举已上传的段请求返回的段数量 最大1000 列举已初始化多段任务请求返回的任务数量 最大1000

多段上传API和权限 用户必须具有使用多段上传操作的所需权限。您可以使用ACL、桶策略或用户策略来授予用户以执行这些操作的权限。下表列出了使用ACL、桶策略或用户策略时，各种多段上传操作的所需权限。 操作 所需权限 初始化上传段任务 您必须要有执行PutObject操作的权限，才能初始化上传段任务。 桶所有者可以允许其他委托人执行PutObject。 上传段 您必须要有执行PutObject操作的权限，才能上传段。 仅多段上传任务的发起者可以上传段。桶所有者必须赋予多段任务发起者执行PutObject操作的权限，以便发起者可以上传该对象的段。 拷贝段 您必须要有执行PutObject操作的权限，同时因为您正在将一个已存在的对象作为一个段来上传，因此您也必须要有对拷贝源对象执行GetObject操作的权限才可以拷贝段。 仅多段上传任务的发起者可以拷贝段。桶所有者必须赋予多段任务发起者对对象执行PutObject操作的权限，以便发起者可以上传该对象的段。 合并段 您必须要有执行PutObject操作的权限，才能进行合并段操作。 仅多段上传任务的发起者可以合并段。桶所有者必须赋予多段任务发起者对对象执行PutObject操作的权限，以便发起者可以完成该对象的多段上传。 取消多段上传任务 您必须要有执行AbortMultipartUpload操作的权限，才能取消多段上传任务。 默认情况下，允许桶所有者和多段上传任务的发起者执行此操作。除了这些默认情况之外，桶所有者可以允许其他委托人对对象执行AbortMultipartUpload操作。桶所有者可以拒绝任何委托人，使其无法执行AbortMultipartUpload操作。 列举已上传的段 您必须得到可以执行ListMultipartUploadParts操作的权限，才能在多段上传中列举已上传的段。 在默认情况下，桶所有者有权为任何针对桶的多段上传列举已上传的段。多段上传任务的发起人有权为特定多段上传列举已上传的段。 除了这些默认情况之外，桶所有者可以允许其他委托人对对象执行ListMultipartUploadParts操作。桶所有者也可以拒绝任何委托人，使其无法执行ListMultipartUploadParts操作。 列举多段上传任务 您必须得到可以对桶执行ListBucketMultipartUploads操作的权限，才能列出正在上传到该桶的多段上传。 除了默认情况之外，桶所有者可以允许其他委托人对桶执行ListBucketMultipartUploads操作。

上传段 上传段时，除了指定上传ID，还必须指定段编号。您可以选择1和10000之间的任意段编号。段编号在您正在上传的对象中唯一地标示了段及其位置。如果您使用之前上传的段的同一段编号上传新段，则之前上传的段将被覆盖。无论您何时上传段，OBS都将在其响应中返回ETag标头。对于每个段上传任务，您必须记录每个段编号和ETag值。您需要在随后的请求中包括这些值以完成多段上传。 初始化上传段任务并上传一个或多个段之后，您必须合并段或取消多段上传任务，才能停止收取上传的段的存储费用。仅当在合并段或取消多段上传任务之后，OBS才释放段存储并停止向您收取段存储费用。 多并发上传同一对象的同一段时，服务端遵循Last Write Win策略，但“Last Write”的时间定义为段元数据创建时间。为了保证数据准确性，客户端需要加锁保证同一对象的同名段上传的并发性。同一对象的不同段并发上传不需要加锁。

使用方式 OBS支持通过控制台、API、SDK、OBS Browser+、obsutil方式设置桶和对象的存储类别。 支持的使用方式 参考文档 控制台 创建桶时指定桶存储类别 上传文件时指定对象存储类别 SDK OBS支持多种语言SDK，请从SDK概述页面选择进入对应的开发指南查阅。 API 设置桶默认存储类别 创建桶时指定桶存储类别（添加x-obs-storage-class头域设置） PUT上传时指定对象存储类别（添加x-obs-storage-class头域设置） POST上传时指定对象存储类别（添加x-obs-storage-class头域设置） OBS Browser+ - obsutil 创建桶时指定桶存储类别 设置桶属性指定桶存储类别 上传对象时指定对象存储类别 设置对象属性指定对象存储类别

图片处理 图片处理特性（Image Processing）是对象存储服务（Object Storage Service，OBS）为用户提供稳定、安全、高效、易用、低成本的图片处理服务，包括：图片瘦身、图片剪切、图片缩放、图片水印、格式转换等。 图片处理特性提供OBS管理控制台和RESTful API接口的使用方法，使用户可以在任何时间和地点对存储在对象存储中的图片进行处理，并且可以快速获取到处理后的图片。 详情请参见图片处理特性指南。 父主题： 数据处理

并行文件系统 并行文件系统（Parallel File System）是OBS提供的一种经过优化的高性能文件系统，提供毫秒级别访问时延，以及TB/s级别带宽和百万级别的IOPS，能够快速处理高性能计算（HPC）工作负载。 作为对象存储服务的子产品，并行文件系统支持用户按照标准的OBS接口读取数据。也支持通过部署在弹性云服务器中的PFS客户端（obsfs工具），按照POSIX文件语义读写数据；通过obsfs用户可以将创建的并行文件系统挂载到云端Linux服务器上并能像操作本地文件系统一样对并行文件系统内的文件和目录进行在线处理，包括：创建、删除文件/目录，重命名文件/目录，修改写文件等操作。 详情请参见并行文件系统特性指南。

多版本控制功能启用时的对象找回机制 启用了多版本控制功能的OBS桶中的文件从“对象”列表删除后，OBS不会立即将其彻底删除，而是保留在“已删除对象”中，同时会为其打上删除标记。您可以通过“取消删除”功能来找回被删除的文件。 使用“取消删除”功能需要注意以下几点： 只支持对文件“取消删除”，不支持对文件夹“取消删除”。 “取消删除”文件后，该文件会恢复到“对象”列表中，此时可以正常使用对象的基本功能。如果文件存放于某个文件夹下，“取消删除”文件后依然会保留原有的目录结构。 “已删除对象”中的文件仍然会保留多版本，在对不同的版本进行删除时需要注意： 如果删除的是带“删除标记”的版本，实际上是找回该文件，等同于“取消删除”文件，而非彻底删除。 如果删除的是不带“删除标记”的版本，则会彻底删除该历史版本。即使后续该文件找回后，也无法恢复这个被彻底删除的历史版本。 “已删除对象”中的文件至少需要保留一个不带“删除标记”的历史版本，否则无法执行“取消删除”操作。

使用场景 桶中不完整的数据称之为碎片。OBS采用分块上传的模式上传数据，在下列情况下（但不仅限于此）通常会导致数据上传失败而产生碎片。 网络条件较差，与OBS的服务器之间的连接经常断开。 上传过程中，人为中断上传任务。 设备故障。 突然断电等特殊情况。 OBS中的碎片会占用存储空间，会按照存储空间计费项进行计费。当存在运行中断或失败的分段上传任务并产生碎片后，您可以继续运行中断或失败的上传任务来消除碎片，或直接将碎片删除以节省存储空间。 您可以根据需要选用合适的方式清理碎片，详情请参见如何处理碎片。 当您遇到删除桶失败的场景，请检查碎片列表中的对象是否已经全部删除。若没有，请先删除碎片列表中的所有对象。 当您遇到桶内无对象，却还在扣费的场景，请检查桶内是否还存在碎片。若存在，请删除碎片以节约存储成本。

单个删除和批量删除 OBS支持单个和批量删除对象，各个使用方式的批量删除方法请参见批量删除对象。 批量删除的性能和单个请求内的对象数负相关，对于QPS的计算，删除N个对象，算N次操作。如果删除对象数量大并且对象前缀使用了字典序，可能导致大量对象的请求访问集中于某个特定分区，造成访问热点。热点分区上的请求速率受限，访问时延上升。 为解决以上问题，您可以考虑减少单个批量删除请求的对象数量，增加并发请求数，并将对象名的顺序前缀改为随机性前缀。

多版本控制功能启用时的对象删除机制 桶的多版本控制功能启用时，删除的目标不同，OBS会采取不同的处理方式： 删除文件或文件夹：文件或文件夹不会立即被彻底删除，而是保留在“已删除对象”列表中，同时会为文件打上删除标记。 如果想要彻底删除，需要再到“已删除对象”列表进行删除。 如果想要找回删除的文件，可以通过“取消删除”功能来找回。详情请参见取消删除对象。 删除文件的某个版本：该版本会被彻底删除且无法恢复。如果删除的是文件的最新版本，那么时间最近的那个历史版本将会变成最新版本。 在多版本控制功能启用的场景下，在“已删除对象”中的文件仍然会保留多版本，在对不同的版本进行删除时需要注意： 如果删除的是带“删除标记”的版本，实际上是找回该文件，等同于“取消删除”文件，而非彻底删除。详情请参见取消删除对象。 如果删除的是不带“删除标记”的版本，则会彻底删除该历史版本，即使后续该文件找回后，也无法恢复这个被彻底删除的历史版本。 更多关于找回已删除对象的内容请参见多版本控制功能启用时的对象找回机制。