Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:GetBucketReplicationProgress

Son Güncelleme:Oct 01, 2026

Bir paketin veri çoğaltma görevinin ilerleme durumunu sorgular.

İstek sözdizimi

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

İstek üst bilgileri

GetBucketReplicationProgress isteğindeki tüm üst bilgiler ortak istek üst bilgileridir. Daha fazla bilgi için bkz. Ortak istek üst bilgileri.

İstek parametreleri


Parametre


Tür


Zorunlu


Açıklama


rule-id


Dize


Evet


Veri çoğaltma kuralının ID değeri. ID değerini sorgulamak için GetBucketReplication işlemini çağırabilirsiniz.

Yanıt üst bilgileri

GetBucketReplicationProgress isteğine verilen yanıtta yer alan tüm üst bilgiler ortak yanıt üst bilgileridir. Daha fazla bilgi için bkz. Ortak yanıt üst bilgileri.

Yanıt parametreleri

Parametre

Tür

Açıklama

ReplicationProgress

Konteyner

Veri çoğaltma görevlerinin ilerleme durumunu depolamak için kullanılan konteyner.

Üst düğümler: yok

Alt düğümler: Rule

Rule

Konteyner

Her bir veri çoğaltma kuralına karşılık gelen veri çoğaltma görevinin ilerleme durumunu depolayan konteyner.

Üst düğümler: ReplicationConfiguration

Alt düğümler: ID, Destination, Status ve Progress

ID

Dize

Veri çoğaltma kuralının ID değeri.

Üst düğümler: Rule

Alt düğümler: yok

PrefixSet

Konteyner

Önekleri depolayan konteyner. Her bir veri çoğaltma kuralında en fazla 10 önek belirtebilirsiniz.

Üst düğümler: Rule

Alt düğümler: Prefix

Prefix

Dize

Çoğaltılacak nesneyi belirtmek için kullanılan önek. Yalnızca önekle eşleşen nesneler hedef pakete çoğaltılır.

Üst düğümler: PrefixSet

Alt düğümler: yok

Action

Dize

Hedef pakete senkronize edilen işlemler.

Action parametresini aşağıdaki işlem türlerinden birine veya birkaçına ayarlayabilirsiniz. Varsayılan değer: ALL.

  • ALL: PUT, DELETE ve ABORT işlemleri hedef pakete senkronize edilir.

  • PUT: Yazma işlemleri hedef pakete senkronize edilir. Bu işlemler şunlardır: PutObject, PostObject, AppendObject, CopyObject, PutObjectACL, InitiateMultipartUpload, UploadPart, UploadPartCopy ve CompleteMultipartUpload.

Üst düğümler: Rule

Alt düğümler: yok

Destination

Konteyner

Hedef paketle ilgili bilgileri depolayan konteyner.

Üst düğümler: Rule

Alt düğümler: Bucket ve Location

Bucket

Dize

Verilerin çoğaltıldığı hedef paket.

Üst düğümler: Destination

Alt düğümler: yok

Location

Dize

Hedef paketin bulunduğu bölge.

Üst düğümler: Destination

Alt düğümler: yok

TransferType

Dize

Veri çoğaltma sırasında verileri aktarmak için kullanılan veri aktarım türü.

  • internal: Object Storage Service (OSS) varsayılan veri aktarım bağlantısını kullanan veri aktarım türü.

  • oss_acc: Veri iletiminin hızlandırıldığı bağlantı. TransferType parametresini oss_acc olarak yalnızca CRR kuralları oluştururken ayarlayabilirsiniz.

HistoricalObjectReplication

Dize

Veri çoğaltma etkinleştirilmeden önce kaynak paketteki geçmiş verilerin hedef pakete çoğaltılıp çoğaltılmadığını gösterir.

Varsayılan değer: enabled. Geçerli değerler:

  • enabled: Geçmiş verilerin hedef pakete çoğaltıldığını gösterir.

  • disabled: Geçmiş verilerin hedef pakete çoğaltılmadığını gösterir. Yalnızca kaynak paket için veri çoğaltma etkinleştirildikten sonra kaynak pakete yüklenen veriler çoğaltılır.

Progress

Konteyner

Veri çoğaltma görevinin ilerleme durumunu depolayan konteyner. Bu parametre yalnızca veri çoğaltma görevi doing durumundayken döndürülür.

Üst düğümler: Rule

Alt düğümler: HistoricalObject ve NewObject

HistoricalObject

Dize

Çoğaltılan geçmiş verilerin yüzdesi. Bu öğe yalnızca HistoricalObjectReplication değeri enabled olarak ayarlandığında geçerlidir.

Üst düğümler: Progress

Alt düğümler: yok

NewObject

Dize

Verilerin hedef pakete çoğaltılıp çoğaltılmadığını belirlemek için kullanılan zaman. Bu zamandan önce kaynak pakete yazılan veriler hedef pakete çoğaltılır. Bu öğenin değeri GMT biçimindedir.

Örnek: Thu, 24 Sep 2015 15:39:18 GMT.

Üst düğümler: Progress

Alt düğümler: yok

Açıklama

  • Örnek istekler

    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****************
  • Örnek yanıtlar

    Not

    TransferType parametresi yalnızca istekte TransferType değeri oss_acc olarak ayarlandığında yanıtın XML gövdesinde yer alır.

    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>

OSS SDK'ları

GetBucketReplicationProgress işlemini çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanabilirsiniz:

ossutil

GetBucketReplicationProgress işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. get-bucket-replication-progress.

Hata kodları


Hata kodu


HTTP durum kodu


Açıklama


NoSuchBucket


404 NotFound


Belirtilen paket mevcut olmadığı için döndürülen hata mesajı.


NoSuchReplicationRule


404 NotFound


Belirtilen kural ID değeri mevcut olmadığı için döndürülen hata mesajı.


NoSuchReplicationConfiguration


404 NotFound


Belirtilen paket için herhangi bir veri çoğaltma kuralı yapılandırılmadığı için döndürülen hata mesajı.


TooManyReplicationRules


400 BadRequest

İstekte birden fazla veri çoğaltma kuralı yapılandırıldığı için döndürülen hata mesajı.

Tek bir istekte yalnızca bir veri çoğaltma kuralı yapılandırabilirsiniz.