GetBucketReplicationProgress - Object Storage Service - Centro de documentación de Alibaba Cloud

Consulta el progreso de una tarea de replicación de datos de un bucket.

Sintaxis de la solicitud

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

Encabezados de solicitud

Todos los encabezados de una solicitud GetBucketReplicationProgress son encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
rule-id	String	Sí	ID de la regla de replicación de datos. Llame a la operación GetBucketReplication para consultar este ID.

Encabezados de respuesta

Todos los encabezados de la respuesta a una solicitud GetBucketReplicationProgress son encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Parámetros de respuesta

Parámetro	Tipo	Descripción
ReplicationProgress	Container	Contenedor que almacena el progreso de las tareas de replicación de datos. Nodos padre: Ninguna Nodos hijo: Rule
Rule	Container	Contenedor que almacena el progreso de la tarea de replicación correspondiente a cada regla. Nodos padre: ReplicationConfiguration Nodos hijo: ID, Destination, Status y Progress
ID	String	ID de la regla de replicación de datos. Nodos padre: Rule Nodos hijo: Ninguna
PrefixSet	Container	Contenedor que almacena prefijos. Especifique hasta 10 prefijos en cada regla de replicación de datos. Nodos padre: Rule Nodos hijo: Prefix
Prefix	String	Prefijo utilizado para especificar el objeto por replicar. Solo se replican al bucket de destino los objetos que coinciden con este prefijo. Nodos padre: PrefixSet Nodos hijo: Ninguna
Action	String	Operaciones sincronizadas con el bucket de destino. Establezca Action en uno o más de los siguientes 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: Ninguna
Destination	Container	Contenedor que almacena información sobre el bucket de destino. Nodos padre: Rule Nodos hijo: Bucket y Location
Bucket	String	Bucket de destino al que se replican los datos. Nodos padre: Destination Nodos hijo: Ninguna
Location	String	Región donde se encuentra el bucket de destino. Nodos padre: Destination Nodos hijo: Ninguna
TransferType	String	Tipo de transferencia utilizado en la replicación de datos. internal: utiliza el enlace de transferencia predeterminado de Object Storage Service (OSS). oss_acc: enlace con transmisión de datos acelerada. Establezca el parámetro TransferType en oss_acc solo al crear reglas CRR.
HistoricalObjectReplication	String	Indica si los datos históricos del bucket de origen se replican al bucket de destino antes de habilitar la replicación de datos. Valor predeterminado: enabled. Valores válidos: enabled: los datos históricos se replican al bucket de destino. disabled: los datos históricos no se replican al bucket de destino. Solo se replican los datos cargados en el bucket de origen después de habilitar la replicación.
Progress	Container	Contenedor que almacena el progreso de la tarea de replicación de datos. Este parámetro se devuelve solo cuando la tarea está en estado doing. Nodos padre: Rule Nodos hijo: HistoricalObject y NewObject
HistoricalObject	String	Porcentaje de datos históricos replicados. Este elemento es válido solo cuando HistoricalObjectReplication se establece en enabled. Nodos padre: Progress Nodos hijo: Ninguna
NewObject	String	Hora de referencia para determinar la replicación de datos al bucket de destino. Los datos escritos en el bucket de origen antes de esta hora se replican. El valor tiene formato GMT. Ejemplo: Thu, 24 Sep 2015 15:39:18 GMT. Nodos padre: Progress Nodos hijo: Ninguna

Descripción

Solicitudes de ejemplo

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

Respuestas de ejemplo

Nota

El parámetro TransferType se incluye en el cuerpo XML de la respuesta solo cuando su valor se establece en oss_acc en la solicitud.

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 de OSS

Use los SDK de OSS para los siguientes lenguajes de programación a fin de llamar a GetBucketReplicationProgress:

ossutil

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

Códigos de error

Código de error	Código de estado HTTP	Descripción
NoSuchBucket	404 NotFound	El bucket especificado no existe.
NoSuchReplicationRule	404 NotFound	El ID de regla especificado no existe.
NoSuchReplicationConfiguration	404 NotFound	No hay reglas de replicación de datos configuradas para el bucket especificado.
TooManyReplicationRules	400 BadRequest	Se configuró más de una regla de replicación de datos en la solicitud. Solo configure una regla de replicación de datos por solicitud.