Todos os produtos
Search

Este produto

    Object Storage Service:GetBucketReplication

    Central de documentação

    Object Storage Service:GetBucketReplication

    Última atualização: Jul 03, 2026

    Consulta as regras de replicação de dados configuradas para um bucket.

    Sintaxe da solicitação

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

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    ReplicationConfiguration

    Container

    N/A

    Container das configurações de replicação de dados.

    Nós pai: nenhum

    Nós filho: Rule

    Rule

    Container

    N/A

    Container das regras de replicação de dados.

    Nós pai: ReplicationConfiguration

    Nós filho: Destination, HistoricalObjectReplication, Status e ID

    ID

    String

    test_replication_1

    ID da regra de replicação de dados.

    Nós pai: Rule

    Nós filho: nenhum

    PrefixSet

    Container

    N/A

    Container de prefixos. Limite de até 10 prefixos por regra.

    Nós pai: Rule

    Nós filho: Prefix

    Prefix

    String

    source1

    Prefixos dos objetos replicados para o bucket de destino.

    Nós pai: PrefixSet

    Nós filho: nenhum

    Action

    String

    PUT

    Operações sincronizadas com o bucket de destino.

    Defina como um ou mais tipos de operação. Padrão: ALL.

    • ALL: as operações PUT, DELETE e ABORT são sincronizadas com o bucket de destino.

    • PUT: as operações de gravação são sincronizadas com o bucket de destino, incluindo PutObject, PostObject, AppendObject, CopyObject, PutObjectACL, InitiateMultipartUpload, UploadPart, UploadPartCopy e CompleteMultipartUpload.

    Nós pai: Rule

    Nós filho: nenhum

    Status

    String

    doing

    Status da tarefa de replicação de dados.

    Valores válidos:

    • starting: o OSS está criando a tarefa de replicação após a configuração de uma regra.

    • doing: a regra de replicação está ativa e os dados estão sendo replicados.

    • closing: o OSS está limpando a tarefa de replicação após a exclusão da regra.

    Nós pai: Rule

    Nós filho: nenhum

    Destination

    Container

    N/A

    Container das informações do bucket de destino.

    Nós pai: Rule

    Nós filho: Bucket e Location

    Bucket

    String

    destbucket

    Bucket de destino para o qual os dados são replicados.

    Nós pai: Destination

    Nós filho: nenhum

    Location

    String

    oss-cn-beijing

    Região do bucket de destino.

    Nós pai: Destination

    Nós filho: nenhum

    TransferType

    String

    oss_acc

    Tipo de transferência de dados usado na replicação. Retornado apenas quando TransferType é definido como oss_acc na solicitação.

    Padrão: internal. Valores válidos:

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

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

    HistoricalObjectReplication

    String

    disabled

    Indica se os dados históricos do bucket de origem são replicados para o bucket de destino antes da ativação da replicação. Valor padrão: enabled.

    Padrão: disabled. Valores válidos:

    • enabled: os dados históricos são replicados para o bucket de destino.

    • disabled: os dados históricos não são replicados. Apenas os dados enviados após a ativação da replicação são copiados.

    Nós pai: Rule

    Nós filho: nenhum

    SyncRole

    String

    aliyunramrole

    Função utilizada para a replicação de dados. Retornada apenas quando o objeto de destino é criptografado com SSE-KMS.

    RTC

    Container

    N/A

    Container do status do recurso Replication Time Control (RTC).

    Nós pai: Rule

    Nós filho: Status

    Status

    String

    enbaled

    Status do recurso RTC. Retornado apenas quando o RTC está no estado de ativação ou ativado.

    Padrão: disabled. Valores válidos:

    • enabling

    • enabled

    • disabled

    Nós pai: RTC

    Nós filho: nenhum

    Exemplos

    • Solicitação de exemplo

    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****************

    • Resposta de exemplo

    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>

    SDKs do OSS

    Chame a operação GetBucketReplication com os seguintes SDKs do OSS:

    ossutil

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

    Códigos de erro

    Código de erro

    Código de status HTTP

    Descrição

    NoSuchBucket

    404 NotFound

    O bucket especificado não existe.

    NoSuchReplicationConfiguration

    404 NotFound

    Não há regras de replicação de dados configuradas para o bucket especificado.