Tous les produits
Search
Centre de documentation

Object Storage Service:GetBucketReplication

Dernière mise à jour :Aug 18, 2026

Interroge les règles de réplication des données configurées pour un compartiment.

Syntaxe de la requête

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

Paramètres de réponse

Paramètre

Type

Exemple

Description

ReplicationConfiguration

Container

N/A

Conteneur des configurations de réplication des données.

Nœuds parents : aucun

Nœuds enfants : Rule

Rule

Container

N/A

Conteneur des règles de réplication des données.

Nœuds parents : ReplicationConfiguration

Nœuds enfants : Destination, HistoricalObjectReplication, Status et ID

ID

String

test_replication_1

ID de la règle de réplication des données.

Nœuds parents : Rule

Nœuds enfants : aucun

PrefixSet

Container

N/A

Conteneur des préfixes. Jusqu'à 10 préfixes par règle.

Nœuds parents : Rule

Nœuds enfants : Prefix

Prefix

String

source1

Préfixes des objets répliqués vers le compartiment de destination.

Nœuds parents : PrefixSet

Nœuds enfants : aucun

Action

String

PUT

Opérations synchronisées avec le compartiment de destination.

Définissez un ou plusieurs types d'opérations. Valeur par défaut : ALL.

  • ALL : les opérations PUT, DELETE et ABORT sont synchronisées avec le compartiment de destination.

  • PUT : les opérations d'écriture sont synchronisées avec le compartiment de destination, y compris PutObject, PostObject, AppendObject, CopyObject, PutObjectACL, InitiateMultipartUpload, UploadPart, UploadPartCopy et CompleteMultipartUpload.

Nœuds parents : Rule

Nœuds enfants : aucun

Status

String

doing

État de la tâche de réplication des données.

Valeurs valides :

  • starting : OSS crée la tâche de réplication après la configuration d'une règle.

  • doing : la règle de réplication est active et les données sont en cours de réplication.

  • closing : OSS supprime la tâche de réplication après la suppression de la règle.

Nœuds parents : Rule

Nœuds enfants : aucun

Destination

Container

N/A

Conteneur des informations sur le compartiment de destination.

Nœuds parents : Rule

Nœuds enfants : Bucket et Location

Bucket

String

destbucket

Compartiment de destination vers lequel les données sont répliquées.

Nœuds parents : Destination

Nœuds enfants : aucun

Location

String

oss-cn-beijing

Région du compartiment de destination.

Nœuds parents : Destination

Nœuds enfants : aucun

TransferType

String

oss_acc

Type de transfert de données utilisé pour la réplication. Renvoyé uniquement lorsque TransferType est défini sur oss_acc dans la requête.

Par défaut : internal. Valeurs valides :

  • internal : lien de transfert de données OSS par défaut.

  • oss_acc : lien de transfert de données accéléré. Disponible uniquement pour les règles de réplication inter-régions (CRR).

HistoricalObjectReplication

String

disabled

Indique si les données historiques du compartiment source sont répliquées vers le compartiment de destination avant l'activation de la réplication. Valeur par défaut : enabled.

Par défaut : disabled. Valeurs valides :

  • enabled : les données historiques sont répliquées vers le compartiment de destination.

  • disabled : les données historiques ne sont pas répliquées. Seules les données téléchargées après l'activation de la réplication sont répliquées.

Nœuds parents : Rule

Nœuds enfants : aucun

SyncRole

String

aliyunramrole

Rôle utilisé pour la réplication des données. Renvoyé uniquement lorsque l'objet de destination est chiffré avec SSE-KMS.

RTC

Container

N/A

Conteneur de l'état de la fonctionnalité Replication Time Control (RTC).

Nœuds parents : Rule

Nœuds enfants : Status

Status

String

enbaled

État de la fonctionnalité RTC. Renvoyé uniquement lorsque RTC est en cours d'activation ou activé.

Par défaut : disabled. Valeurs valides :

  • enabling

  • enabled

  • disabled

Nœuds parents : RTC

Nœuds enfants : aucun

Exemples

  • Exemple de requête

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****************
  • Exemple de réponse

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>

Kits SDK OSS

Appelez GetBucketReplication avec les kits SDK OSS suivants :

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération GetBucketReplication, consultez get-bucket-replication.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

NoSuchBucket

404 NotFound

Le compartiment spécifié n'existe pas.

NoSuchReplicationConfiguration

404 NotFound

Aucune règle de réplication des données n'est configurée pour le compartiment spécifié.