华为云用户手册

列举多段上传任务 通过列举桶中的多段上传任务，您可以获得已初始化多段上传任务的列表，已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多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操作。

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

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

使用方式 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 创建桶时指定桶存储类别 设置桶属性指定桶存储类别 上传对象时指定对象存储类别 设置对象属性指定对象存储类别

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

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

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

使用方式 表1 删除碎片的不同方式 工具 方法 OBS控制台 OBS控制台提供图形化的碎片列表界面，您可以一键批量删除桶中所选中的碎片。 具体操作请参见清理碎片。 OBS Browser+ 您可以一键批量删除桶中所选中的碎片。也可以单击页面上方“删除所有”，清除所有碎片。 obsutil obsutil分段上传任务产生的碎片，可以通过删除分段上传任务来删除碎片。如果一个桶内有多个分段任务，则需要删除多个任务来删除桶中所有碎片。 具体操作请参见删除分段上传任务。 OBS API 您可以通过以下步骤来直接删除桶中碎片： 使用列举桶中已初始化多段任务接口，来列举所有分段上传任务，获取所有UploadId。 使用取消多段上传任务接口，来取消分段上传任务，即可删除所有碎片。 OBS SDK OBS SDK通常只有采用多段上传，并且最后没有合并多段上传任务时会产生碎片，您通过取消多段上传任务来删除桶内碎片。步骤如下： 使用ObsClient.listMultipartUploads列举所有分段上传任务，获取所有UploadId。 使用ObsClient.abortMultipartUpload取消分段上传任务，即可删除所有分段碎片。

手动删除和自动删除 您可以随时手动删除对象，也可以通过生命周期管理功能，定期自动删除桶中对象或者一次性清空桶中所有对象。 对于并行文件系统目录，大数据场景下（目录层级深、目录下文件多）的删除，可能会因超时而删除失败，建议使用： hadoop 客户端（嵌套OBS客户端插件OBSA）删除目录：hadoop fs - rmr obs://{并行文件系统名}/{目录名}。 给目录配置生命周期规则，通过生命周期后台删除。

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

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

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

背景知识 跨域是指不同域名之间相互访问。 跨域访问是浏览器出于安全考虑而设置的一个限制，即同源策略。由于JavaScript同源策略的限制，A域名下的JavaScript无法操作B域名或C域名下的对象。 同协议、同域名（或IP）、以及同端口视为同一个域。两个页面的协议、域名和端口（若指定了端口）相同，则视为同源。为了更好的理解是否同源，您可以查看表1中相对https://support.huaweicloud.com/dir/test.html的同源检测示例。 表1 同源检测示例 URL 访问结果 原因 https://support.huaweicloud.com/dir/other.html 成功 协议、域名、端口都相同 https://support.huaweicloud.com/dir/inner/other.html 成功 协议、域名、端口都相同 http://support.huaweicloud.com/dir/test.html 失败 域名、端口相同，协议不同 https://support.huaweicloud.com:81/dir/test.html 失败 协议、域名相同，端口不同 https://help.huaweicloud.com/dir/test.html 失败 协议、端口相同，域名不同

背景介绍 现在越来越多的行业使用OBS存储图片、视频、软件包等静态资源文件，并将OBS作为网站、论坛、APP、游戏等业务的存储源。在需要获取这些静态资源时，用户通过URL直接从OBS请求数据，数据请求过程如图1所示。OBS能够很好的解决本地存储不够用的难题，但一般情况下文件只存储在一个区域，不同区域的用户访问OBS的响应速度存在差异。在需要频繁访问的场景下，直接访问OBS来获取相应文件，还会消耗大量的流量费用。 图1 从OBS获取数据过程

使用场景 通常您的业务系统可能使用了华为云的多种云服务，您可以为这些云服务下不同的资源实例分别设置标签（对于OBS而言，资源实例即为桶），各服务产生的计费详单中都会体现这些资源实例和实例上设置的标签。如果您的业务系统是由多个不同的应用构成，为同一种应用拥有的资源实例设置统一的标签将很容易帮助您对不同的应用进行使用量分析和成本核算。 对OBS来说，标签用于标识桶，以此来达到对OBS中的桶进行分类的目的。当为桶添加标签时，该桶上所有请求产生的计费话单里都会带上这些标签，从而可以针对话单报表做分类筛选，进行更详细的成本分析。例如：某个应用程序在运行过程会往桶里上传数据，我们可以用应用名称做为标签，设置到被使用的桶上。在分析话单时，就可以通过应用名称的标签来分析此应用的成本。 OBS以键值对的形式来描述标签。一个桶默认最大拥有10个标签。每个标签有且只有一对键值。键和值可以任意顺序出现在标签中。同一个桶标签的键不能重复，但是值可以重复，并且可以为空。设置桶标签后，大约需要等待3分钟才能生效。

