All Products
Search
Document Center

Object Storage Service:GetBucketReplicationLocation

Last Updated:Apr 28, 2024

You can call this operation to query the region in which the destination bucket can be located. You can determine the region of the destination bucket based on the response returned for the operation.

Request structure

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

Response elements

Element

Type

Description

ReplicationLocation

Container

The container that stores the region in which the destination bucket can be located.

Location

String

The region in which the destination bucket can be located. Example: oss-cn-beijing.

Parent node: ReplicationLocation

Child nodes: none

Note

If the destination bucket can be located in multiple regions, multiple regions are contained in the response. If regions in which the destination bucket can be located do not exist, the value of Location is null.

LocationTransferTypeConstraint

Container

The container that stores regions in which the destination bucket can be located with TransferType specified.

LocationTransferType

Container

The container that stores regions in which the destination bucket can be located with the TransferType information.

TransferTypes

Container

The container that stores the transmission type.

Type

String

The link used to transfer data in data replication. Default value: internal.

Valid values:

  • internal: the default link.

  • oss_acc: the link in which data transmission is accelerated. TransferType can be set to oss_acc only for cross-region replication (CRR) rules.

Examples

  • Sample requests

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****************
  • Sample responses

    Note

    The TransferType element is contained in the XML body of the response only when the value of TransferType is set to oss_acc in the request.

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>

Error codes

Error code

HTTP status code

Description

NoSuchBucket

404 NotFound

The error message returned because the specified bucket does not exist.