Todos los productos
Search
Centro de documentos

Object Storage Service:GetBucketReplicationLocation

Última actualización: Sep 03, 2026

Consulta las regiones donde puede ubicarse el bucket de destino de una regla de replicación de datos.

Estructura de la solicitud

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

Elementos de respuesta

Elemento

Tipo

Descripción

ReplicationLocation

Contenedor

Contenedor de las regiones del bucket de destino.

Location

String

Región donde puede ubicarse el bucket de destino. Ejemplo: oss-cn-beijing.

Nodo padre: ReplicationLocation

Nodos secundarios: ninguno

Nota

Si hay varias regiones disponibles, la respuesta contiene varios elementos Location. Si no hay ninguna región disponible, el valor es null.

LocationTransferTypeConstraint

Contenedor

Contenedor de las regiones del bucket de destino con TransferType especificado.

LocationTransferType

Contenedor

Contenedor de una región del bucket de destino con información de TransferType.

TransferTypes

Contenedor

Contenedor del tipo de transferencia.

Type

String

Enlace de transferencia de datos para la replicación. Valor predeterminado: internal.

Valores válidos:

  • internal: enlace de transferencia predeterminado.

  • oss_acc: enlace de aceleración de transferencia. Disponible solo para reglas de cross-region replication (CRR).

Ejemplos

  • Solicitudes de ejemplo

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****************
  • Respuestas de ejemplo

    Nota

    La respuesta incluye el elemento TransferType solo cuando TransferType se establece en 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>

SDK de OSS

Llame a GetBucketReplicationLocation con los siguientes SDK de OSS:

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación GetBucketReplicationLocation, consulte get-bucket-replication-location.

Códigos de error

Código de error

Código de estado HTTP

Descripción

NoSuchBucket

404 NotFound

El bucket especificado no existe.