同账号跨区域桶之间数据复制

1. 在OBS管理控制台左侧导航栏选择“对象存储”。
2. 在桶列表中，单击待操作的桶，进入“对象”页面。
3. 在左侧导航栏，单击“数据管理 > 跨区域复制”。
4. 单击“创建规则”，系统将弹出“创建跨区域复制规则”对话框，如图4所示。
   图4 创建跨区域复制规则

   

   

   • 源桶和目标桶的多版本控制状态必须保持一致。
   • 一个源桶的跨区域复制只能有一个目标桶和IAM委托，后面创建的规则中的目标桶和IAM委托会覆盖已创建规则的目标桶和委托。

5. 根据业务规划配置跨区域复制规则，参数的详细说明如表3所示。

   表3 跨区域复制规则参数

   参数		说明
   状态		选择启用或者禁用当前规则。源桶和目标桶的多版本控制状态必须保持一致。
   源桶	复制对象	在源桶中选择要复制的对象。 所有对象：将源桶中的所有对象复制到目标桶中。 按前缀匹配：将源桶中匹配该前缀的对象复制到目标桶中。
   	前缀	当“复制对象”选择“按前缀匹配”时，需要配置前缀，表示源桶中匹配该前缀的对象会被复制到目标桶中。 输入的对象名前缀不能为空，长度限制为1024个字符。 如果指定的前缀名与某条已配置的规则指定的前缀名存在包含关系，OBS会将两条规则视为同一条，而禁止您配置本条规则。例如，系统中已存在指定前缀名为“abc”的规则，则不允许再配置指定前缀以“abc”字段开头的规则。 如果要复制文件夹，对象名前缀需要使用“/”作为最后一个字符。例如：folder1/。
   	同步历史对象	选择是否将创建本规则前已经存在于源桶中的对象同步复制到目标桶。 默认不同步。
   目标桶	区域	选择目标桶所在区域，目标桶需要与源桶处于不同区域。
   	桶	选择目标桶。 说明： 如果是新创建的桶，在创建成功后您可能需要等待几分钟才能在目标桶的下拉列表中看到该桶。
   	修改复制对象的存储类别	修改从源桶复制到目标桶的对象的存储类别。 默认不勾选，即复制到目标桶的对象和源桶对象的存储类别一致。 勾选后，可以配置复制到目标桶的对象的存储类别。
   权限	复制使用KMS加密的对象	复制源桶中使用KMS加密的对象到目标桶。无论是否勾选，OBS均会尝试复制KMS加密对象。 如果勾选该项，下方的“IAM委托”仅会展示全局项目下配置了任意权限，并且源桶和目标桶所在区域均配置了KMS Administrator的OBS云服务委托。 如果不勾选该项，下方的“IAM委托”仅会展示全局项目下配置了任意权限，且源桶或目标桶所在区域不包含KMS Administrator权限的OBS云服务委托。 如果目标区域没有启用KMS服务或者委托中没有赋予源桶和目标桶所在区域“ KMS Administrator”权限，则源桶中KMS加密对象会复制失败，导致对象复制状态为FAILED。 源桶中以任意KMS密钥加密的对象，复制到目标桶后都会以目标桶所在区域的默认密钥“obs/default”进行加密。
   	IAM委托	将您资源的操作权限委托给OBS，OBS使用此委托执行对象的跨区域复制。 第一次使用时，您需要单击“查看IAM委托”去创建一个新的委托用于跨区域复制。如果已经创建，可以从下拉列表中选择。 所创建或选择的IAM委托要求如下： 此IAM委托必须为“对象存储服务 OBS”的云服务委托，其中“对象存储服务”项目需要具有“Tenant Administrator”权限。 如果勾选了“复制使用KMS加密的对象”，委托还需要具有“KMS Administrator”权限，委托的授权范围选择“指定区域项目资源”并选择源桶和目标桶所在区域。

6. （可选）创建IAM委托，请参见创建用于跨区域复制的委托。
7. 单击“确定”，完成跨区域复制规则创建。

