# 使用OBS实现同账号跨区域桶之间数据复制 #### 使用场景 同账号跨区域复制是指通过创建跨区域复制规则，将某个账号某个区域下的源桶中的数据自动、接近实时地复制到相同账号下的另一个区域下的目标桶中。复制到目标桶的对象是源桶中对象的精确副本。 本节介绍使用OBS控制台、API、obsutil工具实现同账号跨区域桶之间数据复制。 **支持复制的对象范围**：按前缀匹配来复制符合前缀的对象，也可以复制桶中的所有对象，还可以通过设置过滤条件来允许或拒绝符合过滤条件的对象被复制到目标桶中。 **支持复制的对象内容**：对象内容、元数据（对象名称、大小、最后修改时间、创建者、版本号、用户定义的元数据）、ACL、存储类别（默认配置下）。 ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) 在创建跨区域复制规则时，如果配置了"修改复制对象的存储类别"，则复制对象的存储类别与源对象不一致。 图1同账号跨区域复制 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002317075481.png) 同账号跨区域复制主要适用于以下场景： - **合规性要求** OBS默认跨多个地理位置较远的可用区存储数据，但由于合规性要求所规定的数据存储距离可能更远，此时通过跨区域复制，可以在远距离OBS区域之间复制数据以满足合规性要求。 - **最大限度减少延迟** 客户需要在多地访问相同的OBS资源。为了最大限度缩短访问对象时的延迟，您可以使用跨区域复制，在离客户较近的区域中创建对象副本。 - **数据复制** 由于业务原因，您需要将OBS数据从一个区域的数据中心迁移至另一个区域的数据中心。 - **数据备份与容灾** 出于对数据安全性以及可用性的考虑，您希望对所有写入OBS的数据，都在另一个区域的数据中心显式地创建一个备份，以防止在数据发生不可逆损毁时，有安全、可用的备份数据。 - **易维护** 您在两个不同OBS区域中具有分析同一组对象的计算集群，您可以选择在这些区域中维护对象副本。 ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/notice_3.0-zh-cn.png) OBS帮助您将存储于华为云对象存储的业务数据复制到指定Region，但华为云并不感知您的数据的具体内容，也不对您使用本服务的合法合规性负责。如果您的复制涉及跨境传输，请确保您使用本服务符合法律法规的要求。 #### 约束与限制 表1同账号跨区域复制约束与限制 | 限制类别 | 具体限制 | |:---|:---| | 桶版本限制 | 桶版本号为3.0及以上的桶支持跨区域复制功能。 桶版本号可以在OBS管理控制台上，进入桶概览页后，在"基本信息"中查看。详情请参见[查看桶信息](https://support.huaweicloud.com/usermanual-obs/obs_03_0312.html)。 | | 功能限制 | - 源桶中归档存储或深度归档存储类型的对象不支持跨区域复制到目标桶。 - 如果目标桶所属区域不支持存储类别，则复制后对象的存储类别均为标准存储类别。 - OBS目前仅支持一个源桶同时复制到一个目标桶，不支持一个源桶同时复制到多个目标桶。允许修改目标桶，但修改目标桶会更改所有已创建规则的目标桶。 - 跨区域复制不支持追加写对象（[Appendable类型](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829661.html#section3)的对象）复制。 - 同一个源桶只能创建一条复制所有对象的跨区域复制规则，或多条（最多100条）按前缀匹配的跨区域复制规则。 - 不支持跨区域复制SSE-C加密的对象。 | | 时间限制 | 跨区域复制不保证时效性，配置跨区域复制规则后，可能会出现对象不会立即进行复制的情况，请耐心等待。 | | 区域限制 | - 源桶和目标桶必须属于不同的区域。 - OBS跨区域复制支持的区域情况如[图2 跨区域复制支持区域]所示。√表示两个区域可连通，x表示两个区域不可连通。 | | 同步历史对象相关 | - 启用跨区域复制功能之前上传的对象，默认不会被复制到目标桶，除非开启了"同步历史对象"功能。 - 启用历史对象复制后，修改跨区域复制配置可能导致历史对象不复制，建议在历史对象复制完成前不要改变该桶的跨区域复制配置。 - 源桶中对象复制到目标桶后，如果目标桶中对象被删除，3天内重新配置源桶到目标桶的启用历史对象复制的复制规则，在目标桶中被删除的对象的相同版本不会再次被从源桶复制到目标桶。 例如：您先配置跨区域复制规则1，将源桶中的当前版本对象test.txt复制到了目标桶，又从目标桶中删除了该对象test.txt，同时删除了跨区域复制规则1。2天后又配置了启用历史对象复制的跨区域复制规则2，此时对象test.txt不会再被复制到目标桶中。 | | 多版本控制相关 | - **源桶和目标桶的多版本控制状态必须保持一致，即同时开启或关闭多版本控制**。配置了跨区域复制后，如果修改了多版本状态，会导致源桶和目标桶多版本状态不一致期间的操作无法被复制；且多版本控制一旦开启只能暂停而无法关闭，因此在使用replication规则时请谨慎修改多版本状态。 - 当源桶、目标桶多版本控制处于开启或暂停状态，且跨区域复制规则处于开启状态时，在源桶中不指定版本删除对象，目标桶会同步删除此对象。 - 在启用跨区域复制过程中，如果您修改目标桶的多版本控制状态，会导致对象复制失败；如果您尝试修改源桶多版本控制状态，必须先删除复制配置，然后才能进行修改。 | | 权限相关 | - 需要保证桶拥有者具有源桶和目标桶的读写权限，以确保数据能够成功复制。如果源桶或目标桶的读写权限错误，导致系统没有读源对象或者写目标对象的权限，这种对象将一直复制不成功，即使将权限修改正确后，也不会重新复制。 - 不建议您对目标桶中的副本对象进行删除、覆盖或者修改ACL操作，此类操作可能导致目标桶中对象最新版本或者对象访问控制权限与源桶不一致。 | | 其他约束与限制 | - 源桶中的对象只能被复制到一个目标桶中，且复制过去的对象不能再被复制到另外一个目标桶。例如有两个不同区域的桶A和桶B，桶A数据可以复制到桶B中，桶B数据也可以复制到桶A中，但桶B中存储的桶A数据的副本不会复制，同理桶A中存储的桶B数据的副本也不会复制。 - 如果目标桶禁止配置公开ACL（开启了阻止公共访问功能中的BlockPublicAcls开关），那么源桶中配置了ACL公开语义的对象，会因为和目标桶的访问策略冲突而导致复制失败。 | 图2跨区域复制支持区域 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002442204745.png "点击放大") #### 多条跨区域复制规则之间重叠 **在源桶创建多条跨区域复制规则时，如果目标桶选择同一个桶且新创建规则与已有规则的筛选条件存在重叠，则新规则将无法创建成功。** 满足以下任一条件时，认为规则间存在重叠关系： - 如果规则A的筛选条件为所有对象（"复制对象"参数选择"所有对象"），则该规则与其他所有规则重叠。 - 如果规则A的筛选前缀（"复制对象"参数选择"按前缀匹配"）与规则B相同，则规则A和规则B存在重叠。 - 如果规则A的筛选前缀（"复制对象"参数选择"按前缀匹配"）与规则B的筛选前缀之间存在包含关系，则规则A和规则B存在重叠。 - 规则A的筛选条件为按过滤条件匹配指定对象（"复制对象"参数选择"按过滤条件匹配"），默认先匹配到所有对象，然后再根据过滤条件去筛选指定对象进行复制，因此如果规则B的筛选条件为所有对象或按前缀匹配，则规则A和规则B存在重叠。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002510407964.png) #### 注意事项 - 创建桶后，建议您5分钟后再创建跨区域复制规则，否则可能会出现创建跨区域复制规则失败的现象。 - 启用跨区域复制规则且未开启"同步历史对象"时，规则的生效时间约有5分钟的延迟，在此期间上传的对象可能不会被复制。 - 启用跨区域复制规则且开启了"同步历史对象"时，将在5分钟后开始复制历史对象。 - 支持对经过[服务端加密](https://support.huaweicloud.com/usermanual-obs/obs_03_0088.html#ZH-CN_TOPIC_0000002417464641)（包括SSE-KMS、SSE-OBS加密方式）的对象进行复制，复制产生的流量费用SSE-KMS和SSE-OBS按照明文长度计算，详情参见[同账号跨区域复制费用说明]。 #### 同账号跨区域复制费用说明 如果您将某一个桶中的数据通过配置跨区域复制规则复制到不同区域的另外一个桶中，整个过程产生的费用示意图如[图3]所示。可能产生如下费用： 图3跨区域复制数据费用示意图 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001618504009.png "点击放大") 表2跨区域复制数据说明 | 操作名称 | 产生费用类别 | 费用说明 | 付费方式 | |:---|:---|:---|:---| | 跨区域复制数据 | 请求费用 | 按复制成功的对象数计算请求次数，产生请求费用。复制对象过程中调用的请求，请参考[复制对象说明](https://support.huaweicloud.com/usermanual-obs/obs_41_0020.html)。 - 对于非多段对象，成功复制一个对象，会产生源桶的一个GET请求和目标桶的一个PUT请求；在源桶删除一个对象，会产生目标桶的一个DELETE请求。 - 多段对象的每个分段，均会产生源端的GET请求和目标端的PUT请求。 - 已通过跨区域复制功能复制到目标桶的对象，如果修改了源对象的ACL，则跨区域复制功能会同步复制源对象的ACL到目标对象，该操作会产生源端的PUT请求费用。 说明： 由于是源端发起的复制对象ACL的行为，所以产生的PUT请求费用在源端计算。 如何计算请求费用等详细说明，请参见[请求费用说明](https://support.huaweicloud.com/price-obs/obs_42_0004.html)。 | 按需计费 | | 跨区域复制数据 | 流量费用 | 使用跨区域复制功能将源桶数据复制到另一个区域的目标桶时所产生的跨区域复制流量，只收取**数据流出源桶** 的**单向**流量费用。 如果对象经过了[服务端加密](https://support.huaweicloud.com/usermanual-obs/obs_03_0088.html)，计算跨区域复制流量费用时，SSE-KMS和SSE-OBS按照明文长度计算。 说明： 跨账号跨区域复制暂不支持复制SSE-KMS的加密对象 | 按需计费 资源包（跨区域复制流量包） | | 跨区域复制数据 | 存储费用 | 跨区域复制目标桶的存储费用，即除了为源桶数据支付存储费用，由于目标桶经过复制后也会存储数据，您还需支付目标桶数据的存储费用。 如果您修改了复制对象的存储类别，复制到目标桶的数据按新的存储类型计算存储费用。 如果对象经过了[服务端加密](https://support.huaweicloud.com/usermanual-obs/obs_03_0088.html)，计算存储费用时，按照密文长度计算。 | 按需计费 资源包（各存储类别对应的存储包） | | 同步历史对象 | 请求费用 | 启用同步历史对象功能，系统会将创建跨区域复制规则前已经存在于桶中的对象同步复制到目标桶。 请求费用按系统自动同步时复制成功的对象数计算请求次数，产生请求费用，且对于历史对象的列举，产生相应的列举费用。 | 按需计费 | | 同步历史对象 | 流量费用 | 系统跨区域同步对象时，所产生的跨区域复制流量，只收取数据流出源桶的单向流量费用。 如果历史对象经过了[服务端加密](https://support.huaweicloud.com/usermanual-obs/obs_03_0088.html)，计算跨区域复制流量费用时，SSE-KMS和SSE-OBS按照明文长度计算。 | 按需计费 资源包（跨区域复制流量包） | | 同步历史对象 | 存储费用 | 跨区域复制目标桶的存储费用，即除了为源桶数据支付存储费用，由于目标桶经过复制后也会存储数据，您还需支付目标桶数据的存储费用。 如果您修改了复制对象的存储类别，复制到目标桶的数据按新的存储类型计算存储费用。 如果历史对象经过了[服务端加密](https://support.huaweicloud.com/usermanual-obs/obs_03_0088.html)，计算存储费用时，按照密文长度计算。 | 按需计费 资源包（各存储类别对应的存储包） | #### 前提条件 - 已在某个账号某个区域下创建源桶，源桶的版本号为3.0及以上，并且源桶所在区域支持跨区域复制功能。 - 已在相同账号的另一个区域下创建目标桶。创建桶操作请参见[创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.html#ZH-CN_TOPIC_0000001952642149)。 #### 创建同账号跨区域复制规则 OBS支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)、API、SDK、obsutil方式配置同账号跨区域复制，不支持通过、OBS Browser+方式配置同账号跨区域复制。 #### OBS控制台 1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。 2. 在桶列表中，单击待操作的桶，进入"对象"页面。 3. 在左侧导航栏，单击"数据管理 \> 跨区域复制"。 4. 勾选"我已了解并同意"，然后单击"创建规则"，系统将弹出"创建跨区域复制规则"对话框，如[图4]所示。 图4创建跨区域复制规则 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002396339474.png "点击放大") ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) - 源桶和目标桶的多版本控制状态必须保持一致。 - 一个源桶的跨区域复制只能有一个目标桶和IAM委托，后面创建的规则中的目标桶和IAM委托会覆盖已创建规则的目标桶和委托。 5. 根据业务规划配置跨区域复制规则，参数的详细说明如[表3]所示。 表3跨区域复制规则参数 | 参数 || 说明 | |:---|---|:---| | 状态 || 选择启用或者禁用当前规则。源桶和目标桶的多版本控制状态必须保持一致。 | | 源桶 | 复制对象 | 在源桶中选择要复制的对象。 - 所有对象：将源桶中的所有对象复制到目标桶中。 - 按前缀匹配：将源桶中匹配该前缀的对象复制到目标桶中。 - 按过滤条件匹配：允许或拒绝源桶中符合过滤条件的对象被复制到目标桶中。 | | 源桶 | 前缀 | 当"复制对象"选择"按前缀匹配"时，需要配置前缀，表示源桶中匹配该前缀的对象会被复制到目标桶中。 - 输入的对象名前缀不能为空，长度限制为1024个字符。 - 如果指定的前缀名与某条已配置的规则指定的前缀名存在包含关系，OBS会将两条规则视为同一条，而禁止您配置本条规则。例如，系统中已存在指定前缀名为"abc"的规则，则不允许再配置指定前缀以"abc"字段开头的规则。 - 如果要复制文件夹，对象名前缀需要使用"/"作为最后一个字符。例如：folder1/。 | | 源桶 | 过滤效力 | 当"复制对象"选择"按过滤条件匹配"时，需要配置该参数，表示允许或拒绝源桶中符合过滤条件的对象被复制到目标桶中。 - 允许复制：源桶中符合过滤条件的对象将被复制到目标桶中。 - 拒绝复制：源桶中符合过滤条件的对象将不被复制到目标桶中。 | | 源桶 | 标签 | 当"复制对象"选择"按过滤条件匹配"时，需要配置该参数。 使用对象标签作为过滤条件，表示允许或拒绝源桶中带有指定标签的对象复制到目标桶中。 - 当"过滤效力"选择"允许复制"时，最多可以配置10个标签。配置多个标签作为过滤条件，表示同时满足所有标签的对象才会被复制到目标桶中。 - 当"过滤效力"选择"拒绝复制"时，仅支持配置1个标签。 | | 源桶 | 同步历史对象 | 选择是否将创建本规则前已经存在于源桶中的对象同步复制到目标桶。 默认不同步。 | | 源桶 | 同步删除操作 | 选择同步后源桶的对象删除操作会同步到目标桶， 并且不可恢复，为确保您的数据有效性，不推荐此配置，建议您选择不同步。 | | 目标桶 | 桶归属 | 选择目标桶为和源桶同账号下的桶或跨账号下的桶。**此处选择"在当前账号中选择一个桶"。** - 在当前账号中选择一个桶：表示目标桶和源桶属于同一账号，为同账号跨区域桶之间进行数据复制。 - 在另一个账号中指定一个桶：表示目标桶和源桶不属于同一账号，或源桶中存在非源桶拥有者**上传的数据**，为跨账号跨区域桶之间进行数据复制。 | | 目标桶 | 区域 | 选择目标桶所在区域。当桶归属选择"在当前账号中选择一个桶"时，需要配置该参数。 目标桶与源桶属于同一账号，但处于不同区域。 | | 目标桶 | 桶 | 选择目标桶。当桶归属选择"在当前账号中选择一个桶"时，需要配置该参数。 说明： 如果是新创建的桶，在创建成功后您可能需要等待几分钟才能在目标桶的下拉列表中看到该桶。 | | 目标桶 | 修改复制对象的存储类别 | 修改从源桶复制到目标桶的对象的存储类别。 - 默认不勾选，即复制到目标桶的对象和源桶对象的存储类别一致。 - 勾选后，可以配置复制到目标桶的对象的存储类别。 | | 权限 | 复制使用KMS加密的对象 | 复制源桶中使用KMS加密的对象到目标桶。无论是否勾选，OBS均会尝试复制KMS加密对象。 - 如果勾选该项，下方的IAM委托仅会展示全局项目下配置了任意权限，并且源桶和目标桶所在区域均配置了KMS CMKFullAccess的OBS云服务委托。 - 如果不勾选该项，下方的IAM委托仅会展示全局项目下配置了任意权限，且源桶或目标桶所在区域不包含KMS CMKFullAccess权限的OBS云服务委托。 如果目标区域没有启用KMS服务或者委托中没有赋予源桶和目标桶所在区域" KMS CMKFullAccess"权限，则源桶中KMS加密对象会复制失败，导致对象复制状态为FAILED。 源桶中以任意KMS密钥加密的对象，复制到目标桶后都会以目标桶所在区域的默认密钥"obs/default"进行加密。 | | 权限 | IAM委托 | 将您资源的操作权限委托给OBS，OBS使用此委托执行对象的跨区域复制。 第一次使用时，您需要单击"创建委托"去创建一个新的委托用于跨区域复制。如果已经创建，可以从下拉列表中选择。 所创建或选择的IAM委托要求如下： - 此IAM委托必须为"对象存储服务 OBS"的云服务委托，委托需要具有[表4]中的OBS权限。 - 如果勾选了"复制使用KMS加密的对象"，委托还需要具有"KMS CMKFullAccess"权限，委托的授权范围选择"指定区域项目资源"并选择源桶和目标桶所在区域。 | 表4委托需要的OBS权限 | 操作 | 描述 | |:---|:---| | obs:object:GetObject | 获取对象内容、获取对象元数据。 | | obs:object:DeleteObjectVersion | 删除对象、批量删除对象。 | | obs:object:PutObjectVersionAcl | 设置对象ACL。 | | obs:object:AbortMultipartUpload | 取消多段上传任务。 | | obs:object:PutObjectAcl | 设置对象ACL。 | | obs:object:DeleteObject | 删除对象、批量删除对象。 | | obs:bucket:HeadBucket | 获取桶元数据。 | | obs:object:PutObject | PUT上传、POST上传、复制对象、追加写对象、初始化上传段任务、上传段、合并段 | | obs:object:GetObjectVersionAcl | 获取对象ACL。 | | obs:bucket:GetBucketVersioning | 获取桶的多版本状态。 | | obs:bucket:ListBucketMultipartUploads | 列举多段上传任务。 | | obs:object:ListMultipartUploadParts | 列举已上传的段。 | | obs:object:ModifyObjectMetaData | 修改对象元数据。 | | obs:bucket:ListBucketVersions | 列举桶内多版本对象。 | | obs:bucket:ListBucket | 列举桶内对象。 | | obs:object:GetObjectVersion | 获取对象内容、获取对象元数据。 | | obs:object:GetObjectAcl | 获取对象ACL。 | | obs:bucket:GetReplicationConfiguration | 获取桶的跨区域复制配置。 | 6. （可选）创建IAM委托，请参见[创建用于跨区域复制的委托]。 7. 单击"确定"，完成跨区域复制规则创建。 #### 使用OBS API [设置桶的跨区域复制配置](https://support.huaweicloud.com/api-obs/obs_04_0046.html) #### 使用OBS命令行工具obsutil 使用obsutil进行同账号跨区域复制对象，需要开启跨区域复制模式，即"crr"参数必选。 ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/notice_3.0-zh-cn.png) - 复制对象或批量复制时，请确保OBS桶中的源对象不发生变化，否则可能产生复制失败或者数据不一致的问题。 - 如果被复制对象的存储类型为cold，必须首先恢复被复制对象，否则无法复制成功。 - 复制时需要有被复制对象的读权限和目标桶的写权限。 - 如果没有开启客户端跨区域复制模式，复制的源桶和目标桶必须在同一个区域（Region）。 - 如果源桶是并行文件系统（POSIX），则目标桶必须是并行文件系统。 **约束与限制：** - 复制的源路径和目标路径不能完全相同。 - 批量复制时，源路径和目标路径不能相互嵌套： - 目标路径以源路径为前缀时，可能会产生递归复制。 - 源路径以目标路径为前缀时，可能会产生覆盖拷贝。 **命令结构**： - Windows操作系统 - 复制单个对象 ``` obsutil cp obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-crr] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] ``` - 批量复制对象 ``` obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-crr] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] ``` - macOS/Linux操作系统 - 复制单个对象 ``` ./obsutil cp obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-crr] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] ``` - 批量复制对象 ``` ./obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-crr] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] ``` **运行示例**： - 以Windows操作系统为例，运行**obsutil cp obs://bucket-test/key obs://bucket-test2** ，复制单个对象。 ``` obsutil cp obs://bucket-test/key obs://bucket-test2 Start at 2024-09-30 08:30:09.0815415 +0000 UTC Parallel: 3 Jobs: 3 Threshold: 50.00MB PartSize: auto CheckpointDir: xxxx [=====================================================] 100.00% 6/s 0s Waiting for the copied key to be completed on server side. Copy successfully, 19B, obs://bucket-test/key --> obs://bucket-test2/key ext.txt, cost [1708], status [200], request id [00000192420D227E4017336A12F1DC22] ``` - 以Windows操作系统为例，运行**obsutil cp obs://bucket-test/temp/ obs://bucket-test2 -f -r** ，批量复制对象。 ``` obsutil cp obs://bucket-test/temp/ obs://bucket-test2 -r -f Start at 2024-09-30 08:34:02.7819703 +0000 UTC Parallel: 5 Jobs: 5 Threshold: 50.00MB PartSize: auto CheckpointDir: xxxx Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5 OutputDir: xxxx [=============================================================] 100.00% 10/s 0s Succeed count: 5 Failed count: 0 Metrics [max cost:298 ms, min cost:192 ms, average cost:238.00 ms, average tps:9.71, transferred size: 7.20MB] Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5 ``` - 更多运行示例，请参见[常见示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0027.html)。 **参数说明**： | **参数** | **约束** | **描述** | |:---|:---|:---| | srcbucket | 必选 | 源桶名。 | | dstbucket | 必选 | 目标桶名。 | | dest | 可选 | 复制对象时的目标对象名，或批量复制时目标对象名前缀。 | | key | 复制对象时必选 批量复制时可选 | 复制对象时的源对象名，或批量复制时源对象名前缀。 规则如下： - 复制对象时，该值不能为空。 - 如果"dest"为空，则将源对象复制到目标桶的根目录。 - 如果"dest"以"/"结尾，则目标对象名为dest+源对象名；否则，目标对象名为"dest"的值。 - 批量复制时，如果该值为空，则表示复制源桶中的所有对象；否则，复制源桶中以该值为对象名前缀的所有对象。目标对象名的确认规则为： - 如果"dest"以"/"结尾，目标对象名为dest+源对象名。 - 如果"dest"不以"/"结尾，目标对象名为dest+/+源对象名。 - 批量复制且该值不为空时，如果未设置"flat"参数，则复制时源对象名会包含上一级父对象名前缀；如果设置了"flat"参数，则复制时源对象名不包含上一级父对象名前缀。 说明： 请参考[复制示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0030.html)理解该参数的使用方式。 | | fr | 附加参数，复制对象时可选 | 复制对象时生成结果清单文件。 | | flat | 附加参数，批量复制时可选 | 批量复制时，不包含上一级父对象名前缀。 | | dryRun | 附加参数，可选 | 测试模式运行，不执行实际的复制操作。 | | crr | 同账号跨区域复制，该参数必选。 | 复制时使用客户端跨区域复制模式，以通过数据流的方式从源桶直接复制数据到目标桶，且两个桶可以是任意两个OBS服务的桶。 - 如果设置了该参数，必须确保更新了配置文件中客户端跨区域复制的相关配置信息，具体可参考[更新配置文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0023.html)。 - 开启跨区域复制后，因为会占用执行命令主机上传和下载的双向带宽、CPU和内存等资源，可能会影响执行命令主机的性能。 说明： 复制时源桶对应的配置信息为配置文件中的"akCrr/skCrr/tokenCrr/endpointCrr"，目标桶对应的配置信息为配置文件中的"ak/sk/token/endpoint"。 | | vlength | 附加参数，可选 | 复制完成后，验证目标桶对象大小是否与源桶中对象的大小一致。 **该参数必须与"crr"参数配合使用。** | | vmd5 | 附加参数，可选 | 复制完成后，验证目标桶的MD5值是否与源桶中对象的MD5值一致。 - **该参数必须与"crr"参数配合使用。** - **源桶中对象必须包含元数据x-obs-meta-md5chksum，否则会忽略MD5值校验。**MD5值校验通过后，会将该值设置为目标对象元数据x-obs-meta-md5chksum，用于下载或复制时校验MD5。 - **如果您的业务涉及加密场景，请勿使用该参数。** | | u | 附加参数，可选 | 增量复制操作，设置该参数后，复制每个源对象时会对比目标桶中对应路径的目标对象，仅在目标对象不存在，或者目标对象大小与源对象大小不一致，或者目标对象的最后修改时间早于源对象的最后修改时间时进行复制。 | | p | 附加参数，可选 | 每个分段复制任务的最大并发数，默认为配置文件中的defaultParallels。 | | threshold | 附加参数，可选 | 开启分段复制任务的阈值。如果待复制的源对象小于该阈值，则使用直接复制模式；否则使用分段复制模式。 默认为配置文件中的defaultBigfileThreshold。 单位：字节 支持带容量单位配置，例如：配置1MB代表1048576字节。 说明： 直接复制模式不会产生断点记录文件，不支持断点续传。 | | versionId | 附加参数，复制对象时可选 | 复制单个对象时可指定的源对象版本号。 | | acl | 附加参数，可选 | 复制对象时可指定的目标对象的预定义访问策略。 支持的值： - private：私有读写，除对象ACL授权外的其他用户无对象的访问权限。 - public-read：公共读，任何用户都可以对桶内对象进行读操作。 - public-read-write：公共读写，任何用户都可以对桶内对象进行读/写/删除操作。 - bucket-owner-full-control：桶拥有者完全控制，其他任何人都没有访问权限。 | | sc | 附加参数，可选 | 复制对象时可指定的目标对象的存储类型。 支持的值： - standard：标准存储，访问时延低、吞吐量高，适用于有大量热点文件（平均一个月多次）或小文件（小于1MB）。 - warm：低频访问存储，可用性略低于standard，适用于不频繁访问（平均一年少于12次）但在需要时也要求快速访问数据的业务场景。 - cold：归档存储，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。 - deep-archive：深度归档存储，适用于长期不访问（平均几年访问一次）数据的业务场景，其成本相比归档存储更低，但相应的数据恢复时间将更长，一般为数小时。 | | meta | 附加参数，可选 | 复制对象时可指定的标准和自定义元数据。 - 标准元数据包括：Content-Type、Content-Encoding、Cache-Control、Content-Disposition、Content-Language、Expires。 - 自定义元数据格式为：key:value，多个自定义元数据使用#链接。例如key1:value1#key2:value2#key3:value3，其含义是，复制文件后，桶内目标对象包含三组自定义元数据，分别为：key1:value1、key2:value2、key3:value3。 | | fs | 附加参数，可选 | 是否使用并行文件系统的列举方式，如果桶是并行文件系统，推荐加上该参数。 - 该参数开启后，会忽略marker和limit值，统计桶或者并行文件系统或者指定目录的大小。 - Util 5.5.12版本及以上支持该参数。 - 该列举方式会因为目录结构，耗时差别很大。 | | ps | 附加参数，可选 | 每个分段复制任务的段大小。 - 默认为配置文件中的defaultPartSize，支持配置为auto，此时obsutil会根据源文件大小自动设置每个分段任务的段大小。 - 取值范围：100KB\~5GB - 单位：字节。支持带容量单位配置，例如，配置1MB代表1048576字节。 | | cpd | 附加参数，可选 | 生成断点记录文件的文件夹，默认为运行obsutil命令的用户目录的子文件夹.obsutil_checkpoint。 每个分段复制任务会产生唯一对应的断点记录文件并保存至该文件夹的upload子文件夹下。分段任务执行成功后，对应的断点记录文件会被自动删除；分段任务执行失败或被中断后，下次执行该分段任务时会尝试通过对应的断点记录文件恢复任务。 | | r | 附加参数，批量复制时必选 | 按指定源桶的对象名前缀批量复制对象。 | | f | 附加参数，批量复制时可选 | 强制操作，不进行询问提示。 | | j | 附加参数，批量复制时可选 | 批量复制时的最大并发数，默认为配置文件中的defaultJobs。 说明： 工具会保证该值至少为1。 | | exclude | 附加参数，批量复制时可选 | 不包含源对象的匹配模式，设置该参数后，如果待复制的对象名匹配该参数，则跳过该对象的复制。如：\*.txt，代表所有后缀为.txt的文件自动跳过，不复制。 - "\*"匹配多个任意字符，如："abc\*.txt"表示匹配所有以"abc"开头，中间可以包含任意数量的任意字符，以".txt"结尾的文件名。 - "?"匹配单个任意字符，如："abc?.txt"表示匹配所有以"abc"开头，中间包含1个任意字符，以".txt"结尾的文件名。 - 您可以使用"\\\*"代表匹配"\*"字符本身，使用"\\?"代表匹配"?"字符本身。 - 支持指定多个exclude参数，如 -exclude=\*.xxx -exclude=\*.xxx **约束限制：** 该匹配模式仅适用于对象名非"/"结尾的对象。 说明： - 建议使用引号传递该匹配模式（Linux/Mac操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。 - 该匹配模式作用于对象全路径（含从根路径开始的对象前缀和对象名，例如，桶内对象路径为obs://bucket/src1/src2/test.txt，则对象的全路径为src1/src2/test.txt）。 | | include | 附加参数，批量复制时可选 | 包含源对象的匹配模式，设置该参数后，如果待复制的对象名匹配该参数，则复制该对象。如：\*.txt，代表所有后缀为.txt的对象将会被复制。 - "\*"匹配多个任意字符，如："abc\*.txt"表示匹配所有以"abc"开头，中间可以包含任意数量的任意字符，以".txt"结尾的文件名。 - "?"匹配单个任意字符，如："abc?.txt"表示匹配所有以"abc"开头，中间包含1个任意字符，以".txt"结尾的文件名。 - 您可以使用"\\\*"代表匹配"\*"字符本身，使用"\\?"代表匹配"?"字符本身。 - 支持指定多个include参数，如 -include=\*.xxx -include=\*.xxx **约束限制：** - 该匹配模式仅适用于对象名非"/"结尾的对象。 - 如果同时配置了exclude和include参数，则首先执行exclude的匹配规则，如果待复制的对象名不匹配exclude参数，则判断待复制的对象名是否匹配include参数，如果匹配则复制该对象，否则跳过该对象的复制。 **示例：** ``` ./obsutil cp obs://src-bucket/ obs://target-bucket/ -include=/src-object/* -f -r ``` 以上命令的含义是：复制src-bucket桶下符合匹配规则的文件到target-bucket桶下，匹配规则是以"src-object/"开头的对象名称。 说明： - 建议使用引号传递该匹配模式（Linux/Mac操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。 - 该匹配模式作用于对象全路径（含从根路径开始的对象前缀和对象名，例如，桶内对象路径为obs://bucket/src1/src2/test.txt，则对象的全路径为src1/src2/test.txt）。 | | timeRange | 附加参数，批量复制时可选 | 复制对象时的时间段匹配模式，仅复制最后修改时间在该时间段内的对象。 该匹配模式优先级低于文件名匹配模式：exclude和include，即优先执行exclude和include参数匹配，然后执行该匹配模式。 - 该匹配模式表示的时间是UTC时间。 - 使用"time1-time2"，代表匹配的时间段，其中time1必须小于等于time2，格式为yyyyMMddHHmmss。 - 时间格式支持自动补全，例如：yyyyMMdd等价于yyyyMMdd000000，yyyyMM等价于yyyyMM01000000。 - 使用"\*-time2"，代表匹配最后修改时间在time2之前的所有文件，使用"time1-\*"，代表匹配最后修改时间time1之后的所有文件。 **该匹配模式仅适用于对象名非"/"结尾的对象。** | | mf | 附加参数，可选 | 设置名称匹配模式（include、exclude）和时间匹配模式（timeRange）对对象名以"/"结尾的对象也生效。 | | o | 附加参数，可选 | 生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果、失败结果、警告结果三个文件）。 默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。 - 结果清单文件命名规则：cp_{succeed \| failed \| warning}_report_时间_TaskId.txt。 - 单个结果清单文件默认情况下最大为30MB，可在配置文件中通过recordMaxLogSize分别配置。 - 单个结果清单文件默认情况下最多可保留1024个文件，可在配置文件中通过recordBackups分别配置。 - 当涉及多文件/文件夹时，如需确认失败任务的具体错误信息，可参考结果清单文件夹下的失败结果清单文件"cp_failed_report_时间_TaskId.txt"和日志路径下的[日志文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0056.html)。 | | config | 附加参数，可选 | 运行当前命令时的自定义配置文件。 可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。 | | e | 附加参数，可选 | 指定终端节点。 | | i | 附加参数，可选 | 指定用户的AK。 | | k | 附加参数，可选 | 指定用户的SK。 | | t | 附加参数，可选 | 指定用户的securitytoken。 | **响应结果：** | **字段名** | **描述** | |:---|:---| | Parallel | 请求中的-p参数。 | | Jobs | 请求中的-j参数。 | | Threshold | 请求中的-threshold参数。 | | PartSize | 请求中的-ps参数。 | | Exclude | 请求中的-exclude参数。 | | Include | 请求中的-include参数。 | | TimeRange | 请求中的-timeRange参数。 | | VerifyLength | 请求中的-vlength参数。 | | VerifyMd5 | 请求中的-vmd5参数。 | | CheckpointDir | 请求中的-cpd参数。 | | OutputDir | 请求中的-o参数。 | | ArcDir | 请求中的-arcDir参数。 | | Succeed count | 成功的任务数。 | | Failed count | 失败的任务数。 | | Skip count | 增量上传/下载/复制、同步上传/下载/复制跳过的任务数。 说明： 跳过的任务数也会记录到成功的任务数中。 | | Warning count | 执行完成但包含警告的任务数。 说明： - 产生警告的任务可能是失败的也可能是成功的，需要根据成功或失败的结果清单进一步判断。 - 产生警告的任务数与成功/失败任务数是相互独立的，总任务数仍是成功的任务数+失败的任务数。 | | Succeed bytes | 成功上传的字节数。 | | max cost | 所有任务中的最长耗时，单位：毫秒。 | | min cost | 所有任务中的最短耗时，单位：毫秒。 | | average cost | 平均耗时，单位：毫秒。 | | average tps | 平均每秒的任务完成个数。 | | Task id | 每次运行的唯一标识号，用于查找批量任务生成的结果清单文件。 | #### 修改、禁用、启用或删除跨区域复制规则 OBS支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)、API方式管理跨区域复制规则，不支持通过SDK、OBS Browser+、obsutil方式管理跨区域复制规则。 #### 使用OBS控制台 1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。 2. 在桶列表中，单击待操作的桶，进入"对象"页面。 3. 在左侧导航栏，单击"数据管理 \> 跨区域复制"，进入跨区域复制页面。 4. （可选）编辑跨区域复制规则。 1. 单击待修改规则操作列的"编辑"，系统将弹出"编辑跨区域复制规则"对话框。 图5编辑跨区域复制规则 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002318419529.png "点击放大") 2. 修改跨区域复制规则，支持修改的内容如下所示。 表5支持修改的跨区域复制规则参数 | 参数名称 || 说明 | |:---|---|:---| | 状态 || 跨区域复制规则的状态。可以选择启用或禁用跨区域复制规则。 | | 源桶 | 复制对象 | 在源桶中选择要复制的对象。 - 所有对象：将源桶中的所有对象复制到目标桶中。 - 按前缀匹配：将源桶中匹配该前缀的对象复制到目标桶中。 - 按过滤条件匹配：允许或拒绝源桶中符合过滤条件的对象被复制到目标桶中。 | | 源桶 | 前缀 | 当"复制对象"选择"按前缀匹配"时，需要配置前缀，表示源桶中匹配该前缀的对象会被复制到目标桶中。 - 输入的对象名前缀不能为空，长度限制为1024个字符。 - 如果指定的前缀名与某条已配置的规则指定的前缀名存在包含关系，OBS会将两条规则视为同一条，而禁止您配置本条规则。例如，系统中已存在指定前缀名为"abc"的规则，则不允许再配置指定前缀以"abc"字段开头的规则。 - 如果要复制文件夹，对象名前缀需要使用"/"作为最后一个字符。例如：folder1/。 | | 源桶 | 过滤效力 | 当"复制对象"选择"按过滤条件匹配"时，需要配置该参数，表示允许或拒绝源桶中符合过滤条件的对象被复制到目标桶中。 - 允许复制：源桶中符合过滤条件的对象将被复制到目标桶中。 - 拒绝复制：源桶中符合过滤条件的对象将不被复制到目标桶中。 | | 源桶 | 标签 | 当"复制对象"选择"按过滤条件匹配"时，需要配置该参数。 使用对象标签作为过滤条件，表示允许或拒绝源桶中带有指定标签的对象复制到目标桶中。 - 当"过滤效力"选择"允许复制"时，最多可以配置10个标签。配置多个标签作为过滤条件，表示同时满足所有标签的对象才会被复制到目标桶中。 - 当"过滤效力"选择"拒绝复制"时，仅支持配置1个标签。 | | 源桶 | 同步历史对象 | 选择是否将创建本规则前已经存在于源桶中的对象同步复制到目标桶。 默认不同步。 | | 源桶 | 同步删除操作 | 选择同步后源桶的对象删除操作会同步到目标桶， 并且不可恢复，为确保您的数据有效性，不推荐此配置，建议您选择不同步。 | | 目标桶 | 桶归属 | 选择目标桶为和源桶同账号下的桶或跨账号下的桶。 - 在当前账号中选择一个桶：表示目标桶和源桶属于同一账号，为同账号跨区域桶之间进行数据复制。 - 在另一个账号中指定一个桶：表示目标桶和源桶不属于同一账号，或源桶中存在非源桶拥有者**上传的数据** ，为跨账号跨区域桶之间进行数据复制。 在配置跨账号跨区域复制规则前，需要先进行如下操作： - 必须先在目标桶中配置桶策略，授予源桶拥有者除"DeleteBucket"、"PutBucketPolicy"和"PutBucketAcl"外的所有权限，才能将源桶中的对象复制到目标桶中。相关权限配置，请参见[自定义创建桶策略（可视化视图）](https://support.huaweicloud.com/usermanual-obs/obs_03_0123.html#ZH-CN_TOPIC_0000001904425337)。 - 如果源桶中有非源桶拥有者上传的对象时，必须先在源桶配置桶ACL，给源桶的拥有者授予**"FULL_CONTROL"** 权限，同时设置**对象读权限** （对应API中"Delivered"设为"true"），才能将源桶中其他账号的对象复制到目标桶中。可通过编辑源桶拥有者的ACL实现。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002724881964.png "点击放大") - 如果在复制源对象内容到目标桶的同时，还需要复制源对象的ACL到目标桶，则必须先在目标桶中设置桶ACL，给源桶拥有者授予**"FULL_CONTROL"** 权限，同时设置**对象读权限** （对应API中"Delivered"设为"true"）。 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002754441777.png) 关于配置桶ACL，请参见[配置桶ACL](https://support.huaweicloud.com/usermanual-obs/obs_03_0326.html#ZH-CN_TOPIC_0000001858344862)；关于"FULL_CONTROL"权限的说明，请参见[使用自定义ACL](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0005.html#ZH-CN_TOPIC_0242745613__section7575125116596)。 | | 目标桶 | 区域 | 选择目标桶所在区域，目标桶需要与源桶处于不同区域。当桶归属选择"在当前账号中选择一个桶"时，需要配置该参数。 | | 目标桶 | 桶 | 选择目标桶。当桶归属选择"在当前账号中选择一个桶"时，需要配置该参数。 说明： 如果是新创建的桶，在创建成功后您可能需要等待几分钟才能在目标桶的下拉列表中看到该桶。 | | 目标桶 | 账号ID | 输入目标桶所属的账号ID。当桶归属选择"在另一个账号中指定一个桶"时，需要配置该参数。 - 当源桶中存在非源桶拥有者上传的对象且需要将该类对象复制到源桶拥有者在另一区域的桶（目标桶）中时，此处填写源桶拥有者的账号ID。 - 当需要将源桶中的对象复制到另一账号在另一区域的桶（目标桶）中时，此处填写目标桶拥有者的账号ID。 如何获取账号ID，请参见[获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.html)。 | | 目标桶 | 桶名称 | 输入目标桶的名称。当桶归属选择"在另一个账号中指定一个桶"时，需要配置该参数。 如何查找目标桶名称，请参见[列举桶](https://support.huaweicloud.com/usermanual-obs/obs_41_0010.html)。 | | 目标桶 | 副本对象拥有者为目标桶归属账号 | 设置被复制到目标桶中的副本对象的归属账号。当桶归属选择"在另一账号中指定一个桶"时，需要配置该参数。 - 默认勾选，表示副本对象的归属权和访问权转移至目标桶归属账号。 - 如果不勾选，则副本对象的归属权和访问权仍和在源桶中的保持一致。 | | 目标桶 | 修改复制对象的存储类别 | 修改从源桶复制到目标桶的对象的存储类别。 - 默认不勾选，即复制到目标桶的对象和源桶对象的存储类别一致。 - 勾选后，可以配置复制到目标桶的对象的存储类别。 | | 权限 | 复制使用KMS加密的对象 | 复制源桶中使用KMS加密的对象到目标桶。无论是否勾选，OBS均会尝试复制KMS加密对象。 - 如果勾选该项，下方的IAM委托仅会展示全局项目下配置了任意权限，并且源桶和目标桶所在区域均配置了KMS CMKFullAccess的OBS云服务委托。 - 如果不勾选该项，下方的IAM委托仅会展示全局项目下配置了任意权限，且源桶或目标桶所在区域不包含KMS CMKFullAccess权限的OBS云服务委托。 如果目标区域没有启用KMS服务或者委托中没有赋予源桶和目标桶所在区域" KMS CMKFullAccess"权限，则源桶中KMS加密对象会复制失败，导致对象复制状态为FAILED。 源桶中以任意KMS密钥加密的对象，复制到目标桶后都会以目标桶所在区域的默认密钥"obs/default"进行加密。 | | 权限 | IAM委托 | 将您资源的操作权限委托给OBS，OBS使用此委托执行对象的跨区域复制。 第一次使用时，您需要单击"创建委托"去创建一个新的委托用于跨区域复制。如果已经创建，可以从下拉列表中选择。 所创建或选择的IAM委托要求如下： - 此IAM委托必须为"对象存储服务 OBS"的云服务委托，委托需要具有[表6]中的OBS权限。 - 如果勾选了"复制使用KMS加密的对象"，委托还需要具有"KMS CMKFullAccess"权限，委托的授权范围选择"指定区域项目资源"并选择源桶和目标桶所在区域。 | 表6委托需要的OBS权限 | 操作 | 描述 | |:---|:---| | obs:object:GetObject | 获取对象内容、获取对象元数据。 | | obs:object:DeleteObjectVersion | 删除对象、批量删除对象。 | | obs:object:PutObjectVersionAcl | 设置对象ACL。 | | obs:object:AbortMultipartUpload | 取消多段上传任务。 | | obs:object:PutObjectAcl | 设置对象ACL。 | | obs:object:DeleteObject | 删除对象、批量删除对象。 | | obs:bucket:HeadBucket | 获取桶元数据。 | | obs:object:PutObject | PUT上传、POST上传、复制对象、追加写对象、初始化上传段任务、上传段、合并段 | | obs:object:GetObjectVersionAcl | 获取对象ACL。 | | obs:bucket:GetBucketVersioning | 获取桶的多版本状态。 | | obs:bucket:ListBucketMultipartUploads | 列举多段上传任务。 | | obs:object:ListMultipartUploadParts | 列举已上传的段。 | | obs:object:ModifyObjectMetaData | 修改对象元数据。 | | obs:bucket:ListBucketVersions | 列举桶内多版本对象。 | | obs:bucket:ListBucket | 列举桶内对象。 | | obs:object:GetObjectVersion | 获取对象内容、获取对象元数据。 | | obs:object:GetObjectAcl | 获取对象ACL。 | | obs:bucket:GetReplicationConfiguration | 获取桶的跨区域复制配置。 | 3. 单击"确定"，完成修改跨区域复制规则。 5. （可选）禁用跨区域复制规则。 如果跨区域复制规则处于"启用"状态，您可以按以下操作禁用跨区域复制规则。 1. 关闭"是否启用"开关。 还可以勾选待禁用的规则，然后单击列表上方的"禁用"，来批量禁用跨区域复制规则。 2. 单击"确定"。 6. （可选）启用跨区域复制规则。 如果跨区域复制规则处于"禁用"状态，您可以按以下操作启用跨区域复制规则。 1. 打开"是否启用"开关。 还可以勾选待启用的规则，然后单击列表上方的"启用"，来批量启用跨区域复制规则。 2. 单击"确定"。 7. （可选）删除跨区域复制规则。 1. 单击待删除规则操作列的"删除"。 还可以勾选待删除的规则，然后单击列表上方的"删除"，来批量删除跨区域复制规则。 2. 在"删除跨区域复制规则"弹窗，单击"确定"。 #### 使用OBS API - **编辑跨区域复制规则：** 使用[设置桶的跨区域复制配置](https://support.huaweicloud.com/api-obs/obs_04_0046.html)接口，通过修改"请求消息元素"来编辑规则。 - **禁用跨区域复制规则：** 使用[设置桶的跨区域复制配置](https://support.huaweicloud.com/api-obs/obs_04_0046.html)接口，通过修改"请求消息元素"中的"Status"值为"Disabled"来禁用规则。 - **启用跨区域复制规则：** 使用[设置桶的跨区域复制配置](https://support.huaweicloud.com/api-obs/obs_04_0046.html)接口，通过修改"请求消息元素"中的"Status"值为"Enabled"来启用规则。 - [删除跨区域复制规则](https://support.huaweicloud.com/api-obs/obs_04_0048.html) #### 相关文档 #### 创建用于跨区域复制的委托 1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)"创建跨区域复制规则"对话框，单击"创建IAM委托"，进入"统一身份认证服务"控制台"委托"页面。 2. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)"创建跨区域复制规则"对话框，单击"创建委托"，右侧弹出"创建委托"弹窗。 3. 设置委托名称。委托名称不能为空。 4. （可选）创建自定义策略，用来给委托授予OBS相关权限。如果已有符合的策略，请跳过该步骤。 1. 在[IAM控制台](https://console.huaweicloud.com/iam/?locale=zh-cn#/iam/users)左侧导航栏选择"权限管理 \> 权限"。 2. 在权限页面右上角单击"创建自定义策略"。 3. 在创建自定义策略页面，按照如下设置参数内容，其他参数保持默认。 图6自定义策略设置 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002283010894.png "点击放大") - 策略名称：根据需要设置简单易于记忆的名称。 - 云服务：选择"对象存储服务（OBS）"。 - 操作：请选择下表中的操作。 表7委托需要的OBS权限 | 操作 | 描述 | |:---|:---| | obs:object:GetObject | 获取对象内容、获取对象元数据。 | | obs:object:DeleteObjectVersion | 删除对象、批量删除对象。 | | obs:object:PutObjectVersionAcl | 设置对象ACL。 | | obs:object:AbortMultipartUpload | 取消多段上传任务。 | | obs:object:PutObjectAcl | 设置对象ACL。 | | obs:object:DeleteObject | 删除对象、批量删除对象。 | | obs:bucket:HeadBucket | 获取桶元数据。 | | obs:object:PutObject | PUT上传、POST上传、复制对象、追加写对象、初始化上传段任务、上传段、合并段 | | obs:object:GetObjectVersionAcl | 获取对象ACL。 | | obs:bucket:GetBucketVersioning | 获取桶的多版本状态。 | | obs:bucket:ListBucketMultipartUploads | 列举多段上传任务。 | | obs:object:ListMultipartUploadParts | 列举已上传的段。 | | obs:object:ModifyObjectMetaData | 修改对象元数据。 | | obs:bucket:ListBucketVersions | 列举桶内多版本对象。 | | obs:bucket:ListBucket | 列举桶内对象。 | | obs:object:GetObjectVersion | 获取对象内容、获取对象元数据。 | | obs:object:GetObjectAcl | 获取对象ACL。 | | obs:bucket:GetReplicationConfiguration | 获取桶的跨区域复制配置。 | - 资源：选择"特定资源"。 - object：选择"通过资源路径指定"，资源路径格式为"OBS:\*:\*:object:*桶名称* /*对象名称* "。 此处分别添加源桶和目标桶中所有的对象资源，如：**OBS:\*:\*:object:piccomp/\*** 和**OBS:\*:\*:object:piccomp-output/\***分别表示源桶piccomp和目标桶piccomp-output中的所有对象。 - bucket：选择"通过资源路径指定"，资源路径格式为"OBS:\*:\*:bucket:*桶名称* "。 此处分别添加源桶和目标桶资源，如：**OBS:\*:\*:bucket:piccomp** 和**OBS:\*:\*:bucket:piccomp-output**分别表示源桶piccomp和目标桶piccomp-output。 4. 单击"确定"，在权限列表页面可以看到新创建的自定义策略，即表示创建成功。 5. 给委托授予相关权限。 在"委托授权"下的第一个下拉框选择"自定义策略"，然后在下方自定义策略列表中选择[4]创建的自定义策略。 如果勾选了"复制使用KMS加密的对象"，还需要给委托授予源桶和目标桶所在区域的"KMS CMKFullAccess"权限。 6. 单击"确定"。 委托下拉框会自动填充为新创建的委托。如需查看委托授权详情，请单击委托下拉框下的"委托授权详情"。 7. （可选）如果勾选了"复制使用KMS加密的对象"，还需要给委托授予源桶和目标桶所在区域的"KMS CMKFullAccess"权限。 1. 在"统一身份认证服务 IAM"控制台左侧导航栏选择"委托"。 2. 单击[2]创建的委托操作列的"授权"。 3. 在"选择策略"页面选择"KMS CMKFullAccess"权限，单击下方的"下一步"。 4. 选择授权范围方案时，选择"指定区域项目资源"，分别选择源桶和目标桶所在区域的项目。 5. 单击下方的"确定"，完成委托授权。 #### 同账号跨区域复制常见问题 - [创建跨区域复制规则后，为什么对象没有复制到目标桶中？](https://support.huaweicloud.com/obs_faq/obs_faq_0137.html) - [删除对象操作会同步复制到跨区域复制的桶中吗？](https://support.huaweicloud.com/obs_faq/obs_03_0017.html)