GetBucketReplicationProgress - Object Storage Service - Centre de documentation Alibaba Cloud

Syntaxe de la requête

GET /?replicationProgress&rule-id=RuleId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

Une requête GetBucketReplicationProgress utilise uniquement des en-têtes de requête courants. Pour plus d'informations, consultez En-têtes de requête courants.

Paramètres de requête

Paramètre

Type

Obligatoire

Description

rule-id

String

Oui

ID de la règle de réplication des données. Appelez l'opération GetBucketReplication pour obtenir cet ID.

En-têtes de réponse

La réponse à une requête GetBucketReplicationProgress contient uniquement des en-têtes de réponse courants. Pour plus d'informations, consultez En-têtes de réponse courants.

Paramètres de réponse

Paramètre	Type	Description
ReplicationProgress	Container	Conteneur stockant la progression des tâches de réplication des données. Nœuds parents : aucun Nœuds enfants : Rule
Rule	Container	Conteneur contenant la progression de la tâche de réplication associée à chaque règle. Nœuds parents : ReplicationConfiguration Nœuds enfants : ID, Destination, Status et Progress
ID	String	Identifiant de la règle de réplication des données. Nœuds parents : Rule Nœuds enfants : aucun
PrefixSet	Container	Conteneur regroupant les préfixes. Chaque règle de réplication accepte jusqu'à 10 préfixes. Nœuds parents : Rule Nœuds enfants : Prefix
Prefix	String	Préfixe servant à cibler les objets à répliquer. Seuls les objets correspondant à ce préfixe sont répliqués vers le bucket de destination. Nœuds parents : PrefixSet Nœuds enfants : aucun
Action	String	Opérations synchronisées avec le bucket de destination. Le paramètre Action accepte un ou plusieurs types d'opérations parmi les suivants. Valeur par défaut : ALL. ALL : les opérations PUT, DELETE et ABORT sont synchronisées vers le bucket de destination. PUT : les opérations d'écriture sont synchronisées vers le bucket de destination, notamment PutObject, PostObject, AppendObject, CopyObject, PutObjectACL, InitiateMultipartUpload, UploadPart, UploadPartCopy et CompleteMultipartUpload. Nœuds parents : Rule Nœuds enfants : aucun
Destination	Container	Conteneur renfermant les informations relatives au bucket de destination. Nœuds parents : Rule Nœuds enfants : Bucket et Location
Bucket	String	Bucket de destination recevant les données répliquées. Nœuds parents : Destination Nœuds enfants : aucun
Location	String	Région où se trouve le bucket de destination. Nœuds parents : Destination Nœuds enfants : aucun
TransferType	String	Type de transfert utilisé pour acheminer les données lors de la réplication. internal : utilise le lien de transfert de données par défaut d'Object Storage Service (OSS). oss_acc : active un lien avec accélération du transfert. Ce type n'est disponible que lors de la création de règles CRR.
HistoricalObjectReplication	String	Indique si les données historiques du bucket source sont répliquées vers le bucket de destination avant l'activation de la réplication. Valeur par défaut : enabled. Valeurs valides : enabled : les données historiques sont répliquées vers le bucket de destination. disabled : les données historiques ne sont pas répliquées. Seules les données chargées dans le bucket source après l'activation de la réplication sont concernées.
Progress	Container	Conteneur indiquant la progression de la tâche de réplication. Ce paramètre n'apparaît que lorsque la tâche est en cours d'exécution (état doing). Nœuds parents : Rule Nœuds enfants : HistoricalObject et NewObject
HistoricalObject	String	Pourcentage de données historiques déjà répliquées. Cet élément n'est pertinent que si HistoricalObjectReplication vaut enabled. Nœuds parents : Progress Nœuds enfants : aucun
NewObject	String	Horodatage servant de référence pour la réplication. Les données écrites dans le bucket source avant cette date sont répliquées vers la destination. La valeur suit le format GMT. Exemple : Thu, 24 Sep 2015 15:39:18 GMT. Nœuds parents : Progress Nœuds enfants : aucun

Description

Exemples de requêtes

GET /?replicationProgress&rule-id=test_replication_1 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 24 Sep 2015 15:39:15 GMT
Authorization: OSS qn6q**************:77Dv****************

Exemples de réponses

Remarque

Le paramètre TransferType apparaît dans le corps XML de la réponse uniquement s'il a été défini sur oss_acc dans la requête.

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 24 Sep 2015 15:39:15 GMT
Content-Length: 234
Content-Type: application/xml
Connection: close
Server: AliyunOSS

<?xml version="1.0" ?>
<ReplicationProgress>
 <Rule>
   <ID>test_replication_1</ID>
   <PrefixSet>
    <Prefix>source_image</Prefix>
    <Prefix>video</Prefix>
   </PrefixSet>
   <Action>PUT</Action>
   <Destination>
    <Bucket>target-bucket</Bucket>
    <Location>oss-cn-beijing</Location>
    <TransferType>oss_acc</TransferType>
   </Destination>
   <Status>doing</Status>
   <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
   <Progress>
    <HistoricalObject>0.85</HistoricalObject>
    <NewObject>2015-09-24T15:28:14.000Z </NewObject>
   </Progress>
 </Rule>
</ReplicationProgress>

SDK OSS

Les SDK OSS suivants permettent d'appeler l'opération GetBucketReplicationProgress :

ossutil

Pour connaître la commande ossutil correspondant à l'opération GetBucketReplicationProgress, reportez-vous à get-bucket-replication-progress.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

NoSuchBucket

404 NotFound

Le bucket spécifié n'existe pas.

NoSuchReplicationRule

404 NotFound

L'ID de règle indiqué est introuvable.

NoSuchReplicationConfiguration

404 NotFound

Aucune règle de réplication n'est configurée pour ce bucket.

TooManyReplicationRules

400 BadRequest

La requête contient plusieurs règles de réplication.

Une seule règle de réplication est autorisée par requête.