方案说明 OBS提供低成本的存储，华为云CDN可以提供网站加速、文件下载加速和点播加速。将数据存放在OBS中然后通过配置 CDN加速 ，这样构造的业务系统可以在降低成本的同时，提高终端用户使用感受。当终端用户发起访问请求时，会首先通过CDN查找对此域名响应速度最快的CDN节点，并查询此节点是否有缓存终端用户请求的内容。 在CDN节点没有缓存用户请求的数据或缓存到期的情况下，CDN加速访问OBS的示意图如图2所示。 图2 CDN加速访问OBS示意图（CDN无缓存） 当其他终端用户再次访问相同的数据时，CDN将直接返回缓存的数据给终端用户，而无需再向OBS发起访问请求。在CDN有缓存的情况下，CDN加速访问OBS的示意图如图3所示。 图3 CDN加速访问OBS示意图（CDN有缓存） 方案优势 低成本：OBS提供CDN回源流量包折扣方式，使CDN从OBS获取数据时流量费用更低。当数据缓存至CDN节点时，后续请求都将通过CDN回源流量计费，从而减少OBS费用。 高效率：华为云CDN具有加速资源丰富、节点分布广泛优势，保证将用户请求精准调度至最佳边缘节点，提供有效且稳定的加速效果。 适用场景 通过OBS提供文件下载业务的应用或服务。例如：通过http/https提供文件下载业务的网站、工具下载、游戏客户端、APP商店等。 通过OBS提供音 视频点播 业务的应用或服务。例如：在线教育类网站、在线视频分享网站、互联网电视点播平台、音乐视频点播APP等。

使用场景 用户在使用OBS的过程中会不断发送PUT、GET类的请求，产生上传、下载流量，也可能会遇到服务端返回的错误响应。为使用户更好地掌握OBS桶的状态，华为云提供了 云监控服务 （Cloud Eye）。用户可使用该服务监控自己的OBS桶，执行自动实时监控、告警和通知操作，帮助您实时掌握桶中所产生的请求、流量和错误响应等信息。 云监控 服务不需要开通，会在用户创建资源（如OBS桶）后自动启动。 关于云监控服务的更多介绍，请参见云监控服务产品介绍。 图1 云监控示意图