设置桶的跨区域复制配置

使用obsutil进行同账号跨区域复制对象，需要开启跨区域复制模式，即“crr”参数必选。

• 复制对象或批量复制时，请确保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

• 更多运行示例，请参见复制示例。

参数说明：

./obsutil cp obs://src-bucket/ obs://target-bucket/ -include=/src-object/* -f -r

响应结果：

1. 在OBS管理控制台左侧导航栏选择“对象存储”。
2. 在桶列表中，单击待操作的桶，进入“对象”页面。
3. 在左侧导航栏，单击“数据管理 > 跨区域复制”，进入跨区域复制页面。
4. （可选）编辑跨区域复制规则。
   1. 单击待修改规则操作列的“编辑”，系统将弹出“编辑跨区域复制规则”对话框。
      图5 编辑跨区域复制规则
      
   2. 修改跨区域复制规则，支持修改的内容如下所示。

      表4 支持修改的跨区域复制规则参数

      参数名称		说明
      状态		跨区域复制规则的状态。可以选择启用或禁用跨区域复制规则。
      源桶	复制对象	在源桶中选择要复制的对象。 所有对象：将源桶中的所有对象复制到目标桶中。 按前缀匹配：将源桶中匹配该前缀的对象复制到目标桶中。
      	前缀	当“复制对象”选择“按前缀匹配”时，需要配置前缀，表示源桶中匹配该前缀的对象会被复制到目标桶中。 输入的对象名前缀不能为空，长度限制为1024个字符。 如果指定的前缀名与某条已配置的规则指定的前缀名存在包含关系，OBS会将两条规则视为同一条，而禁止您配置本条规则。例如，系统中已存在指定前缀名为“abc”的规则，则不允许再配置指定前缀以“abc”字段开头的规则。 如果要复制文件夹，对象名前缀需要使用“/”作为最后一个字符。例如：folder1/。
      	同步历史对象	选择是否将创建本规则前已经存在于源桶中的对象同步复制到目标桶。 默认不同步。
      目标桶	区域	选择目标桶所在区域，目标桶需要与源桶处于不同区域。 单击右侧的“编辑目标桶”，即可修改目标桶所属区域。
      	桶	选择目标桶。 单击右侧的“编辑目标桶”，即可修改目标桶。 目标桶修改后，将改变所有跨区域复制规则的目标桶。 说明： 如果是新创建的桶，在创建成功后您可能需要等待几分钟才能在目标桶的下拉列表中看到该桶。
      	修改复制对象的存储类别	修改从源桶复制到目标桶的对象的存储类别。 默认不勾选，即复制到目标桶的对象和源桶对象的存储类别一致。 勾选后，可以配置复制到目标桶的对象的存储类别。
      权限	复制使用KMS加密的对象	复制源桶中使用KMS加密的对象到目标桶。无论是否勾选，OBS均会尝试复制KMS加密对象。 如果勾选该项，下方的“IAM委托”仅会展示全局项目下配置了任意权限，并且源桶和目标桶所在区域均配置了KMS Administrator的OBS云服务委托。 如果不勾选该项，下方的“IAM委托”仅会展示全局项目下配置了任意权限，且源桶或目标桶所在区域不包含KMS Administrator权限的OBS云服务委托。 如果目标区域没有启用KMS服务或者委托中没有赋予源桶和目标桶所在区域“ KMS Administrator”权限，则源桶中KMS加密对象会复制失败，导致对象复制状态为FAILED。 源桶中以任意KMS密钥加密的对象，复制到目标桶后都会以目标桶所在区域的默认密钥“obs/default”进行加密。
      	IAM委托	将您资源的操作权限委托给OBS，OBS使用此委托执行对象的跨区域复制。 单击右侧的“修改委托”，即可修改所使用的IAM委托。 第一次使用时，您需要单击“查看IAM委托”去创建一个新的委托用于跨区域复制。如果已经创建，可以从下拉列表中选择。 所创建或选择的IAM委托要求如下： 此IAM委托必须为“对象存储服务 OBS”的云服务委托，其中“对象存储服务”项目需要具有“Tenant Administrator”权限。 如果勾选了“复制使用KMS加密的对象”，委托还需要具有“KMS Administrator”权限，委托的授权范围选择“指定区域项目资源”并选择源桶和目标桶所在区域。

   3. 单击“确定”，完成修改跨区域复制规则。

