Todos los productos
Search
Centro de documentos

Object Storage Service:GetBucketReplication

Última actualización: Sep 03, 2026

Consulta las reglas de replicación de datos configuradas para un bucket.

Sintaxis de la solicitud

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

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

ReplicationConfiguration

Contenedor

N/A

Contenedor de las configuraciones de replicación de datos.

Nodos padre: ninguno

Nodos hijo: Rule

Rule

Contenedor

N/A

Contenedor de las reglas de replicación de datos.

Nodos padre: ReplicationConfiguration

Nodos hijo: Destination, HistoricalObjectReplication, Status e ID

ID

String

test_replication_1

ID de la regla de replicación de datos.

Nodos padre: Rule

Nodos hijo: ninguno

PrefixSet

Contenedor

N/A

Contenedor de prefijos. Se admiten hasta 10 prefijos por regla.

Nodos padre: Rule

Nodos hijo: Prefix

Prefix

String

source1

Prefijos de los objetos replicados al bucket de destino.

Nodos padre: PrefixSet

Nodos hijo: ninguno

Action

String

PUT

Operaciones sincronizadas con el bucket de destino.

Establezca uno o más tipos de operación. Valor predeterminado: ALL.

  • ALL: las operaciones PUT, DELETE y ABORT se sincronizan con el bucket de destino.

  • PUT: las operaciones de escritura se sincronizan con el bucket de destino, incluidas PutObject, PostObject, AppendObject, CopyObject, PutObjectACL, InitiateMultipartUpload, UploadPart, UploadPartCopy y CompleteMultipartUpload.

Nodos padre: Rule

Nodos hijo: ninguno

Status

String

doing

Estado de la tarea de replicación de datos.

Valores válidos:

  • starting: OSS está creando la tarea de replicación después de configurar una regla.

  • doing: la regla de replicación está activa y los datos se están replicando.

  • closing: OSS está limpiando la tarea de replicación después de eliminar la regla.

Nodos padre: Rule

Nodos hijo: ninguno

Destination

Contenedor

N/A

Contenedor de la información del bucket de destino.

Nodos padre: Rule

Nodos hijo: Bucket y Location

Bucket

String

destbucket

Bucket de destino al que se replican los datos.

Nodos padre: Destination

Nodos hijo: ninguno

Location

String

oss-cn-beijing

Región del bucket de destino.

Nodos padre: Destination

Nodos hijo: ninguno

TransferType

String

oss_acc

Tipo de transferencia de datos utilizado para la replicación. Se devuelve solo cuando TransferType se establece en oss_acc en la solicitud.

Valor predeterminado: internal. Valores válidos:

  • internal: enlace de transferencia de datos predeterminado de OSS.

  • oss_acc: enlace de transferencia de datos acelerada. Disponible solo para reglas de cross-region replication (CRR).

HistoricalObjectReplication

String

disabled

Indica si los datos históricos del bucket de origen se replican al bucket de destino antes de habilitar la replicación. Valor predeterminado: enabled.

Valor predeterminado: disabled. Valores válidos:

  • enabled: los datos históricos se replican al bucket de destino.

  • disabled: los datos históricos no se replican. Solo se replica la información cargada después de habilitar la replicación.

Nodos padre: Rule

Nodos hijo: ninguno

SyncRole

String

aliyunramrole

Rol utilizado para la replicación de datos. Se devuelve solo cuando el objeto de destino está cifrado con SSE-KMS.

RTC

Contenedor

N/A

Contenedor del estado de la función Replication Time Control (RTC).

Nodos padre: Rule

Nodos hijo: Status

Status

String

enbaled

Estado de la función RTC. Se devuelve solo cuando RTC se encuentra en estado de habilitación o habilitado.

Valor predeterminado: disabled. Valores válidos:

  • enabling

  • enabled

  • disabled

Nodos padre: RTC

Nodos hijo: ninguno

Ejemplos

  • Solicitud de ejemplo

GET /?replication HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Date: Thu, 24 Sep 2015 15:39:15 GMT
Authorization: OSS qn6q**************:77Dv****************
  • Respuesta de ejemplo

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906**** 
Date: Thu, 24 Sep 2015 15:39:15 GMT
Content-Length: 186
Content-Type: application/xml 
Connection: close
Server: AliyunOSS
<?xml version="1.0" ?>
<ReplicationConfiguration>
  <Rule>
    <ID>test_replication_1</ID>
    <PrefixSet>
      <Prefix>source1</Prefix>
      <Prefix>video</Prefix>
    </PrefixSet>
    <Action>PUT</Action>
    <Destination>
      <Bucket>destbucket</Bucket>
      <Location>oss-cn-beijing</Location>
      <TransferType>oss_acc</TransferType>
    </Destination>
    <Status>doing</Status>
    <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
    <SyncRole>aliyunramrole</SyncRole>
    <RTC>
      <Status>enabled</Status>
    </RTC>
  </Rule>  
</ReplicationConfiguration>

SDK de OSS

Llame a GetBucketReplication con los siguientes SDK de OSS:

ossutil

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

Códigos de error

Código de error

Código de estado HTTP

Descripción

NoSuchBucket

404 NotFound

El bucket especificado no existe.

NoSuchReplicationConfiguration

404 NotFound

No hay reglas de replicación de datos configuradas para el bucket especificado.