使用场景 一些不良网站想要扩充自己站点内容，但却不想增加成本，于是会盗用其他网站的链接。一方面损害了原网站的合法利益，另一方面又加重了服务器的负担。因此，产生了防盗链技术。 在HTTP协议中，通过表头字段referer，网站可以检测目标网页访问的来源网页。有了referer跟踪来源，就可以通过技术手段来进行处理，一旦检测到来源不是本站即进行阻止或者返回指定的页面。防盗链就是通过设置Referer，去检测请求来源的referer字段信息是否与白名单或黑名单匹配，若与白名单匹配成功则允许请求访问，否则阻止请求访问或返回指定页面。 为了防止用户在OBS的数据被其他人盗链，OBS支持基于HTTP header中表头字段referer的防盗链方法。OBS同时支持访问白名单和访问黑名单的设置。 Referer规则如下： 白名单Referer/黑名单Referer输入的字节数不能超过1024个字符。 Referer格式： Referer可以设置多个，多个Referer换行隔开； Referer参数支持通配符（*）和问号（?），通配符可代替0个或多个字符，问号可代替单个字符； 如果下载时Referer头域包含了http或https，则Referer设置必须包含http或https。 白名单Referer为空，黑名单Referer不空时，允许所有黑名单中指定网站以外的其他网站的请求访问目标桶中的数据。 白名单Referer不为空，黑名单Referer为空或不空时，允许在白名单且不在黑名单中的网站的请求访问目标桶中的数据。 当白名单Referer与黑名单Referer内容有交集时，交集部分Referer被禁止。例如：当白名单Referer与黑名单Referer输入框中的referer字段都有“https://www.example.com”时，系统是阻止该网站的请求访问的。 黑名单Referer与白名单Referer都为空时，默认允许所有网站的请求访问目标桶中的数据。 判断用户是否有对桶及其内容访问的四种权限（读取权限、写入权限、ACL读取权限、ACL写入权限）之前，需要首先检查是否符合referer字段的防盗链规则。 白名单和黑名单设置方法如下： 白名单设置 通过设置白名单，用户可以指定允许来自白名单列表中的网站的请求访问，否则将进行拦截。 通过浏览器地址栏直接访问资源的请求，即HTTP请求中referer为空的场景，用户可以通过在Condition的"Referer"中添加${null}字段，用于指定是否允许referer为空的请求访问。 白名单设置具体参考如下policy设置进行实现： "Statement":[ {"Sid": "1", "Effect": "Allow", "Principal": {"ID":["*"]}, "Action": "*", "Resource":["bucket/*"], }, {"Sid":"2", "Effect":"Deny", "Principal":{"ID":["*"]}, "Action":["*"], "Resource":["bucket/*"], "Condition":{ "StringNotEquals": {"Referer":["http://www.example01.com","${null}"]} } } ] 如果按照此方式设置，只有referer为"www.example01.com"和referer为空的请求可以对桶bucket中的资源进行操作。 黑名单设置 使用访问黑名单功能可以参考如下policy设置进行实现： "Statement":[ {"Sid":"1", "Effect":"Deny", "Principal":{"ID":["*"]}, "Action":["*"], "Resource":["bucket/*"], "Condition":{ "StringEquals": {"Referer":["http://www.example01.com","http://www.example02.com"]} } } ] 如果按照此方式设置，当referer为"www.example01.com"或"www.example02.com"时，就不能对桶bucket中的资源进行操作。

使用方式 OBS支持通过控制台、API、SDK、OBS Browser+、obsutil方式列举桶。 支持的使用方式 参考文档 控制台 登录控制台并选择“对象存储”，桶列表页将展示账户下所有的桶。 SDK OBS支持多种语言SDK，请从SDK概述页面选择进入对应的开发指南查阅。 API 列举桶 OBS Browser+ 登录OBS Browser+，桶列表页将展示账户下所有的桶。 obsutil 列举桶

使用场景 OBS为您提供了如表1所示的几种统计分析项，帮助您了解如下信息： 表1 用量统计说明 统计类别 统计项 说明 存储 存储总趋势 包含桶中所有对象的存储总量以及桶中的文件总个数趋势。 存储类型趋势 分别统计桶中标准存储、低频访问存储和归档存储三种存储类别的存储容量趋势。不同的存储类别详细介绍请参考存储类别。 存储各类数量趋势 分别统计桶中标准存储、低频访问存储和归档存储三种存储类别的个数趋势。不同的存储类别详细介绍请参考存储类别。 流量 流量趋势 包含公网/内网流入流量和公网/内网流出流量的趋势。 请求 请求趋势 包含请求总数和总请求平均时延趋势。 请求次数 分别统计产生的GET请求、PUT请求和DELETE请求的次数，以及所有请求的次数总和。 请求使用率 分别统计请求的成功率、有效率和中断率。 状态码分布 分别统计产生请求后服务端返回的状态码的分布情况。不同的状态码详细介绍请参考状态码说明。

