Todos os produtos
Search
Central de documentação

Object Storage Service:GetBucketReplicationLocation

Última atualização: Jul 03, 2026

Consulta as regiões disponíveis para o bucket de destino de uma regra de replicação de dados.

Estrutura da solicitação

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

Elementos da resposta

Elemento

Tipo

Descrição

ReplicationLocation

Container

Contêiner das regiões do bucket de destino.

Location

String

Região disponível para o bucket de destino. Exemplo: oss-cn-beijing.

Nó pai: ReplicationLocation

Nós filhos: nenhum

Nota

Se houver várias regiões disponíveis, a resposta conterá múltiplos elementos Location. Se nenhuma região estiver disponível, o valor será nulo.

LocationTransferTypeConstraint

Container

Contêiner das regiões do bucket de destino com TransferType especificado.

LocationTransferType

Container

Contêiner de uma região do bucket de destino com informações de TransferType.

TransferTypes

Container

Contêiner do tipo de transferência.

Type

String

Link de transferência de dados para replicação. Valor padrão: internal.

Valores válidos:

  • internal: link de transferência padrão.

  • oss_acc: link de aceleração de transferência. Disponível apenas para regras de replicação entre regiões (CRR).

Exemplos

  • Exemplos de solicitações

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****************
  • Exemplos de respostas

    Nota

    A resposta inclui o elemento TransferType somente quando TransferType está definido como oss_acc.

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>

SDKs do OSS

Use os seguintes SDKs do OSS para chamar GetBucketReplicationLocation:

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação GetBucketReplicationLocation, consulte get-bucket-replication-location.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

NoSuchBucket

404 NotFound

O bucket especificado não existe.