赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 关于Bucket操作
  7. 数据复制(Replication)
  8. GetBucketReplicationLocation

GetBucketReplicationLocation

  • 数据复制(Replication)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

GetBucketReplicationLocation接口用于获取可复制到的目标存储空间(Bucket)所在的地域。您可以根据返回结果决定将源Bucket的数据复制到哪个地域。

请求语法

GET /?replicationLocation HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com 
Date: GMT Date
Authorization: SignatureValue

响应元素

名称

类型

描述

ReplicationLocation

容器

可复制地域的容器。

Location

字符串

可复制到的目标Bucket所在的地域,例如oss-cn-beijing。

父节点:ReplicationLocation

子节点:无

说明

如果有多个可复制到的目标地域,那么返回的结果中包含多个Location。如果没有可复制到的目标地域,则返回的Location为空。

LocationTransferTypeConstraint

容器

包含TransferType约束的Location信息容器。

LocationTransferType

容器

包含TransferType的Location信息容器。

TransferTypes

容器

传输类型容器。

Type

字符串

数据复制时使用的数据传输类型。

取值:

  • internal(默认值):OSS默认传输链路。

  • oss_acc:传输加速链路。只有创建跨区域复制规则时才能使用传输加速链路。

示例

  • 请求示例

GET /?replicationLocation HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Date: Thu, 24 Sep 2015 15:39:15 GMT
Authorization: OSS qn6q**************:77Dv****************
  • 返回示例

    说明

    仅当传输类型为oss_acc时,返回的XML示例中才会包含<TransferType>元素。

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 24 Sep 2015 15:39:15 GMT
Content-Length: 84
Content-Type: application/xml 
Connection: close
Server: AliyunOSS

<?xml version="1.0" ?>
<ReplicationLocation>
  <Location>oss-cn-beijing</Location>
  <Location>oss-cn-qingdao</Location>
  <Location>oss-cn-shenzhen</Location>
  <Location>oss-cn-hongkong</Location>
  <Location>oss-us-west-1</Location>
  <LocationTransferTypeConstraint>
    <LocationTransferType>
      <Location>oss-cn-hongkong</Location>
        <TransferTypes>
          <Type>oss_acc</Type>          
        </TransferTypes>
      </LocationTransferType>
      <LocationTransferType>
        <Location>oss-us-west-1</Location>
        <TransferTypes>
          <Type>oss_acc</Type>
        </TransferTypes>
      </LocationTransferType>
    </LocationTransferTypeConstraint>
  </ReplicationLocation>

SDK

此接口所对应的各语言SDK如下:

  • Java

  • Python

  • Go V2

命令行工具ossutil

GetBucketReplicationLocation接口所对应的ossutil命令,请参见get-bucket-replication-location。

错误码

错误码

状态码

描述

NoSuchBucket

404 NotFound

请求的Bucket不存在。

相关文章

PutBucketReplication 2025-04-21 18:15

PutBucketReplication接口用于为存储空间(Bucket)指定数据复制规则。OSS支持跨区域复制(Cross-Region Replication)和同区域复制(Same-Region Replication)。 注意事项 数据复制是以异步(近实时

PutBucketRTC 2025-04-21 18:15

调用PutBucketRTC接口为已有的跨区域复制规则开启或关闭数据复制时间控制(RTC)功能。

GetBucketReplication 2025-04-21 18:15

调用GetBucketReplication接口获取某个存储空间(Bucket)已设置的数据复制规则。 请求语法

GetBucketReplicationLocation 2025-04-21 18:15

GetBucketReplicationLocation接口用于获取可复制到的目标存储空间(Bucket)所在的地域。您可以根据返回结果决定将源Bucket的数据复制到哪个地域。 请求语法

GetBucketReplicationProgress 2025-04-21 18:15

GetBucketReplicationProgress用于获取某个存储空间(Bucket)的数据复制进度。 请求语法

DeleteBucketReplication 2025-04-21 18:15

DeleteBucketReplication接口用来停止某个存储空间(Bucket)的数据复制并删除Bucket的复制配置,此时源Bucket中的任何操作都不会被同步到目标Bucket。 注意事项

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号