OBS帮助文档概览 对象存储服务OBS提供了一系列文档，帮助您由浅入深地了解和使用对象存储服务OBS。 建议您在使用对象存储服务OBS前，先阅读本文档和其他相关帮助文档（见表1），了解对象存储服务OBS的基本概念、使用场景、使用方式等，从而帮助您更快速、更轻松地使用对象存储服务OBS。 表1 对象存储服务OBS帮助文档 文档 描述 成长地图 对象存储服务OBS帮助内容的汇聚页面。自上而下提供由浅入深的内容指引，通过了解对象存储服务OBS、快速入门、使用指南、最佳实践、问题处理、解决方案等多个模块，帮助您从全局掌握 对象存储OBS 的帮助信息，让您能轻松、精准地定位到想要查看的内容。 最新动态 对象存储服务OBS功能新增和文档优化的最新动态展示页面，帮助您第一时间了解对象存储服务OBS的最新资讯，新上线功能和文档体验快人一步。 功能总览 对象存储服务OBS功能汇总。您可以清晰地看到OBS支持的功能及功能发布的区域等。 产品介绍 对象存储服务OBS的系统性介绍文档，从服务的常用概念、产品优势、应用场景、计费说明、权限管理等多个方面进行介绍，让您初步了解对象存储服务OBS。 快速入门 对象存储服务OBS的快速使用指导，帮助您快速完成创建桶、上传对象和下载对象的操作。 控制台指南 对象存储服务OBS控制台的详细使用指导，提供了控制台各个功能特性的使用说明，同时提供应用举例帮助您更好地使用对象存储服务OBS控制台。 工具指南 对象存储服务OBS工具（OBS Browser+、obsutil、obsfs）的详细介绍和使用指导，同时提供应用举例帮助您更好地使用对象存储服务OBS工具。 图片处理特性指南 对象存储服务OBS图片处理特性的详细使用指导，从图片处理的基本概念、功能、常见问题等方面，指导您如何通过控制台和API使用图片处理功能。 并行文件系统特性指南 对象存储服务OBS并行文件系统特性的详细使用指导，从并行文件系统的基本概念、应用场景、约束限制、使用方式、计费标准等多个方面进行介绍，帮助您更好的使用并行文件系统。 权限配置指南 对象存储服务OBS权限控制的使用指导。OBS提供多种权限控制方式，包括 IAM 权限、桶策略、对象ACL、桶ACL，您可以选择应用场景选择合适的方式。 最佳实践 对象存储服务OBS在各个典型场景下的应用实践，帮助您在不同的应用场景下以更优的性能、更低的成本、更便捷地操作使用对象存储服务OBS完成您的业务目标。 API参考 对象存储服务OBS提供的REST API的详细说明文档，详细介绍了各个API的请求示例和参数说明、响应示例和参数说明等信息，帮助您顺利使用API完成二次开发。 SDK参考 对象存储服务OBS软件开发工具包（OBS SDK，Object Storage Service Software Development Kit）的详细使用指导，提供Java、Python、C、GO、Android、IOS等多种主流语言的安装、开发、参数、示例和常见问题处理等内容，帮助您顺利使用SDK完成二次开发。 常见问题 对象存储服务OBS使用过程中的常见问题分类汇总，解答您使用对象存储服务OBS过程中的各种疑问。 视频帮助 对象存储服务OBS介绍、购买和使用的帮助视频，以比文字更加生动的方式向您介绍对象存储服务OBS。 父主题： 使用前须知

使用方式 OBS支持通过控制台、API、SDK、OBS Browser+、obsutil方式创建文件夹。 支持的使用方式 参考文档 控制台 新建文件夹 SDK OBS支持多种语言SDK，请从SDK概述页面选择进入对应的开发指南查阅。 说明： 通过SDK创建文件夹，本质上来说是创建了一个大小为0且对象名以“/”结尾的对象。 API - 说明： 通过API创建文件夹，本质上来说是创建了一个大小为0且对象名以“/”结尾的对象。 OBS Browser+ 新建文件夹 obsutil 创建文件夹

使用场景 您可以在已创建的桶中新建一个文件夹，从而更方便的对存储在OBS中的数据进行分类管理。 由于OBS是一种对象存储服务，并没有文件系统中的文件和文件夹概念。为了使用户更方便进行管理数据，OBS提供了一种方式模拟文件夹。实际上在OBS内部是通过在对象的名称中增加“/”，将该对象在OBS管理控制台或者OBS Browser+上模拟成一个文件夹的形式展现。通过API等方式列举对象，获取到的对象名就是以“/”分隔的，最后一个“/”后的内容就是对象名。如果最后一个“/”后没有内容，则表示一个文件夹路径。文件夹的层级结构深度不会影响访问对象的性能。

URI POST /v1/{project_id}/git/repos/{namespace}/{project}/hooks 参数说明见表1。 表1 路径参数 参数 是否必选 类型 描述 project_id 是 String 租户项目ID。获取方法，请参考获取项目ID。 namespace 是 String 命名空间ID或者URL编码名称。获取方法，请参考获取仓库namespaces。 project 是 String 仓库项目ID或者URL编码名称，如果含有“/”，需要将“/”替换为“:”。获取方法，请参考获取命名空间下所有项目。

