GetBucketReplicationProgress - Object Storage Service: Central de Documentação do Alibaba Cloud

Sintaxe da requisição

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

Cabeçalhos da requisição

Todos os cabeçalhos em uma requisição GetBucketReplicationProgress são cabeçalhos comuns de requisição. Para mais informações, consulte Cabeçalhos comuns de requisição.

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Descrição
rule-id	String	Sim	ID da regra de replicação de dados. Chame a operação GetBucketReplication para consultar o ID.

Cabeçalhos da resposta

Todos os cabeçalhos na resposta de uma requisição GetBucketReplicationProgress são cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.

Parâmetros da resposta

Parâmetro	Tipo	Descrição
ReplicationProgress	Container	Armazena o progresso das tarefas de replicação de dados. Nós pai: nenhum Nós filho: Rule
Rule	Container	Armazena o progresso da tarefa de replicação correspondente a cada regra. Nós pai: ReplicationConfiguration Nós filho: ID, Destination, Status e Progress
ID	String	ID da regra de replicação de dados. Nós pai: Rule Nós filho: nenhum
PrefixSet	Container	Armazena prefixos. Especifique até 10 prefixos em cada regra de replicação de dados. Nós pai: Rule Nós filho: Prefix
Prefix	String	Prefixo usado para especificar o objeto a ser replicado. Apenas objetos correspondentes ao prefixo são replicados para o bucket de destino. Nós pai: PrefixSet Nós filho: nenhum
Action	String	Operações sincronizadas com o bucket de destino. Defina Action como um ou mais dos seguintes tipos de operação. Valor padrão: ALL. ALL: as operações PUT, DELETE e ABORT são sincronizadas com o bucket de destino. PUT: as operações de escrita 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
Destination	Container	Armazena informações sobre o bucket de destino. Nós pai: Rule Nós filho: Bucket e Location
Bucket	String	Bucket de destino para o qual os dados são replicados. Nós pai: Destination Nós filho: nenhum
Location	String	Região onde o bucket de destino está localizado. Nós pai: Destination Nós filho: nenhum
TransferType	String	Tipo de transferência de dados utilizado na replicação. internal: tipo de transferência que utiliza o link de transferência de dados padrão do Object Storage Service (OSS). oss_acc: link com transmissão de dados acelerada. Defina o parâmetro TransferType como oss_acc apenas ao criar regras CRR.
HistoricalObjectReplication	String	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 de dados. Valor padrão: enabled. Valores válidos: enabled: indica que os dados históricos são replicados para o bucket de destino. disabled: indica que os dados históricos não são replicados para o bucket de destino. Apenas os dados enviados ao bucket de origem após a ativação da replicação são replicados.
Progress	Container	Armazena o progresso da tarefa de replicação de dados. Este parâmetro é retornado apenas quando a tarefa de replicação está no estado doing. Nós pai: Rule Nós filho: HistoricalObject e NewObject
HistoricalObject	String	Porcentagem dos dados históricos replicados. Este elemento é válido apenas quando HistoricalObjectReplication está definido como enabled. Nós pai: Progress Nós filho: nenhum
NewObject	Timestamp usado para determinar se os dados foram replicados para o bucket de destino. Os dados gravados no bucket de origem antes deste horário são replicados para o bucket de destino. O valor deste elemento está no formato GMT. Exemplo: Thu, 24 Sep 2015 15:39:18 GMT. Nós pai: Progress Nós filho: nenhum

Descrição

Exemplos de requisição

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

Exemplos de resposta

Nota

O parâmetro TransferType consta no corpo XML da resposta apenas quando o valor de TransferType for definido como oss_acc na requisição.

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>

SDKs do OSS

Use os SDKs do OSS nas linguagens de programação abaixo para chamar GetBucketReplicationProgress:

ossutil

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

Códigos de erro

Código de erro	Código de status HTTP	Descrição
NoSuchBucket	404 NotFound	O bucket especificado não existe.
NoSuchReplicationRule	404 NotFound	O ID da regra especificado não existe.
NoSuchReplicationConfiguration	404 NotFound	Nenhuma regra de replicação de dados está configurada para o bucket especificado.
TooManyReplicationRules	400 BadRequest	Mais de uma regra de replicação de dados foi configurada na requisição. Configure apenas uma regra de replicação de dados por requisição.