全部产品
Search
文档中心

Object Storage Service:put-bucket-replication

更新时间:Jul 06, 2025

Mengonfigurasi aturan replikasi data untuk sebuah bucket. Object Storage Service (OSS) menyediakan dua fitur replikasi data: replikasi lintas wilayah (CRR) dan replikasi dalam wilayah yang sama (SRR).

Catatan penggunaan

Untuk informasi lebih lanjut tentang replikasi data, lihat CRR dan SRR.

Izin

Secara default, akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API

Aksi

Definisi

PutBucketReplication

oss:PutBucketReplication

Mengonfigurasi aturan replikasi data untuk sebuah bucket.

oss:ReplicateGet

Jika replikasi lintas akun digunakan, atau jika replikasi dengan Peran RAM tertentu digunakan, baik bucket sumber maupun bucket tujuan memerlukan izin ini.

Sintaks perintah

ossutil api put-bucket-replication --bucket nilai --replication-configuration nilai [flags]

Parameter

Tipe

Deskripsi

--bucket

string

Nama bucket.

--replication-configuration

string

Konfigurasi replikasi data.

Catatan

Perintah put-bucket-replication sesuai dengan operasi PutBucketReplication. Untuk informasi lebih lanjut tentang parameter dalam operasi PutBucketReplication, lihat PutBucketReplication.

--replication-configuration

Opsi konfigurasi --replication-configuration mendukung format XML dan JSON.

  • Format XML:

    <ReplicationConfiguration>
        <Rule>
            <PrefixSet>
                <Prefix>string</Prefix>
                <Prefix>string</Prefix>
            </PrefixSet>
            <Action>string</Action>
            <Destination>
                <Bucket>string</Bucket>
                <Location>string</Location>
                <TransferType>string</TransferType>
            </Destination>
            <HistoricalObjectReplication>string</HistoricalObjectReplication>
        </Rule>
    </ReplicationConfiguration>
  • Format JSON:

    {
        "Rule": {
            "PrefixSet": {
                "Prefix": [
                    "string",
                    "string"
                ]
            },
            "Action": "string",
            "Destination": {
                "Bucket": "string",
                "Location": "string",
                "TransferType": "string"
            },
            "HistoricalObjectReplication": "enabled"
        }
    }
Catatan

Untuk informasi lebih lanjut, lihat Opsi Baris Perintah.

Contoh

Contoh berikut menunjukkan cara mengonfigurasi aturan replikasi data untuk bucket bernama examplebucket.

  • Buat file konfigurasi bernama replication-configuration.xml dan tambahkan kode berikut ke file konfigurasi:

    <?xml version="1.0" encoding="UTF-8"?>
    <ReplicationConfiguration>
        <Rule>     
            <PrefixSet>
                <Prefix>prefix_1</Prefix>
                <Prefix>prefix_2</Prefix>
            </PrefixSet>
            <Action>PUT</Action>
            <Destination>
                <Bucket>destBucket</Bucket>
                <Location>oss-cn-hangzhou</Location>
                <TransferType>oss_acc</TransferType>
            </Destination>
            <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
        </Rule>
    </ReplicationConfiguration>
    ossutil api put-bucket-replication --bucket examplebucket --replication-configuration file://replication-configuration.xml
  • Buat file konfigurasi bernama replication-configuration.json dan tambahkan kode berikut ke file konfigurasi:

    {
        "Rule": {
            "PrefixSet": {
                "Prefix": [
                    "prefix_1",
                    "prefix_2"
                ]
            },
            "Action": "PUT",
            "Destination": {
                "Bucket": "destBucket",
                "Location": "oss-cn-hangzhou",
                "TransferType": "oss_acc"
            },
            "HistoricalObjectReplication": "enabled"
        }
    }
    
    ossutil api put-bucket-replication --bucket examplebucket --replication-configuration file://replication-configuration.json
  • Konfigurasikan parameter dalam perintah berikut dalam format JSON:

    ossutil api put-bucket-replication --bucket examplebucket --replication-configuration "{\"Rule\":{\"PrefixSet\":{\"Prefix\":[\"prefix_1\",\"prefix_2\"]},\"Action\":\"PUT\",\"Destination\":{\"Bucket\":\"destBucket\",\"Location\":\"oss-cn-hangzhou\",\"TransferType\":\"oss_acc\"},\"HistoricalObjectReplication\":\"enabled\"}}"