Run the replication command to manage CRR rules - Object Storage Service

Notlar

Bir veri çoğaltma kuralı oluşturmak veya bir paket için Replication Time Control (RTC) özelliğini etkinleştirmek üzere oss:PutBucketReplication iznine sahip olmanız gerekir. Bir paketin veri çoğaltma kurallarını sorgulamak için oss:GetBucketReplication iznine, paketin veri çoğaltma kurallarını silmek için oss:DeleteBucketReplication iznine ve pakette gerçekleştirilen bir veri çoğaltma görevinin ilerleme durumunu sorgulamak için oss:GetBucketReplicationProgress iznine ihtiyacınız vardır. Verilerin çoğaltılabileceği paketlerin bölgelerini sorgulamak için oss:GetBucketReplicationLocation izni gereklidir. Daha fazla bilgi için bkz. Özel ilke atama.
ossutil 1.6.16 ve sonraki sürümlerde, komut satırında ikili dosya adı olarak doğrudan ossutil kullanabilirsiniz. İşletim sistemine göre ikili dosya adını güncellemeniz gerekmez. 1.6.16'dan önceki ossutil sürümlerinde ise işletim sistemine göre ikili dosya adını güncellemeniz gerekir. Daha fazla bilgi için bkz. ossutil komut referansı.

Veri çoğaltma kuralı ekleme

Veri çoğaltma kuralları, verileri bir kaynak paketten bir veya daha fazla hedef pakete çoğaltmanıza olanak tanır. Bir paket için en fazla 100 veri çoğaltma kuralı yapılandırabilirsiniz. Veri çoğaltma hakkında daha fazla bilgi için bkz. CRR.

Veri çoğaltma kuralı eklemek için öncelikle yerel bir dosya oluşturup bu dosyaya eklemek istediğiniz kuralı belirtmeniz gerekir. Ardından kuralı kaynak pakete ekleyin.

Komut sözdizimi

ossutil replication --method put oss://bucketname local_xml_file

Aşağıdaki tabloda önceki komutta yer alan parametreler açıklanmaktadır.

Parametre

Açıklama

bucketname

Veri çoğaltma kuralları oluşturmak istediğiniz paketin adı.

local_xml_file

Veri çoğaltma kurallarının depolandığı yerel dosyanın adı. Örnek: localfile.xml.

Daha fazla bilgi için bkz. PutBucketReplication.

Örnekler
1. Yerel bilgisayarınızda localfile.xml adlı bir dosya oluşturun ve iş gereksinimlerinize göre bu dosyada bir veri çoğaltma kuralı yapılandırın.
  Aşağıdaki kod, bir veri çoğaltma kuralının nasıl yapılandırılacağını gösterir. Bu kural, kaynak pakette adı srcdir önekiyle başlayan nesneler üzerinde gerçekleştirilen oluşturma ve değiştirme işlemlerini Çin (Hangzhou) bölgesinde bulunan destbucket adlı bir hedef pakete çoğaltmanıza olanak tanır. Ayrıca bu kural, aktarım hızlandırmanın etkin olduğunu ve geçmiş verilerin hedef pakete çoğaltıldığını belirtir.
```
 <?xml version="1.0" encoding="UTF-8"?>
 <ReplicationConfiguration>
    <Rule>
         <PrefixSet>
             <Prefix>srcdir</Prefix>             
         </PrefixSet>
         <Action>PUT</Action>
         <Destination>
             <Bucket>destbucket</Bucket>
             <Location>oss-cn-hangzhou</Location>
             <TransferType>oss_acc</TransferType>
         </Destination>
         <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
    </Rule>
 </ReplicationConfiguration>
```
2. Veri çoğaltma kuralını srcbucket adlı bir kaynak pakete ekleyin:
```
ossutil replication --method put oss://srcbucket localfile.xml
```
Örnek çıktı

Aşağıdaki çıktı, srcbucket paketi için veri çoğaltma kuralının oluşturulduğunu gösterir:
```
0.856895(s) elapsed
```

