Exécutez la commande put-bucket-replication pour configurer les règles de réplication des données d'un bucket - Object Storage Service

Configure les règles de réplication des données d'un bucket. Object Storage Service (OSS) propose deux fonctionnalités de réplication des données : la réplication inter-régions (CRR) et la réplication intra-région (SRR).

Notes d'utilisation

Pour plus d'informations sur la réplication des données, consultez les rubriques CRR et SRR.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des stratégies RAM ou une Bucket Policy.

API	Action	Description
PutBucketReplication	`oss:PutBucketReplication`	Configure les règles de réplication des données d'un bucket.
PutBucketReplication	`oss:ReplicateGet`	Si vous utilisez la réplication inter-comptes ou la réplication avec un rôle RAM spécifié, le bucket source et le bucket de destination nécessitent tous deux cette autorisation.

Syntaxe de la commande

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

Paramètre

Type

Description

--bucket

string

Nom du bucket.

--replication-configuration

string

Configurations de réplication des données.

Remarque

La commande put-bucket-replication correspond à l'opération PutBucketReplication. Pour plus d'informations sur les paramètres de l'opération PutBucketReplication, consultez la rubrique PutBucketReplication.

--replication-configuration

L'option de configuration --replication-configuration prend en charge les formats XML et 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"
    }
}

Remarque

Pour plus d'informations, consultez la rubrique Options de ligne de commande.

Exemples

Les exemples suivants montrent comment configurer les règles de réplication des données pour un bucket nommé examplebucket.

Créez un fichier de configuration nommé replication-configuration.xml et ajoutez le code suivant au fichier de configuration :

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

Créez un fichier de configuration nommé replication-configuration.json et ajoutez le code suivant au fichier de configuration :

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

Configurez les paramètres de la commande suivante au 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\"}}"