Run the put-bucket-replication command to configure data replication rules for a bucket - Object Storage Service: Central de Documentação do Alibaba Cloud

configure regras de replicação de dados para um bucket. O Object Storage Service (OSS) oferece dois recursos de replicação de dados: replicação entre regiões (CRR) e replicação na mesma região (SRR).

Notas de uso

Para obter mais informações sobre replicação de dados, consulte CRR e SRR.

Permissões

Por padrão, uma conta Alibaba Cloud possui permissões totais. Usuários RAM ou funções RAM associados a uma conta Alibaba Cloud não possuem permissão alguma por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de RAM policies ou Bucket Policy.

API	Ação	Descrição
PutBucketReplication	`oss:PutBucketReplication`	configure regras de replicação de dados para um bucket.
PutBucketReplication	`oss:ReplicateGet`	Ao usar a replicação entre contas ou a replicação com uma função RAM específica, tanto o bucket source quanto o de destino exigem essa permissão.

Sintaxe do comando

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

Parâmetro	Tipo	Descrição
--bucket	string	O nome do bucket.
--replication-configuration	string	As configurações de replicação de dados.

Nota

O comando put-bucket-replication corresponde à operação PutBucketReplication. Para obter mais informações sobre os parâmetros da operação PutBucketReplication, consulte PutBucketReplication.

--replication-configuration

A opção de configuração --replication-configuration aceita os formatos XML e json.

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

Formato json:

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

Nota

Para obter mais informações, consulte Command-line options.

Exemplos

Os exemplos a seguir mostram como configure regras de replicação de dados para um bucket chamado examplebucket.

Crie um arquivo de configuração chamado replication-configuration.xml e adicione o seguinte código ao arquivo:

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

Crie um arquivo de configuração chamado replication-configuration.json e adicione o seguinte código ao arquivo:

{
    "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

configure os parâmetros do comando a seguir no formato 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\"}}"