5. （可选）禁用跨区域复制规则。
   如果跨区域复制规则处于“启用”状态，您可以按以下操作禁用跨区域复制规则。

   1. 单击待禁用规则操作列的“禁用”。

      还可以勾选待禁用的规则，然后单击列表上方的“禁用”，来批量禁用跨区域复制规则。

   2. 在“禁用跨区域复制规则”弹窗，单击“确定”。

6. （可选）启用跨区域复制规则。
   如果跨区域复制规则处于“禁用”状态，您可以按以下操作启用跨区域复制规则。

   1. 单击待启用规则操作列的“启用”。

      还可以勾选待启用的规则，然后单击列表上方的“启用”，来批量启用跨区域复制规则。

   2. 在“启用跨区域复制规则”弹窗，单击“确定”。

7. （可选）删除跨区域复制规则。
   1. 单击待删除规则操作列的“删除”。

      还可以勾选待删除的规则，然后单击列表上方的“删除”，来批量删除跨区域复制规则。

   2. 在“删除跨区域复制规则”弹窗，单击“确定”。

• 编辑跨区域复制规则：使用设置桶的跨区域复制配置接口，通过修改“请求消息元素”来编辑规则。
• 禁用跨区域复制规则：使用设置桶的跨区域复制配置接口，通过修改“请求消息元素”中的“Status”值为“Disabled”来禁用规则。
• 启用跨区域复制规则：使用设置桶的跨区域复制配置接口，通过修改“请求消息元素”中的“Status”值为“Enabled”来启用规则。
• 删除跨区域复制规则

1. 在OBS控制台“创建跨区域复制规则”对话框，单击“查看IAM委托”，进入“统一身份认证服务”控制台“委托”页面。
2. 单击“创建委托”，在“创建委托”页面，设置用于跨区域复制委托相关的参数，其他参数保持默认。

   表5 参数说明

   参数名称	说明
   委托名称	创建的委托名称。 委托名称不能为空。
   委托类型	选择将账号内资源的操作权限委托给其他账号或云服务。 创建用于跨区域复制的委托，此处选择“云服务”。
   云服务	选择将账号内资源的操作权限委托给某个云服务。当“委托类型”选择“云服务”时，需配置该参数。 创建用于跨区域复制的委托，此处选择“对象存储服务 OBS”。

3. 单击“完成”，并在“创建成功”弹窗单击“暂不授权”。在委托列表页面可以看到新创建的委托，即表示委托创建成功。
4. 给创建的委托授予OBS相关权限。
   1. 在“统一身份认证服务 IAM”控制台左侧导航栏选择“委托”。
   2. 单击2创建的委托操作列的“授权”。
   3. 在“选择策略”页面，选择“Tenant Administrator”权限，单击“下一步”。
   4. 在“设置最小权限范围”页面选择“全局服务资源”，单击“确定”。
   5. 在“权限生效时间提醒”弹窗，单击“知道了”。
   6. 在“完成”页面，单击“完成”。

5. （可选）如果勾选了“复制使用KMS加密的对象”，还需要给委托授予源桶和目标桶所在区域的“KMS Administrator”权限。
   1. 在“统一身份认证服务 IAM”控制台左侧导航栏选择“委托”。
   2. 单击2创建的委托操作列的“授权”。
   3. 在“选择策略”页面选择“KMS Administrator”权限，单击下方的“下一步”。
   4. 选择授权范围方案时，选择“指定区域项目资源”，分别选择源桶和目标桶所在区域的项目。
   5. 单击下方的“确定”，完成委托授权。

• 创建跨区域复制规则后，为什么对象没有复制到目标桶中？
• 删除对象操作会同步复制到跨区域复制的桶中吗？