URI GET /v1/{project_id}/git/repos/{namespace}/{project}/hooks 参数说明见表1。 表1 路径参数 参数 是否必选 类型 描述 project_id 是 String 租户项目ID。获取方法，请参考获取项目ID。 namespace 是 String 命名空间ID或者URL编码名称。获取方法，请参考获取仓库namespaces。 project 是 String 仓库项目ID或者URL编码名称，如果含有“/”，需要将“/”替换为“:”。获取方法，请参考获取命名空间下所有项目。

基本概念 帐号 用户注册云平台时的帐号，帐号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于帐号是付费主体，为了确保帐号安全，建议您不要直接使用帐号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由帐号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看帐号ID和用户ID。通常在调用API的鉴权过程中，您需要用到帐号、用户和密码等信息。 区域（Region） 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 您可以从地区和终端节点中查询服务所在的区域。 可用区（AZ） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 云平台的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您帐号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 查看项目ID，请参考获取项目ID。 图1 项目隔离模型 企业项目 企业项目是项目的升级版，针对企业不同项目间资源的分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理服务用户指南》。 父主题： 使用前必读

URI GET /v1/{project_id}/git/repos/{namespace}/{project}/commits 参数说明见表1。 表1 路径参数 参数 是否必选 类型 描述 project_id 是 String 租户项目ID。获取方法，请参考获取项目ID。 namespace 是 String 命名空间ID或者URL编码名称。获取方法，请参考获取仓库namespaces。 project 是 String 仓库项目ID或者URL编码名称，如果含有“/”，需要将“/”替换为“:”。获取方法，请参考获取命名空间下所有项目。 表2 查询参数 参数 是否必选 类型 描述 ref 否 String 分支名称或者tag名称，如果没有提供，使用默认分支。

请求消息 表3 请求Header参数 参数 是否必选 类型 描述 X-ConsumerId 否 String 微服务消费者唯一标识。 Authorization 是 String 若微服务引擎专享版开启了安全认证，此参数必填。否则，无此参数。 开启了安全认证的微服务引擎专享版Token，格式为： Authorization:Bearer {Token} Token获取方法，请参考获取微服务引擎专享版用户Token。 表4 参数说明 参数 是否必选 类型 描述 services 两个参数至少必须选择一个。 Array of objects 微服务请求结构体，具体参考表5。 instances Array of objects 微服务实例请求结构体，具体参考表6。 表5 FindService参数说明 参数 是否必选 类型 描述 service 是 Object 微服务请求结构体，具体参考DependencyMicroService。 rev 否 String 客户端缓存的版本号，用于判断本地缓存和服务中心微服务的差异。 首次传值0。 若传入的rev值与当前的微服务的rev一致，则返回notModified；若不一致，则返回updated信息。 下次请求若需要传入rev，则该值为当前返回body体中的updated中的rev的值 。 表6 FindInstance参数说明 参数 是否必选 类型 描述 instance 是 Object 微服务实例请求结构体，具体参考HeartbeatSetElement。 rev 否 String 客户端缓存的版本号，用于判断本地缓存和服务中心微服务实例的差异。 首次传值0。 若传入的rev值与当前的微服务实例的rev一致，则返回notModified；若不一致，则返回updated信息。 下次请求若需要传入rev，则该值为当前返回body体中的updated中的rev的值 。

响应示例 { "services": { "updated": [ { "index": 0, "rev": "0feb784798bca7b2fb4de8351578c4437b516c4b", "instances": [ { "instanceId": "79cdaf47cacf43a5b2b4185527da2255", "serviceId": "8aed80ea052ac04a64dfc79c24f2170224d074f5", "endpoints": [ "rest:127.0.0.1:8080" ], "hostName": "hostNameTest", "status": "UP", "properties": { "engineID": "30c263e5-2eac-4da1-9c72-5abb9ac94550", "engineName": "cse-fkln1-HA" }, "healthCheck": { "mode": "push", "interval": 30, "times": 3 }, "timestamp": "1650546183", "modTimestamp": "1650546183", "version": "1.0.0" } ] } ] }}