forked from laiweijian4/doc-exports
zhangyue
78cb06737e
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com> Co-authored-by: zhangyue <zhangyue164@huawei.com> Co-committed-by: zhangyue <zhangyue164@huawei.com>
92 lines
11 KiB
HTML
92 lines
11 KiB
HTML
<a name="obs_03_0003"></a><a name="obs_03_0003"></a>
|
|
|
|
<h1 class="topictitle1">Configuring Cross-Region Replication</h1>
|
|
<div id="body1516351604726"><p id="obs_03_0003__p131341258783">Currently, OBS allows you to configure a cross-region replication rule for copying all objects from a source bucket to a destination bucket or multiple cross-region replication rules that match prefixes.</p>
|
|
<div class="note" id="obs_03_0003__note16838440184619"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0003__p188381540184612">A cross-region replication rule may not take effect immediately upon its configuration. Accordingly, the objects that this rule is applied to may not be replicated immediately after the rule is configured.</p>
|
|
</div></div>
|
|
<div class="section" id="obs_03_0003__section32125925213719"><h4 class="sectiontitle">Prerequisites</h4><p id="obs_03_0003__p117778964719">The source bucket version is 3.0 or later, and cross-region replication is available in the region of the source bucket. </p>
|
|
</div>
|
|
<div class="section" id="obs_03_0003__section19643922213936"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0003__ol7055074213947"><li id="obs_03_0003__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0003__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0003__li51927620"><span>In the navigation pane, click <strong id="obs_03_0003__b97869438815">Cross-Region Replication</strong>.</span></li><li id="obs_03_0003__li358255411390"><span>Click <strong id="obs_03_0003__b142761636173312">Create Rule</strong>. The <strong id="obs_03_0003__b12723614344">Create Cross-Region Replication Rule</strong> dialog box is displayed.</span></li><li id="obs_03_0003__li1716820401314"><span>Configure a cross-region replication rule according to your service needs. For details about the parameters, see <a href="#obs_03_0003__table13168114013116">Table 1</a>.</span><p>
|
|
<div class="tablenoborder"><a name="obs_03_0003__table13168114013116"></a><a name="table13168114013116"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0003__table13168114013116" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Cross-region replication parameters</caption><thead align="left"><tr id="obs_03_0003__row1816813409113"><th align="left" class="cellrowborder" colspan="2" valign="top" id="mcps1.3.4.2.4.2.1.2.4.1.1"><p id="obs_03_0003__p416810406110">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" id="mcps1.3.4.2.4.2.1.2.4.1.2"><p id="obs_03_0003__p201681740018">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_03_0003__row9168134010119"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p10168114011118">Status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.2 "><p id="obs_03_0003__p19169174012117">Indicates whether to enable or disable the replication rule. The versioning status of the source bucket must be the same as that of the destination bucket.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_03_0003__row131694401915"><td class="cellrowborder" rowspan="5" valign="top" width="10%" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p21691340114">Source bucket</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p1916994016120">Replicate</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="65%" headers="mcps1.3.4.2.4.2.1.2.4.1.2 "><p id="obs_03_0003__p816934011115">Indicates objects on which the rule takes effect.</p>
|
|
<ul id="obs_03_0003__ul3169174015119"><li id="obs_03_0003__li316915403117"><strong id="obs_03_0003__b636548745">All objects</strong>: The rule applies to all objects in the bucket.</li><li id="obs_03_0003__li4169204013113"><strong id="obs_03_0003__b84381226183313">Match by prefix</strong>: The rule applies only to objects with the preset prefix.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_03_0003__row41691340513"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p1216914401512">Prefix</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><ul id="obs_03_0003__ul131697403117"><li id="obs_03_0003__li12169840219">If you want to apply the rule to objects by prefix, you must set a value no longer than 1024 characters for <strong id="obs_03_0003__b1808905366">Prefix</strong>.</li><li id="obs_03_0003__li14169114011110">When <strong id="obs_03_0003__b1065538300">Match by prefix</strong> is selected and the specified prefix overlaps with the prefix of an existing rule, OBS regards the two rules as one and the new one cannot be configured successfully. For example, if a rule with prefix <strong id="obs_03_0003__b210660063">abc</strong> exists in the system, another rule whose prefix starts with <strong id="obs_03_0003__b1579858040">abc</strong> cannot be configured.</li><li id="obs_03_0003__li5169840318">To copy a folder, end the prefix with a slash (/), for example, <strong id="obs_03_0003__b18711953131712">imgs/</strong>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_03_0003__row1643520415216"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p10269115310217">Synchronize Existing Objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p102696530210">Indicates whether to synchronize the objects that were already in the bucket before the rule configuration to the destination bucket. By default, these objects are not synchronized.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_03_0003__row123280436215"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p632934316216">Synchronize Deleting Action</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p132914431625">Indicates whether to synchronize the object deletions in the source bucket to the destination bucket. With this function enabled, deleting an object from the source bucket will also delete the object copy from the destination bucket.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_03_0003__row2016912401919"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p1216914011113">Replicate KMS encrypted objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p121698406111">OBS will try to copy KMS encrypted objects no matter whether this option is selected or not.</p>
|
|
<ul id="obs_03_0003__ul116917401416"><li id="obs_03_0003__li6169124010115">If this option is selected, only the IAM agencies that have the <strong id="obs_03_0003__b1458799184218">KMS Administrator</strong> permissions at both the source and destination ends are displayed in the drop-down list of <strong id="obs_03_0003__b15888152163910">IAM Agency</strong> in this dialog box.</li><li id="obs_03_0003__li131691402114">If this option is not selected, only the IAM agencies that do not have the <strong id="obs_03_0003__b51676114421">KMS Administrator</strong> permission at either the source or destination end are displayed in the drop-down list of <strong id="obs_03_0003__b2020517424013">IAM Agency</strong> in this dialog box.</li></ul>
|
|
<p id="obs_03_0003__p1316994011118">If KMS is not available in the destination region or the agency does not have the <strong id="obs_03_0003__b19777141224210">KMS Administrator</strong> permissions in the source and destination regions, KMS encrypted objects in the source bucket will fail to be replicated to the destination bucket, and the object replication status will be FAILED.</p>
|
|
<p id="obs_03_0003__p1916912406116">After a KMS encrypted object in the source bucket is replicated to the destination bucket, the key that encrypts the object changes to the default master key <strong id="obs_03_0003__b1126019435">obs/default</strong> of the region where the destination bucket resides.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_03_0003__row18169154010111"><td class="cellrowborder" rowspan="3" valign="top" width="10%" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p181693402116">Destination bucket</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p1017094010119">Region</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="65%" headers="mcps1.3.4.2.4.2.1.2.4.1.2 "><p id="obs_03_0003__p01702401019">Indicates the region of the destination bucket. The destination and source buckets must be in different regions.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_03_0003__row617017404120"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p21701740615">Bucket</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p16170144013112">Indicates the destination bucket.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_03_0003__row217044010119"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p6170184012117">Change storage class for replicated objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p31702400111">By default, this option is not selected, indicating that the storage class of object copies is the same as that of objects in the source bucket. If you need to change the storage class of objects copies, select this parameter, then you can specify a storage class.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_03_0003__row91701240314"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p617013401815">Permissions</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.4.2.1.2.4.1.1 "><p id="obs_03_0003__p817010401516">IAM Agency</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="65%" headers="mcps1.3.4.2.4.2.1.2.4.1.2 "><p id="obs_03_0003__p7170154014110">Delegates OBS to operate your resources, so that OBS can use this agency to implement cross-region replication.</p>
|
|
<p id="obs_03_0003__p1617020408119">If there is no IAM agency available, click <strong id="obs_03_0003__b318713128241">Create IAM agencies</strong> to create one. If you have already created IAM agencies, select one from the drop-down list.</p>
|
|
<div class="note" id="obs_03_0003__note1317094014116"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_03_0003__p201703401611">Requirements:</p>
|
|
<p id="obs_03_0003__p1917010402017">The IAM agency must be of OBS. The OBS project must have the <strong id="obs_03_0003__b2087015714610">OBS FullAccess</strong> permissions. If <strong id="obs_03_0003__b19425105704619">Replicate KMS encrypted objects</strong> is selected, you also need the <strong id="obs_03_0003__b114260574469">KMS Administrator</strong> permissions in the regions where the source and destination buckets are located.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</p></li><li id="obs_03_0003__li11493505104839"><span>(Optional) Create an IAM Agency. For details, see <a href="obs_03_0037.html">Creating an IAM Agency</a>.</span></li><li id="obs_03_0003__li3344106816179"><span>Click <strong id="obs_03_0003__b0824214165713">OK</strong>. The cross-region replication rule is created.</span></li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0001.html">Cross-Region Replication</a></div>
|
|
</div>
|
|
</div>
|
|
|