RTC'yi etkinleştirme veya devre dışı bırakma

Not

Bir CRR görevi yapılandırırken Replication Time Control (RTC) özelliğini etkinleştirebilirsiniz. Mevcut CRR görevleri için de RTC'yi etkinleştirmeniz mümkündür. RTC'yi, bir paketteki tüm nesneleri çoğaltmak veya belirli etiketlere sahip ya da adları belirli önekler içeren nesneleri çoğaltmak amacıyla CRR görevleri için kullanabilirsiniz.

Komut sözdizimi

ossutil replication --method put --item rtc oss://bucketname local_xml_file

Aşağıdaki tabloda önceki komutta yer alan parametreler açıklanmaktadır.

Parametre

Açıklama

bucketname

RTC'yi etkinleştirmek veya devre dışı bırakmak istediğiniz kaynak paketin adı.

local_xml_file

RTC yapılandırmalarını depolayan yerel dosyanın adı. Örnek: localfile.xml.

Daha fazla bilgi için bkz. PutBucketReplication.

Örnekler

Yerel dosyayı yapılandırın.

RTC'yi etkinleştirme

<?xml version="1.0" encoding="UTF-8"?>
<ReplicationRule>
    <RTC>
        <Status>enabled</Status>
    </RTC>
    <ID>test-replication-id</ID>
</ReplicationRule>

RTC'yi devre dışı bırakma

<?xml version="1.0" encoding="UTF-8"?>
<ReplicationRule>
    <RTC>
        <Status>disabled</Status>
    </RTC>
    <ID>test-replication-id</ID>
</ReplicationRule>

srcbucket adlı bir kaynak paket için RTC'yi etkinleştirin veya devre dışı bırakın:
```
ossutil replication --method put --item rtc oss://srcbucket local.xml
```

Örnek çıktı
```
0.856895(s) elapsed
```

Bir paketin veri çoğaltma kurallarını sorgulama

Komut sözdizimi

ossutil replication --method get oss://bucketname

Örnekler

srcbucket paketinin veri çoğaltma kurallarını sorgulamak ve görüntülemek için aşağıdaki komutu çalıştırın:

ossutil replication --method get oss://srcbucket

Aşağıdaki örnek çıktı, srcbucket paketinin veri çoğaltma kurallarının sorgulandığını gösterir:

<?xml version="1.0" encoding="UTF-8"?>
<ReplicationConfiguration>
  <Rule>
    <ID>37417af4-f2dc-4b24-92d3-82092af6****</ID>
    <Action>ALL</Action>
    <Destination>
      <Bucket>destbucket</Bucket>
      <Location>oss-cn-beijing</Location>
    </Destination>
    <Status>doing</Status>
    <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
  </Rule>
</ReplicationConfiguration>

0.069195(s) elapsed

Verilerin çoğaltılabileceği bölgeleri sorgulama

Komut sözdizimi

ossutil replication --method get --item location oss://bucketname

Örnekler

srcbucket paketindeki verilerin çoğaltılabileceği paketlerin bölgelerini sorgulamak için aşağıdaki komutu çalıştırın:

ossutil replication --method get --item location oss://srcbucket

Aşağıdaki örnek çıktı, verilerin çoğaltılabileceği paketlerin bölgelerinin sorgulandığını gösterir:

<?xml version="1.0" ?>
<ReplicationLocation>
  <Location>oss-cn-beijing</Location>
  <Location>oss-cn-qingdao</Location>
  <Location>oss-cn-shenzhen</Location>
  <Location>oss-cn-hongkong</Location>
  <Location>oss-us-west-1</Location>
  <LocationTransferTypeConstraint>
    <LocationTransferType>
      <Location>oss-cn-hongkong</Location>
        <TransferTypes>
          <Type>oss_acc</Type>          
        </TransferTypes>
      </LocationTransferType>
      <LocationTransferType>
        <Location>oss-us-west-1</Location>
        <TransferTypes>
          <Type>oss_acc</Type>
        </TransferTypes>
      </LocationTransferType>
    </LocationTransferTypeConstraint>
  </ReplicationLocation>

0.226523(s) elapsed

Bir pakette gerçekleştirilen veri çoğaltma görevinin ilerleme durumunu sorgulama

Komut sözdizimi

ossutil replication --method get --item progress oss://bucketname [ruleID]

Aşağıdaki tabloda önceki komutta yer alan parametreler açıklanmaktadır.

Parametre	Açıklama
bucketname	Veri çoğaltma ilerleme durumunu sorgulamak istediğiniz paketin adı.
ruleID	Veri çoğaltma kuralının kimliği. Kural kimliğini belirttiğinizde ilgili kurala ait çoğaltma ilerleme durumu sorgulanır. Bir kural kimliği belirtmezseniz paket için tanımlanan tüm veri çoğaltma kurallarına ait çoğaltma ilerleme durumu sorgulanır. Çoğaltma ilerleme durumu yalnızca ekranda görüntülenir.

Örnekler

srcbucket paketi için belirli bir veri çoğaltma kuralına ait ilerleme durumunu sorgulamak üzere aşağıdaki komutu çalıştırın:

ossutil replication --method get --item progress oss://srcbucket 37417af4-f2dc-4b24-92d3-82092af6****

srcbucket paketi için tüm veri çoğaltma kurallarına ait ilerleme durumunu sorgulamak üzere aşağıdaki komutu çalıştırın:

ossutil replication --method get --item progress oss://srcbucket

Aşağıdaki çıktı görüntülenirse veri çoğaltma etkinleştirilmeden önce srcbucket paketinden destbucket paketindeki geçmiş verilerin çoğaltılma ilerlemesi %100'dür. Veri çoğaltma etkinleştirildikten sonra 9 Ağustos 2021 tarihinde saat 06:00:59'dan (UTC+8) önce srcbucket paketine yazılan veriler destbucket adlı hedef pakete çoğaltılır.

<?xml version="1.0" encoding="UTF-8"?>
<ReplicationProgress>
  <Rule>
    <ID>37417af4-f2dc-4b24-92d3-82092af6****</ID>
    <Action>ALL</Action>
    <Destination>
      <Bucket>destbucket</Bucket>
      <Location>oss-cn-beijing</Location>
    </Destination>
    <Status>doing</Status>
    <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
    <Progress>
      <HistoricalObject>1.00</HistoricalObject>
      <NewObject>2021-08-09T06:00:59.000Z</NewObject>
    </Progress>
  </Rule>
</ReplicationProgress>

0.125002(s) elapsed

Veri çoğaltma kuralı silme

Komut sözdizimi

ossutil replication --method delete oss://bucketname ruleID

Örnekler

srcbucket paketi için yapılandırılmış belirli bir veri çoğaltma kuralını silmek üzere aşağıdaki komutu çalıştırın:
```
ossutil replication --method delete oss://srcbucket 37417af4-f2dc-4b24-92d3-82092af6****
```
Aşağıdaki örnek çıktı belirtilen veri çoğaltma kuralının silindiğini gösterir.
```
0.069195(s) elapsed
```

Ortak seçenekler

Farklı bir bölgedeki bir pakete erişmek için uç noktayı belirtmek üzere -e seçeneğini kullanın. Farklı bir Alibaba Cloud hesabına ait bir pakete erişmek için AccessKey ID değeri için -i ve AccessKey secret değeri için -k seçeneğini kullanın.

Örneğin başka bir Alibaba Cloud hesabına ait ve Çin (Şanghay) bölgesinde bulunan testbucket paketi için localfile.txt dosyasındaki bir veri çoğaltma kuralını oluşturmak amacıyla aşağıdaki komutu çalıştırabilirsiniz:

ossutil replication --method put oss://testbucket localfile.txt -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Ortak seçenekler.