vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity

OBS UMN DOC

Browse Source 
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
This commit is contained in:
zhangyue 2024-03-18 15:39:30 +00:00 committed by zuul
parent 62ab8a5fe2
commit b55201d729
160 changed files with 4273 additions and 1375 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3335
docs/obs/umn/ALL_META.TXT.json
View File

File diff suppressed because it is too large Load Diff

1023
docs/obs/umn/CLASS.TXT.json
View File

File diff suppressed because it is too large Load Diff

BIN
docs/obs/umn/en-us_image_0000001730497813.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 422 B

0
docs/obs/umn/en-us_image_0145846362.png → docs/obs/umn/en-us_image_0000001801955289.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

BIN
docs/obs/umn/en-us_image_0145847198.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 36 KiB

BIN
docs/obs/umn/en-us_image_0154344913.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 112 KiB

BIN
docs/obs/umn/en-us_image_0198863546.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 34 KiB

2
docs/obs/umn/en-us_topic_0045853504.html
View File

@ -35,7 +35,7 @@
<p id="en-us_topic_0045853504__p15453151459">If versions of objects in a bucket do not need to be controlled, you can suspend the versioning function.</p>
<ul id="en-us_topic_0045853504__ul59456295"><li id="en-us_topic_0045853504__li65344610">Historical versions will be retained in OBS. If you do not need these historical versions, manually delete them.</li><li id="en-us_topic_0045853504__li51230581">Objects can be downloaded by version IDs. By default, the latest object is downloaded if the version ID is not specified.</li></ul>
</div>
<div class="section" id="en-us_topic_0045853504__section135901320145020"><h4 class="sectiontitle">Differences Between Scenarios When Versioning Is Suspended and Disabled</h4><p id="en-us_topic_0045853504__p162733446142">If you delete an object when versioning is suspended, a <strong id="en-us_topic_0045853504__b1293810133479">null</strong> version with the <strong id="en-us_topic_0045853504__b43191229134716">Delete Marker</strong> is generated regardless of whether the object has historical versions. But, if versioning is disabled, the same operation will not generate a version with the <strong id="en-us_topic_0045853504__b7339469461">Delete Marker</strong>.</p>
<div class="section" id="en-us_topic_0045853504__section135901320145020"><h4 class="sectiontitle">Differences Between Scenarios When Versioning Is Suspended and Disabled</h4><p id="en-us_topic_0045853504__p162733446142">If you delete an object after versioning is suspended for the bucket, a delete marker will be generated, no matter whether the object has historical versions. But, if versioning is disabled, the same operation will not generate a delete marker.</p>
</div>
</div>
<div>

2
docs/obs/umn/en-us_topic_0045853509.html
View File

@ -1,7 +1,7 @@
<a name="en-us_topic_0045853509"></a><a name="en-us_topic_0045853509"></a>
<h1 class="topictitle1">Configuring a Bucket ACL</h1>
<div id="body8662426"><p class="MsoNormal" id="en-us_topic_0045853509__a040d1719d5074a088607c03d2c2c706c">By configuring ACL, you can authorize bucket and ACL permissions to the <strong id="en-us_topic_0045853509__b473817582317">Owner</strong>, <strong id="en-us_topic_0045853509__b2738658163118">Anonymous User</strong>, <strong id="en-us_topic_0045853509__b2073985843116">Registered User</strong>, or <strong id="en-us_topic_0045853509__b173955813313">Log Delivery User</strong> groups.</p>
<div id="body8662426"><p class="MsoNormal" id="en-us_topic_0045853509__a040d1719d5074a088607c03d2c2c706c">You can configure a bucket ACL to grant permissions to the owner, anonymous users, registered users, or log delivery user groups.</p>
<div class="section" id="en-us_topic_0045853509__s7bd2583371ba494cb60f9cb31c5406bd"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853509__o4f3fd7174f1b474e97b33de4cfa5d560"><li id="en-us_topic_0045853509__l62f06423f7dc47e6b99ac914d5a7ca9e"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853509__lc6f821c1714e46eeaa39c7afa00508e7"><span>Click the blank area in the row of the bucket for which you want to set ACL permissions and click <strong id="en-us_topic_0045853509__en-us_topic_0068417482_en-us_topic_0045853509_b31074186174316">Configure Bucket ACL</strong>.</span></li><li id="en-us_topic_0045853509__l24b3ded122274d4692390cc019e8541e"><span>Configure the ACL of the bucket and click <strong id="en-us_topic_0045853509__b035783318132">Save</strong>. For details, see <a href="#en-us_topic_0045853509__ff824ee795c054719ae026365b7671c8f">Figure 1</a>.</span><p><div class="fignone" id="en-us_topic_0045853509__ff824ee795c054719ae026365b7671c8f"><a name="en-us_topic_0045853509__ff824ee795c054719ae026365b7671c8f"></a><a name="ff824ee795c054719ae026365b7671c8f"></a><span class="figcap"><b>Figure 1 </b>Configuring a bucket ACL</span><br><span><img id="en-us_topic_0045853509__image92781818175020" src="en-us_image_0129832488.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="en-us_topic_0045853509__li944717573486"><span>In the displayed dialog box, click <strong id="en-us_topic_0045853509__obs_03_0022_b19371431195919">Close</strong> to close the dialog box.</span></li></ol>
</div>

6
docs/obs/umn/en-us_topic_0045853514.html
View File

@ -1,14 +1,14 @@
<a name="en-us_topic_0045853514"></a><a name="en-us_topic_0045853514"></a>
<h1 class="topictitle1">Managing Fragments</h1>
<div id="body1499753333226"><div class="section" id="en-us_topic_0045853514__section30580753"><h4 class="sectiontitle">Background Information</h4><p id="en-us_topic_0045853514__p12120085">Data can be uploaded to OBS using multipart uploads. Fragments are generated, if a multipart upload fails because of the following reasons (included but not limited to):</p>
<div id="body1499753333226"><div class="section" id="en-us_topic_0045853514__section30580753"><h4 class="sectiontitle">Background Information</h4><p id="en-us_topic_0045853514__p12120085">Data can be uploaded to OBS using multipart uploads. There will be fragments generated, if a multipart upload fails because of the following causes (included but not limited to):</p>
<ul id="en-us_topic_0045853514__ul41971905"><li id="en-us_topic_0045853514__li42202829">The network is in poor conditions, and the connection to the OBS server is interrupted frequently.</li><li id="en-us_topic_0045853514__li44281146">The upload task is manually suspended.</li><li id="en-us_topic_0045853514__li62986002">The device is faulty.</li><li id="en-us_topic_0045853514__li30003108">The device is powered off suddenly.</li></ul>
<p id="en-us_topic_0045853514__p60858368">On OBS Console, storage used by fragments is charged. Clear fragments when they are not needed. If a file upload task fails, upload the file again.</p>
<div class="notice" id="en-us_topic_0045853514__note122503172191"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="en-us_topic_0045853514__p236104213587">Generated fragments take up storage space that is billable.</p>
</div></div>
</div>
<div class="section" id="en-us_topic_0045853514__section6791328"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853514__ol14332711"><li id="en-us_topic_0045853514__li475417311303"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853514__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853514__li1733753692411"><span>In the navigation pane, choose <strong id="en-us_topic_0045853514__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="en-us_topic_0045853514__li46672571"><span>Click <strong id="en-us_topic_0045853514__b7432105114110">Fragments</strong>, select the fragment that you want to delete, and then click <strong id="en-us_topic_0045853514__b11565547114110">Delete</strong> on the right of the fragment.</span><p><p id="en-us_topic_0045853514__p17399957">You can also select multiple fragments and click <strong id="en-us_topic_0045853514__b2041596892163830">Delete</strong> above fragment list to batch delete them.</p>
</p></li><li id="en-us_topic_0045853514__li22381889"><span>Click <strong id="en-us_topic_0045853514__b71046540343">Yes</strong> to confirm the deletion.</span></li></ol>
<div class="section" id="en-us_topic_0045853514__section6791328"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853514__ol14332711"><li id="en-us_topic_0045853514__li475417311303"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853514__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853514__li1733753692411"><span>In the navigation pane, choose <strong id="en-us_topic_0045853514__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="en-us_topic_0045853514__li46672571"><span>Click <strong id="en-us_topic_0045853514__b7432105114110">Fragments</strong>, select the fragment that you want to delete, and click <strong id="en-us_topic_0045853514__b11565547114110">Delete</strong> on the right.</span><p><p id="en-us_topic_0045853514__p17399957">You can also select multiple fragments and click <strong id="en-us_topic_0045853514__b2041596892163830">Delete</strong> above the fragment list to batch delete them.</p>
</p></li><li id="en-us_topic_0045853514__li22381889"><span>Click <strong id="en-us_topic_0045853514__b4651747135115">Yes</strong> to confirm the deletion.</span></li></ol>
</div>
</div>
<div>

2
docs/obs/umn/en-us_topic_0045853553.html
View File

@ -5,7 +5,7 @@
<p id="en-us_topic_0045853553__p18521156142616">The logging function itself is offered for free, only the space occupied by log files is charged.</p>
<p id="en-us_topic_0045853553__p16303104318137">After logging is enabled, the log delivery user group will be automatically granted the permission to read the bucket ACL and write the bucket where logs are saved. If you manually disable such permissions, bucket logging fails.</p>
<p class="MsoNormal" id="en-us_topic_0045853553__p38187048">OBS can record bucket access requests in logs for request analysis and log audit.</p>
<p class="MsoNormal" id="en-us_topic_0045853553__p8139116">Logs occupy some OBS storage space rented by users, causing extra fees. For this reason, OBS does not collect bucket access logs by default.</p>
<p class="MsoNormal" id="en-us_topic_0045853553__p8139116">Logs occupy the OBS storage that incurs costs, so OBS does not collect bucket access logs by default.</p>
<p id="en-us_topic_0045853553__p348350094022">After logging is configured, you can view operation logs in the bucket that stores the logs in approximately fifteen minutes.</p>
<p class="MsoNormal" id="en-us_topic_0045853553__p64418911">The following shows an example access log of the target bucket:</p>
<pre class="screen" id="en-us_topic_0045853553__screen87583912919">787f2f92b20943998a4fe2ab75eb09b8 bucket [13/Aug/2015:01:43:42 +0000] xx.xx.xx.xx

2
docs/obs/umn/en-us_topic_0045853584.html
View File

@ -13,7 +13,7 @@
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0086.html">Permission Control</a></div>
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0086.html">Permissions Control</a></div>
</div>
</div>

6
docs/obs/umn/en-us_topic_0045853630.html
View File

@ -13,7 +13,7 @@
</thead>
<tbody><tr id="en-us_topic_0045853630__rdb7f5ea2a4d74adf91a7682afdb7f55a"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.2.2.3.2.2.2.3.1.1 "><p id="en-us_topic_0045853630__adfec0a920ba04816b079cbcc34cd4dab">Enable HTTPS</p>
</td>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.3.2.2.3.2.2.2.3.1.2 "><p id="en-us_topic_0045853630__afc071fbcfdf240bf8db9256ad7baacea">If this option is selected, all communication information is encrypted and transferred to OBS over HTTPS.</p>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.3.2.2.3.2.2.2.3.1.2 "><p id="en-us_topic_0045853630__afc071fbcfdf240bf8db9256ad7baacea">If this option is selected, all communications information will be encrypted and then transferred to OBS over HTTPS.</p>
</td>
</tr>
<tr id="en-us_topic_0045853630__row4738349017324"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.2.2.3.2.2.2.3.1.1 "><p id="en-us_topic_0045853630__p1285744417324">Enable certificate verification</p>
@ -28,7 +28,7 @@
</tr>
<tr id="en-us_topic_0045853630__r9d15bd3a61304c50b4a10db1b16925a0"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.2.2.3.2.2.2.3.1.1 "><p id="en-us_topic_0045853630__a132962e2f4524b5d8a2f88403ae4f77c">Multipart Upload, Part Size (MB)</p>
</td>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.3.2.2.3.2.2.2.3.1.2 "><p id="en-us_topic_0045853630__af70fafbad2854bf6b27334eeeba60205">Objects whose size is larger than the specified part size (5 MB by default) are segmented and uploaded at the OBS background. The size of each part can be set in this dialog box. The value of <strong id="en-us_topic_0045853630__b2101885531161958">Part Size (MB)</strong> can range from 5 MB to 5 GB.</p>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.3.2.2.3.2.2.2.3.1.2 "><p id="en-us_topic_0045853630__af70fafbad2854bf6b27334eeeba60205">OBS uses multipart uploads by default. Objects larger than the specified part size (5 MB by default) will be uploaded using multipart upload in the background. You can adjust the size of each part as needed. The value of <strong id="en-us_topic_0045853630__b2101885531161958">Part Size (MB)</strong> can range from 5 MB to 5 GB.</p>
<div class="note" id="en-us_topic_0045853630__n9e51b629c15d48a298363e92b7bf6dea"><span class="notetitle"> NOTE: </span><div class="notebody"><p class="textintable" id="en-us_topic_0045853630__a691932aa2cb04490bb10a8762bc8d051">Multipart upload is used by default. Recommended settings of <strong id="en-us_topic_0045853630__b35010965113018">Part Size (MB)</strong> are as follows:</p>
<p class="textintable" id="en-us_topic_0045853630__ad311b703bed74dbc9022d8020ecc98e7">To maximize client performance, set <strong id="en-us_topic_0045853630__a4b013af2e67c4b0a9010deead1b30e9b">Part Size (MB)</strong> based on the upload speed. You are advised to set the <strong id="en-us_topic_0045853630__b1353816100111817">Part Size (MB)</strong> value larger than the maximum upload speed. For example, if the maximum upload speed is 10 MB/s, set <strong id="en-us_topic_0045853630__a7d866fbffd3a406794b97a2bc6280517">Part Size (MB)</strong> to an integer greater than 10 MB. It is recommended that the part size be set to a value two to three times the maximum upload speed.</p>
</div></div>
@ -57,7 +57,7 @@
</thead>
<tbody><tr id="en-us_topic_0045853630__r5d619d0924594f0ea5a7e192c9512dce"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.2.2.4.2.2.2.3.1.1 "><p id="en-us_topic_0045853630__a84ae2cb1419341779c5c75689d62bc74">Enable proxy</p>
</td>
<td class="cellrowborder" valign="top" width="74%" headers="mcps1.3.2.2.4.2.2.2.3.1.2 "><p id="en-us_topic_0045853630__a01bf42ec6e244394a5c2544097a2a1d2">If this option is selected, the <strong id="en-us_topic_0045853630__ada6624bfe80a43b5a6acf143ba321586">Authentication</strong> option is displayed. Set the following parameters to access OBS through the proxy server:</p>
<td class="cellrowborder" valign="top" width="74%" headers="mcps1.3.2.2.4.2.2.2.3.1.2 "><p id="en-us_topic_0045853630__a01bf42ec6e244394a5c2544097a2a1d2">Selecting this option will display the <strong id="en-us_topic_0045853630__ada6624bfe80a43b5a6acf143ba321586">Authentication</strong> option. By configuring the following parameters, you can access OBS through the proxy server:</p>
<ul id="en-us_topic_0045853630__u12af2c34ad70412eb298ce10202467ec"><li id="en-us_topic_0045853630__l671d9be61002469f9ca5eba77656e825">Address: domain name or IP address of the proxy server</li><li id="en-us_topic_0045853630__l890430202529434f827c31e9cd60c6aa">Port: port of the proxy server (default port is <strong id="en-us_topic_0045853630__a99cd61de49444b87b58e1a743cf16cd2">8080</strong>)</li></ul>
</td>
</tr>

16
docs/obs/umn/en-us_topic_0045853659.html
View File

@ -3,15 +3,17 @@
<h1 class="topictitle1">Lifecycle Management Overview</h1>
<div id="body1499753333227"><p id="en-us_topic_0045853659__p1637081283616">Lifecycle management means periodically deleting objects in a bucket or transitioning between object storage classes by configuring rules.</p>
<div class="fignone" id="en-us_topic_0045853659__fig742244913265"><span class="figcap"><b>Figure 1 </b>Lifecycle management</span><br><span><img id="en-us_topic_0045853659__image18424145416535" src="en-us_image_0138955590.png"></span></div>
<div class="MsoNormal" id="en-us_topic_0045853659__p939825173316">Lifecycle management applies to the following scenarios:<ul id="en-us_topic_0045853659__ul394513342347"><li id="en-us_topic_0045853659__li1339895183311">Some periodically uploaded files need only to be retained for one week or one month, and can be deleted once they have expired.</li><li id="en-us_topic_0045853659__li1385724115347">Documents are seldom accessed after a certain period of time. These files need to be transitioned to <strong id="en-us_topic_0045853659__b426844005162114">Warm</strong> or <strong id="en-us_topic_0045853659__b794708140162114">Cold</strong> storage or be deleted.</li></ul>
<div class="MsoNormal" id="en-us_topic_0045853659__p939825173316">You may configure lifecycle rules to:<ul id="en-us_topic_0045853659__ul394513342347"><li id="en-us_topic_0045853659__li1339895183311">Periodically delete logs that are only meant to be retained for a specific period of time (a week or a month).</li><li id="en-us_topic_0045853659__li1385724115347">Transition documents that are seldom accessed to the Warm or Cold storage class or delete them.</li></ul>
</div>
<p class="MsoNormal" id="en-us_topic_0045853659__p533118202000">You can define lifecycle rules for identifying objects and manage lifecycles of the objects based on the rules.</p>
<p class="MsoNormal" id="en-us_topic_0045853659__p64157732195250">You can identify what objects in your bucket will be infrequently accessed, and then configure lifecycle rules to transition them to the Warm or Cold storage class to save storage costs. In short, transition basically means that the object storage class is altered without copying the object. You can also manually change the storage class of an object on the Objects page. For details, see <a href="en-us_topic_0045853663.html">Uploading an Object</a>.</p>
<p class="MsoNormal" id="en-us_topic_0045853659__p26414404">Lifecycle rules have two key elements:</p>
<ul id="en-us_topic_0045853659__ul36403044"><li id="en-us_topic_0045853659__li54206485162633">Configuration policy: <p id="en-us_topic_0045853659__p60665494162633"><a name="en-us_topic_0045853659__li54206485162633"></a><a name="li54206485162633"></a>You can also specify the prefix of object names so that objects whose names have this prefix are restricted by the rules. You can configure a lifecycle rule for a bucket so that all objects in the bucket can be restricted by the lifecycle rule.</p>
</li><li id="en-us_topic_0045853659__li60610947104121">Time: You can specify the number of days after which objects that have been last updated and meet specified conditions are automatically transitioned to <strong id="en-us_topic_0045853659__b1660144524612">Warm</strong> or <strong id="en-us_topic_0045853659__b17431454194619">Cold</strong>. Or you can specify an expiration time after which objects are automatically deleted.<ul id="en-us_topic_0045853659__ul6734890111214"><li id="en-us_topic_0045853659__li54662143111210"><strong id="en-us_topic_0045853659__b1950727816161632">Transition to Warm</strong>: You can specify the number of days after which objects that have been last updated and meet specified conditions are automatically transitioned to <strong id="en-us_topic_0045853659__b1349237872161632">Warm</strong>.</li><li id="en-us_topic_0045853659__li13511407111232"><strong id="en-us_topic_0045853659__b194514423161630">Transition to Cold</strong>: You can specify the number of days after which objects that have been last updated and meet specified conditions are automatically transitioned to <strong id="en-us_topic_0045853659__b54874938161630">Cold</strong>.</li><li id="en-us_topic_0045853659__li3068995820145">Expiration time: You can specify the number of days after which objects are automatically deleted or the day after which an object that matches with a rule is deleted.</li></ul>
<p class="MsoNormal" id="en-us_topic_0045853659__p533118202000">You can define lifecycle rules for your scenarios similar to those mentioned above to better manage your objects.</p>
<p class="MsoNormal" id="en-us_topic_0045853659__p64157732195250">You can configure lifecycle rules for objects that will no longer be frequently accessed to transition them to the Warm or Cold storage class as needed. This can help reduce costs on storage. In short, transition basically means that the object storage class is altered without copying the object. You can also manually change the storage class of an object on the Objects page. For details, see <a href="en-us_topic_0045853663.html">Uploading an Object</a>.</p>
<p class="MsoNormal" id="en-us_topic_0045853659__p26414404">Lifecycle rules have the following key elements:</p>
<ul id="en-us_topic_0045853659__ul36403044"><li id="en-us_topic_0045853659__li54206485162633">Policy<p id="en-us_topic_0045853659__p60665494162633"><a name="en-us_topic_0045853659__li54206485162633"></a><a name="li54206485162633"></a>You can specify an object name prefix to apply a lifecycle rule to a set of objects. You can also apply a lifecycle rule to the entire bucket (including the objects in it).</p>
</li><li id="en-us_topic_0045853659__li60610947104121"><p id="en-us_topic_0045853659__p15929332135914"><a name="en-us_topic_0045853659__li60610947104121"></a><a name="li60610947104121"></a>Time</p>
<p id="en-us_topic_0045853659__li60610947104121p0">You can specify the number of days after which objects that have been last updated and meet specified conditions are automatically transitioned to Warm or Cold, or are expired and then deleted.</p>
<ul id="en-us_topic_0045853659__ul6734890111214"><li id="en-us_topic_0045853659__li54662143111210">Transition to Warm: This defines the number of days since the last object update after which objects meeting specified conditions are automatically transitioned to the Warm storage class.</li><li id="en-us_topic_0045853659__li13511407111232">Transition to Cold: This defines the number of days since the last object update after which objects meeting specified conditions are automatically transitioned to the Cold storage class.</li><li id="en-us_topic_0045853659__li3068995820145">Expiration time: This defines the number of days since the last object update after which objects meeting specified conditions are automatically expired and then deleted.</li></ul>
</li></ul>
<p id="en-us_topic_0045853659__p6016904211523">The previous number of days for objects to be transitioned to <strong id="en-us_topic_0045853659__b119464058316151">Warm</strong> is at least 30. If objects are configured to change to both <strong id="en-us_topic_0045853659__b935926103616">Warm</strong> and <strong id="en-us_topic_0045853659__b62371932113618">Cold</strong>, the number of days for transition to <strong id="en-us_topic_0045853659__b1038514011439">Cold</strong> must be at least 30 days later than that for transition to <strong id="en-us_topic_0045853659__b189663437">Warm</strong>. For example, if the number of days for transition to <strong id="en-us_topic_0045853659__b158038668161454">Warm</strong> is 33, that for transition to <strong id="en-us_topic_0045853659__b300022036161454">Cold</strong> must be 63 at least. If only transition to <strong id="en-us_topic_0045853659__b1031401760161451">Cold</strong> is enabled and transition to <strong id="en-us_topic_0045853659__b1705790675161451">Warm</strong> is disabled, there is no limit on the number of days for transition. The expiration time must be greater than the two transition times.</p>
<p id="en-us_topic_0045853659__p6016904211523">Objects can be transitioned to Warm at least 30 days after their last update. If you configure to transition objects first to Warm and then Cold, the objects must stay Warm at least 30 days before they can be transitioned to Cold. For example, if you configure to transition objects to Warm 33 days after their last update, the objects can be transitioned to Cold at least 63 days after their last update. If only transition to Cold is used, but transition to Warm is not, there is no limit on the number of days for transition. The number set for expiration time must be larger than that specified for any of the transition operations.</p>
</div>
<div>
<div class="familylinks">

5
docs/obs/umn/en-us_topic_0045853662.html
View File

@ -6,7 +6,7 @@
</div></div>
<div class="section" id="en-us_topic_0045853662__section65410517"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853662__obs_03_0306_en-us_topic_0066036515_ol42091162"><li id="en-us_topic_0045853662__obs_03_0306_en-us_topic_0066036515_li53940931"><span>In the upper right corner of the OBS Console homepage, click <strong id="en-us_topic_0045853662__obs_03_0306_b19157112242710">Create Bucket</strong>. The <strong id="en-us_topic_0045853662__obs_03_0306_b823711595271">Create Bucket</strong> page is displayed. For details, see <a href="#en-us_topic_0045853662__obs_03_0306_fig30207295194414">Figure 1</a>.</span><p><div class="fignone" id="en-us_topic_0045853662__obs_03_0306_fig30207295194414"><a name="en-us_topic_0045853662__obs_03_0306_fig30207295194414"></a><a name="obs_03_0306_fig30207295194414"></a><span class="figcap"><b>Figure 1 </b>Creating a bucket</span><br><span><img id="en-us_topic_0045853662__obs_03_0306_image13179145913414" src="en-us_image_0129426050.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="en-us_topic_0045853662__obs_03_0306_p193383292614"></p>
<p id="en-us_topic_0045853662__obs_03_0306_p5330183495815"></p>
<p id="en-us_topic_0045853662__obs_03_0306_p21281164513"></p>
</p></li><li id="en-us_topic_0045853662__obs_03_0306_li14812171815257"><span>Configure bucket parameters.</span><p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0045853662__obs_03_0306_table9210201853617" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Bucket parameters</caption><thead align="left"><tr id="en-us_topic_0045853662__obs_03_0306_row13210518113615"><th align="left" class="cellrowborder" valign="top" width="20.22%" id="mcps1.3.3.2.2.2.1.2.3.1.1"><p id="en-us_topic_0045853662__obs_03_0306_p1121013185365">Parameter</p>
</th>
@ -31,6 +31,7 @@
<tr id="en-us_topic_0045853662__obs_03_0306_row132101185362"><td class="cellrowborder" valign="top" width="20.22%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="en-us_topic_0045853662__obs_03_0306_p18210181833614">Storage Class</p>
</td>
<td class="cellrowborder" valign="top" width="79.78%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="en-us_topic_0045853662__obs_03_0306_p2914586010533">Storage classes of a bucket. Different storage classes meet different requirements for storage performance and costs.</p>
<ul id="en-us_topic_0045853662__obs_03_0306_ul386215378248"><li id="en-us_topic_0045853662__obs_03_0306_li16862137182411">The Standard storage class is for storing a large number of hot files or small files that are frequently accessed (multiple times per month on average) and require quick retrieval.</li><li id="en-us_topic_0045853662__obs_03_0306_li113541355942">The Warm storage class is for storing data that is less frequently accessed (less than 12 times per year on average) and requires quick retrieval.</li><li id="en-us_topic_0045853662__obs_03_0306_li1046755918114">The Cold storage class is for archiving data that is rarely accessed (once a year on average) and has no requirements for quick retrieval.</li></ul>
<p id="en-us_topic_0045853662__obs_03_0306_p859325514419">For details, see <a href="en-us_topic_0050937852.html">Storage Classes Overview</a>.</p>
</td>
@ -59,7 +60,7 @@
</p></li><li id="en-us_topic_0045853662__obs_03_0306_en-us_topic_0066036515_li38699129"><span>Click <strong id="en-us_topic_0045853662__obs_03_0306_b175229391415610">Create Now</strong>.</span></li></ol>
</div>
<div class="section" id="en-us_topic_0045853662__section2680481145652"><h4 class="sectiontitle">Related Operations</h4><p id="en-us_topic_0045853662__p52051693145756">After the bucket is created, you can change its storage class by performing the following steps:</p>
<ol id="en-us_topic_0045853662__ol54196626"><li id="en-us_topic_0045853662__li27850590"><span>In the bucket list on OBS Console, select the target bucket and click <strong id="en-us_topic_0045853662__b117511315018">Change Storage Class</strong> on the right.</span></li><li id="en-us_topic_0045853662__li1360913304813"><span>Select the desired storage class and click <strong id="en-us_topic_0045853662__b1867159133719">OK</strong>.</span><p><div class="note" id="en-us_topic_0045853662__note1136531152715"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0045853662__ul2922161693817"><li id="en-us_topic_0045853662__li792271683811">Changing the storage class of a bucket does not change the storage class of existing objects in the bucket.</li><li id="en-us_topic_0045853662__li11901518123816">An object inherits the bucket storage class by default, if no other storage class is specified for the object upon its upload. When the bucket storage class is changed, newly uploaded objects inherit the new bucket storage class by default.</li></ul>
<ol id="en-us_topic_0045853662__ol54196626"><li id="en-us_topic_0045853662__li27850590"><span>In the bucket list on OBS Console, select the target bucket and click <strong id="en-us_topic_0045853662__b117511315018">Change Storage Class</strong> on the right.</span></li><li id="en-us_topic_0045853662__li1360913304813"><span>Select the desired storage class and click <strong id="en-us_topic_0045853662__b1867159133719">OK</strong>.</span><p><div class="note" id="en-us_topic_0045853662__note1136531152715"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0045853662__ul2922161693817"><li id="en-us_topic_0045853662__li792271683811">Changing the storage class of a bucket does not change the storage class of existing objects in the bucket.</li><li id="en-us_topic_0045853662__li11901518123816">If you do not specify a storage class for an object when uploading it, it inherits the bucket's storage class by default. After the bucket's storage class is changed, newly uploaded objects will inherit the new storage class of the bucket by default.</li></ul>
</div></div>
</p></li></ol>
<p id="en-us_topic_0045853662__p983108915817"></p>

17
docs/obs/umn/en-us_topic_0045853663.html
View File

@ -4,27 +4,30 @@
<div id="body1499753333226"><p id="en-us_topic_0045853663__p11143994113759">This section describes how to upload local files to OBS over the Internet. These files can be texts, images, videos, or any other type of files.</p>
<div class="section" id="en-us_topic_0045853663__section37191890113846"><h4 class="sectiontitle">Limitations and Constraints</h4><ul id="en-us_topic_0045853663__ul861573411396"><li id="en-us_topic_0045853663__li146792038154119">OBS Console allows you to upload files in a batch. Up to 100 files can be uploaded at a time, with the total size of no more than 5 GB. If the file size exceeds 5 GB, use OBS Browser or the multipart upload of OBS SDKs and APIs for upload.</li><li id="en-us_topic_0045853663__li1616338124218">If versioning is disabled for your bucket and you upload a new file with the same name as the one you previously uploaded to your bucket, the new file automatically overwrites the previous file and does not retain its ACL information. If you upload a new folder using the same name that was used with a previous folder in the bucket, the two folders will be merged, and files in the new folder will overwrite namesake files in the previous folder.</li><li id="en-us_topic_0045853663__li2360182919422">After versioning is enabled for your bucket, if the new file you upload has the same name as the one you previously uploaded to the bucket, a new file version will be added in the bucket. For details, see <a href="en-us_topic_0045853504.html">Versioning Overview</a>.</li></ul>
</div>
<div class="section" id="en-us_topic_0045853663__section1750515815466"><h4 class="sectiontitle">Prerequisites</h4><ul id="en-us_topic_0045853663__obs_03_0307_ul13735132573913"><li id="en-us_topic_0045853663__obs_03_0307_li16735122520395">At least one bucket has been created.</li><li id="en-us_topic_0045853663__obs_03_0307_li167391276399">If you want to classify files, you can create folders and upload files to different folders. For details about how to create a folder, see <a href="obs_03_0316.html">Creating a Folder</a></li></ul>
<div class="section" id="en-us_topic_0045853663__section1750515815466"><h4 class="sectiontitle">Prerequisites</h4><ul id="en-us_topic_0045853663__obs_03_0307_ul13735132573913"><li id="en-us_topic_0045853663__obs_03_0307_li16735122520395">At least one bucket has been created.</li><li id="en-us_topic_0045853663__obs_03_0307_li167391276399">If you want to classify files, you can create folders and upload files to different folders. For details, see <a href="obs_03_0316.html">Creating a Folder</a>.</li></ul>
</div>
<div class="section" id="en-us_topic_0045853663__section64292661113931"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853663__obs_03_0307_ol658192291912"><li id="en-us_topic_0045853663__obs_03_0307_li1596440151221"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853663__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853663__obs_03_0307_li123641720664"><span>In the navigation pane, choose <strong id="en-us_topic_0045853663__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="en-us_topic_0045853663__obs_03_0307_li46803166594"><span>Go to the folder to which objects are uploaded. Click <strong id="en-us_topic_0045853663__obs_03_0307_b0882125105511">Upload Object</strong>. The <strong id="en-us_topic_0045853663__obs_03_0307_b6293181115555">Upload Object</strong> dialog box is displayed.</span><p><div class="note" id="en-us_topic_0045853663__obs_03_0307_note186461450113113"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853663__obs_03_0307_p14504161520198">If the files that you want to upload to OBS are stored in Microsoft OneDrive, it is recommended that the names of these files contain a maximum of 32 characters to ensure compatibility.</p>
<div class="section" id="en-us_topic_0045853663__section64292661113931"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853663__obs_03_0307_ol658192291912"><li id="en-us_topic_0045853663__obs_03_0307_li1596440151221"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853663__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853663__obs_03_0307_li123641720664"><span>In the navigation pane, choose <strong id="en-us_topic_0045853663__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="en-us_topic_0045853663__obs_03_0307_li46803166594"><span>Go to the folder where you want to upload files and click <strong id="en-us_topic_0045853663__obs_03_0307_b0882125105511">Upload Object</strong>. The <strong id="en-us_topic_0045853663__obs_03_0307_b6293181115555">Upload Object</strong> dialog box is displayed.</span><p><div class="note" id="en-us_topic_0045853663__obs_03_0307_note186461450113113"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853663__obs_03_0307_p14504161520198">If the files that you want to upload to OBS are stored in Microsoft OneDrive, it is recommended that the names of these files contain a maximum of 32 characters to ensure compatibility.</p>
</div></div>
<div class="fignone" id="en-us_topic_0045853663__obs_03_0307_fig188654349118"><span class="figcap"><b>Figure 1 </b>Uploading objects</span><br><span><img id="en-us_topic_0045853663__obs_03_0307_image10536191814483" src="en-us_image_0153827167.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="en-us_topic_0045853663__obs_03_0307_p1430017260138"></p>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li8341913385"><span>Select a storage class. If you do not specify a storage class, the object you upload inherits the default storage class of the bucket.</span><p><div class="note" id="en-us_topic_0045853663__obs_03_0307_note27281163408"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853663__obs_03_0307_p15728186194013">An object can have a different storage class from its bucket. You can specify a storage class for an object when uploading it, or you can change the object storage class after the object is uploaded.</p>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li8341913385"><span>Select a storage class. If you do not specify a storage class, the objects you upload inherit the default storage class of the bucket.</span><p><div class="note" id="en-us_topic_0045853663__obs_03_0307_note27281163408"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853663__obs_03_0307_p15728186194013">An object can have a different storage class from its bucket. You can specify a storage class for an object when uploading it, or you can change the object storage class after the object is uploaded.</p>
</div></div>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li43271656164119"><span>Add a file or folder to be uploaded by dragging it to the <strong id="en-us_topic_0045853663__obs_03_0307_b120411138146">Upload Object</strong> area.</span><p><p id="en-us_topic_0045853663__obs_03_0307_p5316155610415">You can also click <strong id="en-us_topic_0045853663__obs_03_0307_b9948174410266">add file</strong> in the <strong id="en-us_topic_0045853663__obs_03_0307_b064791710146">Upload Object</strong> area to select files.</p>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li43271656164119"><span>In the <strong id="en-us_topic_0045853663__obs_03_0307_b120411138146">Upload Object</strong> area, drag and drop the files or folders you want to upload.</span><p><p id="en-us_topic_0045853663__obs_03_0307_p5316155610415">You can also click <strong id="en-us_topic_0045853663__obs_03_0307_b38354538523">add file</strong> in the <strong id="en-us_topic_0045853663__obs_03_0307_b064791710146">Upload Object</strong> area to select files.</p>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li74481344102111"><span>(Optional) Select <strong id="en-us_topic_0045853663__obs_03_0307_b16368281536">KMS encryption</strong> to encrypt the uploaded file. For details, see <a href="obs_03_0322.html">Uploading an Object in Server-Side Encryption Mode</a>.</span><p><div class="note" id="en-us_topic_0045853663__obs_03_0307_note610818411894"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853663__obs_03_0307_obs_03_0306_p062133814520">If the default encryption has been enabled for the bucket, uploaded objects are automatically encrypted.</p>
</div></div>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li12125192695311"><span>Click <strong id="en-us_topic_0045853663__obs_03_0307_b1918611133719">Upload</strong>.</span></li></ol>
</div>
<div class="section" id="en-us_topic_0045853663__section2680481145652"><h4 class="sectiontitle">Related Operations</h4><p id="en-us_topic_0045853663__p61538082105347">When uploading an object, you can specify a storage class for it. After the object is uploaded, you can also change its storage class. The procedure is as follows:</p>
<div class="section" id="en-us_topic_0045853663__section2680481145652"><h4 class="sectiontitle">Related Operations</h4><p id="en-us_topic_0045853663__p61538082105347">When uploading an object, you can specify a storage class for it. After the object is uploaded, you can also change its storage class by doing as follows:</p>
<ol id="en-us_topic_0045853663__ol54196626"><li id="en-us_topic_0045853663__li94697228416"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853663__obs_03_0307_b144421021120_1">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853663__li1733753692411"><span>In the navigation pane, choose <strong id="en-us_topic_0045853663__obs_03_0307_b51941856151917_1">Objects</strong>.</span></li><li id="en-us_topic_0045853663__li45807892175717"><span>Select the target object and choose <strong id="en-us_topic_0045853663__b16331938401184">More</strong> &gt; <strong id="en-us_topic_0045853663__b4308642191184">Change Storage Class</strong> on the right.</span><p><p id="en-us_topic_0045853663__p7418134211011"></p>
</p></li><li id="en-us_topic_0045853663__li65518593175554"><span>Select the desired storage class and click <strong id="en-us_topic_0045853663__b6082718214515">OK</strong>.</span></li></ol>
<div class="note" id="en-us_topic_0045853663__note49933437105659"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0045853663__ul48955806162444"><li id="en-us_topic_0045853663__li18917418162447">Objects can be changed from Standard to Warm or Cold storage class, or from Warm to Standard or Cold storage class, but objects in Cold storage class must be restored before being changed to Standard or Warm storage class. Changing from Warm or Cold to other storage classes incurs restore fees. Select an appropriate change option based on your actual needs.</li><li id="en-us_topic_0045853663__li377814260432">When the storage class is changed to Cold, the object restore status changes to <strong id="en-us_topic_0045853663__b478316619">Unrestored</strong>.</li><li id="en-us_topic_0045853663__li20206156162444">You can also configure a lifecycle rule to change the storage class of an object. For details, see <a href="obs_03_0335.html">Configuring a Lifecycle Rule</a>.</li></ul>
<div class="note" id="en-us_topic_0045853663__note49933437105659"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0045853663__ul48955806162444"><li id="en-us_topic_0045853663__li18917418162447"><p id="en-us_topic_0045853663__p171189397011"><a name="en-us_topic_0045853663__li18917418162447"></a><a name="li18917418162447"></a>You can manually change objects between storage classes:</p>
<ul id="en-us_topic_0045853663__ul833112531605"><li id="en-us_topic_0045853663__li47961528215">From Standard to Warm, or Cold</li><li id="en-us_topic_0045853663__li294710252035">From Warm to Standard, or Cold</li><li id="en-us_topic_0045853663__li233213121444">From Cold to Standard, or Warm. Before changing Cold objects, you must restore them first.<p id="en-us_topic_0045853663__p11762134915516"><a name="en-us_topic_0045853663__li233213121444"></a><a name="li233213121444"></a>Changing objects from Warm or Cold to other storage classes incurs restore costs. Select an appropriate change option based on your actual needs.</p>
</li></ul>
</li><li id="en-us_topic_0045853663__li377814260432">After an object is changed to Cold, its restore status changes to <strong id="en-us_topic_0045853663__b6402207131517">Unrestored</strong>.</li><li id="en-us_topic_0045853663__li20206156162444">You can also configure a lifecycle rule to change the storage class of an object. For details, see <a href="obs_03_0335.html">Configuring a Lifecycle Rule</a>.</li></ul>
</div></div>
</div>
<div class="section" id="en-us_topic_0045853663__section6158112111499"><h4 class="sectiontitle">Follow-up Procedure</h4><p id="en-us_topic_0045853663__p12984525104914">You can click <strong id="en-us_topic_0045853663__b749072512715">Copy Path</strong> on the right of an object to copy its path.</p>
<p id="en-us_topic_0045853663__p277211333145">You can share the path with other users. Then they open the bucket where the object is stored and enter the path in the search box to find the object.</p>
<p id="en-us_topic_0045853663__p277211333145">You can share the path with others. Then they can open the bucket where the object is stored and enter the path in the search box above the object list to find the object.</p>
</div>
</div>
<div>

8
docs/obs/umn/en-us_topic_0045853707.html
View File

@ -1,7 +1,7 @@
<a name="en-us_topic_0045853707"></a><a name="en-us_topic_0045853707"></a>
<h1 class="topictitle1">Configuring a Bucket Policy</h1>
<div id="body8662426"><p class="MsoNormal" id="en-us_topic_0045853707__a453722b6b7a847a3b98c866ba89cc863">A bucket policy defines the access control policy of resources (buckets and objects) in OBS.</p>
<div id="body8662426"><p class="MsoNormal" id="en-us_topic_0045853707__a453722b6b7a847a3b98c866ba89cc863">A bucket policy defines access control over resources (buckets and objects) in OBS.</p>
<div class="section" id="en-us_topic_0045853707__sa9ce61a965cf44278ecdea3220e325dd"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853707__o7b6feb4f8efd4473a007a285c8031085"><li id="en-us_topic_0045853707__ld501115dcad3472599e3ec2b2d3e2d53"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853707__l8e12aca8d5a74c7bbfcc73c497db29fd"><span>Click the blank area in the row of the bucket for which you want to configure a bucket policy and choose <strong id="en-us_topic_0045853707__b51831341152516">More</strong> &gt; <strong id="en-us_topic_0045853707__b1953975492517">Configure Bucket Policy</strong>.</span></li><li id="en-us_topic_0045853707__l7c68db23562a4f52af5be58789a03526"><span>In the <strong id="en-us_topic_0045853707__b38385285415242">Configure Bucket Policy</strong> dialog box, input required parameters.</span><p><p id="en-us_topic_0045853707__p1128019273611">The size of a bucket policy cannot exceed 20 KB.</p>
<p class="MsoNormal" id="en-us_topic_0045853707__ac2ee1033c4bd41928091e2c48832ba01"><a href="#en-us_topic_0045853707__t90f413f7432b4558b68c408483fd2be9">Table 1</a> describes the parameters of bucket policies. All fields except the <strong id="en-us_topic_0045853707__b842352706182834">Effect</strong> field are optional.</p>
@ -59,8 +59,8 @@
</tr>
<tr id="en-us_topic_0045853707__re157b39294c34983a344bdd2c19d3867"><td class="cellrowborder" valign="top" width="16.24%" headers="mcps1.3.2.2.3.2.3.2.4.1.1 "><p id="en-us_topic_0045853707__ad301d40b837a4d808b3ade5e40303f19">Action/NotAction</p>
</td>
<td class="cellrowborder" valign="top" width="76.24%" headers="mcps1.3.2.2.3.2.3.2.4.1.2 "><p id="en-us_topic_0045853707__afe04e5f242e546bb9ba2d0527af3d34c">OBS operations on which the bucket policy statement takes effect</p>
<p id="en-us_topic_0045853707__af08cacea86e44fceb08b23dcef32a160">Either <strong id="en-us_topic_0045853707__b208460462388">Action</strong> or <strong id="en-us_topic_0045853707__b1386164993816">NotAction</strong> must be selected to specify whether the bucket policy statement takes effect on the OBS operation.</p>
<td class="cellrowborder" valign="top" width="76.24%" headers="mcps1.3.2.2.3.2.3.2.4.1.2 "><p id="en-us_topic_0045853707__afe04e5f242e546bb9ba2d0527af3d34c">OBS actions which the bucket policy is applied to.</p>
<p id="en-us_topic_0045853707__af08cacea86e44fceb08b23dcef32a160">Either <strong id="en-us_topic_0045853707__b208460462388">Action</strong> or <strong id="en-us_topic_0045853707__b1386164993816">NotAction</strong> must be selected to specify whether the bucket policy applies to the OBS action.</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.2.2.3.2.3.2.4.1.3 "><p id="en-us_topic_0045853707__a5cd8ed2c61f348de990ca923abf0b2ea">Mandatory</p>
</td>
@ -68,7 +68,7 @@
<tr id="en-us_topic_0045853707__r1b58c573b77d42d6aadcd4321ea261ef"><td class="cellrowborder" valign="top" width="16.24%" headers="mcps1.3.2.2.3.2.3.2.4.1.1 "><p id="en-us_topic_0045853707__ae72aee7b2c02460e9cc37200a5e2ba8b">Resource/NotResource</p>
</td>
<td class="cellrowborder" valign="top" width="76.24%" headers="mcps1.3.2.2.3.2.3.2.4.1.2 "><p id="en-us_topic_0045853707__a851f0a72bf774eb8b15f76e4b054de25">Objects on which the bucket policy statement takes effect</p>
<p id="en-us_topic_0045853707__aaa19587fb1e14b49a31f4c9e9cc17200">Either <strong id="en-us_topic_0045853707__b183645180397">Resource</strong> or <strong id="en-us_topic_0045853707__b1999120223391">NotResource</strong> must be selected to specify whether the bucket policy statement takes effect on the OBS resources.</p>
<p id="en-us_topic_0045853707__aaa19587fb1e14b49a31f4c9e9cc17200">Either <strong id="en-us_topic_0045853707__b183645180397">Resource</strong> or <strong id="en-us_topic_0045853707__b1999120223391">NotResource</strong> must be selected to specify whether the bucket policy applies to the OBS resources.</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.2.2.3.2.3.2.4.1.3 "><p id="en-us_topic_0045853707__a69e88c1bcd29489ea748671680a5d3cc">Mandatory</p>
</td>

2
docs/obs/umn/en-us_topic_0045853710.html
View File

@ -2,7 +2,7 @@
<h1 class="topictitle1">Managing Fragments</h1>
<div id="body8662426"><div class="section" id="en-us_topic_0045853710__se3f4c5059d9b4121bf14b13aa64c29db"><h4 class="sectiontitle">Background Information</h4><p id="en-us_topic_0045853710__a2a4ccfb76d4340678b3ba68836829f7c">Data can be uploaded to OBS using multipart uploads. Fragments are generated, if a multipart upload fails because of the following reasons (included but not limited to):</p>
<ul id="en-us_topic_0045853710__ul911618118264"><li id="en-us_topic_0045853710__li011611115266">The network is in poor condition, and connection to the OBS server is frequently interrupted.</li><li id="en-us_topic_0045853710__li121162014269">The upload task is manually suspended.</li><li id="en-us_topic_0045853710__li711611182611">The device is faulty.</li><li id="en-us_topic_0045853710__li161164112614">The device is powered off suddenly.</li></ul>
<ul id="en-us_topic_0045853710__u45896b86aa884440802b2bef5c26968c"><li id="en-us_topic_0045853710__lfee5ee18b16547208680a5eeacfa4a2d">The network is in poor condition, and connection to the OBS server is frequently interrupted.</li><li id="en-us_topic_0045853710__l3d09eb2793c64fcbb0e3e07ead3da14b">The upload task is manually suspended.</li><li id="en-us_topic_0045853710__ld7a264baa56d428c957ad36547ef4f86">The device is faulty.</li><li id="en-us_topic_0045853710__l1e9e9c926242487d9ad9fd34503bbd34">The device is powered off suddenly.</li></ul>
<p id="en-us_topic_0045853710__p10677829175817">If a file fails to be uploaded or the upload task is suspended, fragments are generated and stored in OBS. You can resume the upload through task management. After the resumable upload completes, the fragments will be cleared automatically.</p>
<p id="en-us_topic_0045853710__p667714295583">You can also use the fragment management function to clear fragments. If you resume an upload task after clearing the fragments, the upload progress will be lost and the task needs to be re-uploaded.</p>
<div class="notice" id="en-us_topic_0045853710__note72851911184012"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="en-us_topic_0045853710__p192915474576">The fragment storage in OBS is billed.</p>

2
docs/obs/umn/en-us_topic_0045853737.html
View File

@ -3,7 +3,7 @@
<h1 class="topictitle1">Adding External Buckets</h1>
<div id="body8662426"><p id="en-us_topic_0045853737__a1b72ae5ef8104dc6b996c9a950566e73">OBS Browser supports the external bucket adding function.</p>
<div class="section" id="en-us_topic_0045853737__s4bbb287fa76047df837ed4a670a3a8a3"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0045853737__ac9bad5b5bdcb47ef868ee6ce923b9464">You have obtained the permissions to read and write the external bucket that you want to add.</p>
<p id="en-us_topic_0045853737__p17115102815012">For example: Account <strong id="en-us_topic_0045853737__b816675283516">A</strong> wants to add bucket <strong id="en-us_topic_0045853737__b2068981617361">testbucket</strong> of account <strong id="en-us_topic_0045853737__b361582517364">B</strong>. Account <strong id="en-us_topic_0045853737__b3245533183616">B</strong> must authorize account <strong id="en-us_topic_0045853737__b19727340101713">A</strong> the permission to read bucket <strong id="en-us_topic_0045853737__b171481614193711">testbucket</strong>. If account <strong id="en-us_topic_0045853737__b998063243817">A</strong> needs to upload object to bucket <strong id="en-us_topic_0045853737__b183171502395">testbucket</strong>, account <strong id="en-us_topic_0045853737__b1543945521718">B</strong> needs to authorize account <strong id="en-us_topic_0045853737__b362161915391">A</strong> the permission to write the bucket. Account <strong id="en-us_topic_0045853737__b2251194915409">A</strong> is the owner of the uploaded objects, and needs to authorize account <strong id="en-us_topic_0045853737__b19674135310401">B</strong> the permission to read and write the objects.</p>
<p id="en-us_topic_0045853737__p17115102815012">For example: Account <strong id="en-us_topic_0045853737__b816675283516">A</strong> wants to add bucket <strong id="en-us_topic_0045853737__b2068981617361">testbucket</strong> of account <strong id="en-us_topic_0045853737__b361582517364">B</strong>. Account <strong id="en-us_topic_0045853737__b3245533183616">B</strong> must grant account <strong id="en-us_topic_0045853737__b19727340101713">A</strong> the permission to read bucket <strong id="en-us_topic_0045853737__b171481614193711">testbucket</strong>. If account <strong id="en-us_topic_0045853737__b998063243817">A</strong> needs to upload object to bucket <strong id="en-us_topic_0045853737__b183171502395">testbucket</strong>, account <strong id="en-us_topic_0045853737__b1543945521718">B</strong> needs to grant account <strong id="en-us_topic_0045853737__b362161915391">A</strong> the permission to write the bucket. Account <strong id="en-us_topic_0045853737__b2251194915409">A</strong> is the owner of the uploaded objects, and needs to grant account <strong id="en-us_topic_0045853737__b19674135310401">B</strong> the permission to read and write the objects.</p>
<div class="note" id="en-us_topic_0045853737__note6797359112510"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853737__p739854516309">An external bucket (version 3.0 or later) can be added only when its standard bucket policy is set to <strong id="en-us_topic_0045853737__b376295711234">Public Read and Write</strong>.</p>
<p id="en-us_topic_0045853737__p1279717592252">If the standard bucket policy of an external bucket is set to <strong id="en-us_topic_0045853737__b1889420276276">Public Read and Write</strong> upon its creation, you need to manually change the standard bucket policy to <strong id="en-us_topic_0045853737__b8848173714270">Private</strong> and then change it back to <strong id="en-us_topic_0045853737__b239954572718">Public Read and Write</strong> again, so that it can be added.</p>
</div></div>

8
docs/obs/umn/en-us_topic_0045853744.html
View File

@ -1,11 +1,11 @@
<a name="en-us_topic_0045853744"></a><a name="en-us_topic_0045853744"></a>
<h1 class="topictitle1">Configuring Logging</h1>
<div id="body8662426"><p id="en-us_topic_0045853744__p16911746506">After logging is enabled for a bucket, OBS automatically converts bucket logs into objects following the naming rules and writes the objects into a target bucket.</p>
<div class="section" id="en-us_topic_0045853744__sfe45c5a333f549f48ff1e9ba2d1e8454"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0045853744__a07a271eb678f4753b386d76b089fe5d2">The log delivery user group has been assigned the <strong id="en-us_topic_0045853744__en-us_topic_0068417485_en-us_topic_0045853744_b253662751860">Write</strong> and <strong id="en-us_topic_0045853744__en-us_topic_0068417485_en-us_topic_0045853744_b3060589018613">ACL View</strong> permissions for the target bucket. For details, see <a href="en-us_topic_0045853509.html">Configuring a Bucket ACL</a>.</p>
<div id="body8662426"><p id="en-us_topic_0045853744__p16911746506">After logging is enabled for a bucket, OBS automatically converts the bucket's logs into objects in a fixed naming format and then writes these objects into a destination bucket.</p>
<div class="section" id="en-us_topic_0045853744__sfe45c5a333f549f48ff1e9ba2d1e8454"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0045853744__a07a271eb678f4753b386d76b089fe5d2">The log delivery user group has the write and ACL view permissions for the destination bucket. For details, see <a href="en-us_topic_0045853509.html">Configuring a Bucket ACL</a>.</p>
</div>
<div class="section" id="en-us_topic_0045853744__sd4f53f6d914a46f2a0f751184bad7fcf"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853744__o4a38afeb7a1041b8860750d2a104270b"><li id="en-us_topic_0045853744__l32aaed7801d74f8aa0d5db46f638f1ea"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853744__li277420158506"><span>Click the blank area in the row of the bucket for which you want to configure logging and choose <strong id="en-us_topic_0045853744__b860214296551">More</strong> &gt; <strong id="en-us_topic_0045853744__b14630133416559">Configure Logging</strong>.</span></li><li id="en-us_topic_0045853744__l06b848bcccf446a993374247af410276"><span>Select <strong id="en-us_topic_0045853744__b162984261156">Enable</strong>. See <a href="#en-us_topic_0045853744__fig5791779717938">Figure 1</a>.</span><p><div class="fignone" id="en-us_topic_0045853744__fig5791779717938"><a name="en-us_topic_0045853744__fig5791779717938"></a><a name="fig5791779717938"></a><span class="figcap"><b>Figure 1 </b>Logging</span><br><span><img id="en-us_topic_0045853744__image8941105553011" src="en-us_image_0129837880.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="en-us_topic_0045853744__li375116179585"><span>Select an existing bucket where you want to store log files. Log delivery users of the selected bucket will be automatically assigned with the permission to read the bucket ACL and write logs to the bucket.</span></li><li id="en-us_topic_0045853744__li12160434593"><span>Enter a prefix for the <strong id="en-us_topic_0045853744__obs_03_0329_b1013214416211">Log File Name Prefix</strong>.</span><p><p id="en-us_topic_0045853744__obs_03_0329_p101162592117">After logging is enabled, generated logs are named in the following format:</p>
<div class="section" id="en-us_topic_0045853744__sd4f53f6d914a46f2a0f751184bad7fcf"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853744__o4a38afeb7a1041b8860750d2a104270b"><li id="en-us_topic_0045853744__l32aaed7801d74f8aa0d5db46f638f1ea"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853744__li277420158506"><span>Click the blank area in the row of the bucket for which you want to configure logging and choose <strong id="en-us_topic_0045853744__b860214296551">More</strong> &gt; <strong id="en-us_topic_0045853744__b14630133416559">Configure Logging</strong>.</span></li><li id="en-us_topic_0045853744__l06b848bcccf446a993374247af410276"><span>Select <strong id="en-us_topic_0045853744__b162984261156">Enable</strong>. See <a href="#en-us_topic_0045853744__fig5791779717938">Figure 1</a>.</span><p><div class="fignone" id="en-us_topic_0045853744__fig5791779717938"><a name="en-us_topic_0045853744__fig5791779717938"></a><a name="fig5791779717938"></a><span class="figcap"><b>Figure 1 </b>Configuring logging</span><br><span><img id="en-us_topic_0045853744__image8941105553011" src="en-us_image_0129837880.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="en-us_topic_0045853744__li375116179585"><span>Select an existing bucket where you want to store log files. Log delivery users of the selected bucket will be automatically granted the permissions to read the bucket ACL and write logs to the bucket.</span></li><li id="en-us_topic_0045853744__li12160434593"><span>Enter a prefix for the <strong id="en-us_topic_0045853744__obs_03_0329_b1013214416211">Log File Name Prefix</strong>.</span><p><p id="en-us_topic_0045853744__obs_03_0329_p101162592117">After logging is enabled, generated logs are named in the following format:</p>
<p id="en-us_topic_0045853744__obs_03_0329_p161169590114"><em id="en-us_topic_0045853744__obs_03_0329_i13116205971118">&lt;Log File Name Prefix&gt;</em>YYYY-mm-DD-HH-MM-SS-<em id="en-us_topic_0045853744__obs_03_0329_i161162591113">&lt;UniqueString&gt;</em></p>
<ul id="en-us_topic_0045853744__obs_03_0329_ul16116195910111"><li id="en-us_topic_0045853744__obs_03_0329_li5116135991118"><em id="en-us_topic_0045853744__obs_03_0329_i2560034149">&lt;Log File Name Prefix&gt;</em> is the shared prefix of log file names.</li><li id="en-us_topic_0045853744__obs_03_0329_li9116105920117"><strong id="en-us_topic_0045853744__obs_03_0329_b17511842134510">YYYY-mm-DD-HH-MM-SS</strong> indicates when the log is generated.</li><li id="en-us_topic_0045853744__obs_03_0329_li1711611596116"><em id="en-us_topic_0045853744__obs_03_0329_i19552638132513">&lt;UniqueString&gt;</em> indicates a character string generated by OBS.</li></ul>
<p id="en-us_topic_0045853744__obs_03_0329_p10116159191115">On OBS Console, if the configured <em id="en-us_topic_0045853744__obs_03_0329_i145914442109">&lt;Log File Name Prefix&gt;</em> ends with a slash (/), logs generated in the bucket are stored in the <em id="en-us_topic_0045853744__obs_03_0329_i5741133118464">&lt;Log File Name Prefix&gt;</em> folder in the bucket, facilitating the management of log files.</p>

13
docs/obs/umn/en-us_topic_0045853745.html
View File

@ -2,12 +2,12 @@
<h1 class="topictitle1">Bucket Policies and Object Policies</h1>
<div id="body1557026128761"><div class="section" id="en-us_topic_0045853745__section4574154145010"><h4 class="sectiontitle">Bucket Owner and Object Owner</h4><p id="en-us_topic_0045853745__p18002110210">The owner of a bucket is the account that created the bucket. If the bucket is created by an IAM user under the account, the bucket owner is the account instead of the IAM user.</p>
<p id="en-us_topic_0045853745__p14995316180">The owner of an object is the account that uploads the object, who may not be the owner of the bucket to which the object belongs. For example, account <strong id="en-us_topic_0045853745__b9675163893317">B</strong> is granted the permission to access a bucket of account <strong id="en-us_topic_0045853745__b12399154193316">A</strong>, and account <strong id="en-us_topic_0045853745__b965591349">B</strong> uploads a file to the bucket. In that case, instead of the bucket owner account <strong id="en-us_topic_0045853745__b207151754205513">A</strong>, account <strong id="en-us_topic_0045853745__b1092841123418">B</strong> is the owner of the object.</p>
<p id="en-us_topic_0045853745__p14995316180">The owner of an object is the account that uploads the object, who may not be the owner of the bucket to which the object belongs. For example, account <strong id="en-us_topic_0045853745__b195491217194518">B</strong> is granted the permission to access a bucket of account <strong id="en-us_topic_0045853745__b165491017134515">A</strong>, and account <strong id="en-us_topic_0045853745__b16549141713459">B</strong> uploads a file to the bucket. In that case, instead of the bucket owner account <strong id="en-us_topic_0045853745__b454941710457">A</strong>, account <strong id="en-us_topic_0045853745__b0549517184517">B</strong> is the owner of the object.</p>
</div>
<div class="section" id="en-us_topic_0045853745__section1825740772"><h4 class="sectiontitle">Bucket Policy</h4><p id="en-us_topic_0045853745__p859419124614">A bucket policy is attached to a bucket and objects in the bucket. By leveraging bucket policies, the owner of a bucket can grant IAM users or other accounts the permissions to operate the bucket and objects in the bucket.</p>
<p id="en-us_topic_0045853745__p116964110188"><strong id="en-us_topic_0045853745__b1310315411577">Bucket Policy Application Scenarios</strong>:</p>
<div class="section" id="en-us_topic_0045853745__section1825740772"><h4 class="sectiontitle">Bucket Policies</h4><p id="en-us_topic_0045853745__p859419124614">A bucket policy is attached to a bucket and objects in the bucket. By leveraging bucket policies, the owner of a bucket can grant IAM users or other accounts the permissions to operate the bucket and objects in the bucket.</p>
<p id="en-us_topic_0045853745__p116964110188"><strong id="en-us_topic_0045853745__b1310315411577">Application Scenarios</strong></p>
<ul id="en-us_topic_0045853745__ul7761857101919"><li id="en-us_topic_0045853745__li10777579196">If no <span id="en-us_topic_0045853745__ph9419171385810">IAM policies</span> are used for access control and you want to grant other accounts the permissions to access your OBS resources, you can use bucket policies.</li><li id="en-us_topic_0045853745__li129735910199">You can configure bucket policies to grant IAM users different access permissions on buckets.</li><li id="en-us_topic_0045853745__li121708142011">You can also use bucket policies to grant other accounts the permissions to access your buckets.</li></ul>
<p id="en-us_topic_0045853745__p108879396110"><strong id="en-us_topic_0045853745__b1738916595918">Standard Bucket Policies</strong>:</p>
<p id="en-us_topic_0045853745__p108879396110"><strong id="en-us_topic_0045853745__b1738916595918">Standard Bucket Policies</strong></p>
<p id="en-us_topic_0045853745__p1320714303352">There are three options for standard bucket policies.</p>
<ul id="en-us_topic_0045853745__ul15740133433513"><li id="en-us_topic_0045853745__li4740103420354"><strong id="en-us_topic_0045853745__b8759625143810">Private</strong>: No access beyond the bucket ACL settings is granted.</li><li id="en-us_topic_0045853745__li377138153513"><strong id="en-us_topic_0045853745__b161311618113117">Public Read</strong>: Anyone can read objects in the bucket.</li><li id="en-us_topic_0045853745__li66641044203514"><strong id="en-us_topic_0045853745__b931618225313">Public Read and Write</strong>: Anyone can read, write, or delete objects in the bucket.</li></ul>
<p id="en-us_topic_0045853745__p17739175319515">After a bucket is created, the default bucket policy is <strong id="en-us_topic_0045853745__b17602010102814">Private</strong>. Only the bucket owner has the full control permissions over the bucket. To ensure data security, it is recommended that you do not use the <strong id="en-us_topic_0045853745__b10152175317123">Public Read</strong> or <strong id="en-us_topic_0045853745__b667475711122">Public Read and Write</strong> policies.</p>
@ -73,13 +73,14 @@
<div class="note" id="en-us_topic_0045853745__note2118103711307"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853745__p4682317528">For buckets whose version is 3.0, the default permissions of <strong id="en-us_topic_0045853745__b1994991416242">Public Read</strong> and <strong id="en-us_topic_0045853745__b99614143244">Public Read and Write</strong> are updated to solve the problem where external buckets fail to be added to OBS Browser due to insufficient permissions.</p>
<ul id="en-us_topic_0045853745__ul434119504315"><li id="en-us_topic_0045853745__li163422505317">Added the ListBucket permission to the <strong id="en-us_topic_0045853745__b11720943112420">Public Read</strong> policy.</li><li id="en-us_topic_0045853745__li93426503315">Added the ListBucket permission to the <strong id="en-us_topic_0045853745__b36061540240">Public Read and Write</strong> policy.</li><li id="en-us_topic_0045853745__li934255083119">If you want to add an external bucket to OBS Browser, manually update the configuration of standard bucket policies.</li></ul>
</div></div>
<p id="en-us_topic_0045853745__p102285401236"><strong id="en-us_topic_0045853745__b12791142219148">Custom Bucket Policy</strong>:</p>
<p id="en-us_topic_0045853745__p102285401236"><strong id="en-us_topic_0045853745__b12791142219148">Custom Bucket Policies</strong></p>
<p id="en-us_topic_0045853745__p385655915198">The following three modes are provided to facilitate quick configuration:</p>
<ul id="en-us_topic_0045853745__ul8780438183815"><li id="en-us_topic_0045853745__li14780838163818"><strong id="en-us_topic_0045853745__b1579603411120">Read-only</strong>: With the <strong id="en-us_topic_0045853745__b149541244151111">Read-only</strong> mode, you only need to specify the <strong id="en-us_topic_0045853745__b154171455161115">Principal</strong> (authorized users). Then the authorized users have the read permission for the bucket and objects in the bucket, and can perform all GET operations on these resources.</li><li id="en-us_topic_0045853745__li11780438103816"><strong id="en-us_topic_0045853745__b14945201661218">Read and write</strong>: With the <strong id="en-us_topic_0045853745__b7774422121220">Read and write</strong> mode, you only need to specify the <strong id="en-us_topic_0045853745__b197141041313">Principal</strong> (authorized users). Then the authorized users have the full control permissions for the bucket and objects in the bucket, and can perform any operation on these resources.</li><li id="en-us_topic_0045853745__li15780138123814"><strong id="en-us_topic_0045853745__b16901182413136">Customized</strong>: With the <strong id="en-us_topic_0045853745__b1392612293135">Customized</strong> mode, you can define the specific operation permissions that you want to grant to users and accounts by configuring the <strong id="en-us_topic_0045853745__b1496317562136">Effect</strong>, <strong id="en-us_topic_0045853745__b14784013141">Principal</strong>, <strong id="en-us_topic_0045853745__b05277541415">Resources</strong>, <strong id="en-us_topic_0045853745__b21719971415">Actions</strong>, and <strong id="en-us_topic_0045853745__b143672163147">Conditions</strong> parameters. </li></ul>
<div class="note" id="en-us_topic_0045853745__note14398193912214"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853745__p639816399229">On OBS Console, when you use a custom bucket policy to grant other users the permissions to operate resources in a bucket, you also need to grant these users the bucket read permission <strong id="en-us_topic_0045853745__b1735213568396">ListBucket</strong> (leaving the resource name blank indicates that the policy takes effect on the entire bucket). Otherwise, the users may have no permission to access the bucket from OBS Console.</p>
</div></div>
</div>
<div class="section" id="en-us_topic_0045853745__section0354920819"><h4 class="sectiontitle">Object Policy</h4><p id="en-us_topic_0045853745__p139763410611">Object policies apply to objects in a bucket. A bucket policy is applicable to a set of objects (with the same object name prefix) or to all objects (specified by an asterisk <strong id="en-us_topic_0045853745__b2086119513210">*</strong>) in the bucket. To configure an object policy, select an object, and then configure a policy for it.</p>
<div class="section" id="en-us_topic_0045853745__section0354920819"><h4 class="sectiontitle">Object Policies</h4><p id="en-us_topic_0045853745__p139763410611">Object policies apply to objects in a bucket. A bucket policy is applicable to a set of objects (with the same object name prefix) or to all objects (specified by an asterisk <strong id="en-us_topic_0045853745__b2086119513210">*</strong>) in the bucket. To configure an object policy, select an object, and then configure a policy for it.</p>
<p id="en-us_topic_0045853745__p09403144379"></p>
</div>
</div>
<div>

32
docs/obs/umn/en-us_topic_0045853755.html
View File

@ -1,25 +1,25 @@
<a name="en-us_topic_0045853755"></a><a name="en-us_topic_0045853755"></a>
<h1 class="topictitle1">Configuring Static Website Hosting</h1>
<div id="body1499758606807"><p id="en-us_topic_0045853755__p30121176153913">This section describes how to configure static website hosting for buckets and use bucket domain names to access static websites.</p>
<p id="en-us_topic_0045853755__p885135018528">The static website hosting takes effect within two minutes after its configuration is complete.</p>
<div class="section" id="en-us_topic_0045853755__section11221613153921"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0045853755__p1146611514350">Web page files of the static website have been uploaded to a bucket.</p>
<div id="body1499758606807"><p id="en-us_topic_0045853755__p30121176153913">You can configure static website hosting for a bucket and then use the bucket's domain name to access static websites hosted in the bucket.</p>
<p id="en-us_topic_0045853755__p885135018528">The configuration of static website hosting takes two minutes at most to take effect.</p>
<div class="section" id="en-us_topic_0045853755__section11221613153921"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0045853755__p1146611514350">Web page files required for static website hosting have been uploaded to the specified bucket.</p>
<p id="en-us_topic_0045853755__p1812645682117">The static website files hosted in the bucket are accessible to anonymous users.</p>
<p id="en-us_topic_0045853755__p3350182614313">If the web page files are in the Cold storage class, restore them first. For more information, see <a href="obs_03_0320.html">Restoring Objects from the Cold Storage</a>.</p>
<p id="en-us_topic_0045853755__p3350182614313">Static web page files in the Cold storage class have been restored. For more information, see <a href="obs_03_0320.html">Restoring Objects from the Cold Storage</a>.</p>
</div>
<div class="section" id="en-us_topic_0045853755__section11587693153957"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853755__ol44271394154014"><li id="en-us_topic_0045853755__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853755__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853755__li45818654181751"><span>(<strong id="en-us_topic_0045853755__b7869135132012">Optional</strong>) If the static website files in the bucket are not accessible to anonymous users, perform this step. If the static website files are already accessible to anonymous users, skip this step.</span><p><p id="en-us_topic_0045853755__p18712161416268">Grant the read permission for static website files to anonymous users. For details, see <a href="obs_03_0132.html">Granting Object Access Permissions to Anonymous Users</a>.</p>
<div class="section" id="en-us_topic_0045853755__section11587693153957"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853755__ol44271394154014"><li id="en-us_topic_0045853755__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853755__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853755__li45818654181751"><span>(<strong id="en-us_topic_0045853755__b7869135132012">Optional</strong>) If the static website files in the bucket are not accessible to anonymous users, perform this step. If they are already accessible to everyone, skip this step.</span><p><p id="en-us_topic_0045853755__p18712161416268">Grant the read permission for static website files to anonymous users. For details, see <a href="obs_03_0132.html">Granting Anonymous Users Permission to Access Objects</a>.</p>
<p id="en-us_topic_0045853755__p14415184985410">If the bucket contains only static website files, configure the <strong id="en-us_topic_0045853755__b63305532481">Public Read</strong> policy for the bucket so that all files in it can be accessed publicly.</p>
<ol type="a" id="en-us_topic_0045853755__ol56026477144312"><li id="en-us_topic_0045853755__li26219314144346">Choose <strong id="en-us_topic_0045853755__b1966141115407">Permissions</strong> &gt; <strong id="en-us_topic_0045853755__b7671191919400">Bucket Policies</strong>.</li><li id="en-us_topic_0045853755__li820711719166">In the <strong id="en-us_topic_0045853755__b137091459121110">Standard Bucket Policies</strong> area, select the <strong id="en-us_topic_0045853755__b8285215161211">Public Read</strong> policy for the bucket.</li><li id="en-us_topic_0045853755__li588503161565">Click <strong id="en-us_topic_0045853755__b9882162941218">Public Read</strong>. For details, see <a href="#en-us_topic_0045853755__fig15186794193556">Figure 1</a>. In the confirmation dialog box that is displayed, click <strong id="en-us_topic_0045853755__b1842219132">Yes</strong>.<div class="fignone" id="en-us_topic_0045853755__fig15186794193556"><a name="en-us_topic_0045853755__fig15186794193556"></a><a name="fig15186794193556"></a><span class="figcap"><b>Figure 1 </b>Configuring the public read permission</span><br><span><img id="en-us_topic_0045853755__image1956565091517" src="en-us_image_0129612765.png" title="Click to enlarge" class="imgResize"></span></div>
</li></ol>
</p></li><li id="en-us_topic_0045853755__li18830181855820"><span>In the right <strong id="en-us_topic_0045853755__b838813813356">Basic Configurations</strong> area, click <strong id="en-us_topic_0045853755__b14321164593516">Static Website Hosting</strong>. The <strong id="en-us_topic_0045853755__b1936125173510">Static Website Hosting</strong> page is displayed.</span><p><p id="en-us_topic_0045853755__p1732877134316">Alternatively, you can choose <strong id="en-us_topic_0045853755__b16921115721615">Basic Configurations</strong> &gt; <strong id="en-us_topic_0045853755__b8474115171713">Static Website Hosting</strong> from the navigation pane on the left.</p>
</p></li><li id="en-us_topic_0045853755__li16425445133613"><span>Click <strong id="en-us_topic_0045853755__b145689166565">Configure Static Website Hosting</strong>. The <strong id="en-us_topic_0045853755__b16569201612565">Configure Static Website Hosting</strong> dialog box is displayed.</span></li><li id="en-us_topic_0045853755__li16729105453"><span>Enable it by turning on the status switch.</span></li><li id="en-us_topic_0045853755__li13201511640"><span>Set the hosting type to the current bucket. For details, see <a href="#en-us_topic_0045853755__fig1131112528711">Figure 2</a>.</span><p><div class="fignone" id="en-us_topic_0045853755__fig1131112528711"><a name="en-us_topic_0045853755__fig1131112528711"></a><a name="fig1131112528711"></a><span class="figcap"><b>Figure 2 </b>Configuring static website hosting</span><br><span><img id="en-us_topic_0045853755__image27411688519" src="en-us_image_0145846197.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="en-us_topic_0045853755__li18830181855820"><span>In the <strong id="en-us_topic_0045853755__b838813813356">Basic Configurations</strong> area, click <strong id="en-us_topic_0045853755__b14321164593516">Static Website Hosting</strong>. The <strong id="en-us_topic_0045853755__b1936125173510">Static Website Hosting</strong> page is displayed.</span><p><p id="en-us_topic_0045853755__p1732877134316">Alternatively, you can choose <strong id="en-us_topic_0045853755__b16921115721615">Basic Configurations</strong> &gt; <strong id="en-us_topic_0045853755__b8474115171713">Static Website Hosting</strong> from the navigation pane on the left.</p>
</p></li><li id="en-us_topic_0045853755__li16425445133613"><span>Click <strong id="en-us_topic_0045853755__b145689166565">Configure Static Website Hosting</strong>. The <strong id="en-us_topic_0045853755__b16569201612565">Configure Static Website Hosting</strong> dialog box is displayed.</span></li><li id="en-us_topic_0045853755__li16729105453"><span>Enable <strong id="en-us_topic_0045853755__b6575121121913">Status</strong>.</span></li><li id="en-us_topic_0045853755__li13201511640"><span>Set the hosting type to the current bucket. For details, see <a href="#en-us_topic_0045853755__fig1131112528711">Figure 2</a>.</span><p><div class="fignone" id="en-us_topic_0045853755__fig1131112528711"><a name="en-us_topic_0045853755__fig1131112528711"></a><a name="fig1131112528711"></a><span class="figcap"><b>Figure 2 </b>Configuring static website hosting</span><br><span><img id="en-us_topic_0045853755__image27411688519" src="en-us_image_0145846197.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="en-us_topic_0045853755__p261473213246"></p>
</p></li><li id="en-us_topic_0045853755__li65471095155127"><span>Set the values of the homepage and 404 error page.</span><p>
<ul id="en-us_topic_0045853755__ul58086424"><li id="en-us_topic_0045853755__li44406302"><strong id="en-us_topic_0045853755__b180866775">Home Page</strong>: specifies the default homepage of the static website. When OBS Console is used to configure static website hosting, only HTML web pages are supported. When are used to configure static website hosting, OBS does not have such a restriction but the <strong id="en-us_topic_0045853755__b95712271369">Content-Type</strong> of objects must be specified.<p id="en-us_topic_0045853755__p64112402">OBS only allows files such as <strong id="en-us_topic_0045853755__b7877104162117">index.html</strong> in the root directory of a bucket to function as the default homepage. Do not set the default homepage with a multi-level directory structure (for example, <strong id="en-us_topic_0045853755__b887715452112">/page/index.html</strong>).</p>
</li><li id="en-us_topic_0045853755__li40140706"><strong id="en-us_topic_0045853755__b1074981173714">404 Error Page</strong>: specifies the error page returned when an error occurs during static website access. When OBS Console is used to configure static website hosting, only HTML, JPG, PNG, BMP, and WEBP files under the root directory are supported. When APIs are used to configure static website hosting, OBS does not have such a restriction but the <strong id="en-us_topic_0045853755__b12328101310377">Content-Type</strong> of objects must be specified.</li></ul>
</p></li><li id="en-us_topic_0045853755__li53951195155255"><span><strong id="en-us_topic_0045853755__b67601913142610">Optional</strong>: In <strong id="en-us_topic_0045853755__b1499976005142610">Redirection Rules</strong>, configure redirection rules. Requests that comply with the redirection rules are redirected to the specific host or page.</span><p><p id="en-us_topic_0045853755__p2518484920120">A redirection rule is compiled in the JSON or XML format. Each rule contains a <strong id="en-us_topic_0045853755__b261716153396">Condition</strong> and a <strong id="en-us_topic_0045853755__b16476172503913">Redirect</strong>. The parameters are described as follows:</p>
</p></li><li id="en-us_topic_0045853755__li65471095155127"><span>Configure the homepage and 404 error page.</span><p>
<ul id="en-us_topic_0045853755__ul58086424"><li id="en-us_topic_0045853755__li44406302"><strong id="en-us_topic_0045853755__b875491074">Home Page</strong>: specifies the default homepage of the static website. When OBS Console is used to configure static website hosting, only HTML web pages are supported. When APIs are used to configure static website hosting, OBS does not have such a restriction, but the object <strong id="en-us_topic_0045853755__b95712271369">Content-Type</strong> must be specified.<p id="en-us_topic_0045853755__p64112402">OBS only allows files such as <strong id="en-us_topic_0045853755__b7877104162117">index.html</strong> in the root directory of a bucket to function as the default homepage. Do not set the default homepage with a multi-level directory structure (for example, <strong id="en-us_topic_0045853755__b887715452112">/page/index.html</strong>).</p>
</li><li id="en-us_topic_0045853755__li40140706"><strong id="en-us_topic_0045853755__b1074981173714">404 Error Page</strong>: specifies the error page returned when an error occurs during static website access. When OBS Console is used to configure static website hosting, only HTML, JPG, PNG, BMP, and WebP files under the root directory are supported. When APIs are used to configure static website hosting, OBS does not have such a restriction, but the object <strong id="en-us_topic_0045853755__b12328101310377">Content-Type</strong> must be specified.</li></ul>
</p></li><li id="en-us_topic_0045853755__li53951195155255"><span><strong id="en-us_topic_0045853755__b67601913142610">Optional</strong>: In <strong id="en-us_topic_0045853755__b1499976005142610">Redirection Rules</strong>, configure redirection rules. Requests that comply with the redirection rules are redirected to the specific host or page.</span><p><p id="en-us_topic_0045853755__p2518484920120">A redirection rule is compiled in the JSON or XML format. Each rule contains a <strong id="en-us_topic_0045853755__b261716153396">Condition</strong> and a <strong id="en-us_topic_0045853755__b16476172503913">Redirect</strong>. The parameters are described in <a href="#en-us_topic_0045853755__table59166151447">Table 1</a>.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0045853755__table59166151447" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0045853755__row2916201574415"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.8.2.2.2.4.1.1"><p id="en-us_topic_0045853755__p1091631511441">Container</p>
<div class="tablenoborder"><a name="en-us_topic_0045853755__table59166151447"></a><a name="table59166151447"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0045853755__table59166151447" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0045853755__row2916201574415"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.8.2.2.2.4.1.1"><p id="en-us_topic_0045853755__p1091631511441">Container</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.8.2.2.2.4.1.2"><p id="en-us_topic_0045853755__p6916111514447">Key</p>
</th>
@ -45,7 +45,7 @@
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.8.2.2.2.4.1.2 "><p id="en-us_topic_0045853755__p891613152448">Protocol</p>
</td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.8.2.2.2.4.1.3 "><p id="en-us_topic_0045853755__p3320144784713">Protocol used for redirection The value can be <strong id="en-us_topic_0045853755__b12336184372115">http</strong> or <strong id="en-us_topic_0045853755__b15760124532113">https</strong>. If this parameter is not specified, the default value <strong id="en-us_topic_0045853755__b125449352210">http</strong> is used.</p>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.8.2.2.2.4.1.3 "><p id="en-us_topic_0045853755__p3320144784713">Protocol used for redirecting requests. The value can be <strong id="en-us_topic_0045853755__b12336184372115">http</strong> or <strong id="en-us_topic_0045853755__b15760124532113">https</strong>. If this parameter is not specified, the default value <strong id="en-us_topic_0045853755__b125449352210">http</strong> is used.</p>
</td>
</tr>
<tr id="en-us_topic_0045853755__row1091651554417"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.2.2.2.4.1.1 "><p id="en-us_topic_0045853755__p1491691513447">HostName</p>
@ -55,12 +55,14 @@
</tr>
<tr id="en-us_topic_0045853755__row149161015184410"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.2.2.2.4.1.1 "><p id="en-us_topic_0045853755__p109167156447">ReplaceKeyPrefixWith</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.2.2.2.4.1.2 "><p id="en-us_topic_0045853755__p119161715134413">Object name prefix on which the redirection rule takes effect</p>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.2.2.2.4.1.2 "><p id="en-us_topic_0045853755__p130175665316">The object name prefix used in the redirection request. OBS replaces the value of <strong id="en-us_topic_0045853755__b13222155116129">KeyPrefixEquals</strong> with the value you specified here for <strong id="en-us_topic_0045853755__b19325135517124">ReplaceKeyPrefixWith</strong>.</p>
<p id="en-us_topic_0045853755__p56931718544">For example, to redirect requests for <strong id="en-us_topic_0045853755__b1831612161620">docs</strong> (objects in the <strong id="en-us_topic_0045853755__b618982514175">docs</strong> directory) to <strong id="en-us_topic_0045853755__b186571406176">documents</strong> (objects in the <strong id="en-us_topic_0045853755__b1526918742219">documents</strong> directory), set <strong id="en-us_topic_0045853755__b1083852416222">KeyPrefixEquals</strong> to <strong id="en-us_topic_0045853755__b676382832216">docs</strong> under <strong id="en-us_topic_0045853755__b147931231145710">Condition</strong> and <strong id="en-us_topic_0045853755__b125215412317">ReplaceKeyPrefixWith</strong> to <strong id="en-us_topic_0045853755__b109571083236">documents</strong> under <strong id="en-us_topic_0045853755__b1239154719571">Redirect</strong>. This way, requests for object <strong id="en-us_topic_0045853755__b132441144152319">docs/a.html</strong> will be redirected to <strong id="en-us_topic_0045853755__b1269195852313">documents/a.html</strong>.</p>
</td>
</tr>
<tr id="en-us_topic_0045853755__row15916111519446"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.2.2.2.4.1.1 "><p id="en-us_topic_0045853755__p1391611518441">ReplaceKeyWith</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.2.2.2.4.1.2 "><p id="en-us_topic_0045853755__p891661574418">Object name on which the redirection rule takes effect</p>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.2.2.2.4.1.2 "><p id="en-us_topic_0045853755__p527545675416">The object name used in the redirection request. OBS replaces the entire object name in the request with the value you specified here for <strong id="en-us_topic_0045853755__b1867410487321">ReplaceKeyWith</strong>.</p>
<p id="en-us_topic_0045853755__p17284133215413">For example, to redirect requests for all objects in the <strong id="en-us_topic_0045853755__b1479010335380">docs</strong> directory to <strong id="en-us_topic_0045853755__b1991854363814">documents/error.html</strong>, set <strong id="en-us_topic_0045853755__b11206124914383">KeyPrefixEquals</strong> to <strong id="en-us_topic_0045853755__b684918823918">docs</strong> under <strong id="en-us_topic_0045853755__b1855219124583">Condition</strong> and <strong id="en-us_topic_0045853755__b124201621123910">ReplaceKeyWith</strong> to <strong id="en-us_topic_0045853755__b3481103403917">documents/error.html</strong> under <strong id="en-us_topic_0045853755__b178362315819">Redirect</strong>. This way, requests for both objects <strong id="en-us_topic_0045853755__b1963161104020">docs/a.html</strong> and <strong id="en-us_topic_0045853755__b1195518149407">docs/b.html</strong> will be redirected to <strong id="en-us_topic_0045853755__b85962343403">documents/error.html</strong>.</p>
</td>
</tr>
<tr id="en-us_topic_0045853755__row191651510442"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.2.2.2.4.1.1 "><p id="en-us_topic_0045853755__p391619155443">HttpRedirectCode</p>

12
docs/obs/umn/en-us_topic_0045853756.html
View File

@ -9,15 +9,17 @@
<div class="section" id="en-us_topic_0045853756__section4474995017112"><h4 class="sectiontitle">Background Information</h4><p id="en-us_topic_0045853756__p1083392434616"><strong id="en-us_topic_0045853756__en-us_topic_0066176932_b27993720241">Object Deletion with Versioning Enabled</strong></p>
<p id="en-us_topic_0045853756__p3811164916814">When versioning is enabled for a bucket, OBS works slightly different when deleting different objects.</p>
<ul id="en-us_topic_0045853756__ul188111049680"><li id="en-us_topic_0045853756__li58113497814">Deleting a file or folder: The file or folder is not permanently deleted, but is retained in the <strong id="en-us_topic_0045853756__b1019013713418">Deleted Objects</strong> list and marked with the <strong id="en-us_topic_0045853756__b3190937544">Delete Marker</strong>. In <strong id="en-us_topic_0045853756__b145986654812">Deleted Objects</strong>, click the object name. On the <strong id="en-us_topic_0045853756__b918773216485">Versions</strong> tab, you can see that the latest object version has the delete marker.<ul id="en-us_topic_0045853756__ul28125495811"><li id="en-us_topic_0045853756__li8812164914810">To permanently delete the file or folder, delete it again from the <strong id="en-us_topic_0045853756__b106151452142">Deleted Objects</strong> list. For details, see <a href="#en-us_topic_0045853756__section56466209">Procedure</a>.</li><li id="en-us_topic_0045853756__li138124491681">To recover the deleted file, undelete it from the <strong id="en-us_topic_0045853756__b9271416752">Deleted Objects</strong> list. For details, see <a href="en-us_topic_0066176932.html">Undeleting an Object</a>.</li></ul>
</li><li id="en-us_topic_0045853756__li108124498813">Deleting an object version: The version will be permanently deleted. If the deleted version is the latest one, the next latest version becomes the latest version.</li></ul>
</li><li id="en-us_topic_0045853756__li108124498813">Deleting an object version: The version will be permanently deleted and cannot be recovered. If the deleted version is the latest one, the next latest version becomes the latest version.</li></ul>
</div>
<div class="section" id="en-us_topic_0045853756__section56466209"><a name="en-us_topic_0045853756__section56466209"></a><a name="section56466209"></a><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853756__ol36405904"><li id="en-us_topic_0045853756__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853756__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853756__li1733753692411"><span>In the navigation pane, choose <strong id="en-us_topic_0045853756__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="en-us_topic_0045853756__li1463890417452"><span>Select the file or folder you want to delete, and choose <strong id="en-us_topic_0045853756__b1994517127">More</strong> &gt; <strong id="en-us_topic_0045853756__b2469696171138">Delete</strong> on the right.</span><p><p id="en-us_topic_0045853756__en-us_topic_0066036524_p18694614">You can select multiple files or folders and click <strong id="en-us_topic_0045853756__b1919669813155639">Delete</strong> above the object list to batch delete them.</p>
</p></li><li id="en-us_topic_0045853756__en-us_topic_0066036524_li34033799"><span>Click <strong id="en-us_topic_0045853756__b2066253718256">Yes</strong> to confirm the deletion.</span></li><li id="en-us_topic_0045853756__li15791184521118"><span>If versioning is enabled for the bucket, delete the deleted files or folders again from the <strong id="en-us_topic_0045853756__b1489110814398">Deleted Objects</strong> list to permanently delete them.</span><p><ol type="a" id="en-us_topic_0045853756__ol1694911141313"><li id="en-us_topic_0045853756__li329516215438">Click <strong id="en-us_topic_0045853756__b1428610442012">Deleted Objects</strong>.</li><li id="en-us_topic_0045853756__li1725114121417">In the <strong id="en-us_topic_0045853756__b122564346399">Operation</strong> column of the file or folder to be deleted, click <strong id="en-us_topic_0045853756__b9196114171512">Permanently Delete</strong>.<p id="en-us_topic_0045853756__p63743352160">You can also select multiple files or folders and click <strong id="en-us_topic_0045853756__b12162648103917">Permanently Delete</strong> above the object list to batch delete them.</p>
<div class="section" id="en-us_topic_0045853756__section56466209"><a name="en-us_topic_0045853756__section56466209"></a><a name="section56466209"></a><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853756__ol36405904"><li id="en-us_topic_0045853756__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853756__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853756__li1733753692411"><span>In the navigation pane, choose <strong id="en-us_topic_0045853756__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="en-us_topic_0045853756__li1463890417452"><span>Select the file or folder you want to delete and choose <strong id="en-us_topic_0045853756__b1994517127">More</strong> &gt; <strong id="en-us_topic_0045853756__b2469696171138">Delete</strong> on the right.</span><p><p id="en-us_topic_0045853756__en-us_topic_0066036524_p18694614">You can select multiple files or folders and click <strong id="en-us_topic_0045853756__b1919669813155639">Delete</strong> above the object list to batch delete them.</p>
</p></li><li id="en-us_topic_0045853756__en-us_topic_0066036524_li34033799"><span>Click <strong id="en-us_topic_0045853756__b11509189151813">Yes</strong> to confirm the deletion.</span><p><div class="caution" id="en-us_topic_0045853756__note16884124153911"><span class="cautiontitle"><img src="public_sys-resources/caution_3.0-en-us.png"> </span><div class="cautionbody"><p id="en-us_topic_0045853756__p488414410392">If you delete an object from a bucket with versioning enabled, the object is not permanently deleted but retained in the <strong id="en-us_topic_0045853756__b799843610125">Deleted Objects</strong> list. All versions of the object are still kept in the bucket and are billed for storage. If you need to permanently delete the object, see the following steps.</p>
</div></div>
</p></li><li id="en-us_topic_0045853756__li15791184521118"><span>If versioning is enabled for the bucket, delete the files or folders again from the <strong id="en-us_topic_0045853756__b1489110814398">Deleted Objects</strong> list to permanently delete them.</span><p><ol type="a" id="en-us_topic_0045853756__ol1694911141313"><li id="en-us_topic_0045853756__li329516215438">Click <strong id="en-us_topic_0045853756__b1428610442012">Deleted Objects</strong>.</li><li id="en-us_topic_0045853756__li1725114121417">In the <strong id="en-us_topic_0045853756__b122564346399">Operation</strong> column of the file or folder to be deleted, click <strong id="en-us_topic_0045853756__b9196114171512">Permanently Delete</strong>.<p id="en-us_topic_0045853756__p63743352160">You can also select multiple files or folders and click <strong id="en-us_topic_0045853756__b12162648103917">Permanently Delete</strong> above the object list to batch delete them.</p>
</li></ol>
</p></li></ol>
</div>
<div class="section" id="en-us_topic_0045853756__section089519314196"><a name="en-us_topic_0045853756__section089519314196"></a><a name="section089519314196"></a><h4 class="sectiontitle">Related Operations</h4><div class="p" id="en-us_topic_0045853756__p747615218216">When versioning is enabled, files in the <strong id="en-us_topic_0045853756__b118321213194311">Deleted Objects</strong> list also have multiple versions. Note the following points when deleting different versions of files:<ul id="en-us_topic_0045853756__ul680983374211"><li id="en-us_topic_0045853756__li4809233154212">Deleting a version with the <strong id="en-us_topic_0045853756__b124401227135111">Delete Marker</strong> actually recovers this version instead of permanently deleting it. For details, see <a href="en-us_topic_0066176932.html">Undeleting an Object</a>.</li><li id="en-us_topic_0045853756__li14809143354215">Deleting a version without the <strong id="en-us_topic_0045853756__b135921220165316">Delete Marker</strong> permanently deletes this version. This version will not be recovered even if the object is recovered later.</li></ul>
</div>
<div class="section" id="en-us_topic_0045853756__section089519314196"><a name="en-us_topic_0045853756__section089519314196"></a><a name="section089519314196"></a><h4 class="sectiontitle">Related Operations</h4><p id="en-us_topic_0045853756__p747615218216">When versioning is enabled, files in the <strong id="en-us_topic_0045853756__b118321213194311">Deleted Objects</strong> list also have multiple versions. Note the following points when deleting different versions of files:</p>
<ul id="en-us_topic_0045853756__ul680983374211"><li id="en-us_topic_0045853756__li4809233154212">Deleting a version with the <strong id="en-us_topic_0045853756__b124401227135111">Delete Marker</strong> actually recovers this version instead of permanently deleting it. For details, see <a href="en-us_topic_0066176932.html">Undeleting an Object</a>.</li><li id="en-us_topic_0045853756__li14809143354215">Deleting a version without the <strong id="en-us_topic_0045853756__b135921220165316">Delete Marker</strong> permanently deletes this version. This version will not be recovered even if the object is recovered later.</li></ul>
</div>
</div>
<div>

12
docs/obs/umn/en-us_topic_0045853764.html
View File

@ -3,18 +3,18 @@
<h1 class="topictitle1">Managing Accounts</h1>
<div id="body8662426"><p id="en-us_topic_0045853764__p1588588471">Account names on OBS Browser are used to distinguish one from another, which are irrelevant to the registered cloud service account. An OBS Browser account has one pair of AK and SK, but a pair of AK and SK can be used by multiple OBS Browser accounts. A maximum of 10 accounts can be added to OBS Browser.</p>
<p id="en-us_topic_0045853764__a9ee1baf545504fa18b4420f79aa0f577">OBS Browser uses the AK and SK for identity authentication. AKs and SKs are the access keys created by on the management console (on <strong id="en-us_topic_0045853764__b8823171081715">My Credential</strong> page) by cloud service accounts and IAM users. For details, see <a href="obs_03_0405.html">Creating Access Keys (AK and SK)</a>.</p>
<ol id="en-us_topic_0045853764__ol361251681120"><li id="en-us_topic_0045853764__li18612116151113">AKs and SKs are required for logging in to OBS Browser to access OBS resources.</li><li id="en-us_topic_0045853764__li175911247191220">Once an AK and SK are entered, IAM receives the AK and SK, finds the cloud service account or IAM user that own the pair of AK and SK, and checks which OBS permissions the account or IAM user has.</li><li id="en-us_topic_0045853764__li181713282136">Then IAM authorizes the user who tries to log in to OBS Browser the OBS permissions accordingly.</li><li id="en-us_topic_0045853764__li98531228131418">The user can access OBS resources through OBS Browser.</li></ol>
<div class="section" id="en-us_topic_0045853764__s37e0eea035fc48e29b93c6ffbe9fadf1"><h4 class="sectiontitle">Add an Account</h4><ol id="en-us_topic_0045853764__o1adf60176e5245a1b5bf9e5b5c08b162"><li id="en-us_topic_0045853764__l7096fd15c7994190817554b5beab8f4a"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853764__l88c0336e2493418ea0debd3d164e2387"><span>In the upper right corner of OBS Browser, click the account name, and select <strong id="en-us_topic_0045853764__b2420151217228">Manage Account</strong>.</span></li><li id="en-us_topic_0045853764__l37dea8e1cb904a2ebe28ef6bc85995cd"><span>In the <strong id="en-us_topic_0045853764__b18949014152219">Manage Account</strong> dialog box that is displayed, click <strong id="en-us_topic_0045853764__b394991492212">Add Account</strong>.</span></li><li id="en-us_topic_0045853764__l18583f81bd3a49f3ad0a226ee5c06df2"><span>In the <strong id="en-us_topic_0045853764__b191169386229">Add Account</strong> dialog box, enter the account information.</span><p><p id="en-us_topic_0045853764__a6e73c586e39d4fa299c471dd6adf5b89">The account information includes the following parameters:</p>
<ul id="en-us_topic_0045853764__u914059a5a7d64ab19c290c246d3bd062"><li id="en-us_topic_0045853764__l9576f9cf380643d28dcf77fa3bdddc52">Account name: The account name is used only to uniquely identify an account and can be different from the OBS account registered with the cloud services. The account name cannot exceed 50 characters.</li><li id="en-us_topic_0045853764__lc7358cc5b57242fb90e8c0122b9c64c0">Service: OBS Browser can connect to <strong id="en-us_topic_0045853764__b527345151111">OBS</strong> or <strong id="en-us_topic_0045853764__b1334662033714">Other object storage services</strong>.<ul id="en-us_topic_0045853764__uc8d766687532494b94e750276a344909"><li id="en-us_topic_0045853764__lba533434db614035b07ed0ea0e66ab11">When accessing OBS, select <strong id="en-us_topic_0045853764__b0145191812468">OBS</strong>. For details, see <a href="#en-us_topic_0045853764__f7b99ff29dc1543b4b16e69c9db5bd5af">Figure 1</a>.<div class="fignone" id="en-us_topic_0045853764__f7b99ff29dc1543b4b16e69c9db5bd5af"><a name="en-us_topic_0045853764__f7b99ff29dc1543b4b16e69c9db5bd5af"></a><a name="f7b99ff29dc1543b4b16e69c9db5bd5af"></a><span class="figcap"><b>Figure 1 </b>Add a new account - OBS</span><br><span><img id="en-us_topic_0045853764__image1531731141011" src="en-us_image_0129866022.png" title="Click to enlarge" class="imgResize"></span></div>
</li><li id="en-us_topic_0045853764__li285564717611">When connecting to other object storage services, select <strong id="en-us_topic_0045853764__b3827135813398">Other object storage services</strong>. For details, see <a href="#en-us_topic_0045853764__f8c588f27619148c78257359a12e609a7">Figure 2</a>.<div class="p" id="en-us_topic_0045853764__p5451174810619">Specify <strong id="en-us_topic_0045853764__b2911520132713">Server Address</strong>. You can enter the IP address or domain name in the following format: <em id="en-us_topic_0045853764__i1397895382710">server IP address or domain name:server port</em> (the protocol port of HTTPS is <strong id="en-us_topic_0045853764__b588332213282">443</strong> and that of HTTP is <strong id="en-us_topic_0045853764__b104262033152811">80</strong>). The HTTPS server is used by default. If you want to use the HTTP server, click <span><img id="en-us_topic_0045853764__image1047861716599" src="en-us_image_0237530299.png"></span> in the upper right corner and click <strong id="en-us_topic_0045853764__b1940912176">System Configuration</strong>. In the <strong id="en-us_topic_0045853764__b1143179660">System Configuration</strong> dialog box that is displayed, deselect <strong id="en-us_topic_0045853764__b2052732098">Enable HTTPS</strong>.<div class="fignone" id="en-us_topic_0045853764__f8c588f27619148c78257359a12e609a7"><a name="en-us_topic_0045853764__f8c588f27619148c78257359a12e609a7"></a><a name="f8c588f27619148c78257359a12e609a7"></a><span class="figcap"><b>Figure 2 </b>Adding a new account - Other object storage services</span><br><span><img id="en-us_topic_0045853764__image198085231010" src="en-us_image_0129867278.png" title="Click to enlarge" class="imgResize"></span></div>
<ol id="en-us_topic_0045853764__ol361251681120"><li id="en-us_topic_0045853764__li18612116151113">AKs and SKs are required for logging in to OBS Browser to access OBS resources.</li><li id="en-us_topic_0045853764__li175911247191220">Once an AK and SK are entered, IAM receives the AK and SK, finds the cloud service account or IAM user that owns the pair of AK and SK, and checks which OBS permissions the account or IAM user has.</li><li id="en-us_topic_0045853764__li181713282136">Then IAM grants the user who tries to log in to OBS Browser the OBS permissions accordingly.</li><li id="en-us_topic_0045853764__li98531228131418">The user can access OBS resources through OBS Browser.</li></ol>
<div class="section" id="en-us_topic_0045853764__s37e0eea035fc48e29b93c6ffbe9fadf1"><h4 class="sectiontitle">Adding an Account</h4><ol id="en-us_topic_0045853764__o1adf60176e5245a1b5bf9e5b5c08b162"><li id="en-us_topic_0045853764__l7096fd15c7994190817554b5beab8f4a"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853764__l88c0336e2493418ea0debd3d164e2387"><span>In the upper right corner of OBS Browser, click the account name, and select <strong id="en-us_topic_0045853764__b3948634124020">Manage Account</strong>.</span></li><li id="en-us_topic_0045853764__l37dea8e1cb904a2ebe28ef6bc85995cd"><span>In the <strong id="en-us_topic_0045853764__b112859381404">Manage Account</strong> dialog box that is displayed, click <strong id="en-us_topic_0045853764__b628563844013">Add Account</strong>.</span></li><li id="en-us_topic_0045853764__l18583f81bd3a49f3ad0a226ee5c06df2"><span>In the <strong id="en-us_topic_0045853764__b7739103917402">Add Account</strong> dialog box, enter the account information.</span><p><p id="en-us_topic_0045853764__a6e73c586e39d4fa299c471dd6adf5b89">The following parameters need to be configured:</p>
<ul id="en-us_topic_0045853764__u914059a5a7d64ab19c290c246d3bd062"><li id="en-us_topic_0045853764__l9576f9cf380643d28dcf77fa3bdddc52">Account name: The account name is used only to uniquely identify an account and can be different from the OBS account registered with the cloud services. The account name cannot exceed 50 characters.</li><li id="en-us_topic_0045853764__lc7358cc5b57242fb90e8c0122b9c64c0">Service: OBS Browser can connect to <strong id="en-us_topic_0045853764__b527345151111">OBS</strong> or <strong id="en-us_topic_0045853764__b1334662033714">Other object storage services</strong>.<ul id="en-us_topic_0045853764__uc8d766687532494b94e750276a344909"><li id="en-us_topic_0045853764__lba533434db614035b07ed0ea0e66ab11">When connecting OBS Browser to OBS, select <strong id="en-us_topic_0045853764__b0145191812468">OBS</strong>. For details, see <a href="#en-us_topic_0045853764__f7b99ff29dc1543b4b16e69c9db5bd5af">Figure 1</a>.<div class="fignone" id="en-us_topic_0045853764__f7b99ff29dc1543b4b16e69c9db5bd5af"><a name="en-us_topic_0045853764__f7b99ff29dc1543b4b16e69c9db5bd5af"></a><a name="f7b99ff29dc1543b4b16e69c9db5bd5af"></a><span class="figcap"><b>Figure 1 </b>Adding a new account - OBS</span><br><span><img id="en-us_topic_0045853764__image1531731141011" src="en-us_image_0129866022.png" title="Click to enlarge" class="imgResize"></span></div>
</li><li id="en-us_topic_0045853764__li285564717611">When connecting OBS Browser to any other object storage service, select <strong id="en-us_topic_0045853764__b3827135813398">Other object storage services</strong>. For details, see <a href="#en-us_topic_0045853764__f8c588f27619148c78257359a12e609a7">Figure 2</a>.<div class="p" id="en-us_topic_0045853764__p5451174810619">Specify <strong id="en-us_topic_0045853764__b2911520132713">Server Address</strong>. You can enter the IP address or domain name in the following format: <em id="en-us_topic_0045853764__i1397895382710">server IP address or domain name:server port</em> (the protocol port of HTTPS is <strong id="en-us_topic_0045853764__b588332213282">443</strong> and that of HTTP is <strong id="en-us_topic_0045853764__b104262033152811">80</strong>). The HTTPS server is used by default. If you want to use the HTTP server, click <span><img id="en-us_topic_0045853764__image1047861716599" src="en-us_image_0237530299.png"></span> in the upper right corner and click <strong id="en-us_topic_0045853764__b1395258867">System Configuration</strong>. In the <strong id="en-us_topic_0045853764__b1063289226">System Configuration</strong> dialog box that is displayed, deselect <strong id="en-us_topic_0045853764__b1101492717">Enable HTTPS</strong>.<div class="fignone" id="en-us_topic_0045853764__f8c588f27619148c78257359a12e609a7"><a name="en-us_topic_0045853764__f8c588f27619148c78257359a12e609a7"></a><a name="f8c588f27619148c78257359a12e609a7"></a><span class="figcap"><b>Figure 2 </b>Adding a new account - Other object storage services</span><br><span><img id="en-us_topic_0045853764__image198085231010" src="en-us_image_0129867278.png" title="Click to enlarge" class="imgResize"></span></div>
</div>
</li></ul>
</li></ul>
<ul id="en-us_topic_0045853764__u572053b0e7ff4ed685591e480985f3cd"><li id="en-us_topic_0045853764__l5c80bedd86344e13bd40047b1c26d5ad">AK and SK: Enter the AK and SK created on the <strong id="en-us_topic_0045853764__b19694124316132">My Credential</strong> page after you register with a cloud service. For details about how to obtain AKs and SKs, see <a href="obs_03_0405.html">Creating Access Keys (AK and SK)</a>.</li><li id="en-us_topic_0045853764__lc2cea96b02214ece991f6ec890dd3cbb"><strong id="en-us_topic_0045853764__b820451112395">Remember my secret access key</strong> is selected by default. If you do not select <strong id="en-us_topic_0045853764__b1756312299397">Remember my secret access key</strong>, you must input the secret access key each time you log in to OBS Browser.</li></ul>
<ul id="en-us_topic_0045853764__u572053b0e7ff4ed685591e480985f3cd"><li id="en-us_topic_0045853764__l5c80bedd86344e13bd40047b1c26d5ad">AK and SK: Enter the AK and SK created on the <strong id="en-us_topic_0045853764__b20850133574217">My Credential</strong> page after you register with a cloud service. For details about how to obtain AKs and SKs, see <a href="obs_03_0405.html">Creating Access Keys (AK and SK)</a>.</li><li id="en-us_topic_0045853764__lc2cea96b02214ece991f6ec890dd3cbb"><strong id="en-us_topic_0045853764__b820451112395">Remember my secret access key</strong> is selected by default. If you do not select <strong id="en-us_topic_0045853764__b1756312299397">Remember my secret access key</strong>, you must input the secret access key each time you log in to OBS Browser.</li></ul>
</p></li><li id="en-us_topic_0045853764__l19d4fa56d7b74843a0479b35df05e9fe"><span>Click <strong id="en-us_topic_0045853764__en-us_topic_0068417475_en-us_topic_0045853764_b44623710141918">OK</strong>.</span><p><p id="en-us_topic_0045853764__a8d495b004d46497f9836b182ff6898cd">After saving the account information, you can click the account name in the upper corner of the page and the newly added account is displayed in the account name drop-down list. You can click the desired account to switch to that account from the current login account.</p>
</p></li></ol>
</div>
<div class="section" id="en-us_topic_0045853764__s7d777eae81d042bda0ee33fed97ede04"><h4 class="sectiontitle">Edit an Account</h4><ol id="en-us_topic_0045853764__od127b5f9651b4b849cde153fd0aec358"><li id="en-us_topic_0045853764__lbac8c438039447d895bac88c0e68a8f0"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853764__lf85907aafef34562a54df05e0450c8c4"><span>In the upper right corner of OBS Browser, click the account name, and select <strong id="en-us_topic_0045853764__b2428227403">Manage Account</strong>.</span></li><li id="en-us_topic_0045853764__lef0aaa84425e4d66aef1b0a1db3cb4bf"><span>Click <strong id="en-us_topic_0045853764__b151343337402">Edit</strong> in the row where the desired account resides.</span></li><li id="en-us_topic_0045853764__la1486f8204f2448dbcc15e4c8f0e2eb6"><span>Modify account information as required.</span></li><li id="en-us_topic_0045853764__l98ea0197d9fc4885ab5de4ee68d8371b"><span>Click <strong id="en-us_topic_0045853764__b11773185114111">OK</strong> to save the modification.</span></li></ol>
<div class="section" id="en-us_topic_0045853764__s7d777eae81d042bda0ee33fed97ede04"><h4 class="sectiontitle">Editing an Account</h4><ol id="en-us_topic_0045853764__od127b5f9651b4b849cde153fd0aec358"><li id="en-us_topic_0045853764__lbac8c438039447d895bac88c0e68a8f0"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853764__lf85907aafef34562a54df05e0450c8c4"><span>In the upper right corner of OBS Browser, click the account name, and select <strong id="en-us_topic_0045853764__b2428227403">Manage Account</strong>.</span></li><li id="en-us_topic_0045853764__lef0aaa84425e4d66aef1b0a1db3cb4bf"><span>Click <strong id="en-us_topic_0045853764__b151343337402">Edit</strong> in the row where the desired account resides.</span></li><li id="en-us_topic_0045853764__la1486f8204f2448dbcc15e4c8f0e2eb6"><span>Modify account information as required.</span></li><li id="en-us_topic_0045853764__l98ea0197d9fc4885ab5de4ee68d8371b"><span>Click <strong id="en-us_topic_0045853764__b11773185114111">OK</strong> to save the modification.</span></li></ol>
</div>
<div class="section" id="en-us_topic_0045853764__s1e8cf08855dd4b86ad9815dfb56f7326"><h4 class="sectiontitle">Deleting an Account</h4><ol id="en-us_topic_0045853764__o339e32694d8d4853b4286b09948920ba"><li id="en-us_topic_0045853764__l2a7028c6383042cf8875b565390e1f6d"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853764__l3bb5860b0fa44008b7c58b50814699f1"><span>In the upper right corner of OBS Browser, click the account name, and select <strong id="en-us_topic_0045853764__b1799311704116">Manage Account</strong>.</span></li><li id="en-us_topic_0045853764__ld1f101f5457d4554b29edd5650940ac3"><span>Click <strong id="en-us_topic_0045853764__b84231625114119">Delete</strong> in the row where the desired account resides.</span></li><li id="en-us_topic_0045853764__l92af58b779a04801b3f7a6ed3117c809"><span>Click <strong id="en-us_topic_0045853764__en-us_topic_0068417475_en-us_topic_0045853764_b40636024164955">OK</strong> and the account is deleted.</span></li></ol>
</div>

6
docs/obs/umn/en-us_topic_0045853821.html
View File

@ -4,16 +4,16 @@
<div id="body1557123327164"><div class="section" id="en-us_topic_0045853821__section654711404519"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0045853821__p131591575457">You are the object owner or you have the permission to write the object ACL.</p>
<p id="en-us_topic_0045853821__p14538134016468">An object owner is the account that uploads the object, but may not be the owner of the bucket that stores the object. For example, account <strong id="en-us_topic_0045853821__b131031122538">B</strong> is granted the permission to access a bucket of account <strong id="en-us_topic_0045853821__b10109529531">A</strong>, and account <strong id="en-us_topic_0045853821__b1111017255312">B</strong> uploads a file to the bucket. In that case, account <strong id="en-us_topic_0045853821__b1911016216538">B</strong>, instead of the bucket owner account <strong id="en-us_topic_0045853821__b111101821537">A</strong>, is the owner of the object. By default, account A is not allowed to access this object and cannot read or modify the object ACL.</p>
</div>
<div class="section" id="en-us_topic_0045853821__section125891538184018"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853821__ol3653067817298"><li id="en-us_topic_0045853821__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853821__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853821__li2931491252"><span>In the navigation pane, choose <strong id="en-us_topic_0045853821__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="en-us_topic_0045853821__li27180413161423"><span>Click the object to be operated.</span></li><li id="en-us_topic_0045853821__li30113624141859"><span>On the <strong id="en-us_topic_0045853821__b51051121169">Object ACL</strong> tab, click <strong id="en-us_topic_0045853821__b12752165594317">Edit</strong> to set ACL permissions of the <strong id="en-us_topic_0045853821__b1250210194412">Owner</strong>, <strong id="en-us_topic_0045853821__b999571984411">Registered User</strong>, and <strong id="en-us_topic_0045853821__b12376141564415">Anonymous User</strong> for the target object.</span><p><div class="note" id="en-us_topic_0045853821__note32759916"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="NotesText" id="en-us_topic_0045853821__p26403792">If the object is encrypted, the ACL permission cannot be configured for registered users and anonymous users.</p>
<div class="section" id="en-us_topic_0045853821__section125891538184018"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853821__ol3653067817298"><li id="en-us_topic_0045853821__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853821__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853821__li2931491252"><span>In the navigation pane, choose <strong id="en-us_topic_0045853821__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="en-us_topic_0045853821__li27180413161423"><span>Click the object to be operated.</span></li><li id="en-us_topic_0045853821__li30113624141859"><span>On the <strong id="en-us_topic_0045853821__b51051121169">Object ACL</strong> tab page, click <strong id="en-us_topic_0045853821__b12752165594317">Edit</strong> to grant the owner, registered user, and anonymous user ACL permissions for the object.</span><p><div class="note" id="en-us_topic_0045853821__note32759916"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="NotesText" id="en-us_topic_0045853821__p26403792">ACL permissions for encrypted objects cannot be granted to registered users or anonymous users.</p>
</div></div>
</p></li><li id="en-us_topic_0045853821__li1325219548272"><span>Click <strong id="en-us_topic_0045853821__b13467135117710">Add</strong> to apply specific ACL permissions to an account, as shown in <a href="#en-us_topic_0045853821__fig3474335195326">Figure 1</a>.</span><p><p id="en-us_topic_0045853821__p271280205114">Enter an account ID or account name and set ACL permissions for the account. You can obtain the account ID or account name from the <strong id="en-us_topic_0045853821__b13462053113017">My Credentials</strong> page. The account ID and account name correspond to the <strong id="en-us_topic_0045853821__b439115211314">Domain ID</strong> and <strong id="en-us_topic_0045853821__b1139272116111">Domain Name</strong> respectively on the <strong id="en-us_topic_0045853821__b9392102115112">My Credentials</strong> page.</p>
</p></li><li id="en-us_topic_0045853821__li1325219548272"><span>Click <strong id="en-us_topic_0045853821__b754016207183">Add</strong> to apply specific ACL permissions to an account, as shown in <a href="#en-us_topic_0045853821__fig3474335195326">Figure 1</a>.</span><p><p id="en-us_topic_0045853821__p271280205114">Enter an account ID or account name and specify ACL permissions for the account. You can obtain the account ID or account name from the <strong id="en-us_topic_0045853821__b13462053113017">My Credentials</strong> page. The account ID and account name correspond to the <strong id="en-us_topic_0045853821__b439115211314">Domain ID</strong> and <strong id="en-us_topic_0045853821__b1139272116111">Domain Name</strong> respectively on the <strong id="en-us_topic_0045853821__b9392102115112">My Credentials</strong> page.</p>
<div class="fignone" id="en-us_topic_0045853821__fig3474335195326"><a name="en-us_topic_0045853821__fig3474335195326"></a><a name="fig3474335195326"></a><span class="figcap"><b>Figure 1 </b>Adding ACL permissions for an object</span><br><span><img id="en-us_topic_0045853821__image1665582616554" src="en-us_image_0168396382.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="en-us_topic_0045853821__li4969125915456"><span>Click <strong id="en-us_topic_0045853821__b13644141523117">Save</strong>.</span></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0086.html">Permission Control</a></div>
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0086.html">Permissions Control</a></div>
</div>
</div>

16
docs/obs/umn/en-us_topic_0045853854.html
View File

@ -4,22 +4,22 @@
<div id="body8662426"><p class="MsoNormal" id="en-us_topic_0045853854__a011084ccf48a4f58a085187a6b7f134d">You can configure a lifecycle management rule for a bucket, and applicable objects in the bucket will be managed by the rule.</p>
<div class="section" id="en-us_topic_0045853854__s359ce6c524924685935216cccfb24694"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853854__o68eced8e247a4f02be462c64adfc781f"><li id="en-us_topic_0045853854__l603a13b7f742435d95de28b80715893b"><span>Log in to OBS Browser.</span></li><li id="en-us_topic_0045853854__ldd39e62d1a324e1bb5c8310318f299f5"><span>Click the blank area in the row of the bucket for which you want to configure a lifecycle rule and choose <strong id="en-us_topic_0045853854__ab5ea61f13edb4b9a9e65eb2d4b76953d">More</strong> &gt; <strong id="en-us_topic_0045853854__a02ade08eb3c3489298d230fc605bc340">Configure Lifecycle Rule</strong>.</span></li><li id="en-us_topic_0045853854__l4d057ec816d0472d9f09f79af460d8a2"><span>In the <strong id="en-us_topic_0045853854__b128421443143315">Configure Lifecycle Rule</strong> dialog box, click <strong id="en-us_topic_0045853854__b9735860115">Create</strong>. The dialog box in <a href="#en-us_topic_0045853854__fig49848587164214">Figure 1</a> is displayed.</span><p><div class="fignone" id="en-us_topic_0045853854__fig49848587164214"><a name="en-us_topic_0045853854__fig49848587164214"></a><a name="fig49848587164214"></a><span class="figcap"><b>Figure 1 </b>Creating a lifecycle rule on OBS Browser</span><br><span><img id="en-us_topic_0045853854__image230212174318" src="en-us_image_0129833825.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="en-us_topic_0045853854__l853c4fbb194b42b4b5ba54cd8c20aa03"><span>Configure a lifecycle rule.</span><p><div class="p" id="en-us_topic_0045853854__obs_03_0335_p5509517915252"><strong id="en-us_topic_0045853854__obs_03_0335_b264519183425">Basic Information</strong>:<ul id="en-us_topic_0045853854__obs_03_0335_ul16342320"><li id="en-us_topic_0045853854__obs_03_0335_li6267879315835"><strong id="en-us_topic_0045853854__obs_03_0335_b5881289715835">Status</strong>: <p id="en-us_topic_0045853854__obs_03_0335_p885822615835">Select <strong id="en-us_topic_0045853854__obs_03_0335_b19429790191407">Enable</strong> to enable the lifecycle rule.</p>
</li><li id="en-us_topic_0045853854__obs_03_0335_li5729884015841"><strong id="en-us_topic_0045853854__obs_03_0335_b2914155715841">Rule Name</strong>: <p id="en-us_topic_0045853854__obs_03_0335_p2310122815842">Identify lifecycle rules. The <strong id="en-us_topic_0045853854__obs_03_0335_b1095408517145111">Rule Name</strong> contains a maximum of 255 characters.</p>
</li><li id="en-us_topic_0045853854__obs_03_0335_li61432666143253"><strong id="en-us_topic_0045853854__obs_03_0335_b1443569572145115">Applies To</strong>: Can be set to <strong id="en-us_topic_0045853854__obs_03_0335_b948338085145115">Object name prefix</strong> or <strong id="en-us_topic_0045853854__obs_03_0335_b405387834145115">Bucket</strong>.<ul id="en-us_topic_0045853854__obs_03_0335_ul4702430145854"><li id="en-us_topic_0045853854__obs_03_0335_li34845172143258"><strong id="en-us_topic_0045853854__obs_03_0335_b1919975112496">Object name prefix</strong>: Objects that have the specified prefix will be managed by the lifecycle rule. The prefix cannot start with a slash (/), cannot have consecutive slashes (/), and cannot contain the following special characters: <strong id="en-us_topic_0045853854__obs_03_0335_b630544719504">\:*?"&lt;&gt;|</strong></li><li id="en-us_topic_0045853854__obs_03_0335_li43762555113418"><strong id="en-us_topic_0045853854__obs_03_0335_b261482711145141">Bucket</strong>: All objects in the bucket will be managed by the lifecycle rule.</li></ul>
</li><li id="en-us_topic_0045853854__obs_03_0335_li5729884015841"><strong id="en-us_topic_0045853854__obs_03_0335_b2914155715841">Rule Name</strong>: <p id="en-us_topic_0045853854__obs_03_0335_p2310122815842">It identifies a lifecycle rule. A rule name can contain a maximum of 255 characters.</p>
</li><li id="en-us_topic_0045853854__obs_03_0335_li61432666143253"><strong id="en-us_topic_0045853854__obs_03_0335_b1443569572145115">Applies To</strong>: Can be set to <strong id="en-us_topic_0045853854__obs_03_0335_b948338085145115">Object name prefix</strong> or <strong id="en-us_topic_0045853854__obs_03_0335_b405387834145115">Bucket</strong>.<ul id="en-us_topic_0045853854__obs_03_0335_ul4702430145854"><li id="en-us_topic_0045853854__obs_03_0335_li34845172143258"><strong id="en-us_topic_0045853854__obs_03_0335_b194117256424">Object name prefix</strong>: Objects with this specified prefix will be managed by the lifecycle rule. The prefix cannot start with a slash (/) or contain two consecutive slashes (//), and cannot contain the following special characters: \:*?"&lt;&gt;|</li><li id="en-us_topic_0045853854__obs_03_0335_li43762555113418"><strong id="en-us_topic_0045853854__obs_03_0335_b261482711145141">Bucket</strong>: All objects in the bucket will be managed by the lifecycle rule.</li></ul>
</li></ul>
<div class="note" id="en-us_topic_0045853854__obs_03_0335_note35283025"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0045853854__obs_03_0335_ul49111773"><li id="en-us_topic_0045853854__obs_03_0335_li39352775">When <strong id="en-us_topic_0045853854__obs_03_0335_b9793193455">Object name prefix</strong> is selected and the specified prefix and the prefix of an existing lifecycle rule overlap, OBS regards the two rules as one and disables the one to be configured. For example, if a rule with prefix <strong id="en-us_topic_0045853854__obs_03_0335_b54296197">abc</strong> exists in the system, another rule whose prefix starts with <strong id="en-us_topic_0045853854__obs_03_0335_b18903728">abc</strong> cannot be configured.</li><li id="en-us_topic_0045853854__obs_03_0335_li18630656">If a lifecycle rule whose <strong id="en-us_topic_0045853854__obs_03_0335_b271524188145347">Applies To</strong> is set to <strong id="en-us_topic_0045853854__obs_03_0335_b1093346387145347">Object name prefix</strong> has been configured, you cannot configure a lifecycle rule whose <strong id="en-us_topic_0045853854__obs_03_0335_b1811847536145347">Applies To</strong> is set to <strong id="en-us_topic_0045853854__obs_03_0335_b1291855916145347">Bucket</strong>.</li><li id="en-us_topic_0045853854__obs_03_0335_li33458177">If a lifecycle rule has been configured for the entire bucket, no more rules that apply to object name prefix can be added.</li></ul>
<div class="note" id="en-us_topic_0045853854__obs_03_0335_note35283025"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0045853854__obs_03_0335_ul49111773"><li id="en-us_topic_0045853854__obs_03_0335_li39352775">If the specified prefix is overlapping with the prefix set in an existing lifecycle rule, OBS regards these two rules as one and forbids you to configure the one you are configuring. For example, if there is already a rule with prefix <strong id="en-us_topic_0045853854__obs_03_0335_b54296197">abc</strong> in OBS, you cannot configure another rule whose prefix starts with <strong id="en-us_topic_0045853854__obs_03_0335_b18903728">abc</strong>.</li><li id="en-us_topic_0045853854__obs_03_0335_li18630656">If there is already a lifecycle rule based on an object prefix, you are not allowed to configure another rule that is applied to the entire bucket.</li><li id="en-us_topic_0045853854__obs_03_0335_li33458177">If a lifecycle rule has been configured for the entire bucket, no more rules that apply to object name prefix can be added.</li></ul>
</div></div>
</div>
<p id="en-us_topic_0045853854__obs_03_0335_p4329302814373"><strong id="en-us_topic_0045853854__obs_03_0335_b1106642753145428">Current Version</strong> or <strong id="en-us_topic_0045853854__obs_03_0335_b49163472145428">Historical Version</strong>:</p>
<div class="note" id="en-us_topic_0045853854__obs_03_0335_note16805850"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0045853854__obs_03_0335_ul3456553515453"><li class="NotesText" id="en-us_topic_0045853854__obs_03_0335_li6309484515453"><strong id="en-us_topic_0045853854__obs_03_0335_b55775843115041">Current Version</strong> and <strong id="en-us_topic_0045853854__obs_03_0335_b10717756115044">Historical Version</strong> are two concepts for <strong id="en-us_topic_0045853854__obs_03_0335_b170174764414158">Versioning</strong>. If <strong id="en-us_topic_0045853854__obs_03_0335_b101700759114156">Versioning</strong> is enabled, uploading objects with the same name to the same path generates different versions. The object uploaded lastly is called <strong id="en-us_topic_0045853854__obs_03_0335_b125316129259">Current Version</strong>, and the object uploaded previously is called <strong id="en-us_topic_0045853854__obs_03_0335_b22541312182516">Historical Version</strong>. </li><li id="en-us_topic_0045853854__obs_03_0335_li555179501550">You can configure either the <strong id="en-us_topic_0045853854__obs_03_0335_b1735055012614">Current Version</strong> or <strong id="en-us_topic_0045853854__obs_03_0335_b111680576617">Historical Version</strong>, or both of them.</li></ul>
<div class="note" id="en-us_topic_0045853854__obs_03_0335_note16805850"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0045853854__obs_03_0335_ul3456553515453"><li class="NotesText" id="en-us_topic_0045853854__obs_03_0335_li6309484515453"><strong id="en-us_topic_0045853854__obs_03_0335_b55775843115041">Current Version</strong> and <strong id="en-us_topic_0045853854__obs_03_0335_b10717756115044">Historical Version</strong> are two concepts for versioning. If versioning is enabled for a bucket, uploading objects with the same name to the bucket creates different object versions. The last uploaded object is called the current version, while those previously uploaded are called historical versions. </li><li id="en-us_topic_0045853854__obs_03_0335_li555179501550">You can configure either the <strong id="en-us_topic_0045853854__obs_03_0335_b1735055012614">Current Version</strong> or <strong id="en-us_topic_0045853854__obs_03_0335_b111680576617">Historical Version</strong>, or both of them.</li></ul>
</div></div>
<ul id="en-us_topic_0045853854__obs_03_0335_ul944841515351"><li id="en-us_topic_0045853854__obs_03_0335_li53535400204050"><strong id="en-us_topic_0045853854__obs_03_0335_b125316048314562">Transition to Warm</strong>: You can specify the number of days after which objects that have been last updated and meet specified conditions are automatically transitioned to <strong id="en-us_topic_0045853854__obs_03_0335_b189775300114562">Warm</strong>. This number must be at least 30.</li><li id="en-us_topic_0045853854__obs_03_0335_li40553341204057"><strong id="en-us_topic_0045853854__obs_03_0335_b14315176105017">Transition to Cold</strong>: You can specify the number of days after which objects that have been last updated and meet specified conditions are automatically transitioned to <strong id="en-us_topic_0045853854__obs_03_0335_b11208164211511">Cold</strong>. If you configure to transition objects first to Warm and then Cold, the objects must stay Warm at least 30 days before they can be transitioned to Cold. If only transition to Cold is used, but transition to Warm is not, there is no limit on the number of days for transition.</li><li id="en-us_topic_0045853854__obs_03_0335_li3114893515420">Object deletion upon expiration: You can specify the number of days after which objects that have been last updated and meet the specified conditions are automatically deleted. The expiration time must be greater than the two transition times.</li></ul>
<ul id="en-us_topic_0045853854__obs_03_0335_ul944841515351"><li id="en-us_topic_0045853854__obs_03_0335_li53535400204050"><strong id="en-us_topic_0045853854__obs_03_0335_b162314240584">Transition to Warm</strong>: After this number of days since the last update, objects meeting specified conditions will be transitioned to Warm. This number must be at least 30.</li><li id="en-us_topic_0045853854__obs_03_0335_li40553341204057"><strong id="en-us_topic_0045853854__obs_03_0335_b9401121715914">Transition to Cold</strong>: After this number of days since the last update, objects meeting specified conditions will be transitioned to Cold. If you configure to transition objects first to Warm and then Cold, the objects must stay Warm at least 30 days before they can be transitioned to Cold. If only transition to Cold is used, but transition to Warm is not, there is no limit on the number of days for transition.</li><li id="en-us_topic_0045853854__obs_03_0335_li3114893515420"><strong id="en-us_topic_0045853854__obs_03_0335_b185768348720">Delete Objects After (Days)</strong>: After this number of days since the last update, objects meeting certain conditions will be expired and then deleted. This number must be larger than that specified for any of the transition operations.</li></ul>
<div class="p" id="en-us_topic_0045853854__obs_03_0335_p50988061113345">For example, on January 7, 2015, you saved the following files in OBS:<ul id="en-us_topic_0045853854__obs_03_0335_ul466294043312"><li id="en-us_topic_0045853854__obs_03_0335_li28459613">log/test1.log</li><li id="en-us_topic_0045853854__obs_03_0335_li54809927">log/test2.log</li><li id="en-us_topic_0045853854__obs_03_0335_li23527303">doc/example.doc</li><li id="en-us_topic_0045853854__obs_03_0335_li10419141">doc/good.txt</li></ul>
</div>
<div class="MsoNormal" id="en-us_topic_0045853854__obs_03_0335_p26663410">On January 10, 2015, you saved the following files:<ul id="en-us_topic_0045853854__obs_03_0335_ul1877348103412"><li id="en-us_topic_0045853854__obs_03_0335_li12252614">log/clientlog.log</li><li id="en-us_topic_0045853854__obs_03_0335_li43164662">log/serverlog.log</li><li id="en-us_topic_0045853854__obs_03_0335_li52937641">doc/work.doc</li><li id="en-us_topic_0045853854__obs_03_0335_li19422124114310">doc/travel.txt</li></ul>
<div class="MsoNormal" id="en-us_topic_0045853854__obs_03_0335_p26663410">On January 10, 2015, you saved another four files:<ul id="en-us_topic_0045853854__obs_03_0335_ul1877348103412"><li id="en-us_topic_0045853854__obs_03_0335_li12252614">log/clientlog.log</li><li id="en-us_topic_0045853854__obs_03_0335_li43164662">log/serverlog.log</li><li id="en-us_topic_0045853854__obs_03_0335_li52937641">doc/work.doc</li><li id="en-us_topic_0045853854__obs_03_0335_li19422124114310">doc/travel.txt</li></ul>
</div>
<p id="en-us_topic_0045853854__obs_03_0335_p513573918258">On January 10, 2015, you set the expiration time of objects prefixed with <strong id="en-us_topic_0045853854__obs_03_0335_b1466203810337">log</strong> to one day later, you may encounter the following situations:</p>
<ul id="en-us_topic_0045853854__obs_03_0335_ul144381629142811"><li id="en-us_topic_0045853854__obs_03_0335_li343932952810">Objects <strong id="en-us_topic_0045853854__obs_03_0335_b86511511153712">log/test1.log</strong> and <strong id="en-us_topic_0045853854__obs_03_0335_b0309616103717">log/test2.log</strong> uploaded on January 7, 2015 may be deleted after the last system scan. The deletion may happen on January 10, 2015 or January 11, 2015, depending on the time of the last system scan.</li><li id="en-us_topic_0045853854__obs_03_0335_li49041356113017">Objects <strong id="en-us_topic_0045853854__obs_03_0335_b15317154311425">log/clientlog.log</strong> and <strong id="en-us_topic_0045853854__obs_03_0335_b93695478426">log/serverlog.log</strong> uploaded on January 10, 2015 are usually deleted on January 11, 2015 or January 12, 2015, depending on the time of the last system scan. If the objects have been stored for more than one day at the time of the last system scan, the objects are deleted upon the scan. Or, they are deleted at the next system scan or later whenever their storage duration meets the specified expiration time requirement.</li></ul>
<p id="en-us_topic_0045853854__obs_03_0335_p513573918258">On January 10, 2015, you set the objects prefixed with <strong id="en-us_topic_0045853854__obs_03_0335_b1466203810337">log</strong> to expire one day later. You might encounter the following situations:</p>
<ul id="en-us_topic_0045853854__obs_03_0335_ul144381629142811"><li id="en-us_topic_0045853854__obs_03_0335_li343932952810">Objects <strong id="en-us_topic_0045853854__obs_03_0335_b86511511153712">log/test1.log</strong> and <strong id="en-us_topic_0045853854__obs_03_0335_b0309616103717">log/test2.log</strong> uploaded on January 7, 2015 might be deleted after the last system scan. The deletion could happen on January 10, 2015 or January 11, 2015, depending on the time of the last system scan.</li><li id="en-us_topic_0045853854__obs_03_0335_li49041356113017">Objects <strong id="en-us_topic_0045853854__obs_03_0335_b15317154311425">log/clientlog.log</strong> and <strong id="en-us_topic_0045853854__obs_03_0335_b93695478426">log/serverlog.log</strong> uploaded on January 10, 2015 might be deleted on January 11, 2015 or January 12, 2015, depending on whether they have been stored for over one day (since their last update) when the system scan happened.</li></ul>
<p id="en-us_topic_0045853854__obs_03_0335_p182057154316">On the day of operation, you can set the objects with the name prefix <strong id="en-us_topic_0045853854__obs_03_0335_b164031732111017">log</strong> to be transitioned to <strong id="en-us_topic_0045853854__obs_03_0335_b8404123211010">Warm</strong> 30 days later, transitioned to <strong id="en-us_topic_0045853854__obs_03_0335_b104045322101">Cold</strong> 60 days later, and deleted 100 days later, then OBS will transition <strong id="en-us_topic_0045853854__obs_03_0335_b8404123201014">log/clientlog.log</strong>, <strong id="en-us_topic_0045853854__obs_03_0335_b17404123211013">log/serverlog.log</strong>, <strong id="en-us_topic_0045853854__obs_03_0335_b340433291011">log/test1.log</strong>, and <strong id="en-us_topic_0045853854__obs_03_0335_b1940443211020">log/test2.log</strong> to <strong id="en-us_topic_0045853854__obs_03_0335_b20404133212104">Warm</strong> when their storage duration exceeds 30 days, transition them to <strong id="en-us_topic_0045853854__obs_03_0335_b11404183261014">Cold</strong> when their storage duration exceeds 60 days, and delete them when their storage duration exceeds 100 days, respectively.</p>
<div class="note" id="en-us_topic_0045853854__obs_03_0335_note8551937154317"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853854__obs_03_0335_p1656615482483">In theory, it takes 24 hours at most to execute a lifecycle rule. Because OBS calculates the lifecycle of an object from the next 00:00 (UTC time) after the object is uploaded, there may be a delay in transitioning objects between storage classes and deleting expired objects. Generally, the delay does not exceed 48 hours. If you make changes to an existing lifecycle rule, the rule will take effect again.</p>
</div></div>

6
docs/obs/umn/en-us_topic_0045853860.html
View File

@ -7,7 +7,7 @@
</p></li><li id="en-us_topic_0045853860__ld376f10636be4cfbbe4e7a7beabb99b9"><span>In the <strong id="en-us_topic_0045853860__b31769315353">Add CORS Rule</strong> dialog box that is displayed, enter CORS rules.</span><p><div class="fignone" id="en-us_topic_0045853860__fe30e6fe056434c66a690c9063d04e6bb"><span class="figcap"><b>Figure 1 </b>Adding a CORS rule</span><br><span><img id="en-us_topic_0045853860__image9932163915310" src="en-us_image_0129834236.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="en-us_topic_0045853860__a75de0ac8ec7f4961b07a5097182bd1f9"><a href="#en-us_topic_0045853860__t810c07199d9d4fb4949e45cc402582a0">Table 1</a> describes parameters in CORS rules.</p>
<div class="tablenoborder"><a name="en-us_topic_0045853860__t810c07199d9d4fb4949e45cc402582a0"></a><a name="t810c07199d9d4fb4949e45cc402582a0"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0045853860__t810c07199d9d4fb4949e45cc402582a0" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters in CORS rules</caption><thead align="left"><tr id="en-us_topic_0045853860__r282c3ed8eee94e42b62d5849670244ca"><th align="left" class="cellrowborder" valign="top" width="32%" id="mcps1.3.2.2.4.2.3.2.3.1.1"><p id="en-us_topic_0045853860__a602c237b70394ce5a689bb6ebdca0c16">Parameter</p>
<div class="tablenoborder"><a name="en-us_topic_0045853860__t810c07199d9d4fb4949e45cc402582a0"></a><a name="t810c07199d9d4fb4949e45cc402582a0"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0045853860__t810c07199d9d4fb4949e45cc402582a0" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters in a CORS rule</caption><thead align="left"><tr id="en-us_topic_0045853860__r282c3ed8eee94e42b62d5849670244ca"><th align="left" class="cellrowborder" valign="top" width="32%" id="mcps1.3.2.2.4.2.3.2.3.1.1"><p id="en-us_topic_0045853860__a602c237b70394ce5a689bb6ebdca0c16">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="68%" id="mcps1.3.2.2.4.2.3.2.3.1.2"><p id="en-us_topic_0045853860__a1d5215e5897b4b16828bfbc8b1878a5a">Description</p>
</th>
@ -46,7 +46,9 @@ https://*.vbs.example.com</pre>
</tbody>
</table>
</div>
</p></li><li id="en-us_topic_0045853860__l909d86eda87a4867840e3f70759c3d27"><span>Click <strong id="en-us_topic_0045853860__b49531058153717">OK</strong>.</span></li><li id="en-us_topic_0045853860__lb7780ddd3dc54401a277774fe33669f5"><span>Click <strong id="en-us_topic_0045853860__en-us_topic_0068417484_en-us_topic_0045853860_b28560655">OK</strong> to save the rules.</span><p><p id="en-us_topic_0045853860__ad8d208b8d5f54feab51ecccbc9db574e">After CORS is successfully configured, only the addresses specified in <strong id="en-us_topic_0045853860__b52361124155219">Allowed Origin</strong> can access a bucket in OBS using the method specified in <strong id="en-us_topic_0045853860__b3878103118527">Allowed Method</strong>. For example, you configure CORS parameters for bucket <strong id="en-us_topic_0045853860__b14421781532">testbucket</strong> as follows: <strong id="en-us_topic_0045853860__b7256653123920">Allowed Origin: www.example.com</strong>; <strong id="en-us_topic_0045853860__b19551162344010">Allowed Method: GET</strong>; <strong id="en-us_topic_0045853860__b634395113419">Allowed Header</strong>: left blank; <strong id="en-us_topic_0045853860__b19613161752">Exposed Header</strong>: left blank; <strong id="en-us_topic_0045853860__b1857918119422">Cache Duration (s): 100</strong>. Then OBS only allows GET requests from <strong id="en-us_topic_0045853860__b20320835650">www.example.com</strong> to access bucket <strong id="en-us_topic_0045853860__b824555357">testbucket</strong>, without restrictions on request headers. The client can cache the CORS response for 100 seconds. </p>
</p></li><li id="en-us_topic_0045853860__l909d86eda87a4867840e3f70759c3d27"><span>Click <strong id="en-us_topic_0045853860__b49531058153717">OK</strong>.</span></li><li id="en-us_topic_0045853860__lb7780ddd3dc54401a277774fe33669f5"><span>Click <strong id="en-us_topic_0045853860__en-us_topic_0068417484_en-us_topic_0045853860_b28560655">OK</strong> to save the rules.</span><p><p id="en-us_topic_0045853860__p370795133812">After CORS is successfully configured, only the addresses specified for <strong id="en-us_topic_0045853860__b107079515389">Allowed Origin</strong> can access the bucket using the methods specified for <strong id="en-us_topic_0045853860__b270715515381">Allowed Method</strong>. For example, you configure a CORS rule for bucket <strong id="en-us_topic_0045853860__b18707855382">testbucket</strong> as follows:</p>
<ul id="en-us_topic_0045853860__ul1443611584382"><li id="en-us_topic_0045853860__li186402015388"><strong id="en-us_topic_0045853860__b15651520163813">Allowed Origin: www.example.com</strong></li><li id="en-us_topic_0045853860__li3857172315382"><strong id="en-us_topic_0045853860__b188588235387">Allowed Method: GET</strong></li><li id="en-us_topic_0045853860__li05043268389"><strong id="en-us_topic_0045853860__b650482611389">Allowed Header</strong>: left blank</li><li id="en-us_topic_0045853860__li10356182912387"><strong id="en-us_topic_0045853860__b935662993819">Exposed Header</strong>: left blank</li><li id="en-us_topic_0045853860__li3528559133811"><strong id="en-us_topic_0045853860__b14783232173816">Cache Duration (s): 100</strong></li></ul>
<p id="en-us_topic_0045853860__p46924516389">Then, OBS only allows GET requests from <strong id="en-us_topic_0045853860__b126851381379">www.example.com</strong> to access bucket <strong id="en-us_topic_0045853860__b1768617873718">testbucket</strong> and does not limit request headers. The client can cache CORS responses for 100 seconds.</p>
</p></li><li id="en-us_topic_0045853860__li944717573486"><span>In the displayed dialog box, click <strong id="en-us_topic_0045853860__obs_03_0022_b19371431195919">Close</strong> to close the dialog box.</span></li></ol>
</div>
</div>

4
docs/obs/umn/en-us_topic_0049066876.html
View File

@ -1,7 +1,7 @@
<a name="en-us_topic_0049066876"></a><a name="en-us_topic_0049066876"></a>
<h1 class="topictitle1">Object Metadata Overview</h1>
<div id="body1499753333227"><p id="en-us_topic_0049066876__p57782575145617">Object metadata is a set of name-value pairs that are part of object management.</p>
<div id="body1499753333227"><p id="en-us_topic_0049066876__p57782575145617">Object metadata is a set of name-value pairs that describe the object and is used for object management.</p>
<p id="en-us_topic_0049066876__p13189138161814">Currently, only the metadata defined by the system is supported.</p>
<p id="en-us_topic_0049066876__p2768182635920">The metadata defined by the system is classified into the following types: system-controlled and user-controlled. For example, metadata such as <strong id="en-us_topic_0049066876__b1558942811363">Last-Modified</strong> is controlled by the system and cannot be modified. You can call the API to modify the metadata such as <strong id="en-us_topic_0049066876__b2033616359364">ContentLanguage</strong>. The metadata that can be modified is described as follows:</p>
@ -56,7 +56,7 @@
</tbody>
</table>
</div>
<div class="note" id="en-us_topic_0049066876__note31593131154710"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0049066876__ul15902730154710"><li id="en-us_topic_0049066876__li8906846154710">When versioning is enabled for a bucket, you can set metadata for objects which are <strong id="en-us_topic_0049066876__b127559824155347">Latest Version</strong>, but cannot set metadata for objects which are <strong id="en-us_topic_0049066876__b74712712155347">Historical Version</strong>.</li><li id="en-us_topic_0049066876__li50365905154710">You cannot set object metadata for a <strong id="en-us_topic_0049066876__b1023920545492">Cold</strong> object.</li></ul>
<div class="note" id="en-us_topic_0049066876__note31593131154710"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0049066876__ul15902730154710"><li id="en-us_topic_0049066876__li8906846154710">When versioning is enabled for a bucket, you can set metadata for objects which are <strong id="en-us_topic_0049066876__b127559824155347">Latest Version</strong>, but cannot set metadata for objects which are <strong id="en-us_topic_0049066876__b74712712155347">Historical Version</strong>.</li><li id="en-us_topic_0049066876__li50365905154710">Metadata cannot be configured for Cold objects.</li></ul>
</div></div>
</div>
<div>

25
docs/obs/umn/en-us_topic_0050937852.html
View File

@ -3,7 +3,7 @@
<h1 class="topictitle1">Storage Classes Overview</h1>
<div id="body1499758606806"><p id="en-us_topic_0050937852__p5495173433013">OBS supports tiered storage classes at the bucket level and object level.</p>
<p id="en-us_topic_0050937852__p59654135102119">OBS provides the following storage classes: Standard, Warm, and Cold.</p>
<div class="p" id="en-us_topic_0050937852__p2914586010533">Different storage classes meet different requirements for storage performance and costs.<ul id="en-us_topic_0050937852__ul3992358810533"><li id="en-us_topic_0050937852__li1693337310533">The Standard storage class features low access latency and high throughput. It is therefore suitable for storing a massive number of hot files (frequently accessed every month) or small files (less than 1 MB). The application scenarios include big data analytics, mobile apps, hot videos, and social apps.</li><li id="en-us_topic_0050937852__li61152206154814">The Warm storage class is ideal for storing data that is semi-frequently accessed (less than 12 times a year), with requirements for quick response. The application scenarios include file synchronization, file sharing, and enterprise backup.</li><li id="en-us_topic_0050937852__li57040773154825">The Cold storage class is suitable for archiving data that is rarely-accessed (averagely once a year). The application scenarios include data archiving and long-term data backups. The Cold storage class is secure, durable, and inexpensive, and can be used to replace tape libraries. To keep cost low, it may take hours to restore data from the Cold storage class.</li></ul>
<div class="p" id="en-us_topic_0050937852__p2914586010533">These storage classes can meet different needs for storage performance and costs.<ul id="en-us_topic_0050937852__ul3992358810533"><li id="en-us_topic_0050937852__li1693337310533">Standard: The Standard storage class features low latency and high throughput. It is therefore good for storing frequently (multiple times per month) accessed files or small files (less than 1 MB). Its application scenarios include big data analytics, mobile apps, hot videos, and social apps.</li><li id="en-us_topic_0050937852__li61152206154814">Warm: The Warm storage class is for storing data that is infrequently (less than 12 times per year) accessed, but when needed, the access has to be fast. It can be used for file synchronization, file sharing, enterprise backups, and many other scenarios.</li><li id="en-us_topic_0050937852__li57040773154825">Cold: The Cold storage class is ideal for storing data that is rarely (once per year) accessed. Its application scenarios include data archive and long-term backups. The Cold storage class is secure, durable, and inexpensive, and can be used to replace tape libraries. To keep cost low, it may take hours to restore data from the Cold storage class.</li></ul>
</div>
<div class="section" id="en-us_topic_0050937852__section510051131514"><h4 class="sectiontitle">Bucket Storage Classes vs. Object Storage Classes</h4><p id="en-us_topic_0050937852__p8262771203">When an object is uploaded, it inherits the storage class of the bucket by default, but you can change the default storage class when you upload the object.</p>
<p id="en-us_topic_0050937852__p15587122093216">Changing the storage class of a bucket does not change the storage classes of existing objects in the bucket, but newly uploaded objects will inherit the new storage class.</p>
@ -21,11 +21,11 @@
</thead>
<tbody><tr id="en-us_topic_0050937852__row103188419355"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="en-us_topic_0050937852__p131810412351">Feature</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="en-us_topic_0050937852__p2031818473511">Top-notch performance, highly reliable and available </p>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="en-us_topic_0050937852__p2031818473511">Top-notch performance, high reliability and availability</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.3 "><p id="en-us_topic_0050937852__p83181416352">Reliable, inexpensive, and real-time storage access</p>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.3 "><p id="en-us_topic_0050937852__p83181416352">Reliable, inexpensive storage with real-time access</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.4 "><p id="en-us_topic_0050937852__p19318134103517">Long-term storage for archived data at a very low cost</p>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.4 "><p id="en-us_topic_0050937852__p19318134103517">Long-term storage for Cold data at a low cost</p>
</td>
</tr>
<tr id="en-us_topic_0050937852__row265162715348"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="en-us_topic_0050937852__p46642711342">Application scenarios</p>
@ -37,9 +37,22 @@
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.4 "><p id="en-us_topic_0050937852__p186612743416">Archive, medical image storage, video material storage, and replacement of tape libraries</p>
</td>
</tr>
<tr id="en-us_topic_0050937852__row565445793616"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="en-us_topic_0050937852__p136541857183616">Minimum storage duration</p>
<tr id="en-us_topic_0050937852__row9115436175710"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="en-us_topic_0050937852__en-us_topic_0292412045_p13417642111516">Minimum measurement unit<sup id="en-us_topic_0050937852__sup15328648929">a</sup></p>
<div class="note" id="en-us_topic_0050937852__note142616439418"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="en-us_topic_0050937852__p1148863415">a: Minimum measurement unit refers to a minimum billable object size. For example, a 32 KB Standard object will be billed as if it were 64 KB.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="en-us_topic_0050937852__p18654105712362">Not required</p>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="en-us_topic_0050937852__en-us_topic_0292412045_p1417164213154">64 KB</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.3 "><p id="en-us_topic_0050937852__en-us_topic_0292412045_p5270218151610">64 KB</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.4 "><p id="en-us_topic_0050937852__en-us_topic_0292412045_p5876152871616">64 KB</p>
</td>
</tr>
<tr id="en-us_topic_0050937852__row565445793616"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="en-us_topic_0050937852__en-us_topic_0292412045_p136541857183616">Minimum storage duration<sup id="en-us_topic_0050937852__sup15155142520210">b</sup></p>
<div class="note" id="en-us_topic_0050937852__note146341423164216"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="en-us_topic_0050937852__p14481866410">b: Minimum storage duration refers to a minimum billable storage duration. For example, an Infrequent Access object deleted when it was stored for 20 days will be billed for a full 30 days.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="en-us_topic_0050937852__p18654105712362">N/A</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.3 "><p id="en-us_topic_0050937852__p12654145712368">30 days</p>
</td>

16
docs/obs/umn/en-us_topic_0066036542.html
View File

@ -4,7 +4,7 @@
<div id="body1499753333227"><p id="en-us_topic_0066036542__p55351642">This section describes how to use CORS in HTML5 to implement cross-origin access.</p>
<div class="section" id="en-us_topic_0066036542__section48948668114148"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0066036542__p5419211114148">Static website hosting has been configured. For details, see <a href="en-us_topic_0045853755.html">Configuring Static Website Hosting</a>.</p>
</div>
<div class="section" id="en-us_topic_0066036542__section54298028"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0066036542__ol23319874"><li id="en-us_topic_0066036542__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0066036542__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0066036542__li18830181855820"><span>On the right of the <strong id="en-us_topic_0066036542__b3277199132716">Overview</strong> page, click <strong id="en-us_topic_0066036542__b6556172482718">CORS Rules</strong> in the <strong id="en-us_topic_0066036542__b2562175252319">Basic Configurations</strong> area. The <strong id="en-us_topic_0066036542__b763811488279">CORS Rules</strong> page is displayed.</span><p><p id="en-us_topic_0066036542__p471425117139">Alternatively, you can choose <strong id="en-us_topic_0066036542__b1898818329375">Basic Configurations</strong> &gt; <strong id="en-us_topic_0066036542__b18988132103714">CORS Rules</strong> in the navigation pane.</p>
<div class="section" id="en-us_topic_0066036542__section54298028"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0066036542__ol23319874"><li id="en-us_topic_0066036542__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0066036542__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0066036542__li18830181855820"><span>In the <strong id="en-us_topic_0066036542__b2562175252319">Basic Configurations</strong> area, click <strong id="en-us_topic_0066036542__b6556172482718">CORS Rules</strong>. The <strong id="en-us_topic_0066036542__b763811488279">CORS Rules</strong> page is displayed.</span><p><p id="en-us_topic_0066036542__p471425117139">Alternatively, you can choose <strong id="en-us_topic_0066036542__b1898818329375">Basic Configurations</strong> &gt; <strong id="en-us_topic_0066036542__b18988132103714">CORS Rules</strong> in the navigation pane.</p>
</p></li><li id="en-us_topic_0066036542__li45993918325"><span>Click <strong id="en-us_topic_0066036542__b15332124463218">Create</strong>. The <strong id="en-us_topic_0066036542__b08802053113218">Create CORS Rule</strong> dialog box is displayed. See <a href="#en-us_topic_0066036542__fig2425430173411">Figure 1</a> for details.</span><p><div class="note" id="en-us_topic_0066036542__note714561653618"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0066036542__p61451516193620">A bucket can have a maximum of 100 CORS rules configured.</p>
</div></div>
<div class="fignone" id="en-us_topic_0066036542__fig2425430173411"><a name="en-us_topic_0066036542__fig2425430173411"></a><a name="fig2425430173411"></a><span class="figcap"><b>Figure 1 </b>Creating a CORS rule</span><br><span><img id="en-us_topic_0066036542__image154545112510" src="en-us_image_0145420855.png" title="Click to enlarge" class="imgResize"></span></div>
@ -19,8 +19,8 @@
<tbody><tr id="en-us_topic_0066036542__row47932664"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.3.2.4.2.1.2.3.1.1 "><p id="en-us_topic_0066036542__p57340601">Allowed Origin</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066036542__p43172637202016">Mandatory</p>
<p id="en-us_topic_0066036542__p14077143">Requests from this origin can access the bucket.</p>
<p id="en-us_topic_0066036542__p59585428">Multiple matching rules are allowed. One rule occupies one line, and allows one wildcard character (<strong id="en-us_topic_0066036542__b562579815151012">*</strong>) at most. Example:</p>
<p id="en-us_topic_0066036542__p14077143">Specifies the origins from which requests can access the bucket.</p>
<p id="en-us_topic_0066036542__p59585428">Multiple matching rules are allowed. One rule occupies one line, and allows one wildcard character (<strong id="en-us_topic_0066036542__b562579815151012">*</strong>) at most. An example is given as follows:</p>
<pre class="screen" id="en-us_topic_0066036542__screen5755676013302">http://rds.example.com
https://*.vbs.example.com</pre>
</td>
@ -28,22 +28,22 @@ https://*.vbs.example.com</pre>
<tr id="en-us_topic_0066036542__row18342472"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.3.2.4.2.1.2.3.1.1 "><p id="en-us_topic_0066036542__p9345259">Allowed Method</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066036542__p18768523">Mandatory</p>
<p id="en-us_topic_0066036542__p63231021153331">Specifies the acceptable operation type of buckets and objects.</p>
<p id="en-us_topic_0066036542__p63231021153331">Specifies the allowed request methods for buckets and objects.</p>
<p id="en-us_topic_0066036542__p59725833153419">The methods include Get, Post, Put, Delete, and Head.</p>
</td>
</tr>
<tr id="en-us_topic_0066036542__row34698981"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.3.2.4.2.1.2.3.1.1 "><p id="en-us_topic_0066036542__p59154058">Allowed Header</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066036542__p6976477153727">Optional</p>
<p id="en-us_topic_0066036542__p58393322153740">Specifies the allowed header of cross-origin requests.</p>
<p id="en-us_topic_0066036542__p2773754710645">Only CORS requests matching the allowed header are valid.</p>
<p id="en-us_topic_0066036542__p58393322153740">Specifies the allowed headers in cross-origin requests.</p>
<p id="en-us_topic_0066036542__p2773754710645">Only CORS requests matching the allowed headers are valid.</p>
<p id="en-us_topic_0066036542__p5132822810315">You can enter multiple allowed headers (one per line) and each line can contain one wildcard character (*) at most. Spaces and special characters including <strong id="en-us_topic_0066036542__b648117133820">&amp;:&lt;</strong> are not allowed.</p>
</td>
</tr>
<tr id="en-us_topic_0066036542__row19218446"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.3.2.4.2.1.2.3.1.1 "><p id="en-us_topic_0066036542__p13190333">Exposed Header</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066036542__p32426730153840">Optional</p>
<p id="en-us_topic_0066036542__p309847910721">Specifies the exposed header in CORS responses, providing additional information for clients.</p>
<p id="en-us_topic_0066036542__p309847910721">Specifies the exposed headers in CORS responses, providing additional information for clients.</p>
<p id="en-us_topic_0066036542__p27193935815">By default, a browser can access only headers <strong id="en-us_topic_0066036542__b1748822114214">Content-Length</strong> and <strong id="en-us_topic_0066036542__b649832315426">Content-Type</strong>. If the browser wants to access other headers, you need to configure those headers in this parameter.</p>
<p id="en-us_topic_0066036542__p162724431079">You can enter multiple exposed headers (one per line). Spaces and special characters including <strong id="en-us_topic_0066036542__b5125223280">*&amp;:&lt;</strong> are not allowed.</p>
</td>
@ -57,7 +57,7 @@ https://*.vbs.example.com</pre>
</tbody>
</table>
</div>
</p></li><li id="en-us_topic_0066036542__li32190482"><span>Click <strong id="en-us_topic_0066036542__b51291972">OK</strong>.</span><p><p id="en-us_topic_0066036542__p21278887">Message "The CORS rule created successfully." is displayed. The configuration of CORS takes effect within two minutes.</p>
</p></li><li id="en-us_topic_0066036542__li32190482"><span>Click <strong id="en-us_topic_0066036542__b51291972">OK</strong>.</span><p><p id="en-us_topic_0066036542__p21278887">Message "The CORS rule created successfully." is displayed. The CORS configuration takes effect within two minutes.</p>
<p id="en-us_topic_0066036542__p4122287715475">After CORS is successfully configured, only the addresses specified in <strong id="en-us_topic_0066036542__b52937069154642">Allowed Origin</strong> can access a bucket in OBS using the methods specified in <strong id="en-us_topic_0066036542__b6671576154642">Allowed Method</strong>. For example, you can configure CORS parameters for bucket <strong id="en-us_topic_0066036542__b842352706154754">testbucket</strong> as follows:</p>
<ul id="en-us_topic_0066036542__ul62505518154627"><li id="en-us_topic_0066036542__li20204262154651"><strong id="en-us_topic_0066036542__b84235270615484">Allowed Origin</strong>: <strong id="en-us_topic_0066036542__b84235270615489">https://www.example.com</strong></li><li id="en-us_topic_0066036542__li27910770154655"><strong id="en-us_topic_0066036542__b842352706154814">Allowed Method</strong>: <strong id="en-us_topic_0066036542__b842352706154826">GET</strong></li><li id="en-us_topic_0066036542__li56306823154657"><strong id="en-us_topic_0066036542__b842352706154822">Allowed Header</strong>: *</li><li id="en-us_topic_0066036542__li482933015472"><strong id="en-us_topic_0066036542__b842352706154834">Exposed Header</strong>: *</li><li id="en-us_topic_0066036542__li14401598154627"><strong id="en-us_topic_0066036542__b842352706154842">Cache Duration (s)</strong>: <strong id="en-us_topic_0066036542__b842352706154846">100</strong></li></ul>
<p id="en-us_topic_0066036542__p1737051413398">By doing so, OBS only allows GET requests from <strong id="en-us_topic_0066036542__b10171133114014">https://www.example.com</strong> to access bucket <strong id="en-us_topic_0066036542__b686913114405">testbucket</strong>, without restrictions on request headers. The client can cache CORS responses for 100 seconds.</p>

10
docs/obs/umn/en-us_topic_0066088957.html
View File

@ -2,13 +2,13 @@
<h1 class="topictitle1">Configuring Redirection</h1>
<div id="body1499758606807"><p id="en-us_topic_0066088957__p30121176153913">You can redirect all requests for a bucket to another bucket or URL by configuring redirection rules.</p>
<div class="section" id="en-us_topic_0066088957__section6167532661"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0066088957__en-us_topic_0045853755_p1146611514350">Web page files of the static website have been uploaded to a bucket.</p>
<div class="section" id="en-us_topic_0066088957__section6167532661"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0066088957__en-us_topic_0045853755_p1146611514350">Web page files required for static website hosting have been uploaded to the specified bucket.</p>
<p id="en-us_topic_0066088957__en-us_topic_0045853755_p1812645682117">The static website files hosted in the bucket are accessible to anonymous users.</p>
<p id="en-us_topic_0066088957__en-us_topic_0045853755_p3350182614313">If the web page files are in the Cold storage class, restore them first. For more information, see <a href="obs_03_0320.html">Restoring Objects from the Cold Storage</a>.</p>
<p id="en-us_topic_0066088957__en-us_topic_0045853755_p3350182614313">Static web page files in the Cold storage class have been restored. For more information, see <a href="obs_03_0320.html">Restoring Objects from the Cold Storage</a>.</p>
</div>
<div class="section" id="en-us_topic_0066088957__section11587693153957"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0066088957__ol44271394154014"><li id="en-us_topic_0066088957__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0066088957__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0066088957__li18830181855820"><span>In the right <strong id="en-us_topic_0066088957__b579893112401">Basic Configurations</strong> area, click <strong id="en-us_topic_0066088957__b1579816319404">Static Website Hosting</strong>. The <strong id="en-us_topic_0066088957__b1979815314406">Static Website Hosting</strong> page is displayed.</span><p><p id="en-us_topic_0066088957__p1732877134316">Alternatively, you can choose <strong id="en-us_topic_0066088957__b5238144012014">Basic Configurations</strong> &gt; <strong id="en-us_topic_0066088957__b1024004072014">Static Website Hosting</strong> from the navigation pane on the left.</p>
</p></li><li id="en-us_topic_0066088957__li720344934317"><span>Click <strong id="en-us_topic_0066088957__b5556142185612">Configure Static Website Hosting</strong>. The <strong id="en-us_topic_0066088957__b17556942185614">Configure Static Website Hosting</strong> dialog box is displayed.</span></li><li id="en-us_topic_0066088957__li16729105453"><span>Enable it by turning on the status switch.</span></li><li id="en-us_topic_0066088957__li13201511640"><span>Set <strong id="en-us_topic_0066088957__b644395452019">Hosting By</strong> to <strong id="en-us_topic_0066088957__b14460357102014">Redirection</strong>. See <a href="#en-us_topic_0066088957__fig1131112528711">Figure 1</a> for details. Enter a bucket access domain name or URL in the text box of <strong id="en-us_topic_0066088957__b22561610132213">Redirect To</strong>.</span><p><div class="fignone" id="en-us_topic_0066088957__fig1131112528711"><a name="en-us_topic_0066088957__fig1131112528711"></a><a name="fig1131112528711"></a><span class="figcap"><b>Figure 1 </b>Configuring redirection</span><br><span><img id="en-us_topic_0066088957__image1816713085112" src="en-us_image_0145846362.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="en-us_topic_0066088957__li48239657155648"><span>Click <strong id="en-us_topic_0066088957__b36028660">OK</strong>.</span></li><li id="en-us_topic_0066088957__li21017577482"><span>In the bucket list, click the bucket to which requests for the static website are redirected.</span></li><li id="en-us_topic_0066088957__li45818654181751"><span>(<strong id="en-us_topic_0066088957__en-us_topic_0045853755_b7869135132012">Optional</strong>) If the static website files in the bucket are not accessible to anonymous users, perform this step. If the static website files are already accessible to anonymous users, skip this step.</span><p><p id="en-us_topic_0066088957__en-us_topic_0045853755_p18712161416268">Grant the read permission for static website files to anonymous users. For details, see <a href="obs_03_0132.html">Granting Object Access Permissions to Anonymous Users</a>.</p>
<div class="section" id="en-us_topic_0066088957__section11587693153957"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0066088957__ol44271394154014"><li id="en-us_topic_0066088957__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0066088957__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0066088957__li18830181855820"><span>In the <strong id="en-us_topic_0066088957__b105231578574">Basic Configurations</strong> area, click <strong id="en-us_topic_0066088957__b19523117125713">Static Website Hosting</strong>. The <strong id="en-us_topic_0066088957__b852320795717">Static Website Hosting</strong> page is displayed.</span><p><p id="en-us_topic_0066088957__p1732877134316">Alternatively, you can choose <strong id="en-us_topic_0066088957__b5238144012014">Basic Configurations</strong> &gt; <strong id="en-us_topic_0066088957__b1024004072014">Static Website Hosting</strong> from the navigation pane on the left.</p>
</p></li><li id="en-us_topic_0066088957__li720344934317"><span>Click <strong id="en-us_topic_0066088957__b5556142185612">Configure Static Website Hosting</strong>. The <strong id="en-us_topic_0066088957__b17556942185614">Configure Static Website Hosting</strong> dialog box is displayed.</span></li><li id="en-us_topic_0066088957__li16729105453"><span>Enable <strong id="en-us_topic_0066088957__b14179153622818">Status</strong>.</span></li><li id="en-us_topic_0066088957__li265648184614"><span>Set <strong id="en-us_topic_0066088957__b23336411105">Hosting By</strong> to <strong id="en-us_topic_0066088957__b571910302110">Redirection</strong>, as shown in <a href="#en-us_topic_0066088957__fig965144815468">Figure 1</a>. In the text box of <strong id="en-us_topic_0066088957__b137976411110">Redirect To</strong>, enter the bucket's access domain name or URL.</span><p><div class="fignone" id="en-us_topic_0066088957__fig965144815468"><a name="en-us_topic_0066088957__fig965144815468"></a><a name="fig965144815468"></a><span class="figcap"><b>Figure 1 </b>Configuring redirection</span><br><span><img id="en-us_topic_0066088957__image146644814611" src="en-us_image_0000001801955289.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="en-us_topic_0066088957__li48239657155648"><span>Click <strong id="en-us_topic_0066088957__b36028660">OK</strong>.</span></li><li id="en-us_topic_0066088957__li21017577482"><span>In the bucket list, click the bucket to which requests for the static website are redirected.</span></li><li id="en-us_topic_0066088957__li45818654181751"><span>(<strong id="en-us_topic_0066088957__en-us_topic_0045853755_b7869135132012">Optional</strong>) If the static website files in the bucket are not accessible to anonymous users, perform this step. If they are already accessible to everyone, skip this step.</span><p><p id="en-us_topic_0066088957__en-us_topic_0045853755_p18712161416268">Grant the read permission for static website files to anonymous users. For details, see <a href="obs_03_0132.html">Granting Anonymous Users Permission to Access Objects</a>.</p>
<p id="en-us_topic_0066088957__en-us_topic_0045853755_p14415184985410">If the bucket contains only static website files, configure the <strong id="en-us_topic_0066088957__en-us_topic_0045853755_b63305532481">Public Read</strong> policy for the bucket so that all files in it can be accessed publicly.</p>
<ol type="a" id="en-us_topic_0066088957__en-us_topic_0045853755_ol56026477144312"><li id="en-us_topic_0066088957__en-us_topic_0045853755_li26219314144346">Choose <strong id="en-us_topic_0066088957__en-us_topic_0045853755_b1966141115407">Permissions</strong> &gt; <strong id="en-us_topic_0066088957__en-us_topic_0045853755_b7671191919400">Bucket Policies</strong>.</li><li id="en-us_topic_0066088957__en-us_topic_0045853755_li820711719166">In the <strong id="en-us_topic_0066088957__en-us_topic_0045853755_b137091459121110">Standard Bucket Policies</strong> area, select the <strong id="en-us_topic_0066088957__en-us_topic_0045853755_b8285215161211">Public Read</strong> policy for the bucket.</li><li id="en-us_topic_0066088957__en-us_topic_0045853755_li588503161565">Click <strong id="en-us_topic_0066088957__en-us_topic_0045853755_b9882162941218">Public Read</strong>. For details, see <a href="#en-us_topic_0066088957__en-us_topic_0045853755_fig15186794193556">Figure 2</a>. In the confirmation dialog box that is displayed, click <strong id="en-us_topic_0066088957__en-us_topic_0045853755_b1842219132">Yes</strong>.<div class="fignone" id="en-us_topic_0066088957__en-us_topic_0045853755_fig15186794193556"><a name="en-us_topic_0066088957__en-us_topic_0045853755_fig15186794193556"></a><a name="en-us_topic_0045853755_fig15186794193556"></a><span class="figcap"><b>Figure 2 </b>Configuring the public read permission</span><br><span><img id="en-us_topic_0066088957__en-us_topic_0045853755_image1956565091517" src="en-us_image_0129612765.png" title="Click to enlarge" class="imgResize"></span></div>
</li></ol>

2
docs/obs/umn/en-us_topic_0066088963.html
View File

@ -4,7 +4,7 @@
<div id="body1499758606807"><p id="en-us_topic_0066088963__p1195915314414">This topic describes how to configure an SMN-enabled event notification rule on OBS Console.</p>
<div class="section" id="en-us_topic_0066088963__section72855457345"><h4 class="sectiontitle">Background Information</h4><p id="en-us_topic_0066088963__p76811548103411">For details, see <a href="en-us_topic_0045853816.html">SMN-Enabled Event Notifications</a>.</p>
</div>
<div class="section" id="en-us_topic_0066088963__section4422459618019"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0066088963__ol6247704518019"><li id="en-us_topic_0066088963__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0066088963__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0066088963__li18830181855820"><span>In the right <strong id="en-us_topic_0066088963__b52421745173018">Basic Configurations</strong> area, click <strong id="en-us_topic_0066088963__b16528417163113">Event Notification</strong>. The <strong id="en-us_topic_0066088963__b14368192511314">Event Notification</strong> page is displayed.</span><p><p id="en-us_topic_0066088963__p471425117139">Alternatively, you can choose <strong id="en-us_topic_0066088963__b37321058164212">Basic Configurations</strong> &gt; <strong id="en-us_topic_0066088963__b167381858114211">Event Notification</strong> in the navigation pane.</p>
<div class="section" id="en-us_topic_0066088963__section4422459618019"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0066088963__ol6247704518019"><li id="en-us_topic_0066088963__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0066088963__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0066088963__li18830181855820"><span>In the <strong id="en-us_topic_0066088963__b98291154185118">Basic Configurations</strong> area, click <strong id="en-us_topic_0066088963__b1082935455110">Event Notification</strong>. The <strong id="en-us_topic_0066088963__b1482955414517">Event Notification</strong> page is displayed.</span><p><p id="en-us_topic_0066088963__p471425117139">Alternatively, you can choose <strong id="en-us_topic_0066088963__b37321058164212">Basic Configurations</strong> &gt; <strong id="en-us_topic_0066088963__b167381858114211">Event Notification</strong> in the navigation pane.</p>
</p></li><li id="en-us_topic_0066088963__li108481812202814"><span>Click <strong id="en-us_topic_0066088963__b10410184615474">Create</strong>. The <strong id="en-us_topic_0066088963__b5197637481">Create Event Notification</strong> dialog box is displayed. See <a href="#en-us_topic_0066088963__fig17847723015">Figure 1</a> for details.</span><p><div class="fignone" id="en-us_topic_0066088963__fig17847723015"><a name="en-us_topic_0066088963__fig17847723015"></a><a name="fig17847723015"></a><span class="figcap"><b>Figure 1 </b>Creating an event notification rule</span><br><span><img id="en-us_topic_0066088963__image1754618155260" src="en-us_image_0145117970.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="en-us_topic_0066088963__li879014539554"><span>Configure event notification parameters, as described in <a href="#en-us_topic_0066088963__aobs_console_0039_mmccppss_table01">Table 1</a>.</span><p>
<div class="tablenoborder"><a name="en-us_topic_0066088963__aobs_console_0039_mmccppss_table01"></a><a name="aobs_console_0039_mmccppss_table01"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0066088963__aobs_console_0039_mmccppss_table01" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Event notification parameters</caption><thead align="left"><tr id="en-us_topic_0066088963__row2055942"><th align="left" class="cellrowborder" valign="top" width="34%" id="mcps1.3.3.2.4.2.1.2.3.1.1"><p id="en-us_topic_0066088963__p32313598">Parameter</p>

22
docs/obs/umn/en-us_topic_0066088967.html
View File

@ -15,13 +15,13 @@
<tbody><tr id="en-us_topic_0066088967__row122361958192016"><td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.3.2.3.1.1 "><p id="en-us_topic_0066088967__p1223615586209">Specific User</p>
</td>
<td class="cellrowborder" valign="top" width="73%" headers="mcps1.3.4.3.2.3.1.2 "><p id="en-us_topic_0066088967__p1377083924318">You can grant accounts access permissions to a bucket or an object using ACLs. Once a specific account is granted the access permissions, all IAM users who have OBS resource permissions under this account can have the same access permissions to operate the bucket or object.</p>
<p id="en-us_topic_0066088967__p223612587202">If you need to grant different access permissions to different IAM users, configure bucket policies. For details, see <a href="obs_03_0080.html">Granting an IAM User with the Operation Permissions for a Specified Bucket</a>.</p>
<p id="en-us_topic_0066088967__p223612587202">If you need to grant different access permissions to different IAM users, configure bucket policies. For details, see <a href="obs_03_0080.html">Granting an IAM User Permissions to Operate a Specific Bucket</a>.</p>
</td>
</tr>
<tr id="en-us_topic_0066088967__row14236115815207"><td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.3.2.3.1.1 "><p id="en-us_topic_0066088967__p4237195812018">Owner</p>
</td>
<td class="cellrowborder" valign="top" width="73%" headers="mcps1.3.4.3.2.3.1.2 "><p id="en-us_topic_0066088967__p82371758102019">The owner of a bucket is the account that created the bucket. The bucket owner has all bucket access permissions by default. The read and write permissions for the bucket ACL are permanently available to the bucket owner, and cannot be modified.</p>
<p id="en-us_topic_0066088967__p108801457143318">The owner of an object is the account that uploaded the object, who may not be the owner of the bucket to which the object belongs. The object owner has the read access to the object, as well as the read and write access to the object ACL, and such access permissions cannot be modified.</p>
<p id="en-us_topic_0066088967__p108801457143318">The owner of an object is the account that uploads the object, who may not be the owner of the bucket to which the object belongs. The object owner has the read access to the object, as well as the read and write access to the object ACL, and such access permissions cannot be modified.</p>
<div class="notice" id="en-us_topic_0066088967__note16704211185110"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="en-us_topic_0066088967__p11704131114517">Do not modify the bucket owner's read and write access permissions for the bucket.</p>
</div></div>
</td>
@ -63,25 +63,25 @@
</td>
<td class="cellrowborder" valign="top" width="14.97%" headers="mcps1.3.5.3.2.4.1.2 "><p id="en-us_topic_0066088967__p27006329">READ</p>
</td>
<td class="cellrowborder" valign="top" width="65.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="en-us_topic_0066088967__p40029077">Allows a grantee to obtain the list of objects in and the metadata of a bucket.</p>
<td class="cellrowborder" valign="top" width="65.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="en-us_topic_0066088967__p40029077">Used to obtain the list of objects in a bucket and the bucket metadata.</p>
</td>
</tr>
<tr id="en-us_topic_0066088967__row21129772"><td class="cellrowborder" valign="top" headers="mcps1.3.5.3.2.4.1.1 "><p id="en-us_topic_0066088967__p33789992">WRITE</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.5.3.2.4.1.2 "><p id="en-us_topic_0066088967__p52634865">Allows a grantee to upload, overwrite, and delete any object in a bucket.</p>
<td class="cellrowborder" valign="top" headers="mcps1.3.5.3.2.4.1.2 "><p id="en-us_topic_0066088967__p52634865">Used to upload, overwrite, and delete any object in a bucket.</p>
</td>
</tr>
<tr id="en-us_topic_0066088967__row35565678"><td class="cellrowborder" rowspan="2" valign="top" width="19.55%" headers="mcps1.3.5.3.2.4.1.1 "><p id="en-us_topic_0066088967__p46542350172415">Access to ACL</p>
</td>
<td class="cellrowborder" valign="top" width="14.97%" headers="mcps1.3.5.3.2.4.1.2 "><p id="en-us_topic_0066088967__p62247688">READ_ACP</p>
</td>
<td class="cellrowborder" valign="top" width="65.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="en-us_topic_0066088967__p8897958">Allows a grantee to obtain the ACL of a bucket.</p>
<td class="cellrowborder" valign="top" width="65.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="en-us_topic_0066088967__p8897958">Used to obtain the ACL of a bucket.</p>
<p id="en-us_topic_0066088967__p12972762">The bucket owner has this permission permanently by default.</p>
</td>
</tr>
<tr id="en-us_topic_0066088967__row49646001"><td class="cellrowborder" valign="top" headers="mcps1.3.5.3.2.4.1.1 "><p id="en-us_topic_0066088967__p61903120">WRITE_ACP</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.5.3.2.4.1.2 "><p id="en-us_topic_0066088967__p48096812">Allows a grantee to update the ACL of a bucket.</p>
<td class="cellrowborder" valign="top" headers="mcps1.3.5.3.2.4.1.2 "><p id="en-us_topic_0066088967__p48096812">Used to update the ACL of a bucket.</p>
<p id="en-us_topic_0066088967__p30218124">The bucket owner has this permission permanently by default.</p>
</td>
</tr>
@ -102,20 +102,20 @@
</td>
<td class="cellrowborder" valign="top" width="14.97%" headers="mcps1.3.5.5.2.4.1.2 "><p id="en-us_topic_0066088967__en-us_topic_0071293615_p27006329">READ</p>
</td>
<td class="cellrowborder" valign="top" width="65.48%" headers="mcps1.3.5.5.2.4.1.3 "><p id="en-us_topic_0066088967__en-us_topic_0071293615_p40029077">Allows a grantee to obtain the content and metadata of an object.</p>
<td class="cellrowborder" valign="top" width="65.48%" headers="mcps1.3.5.5.2.4.1.3 "><p id="en-us_topic_0066088967__en-us_topic_0071293615_p40029077">Used to obtain the content and metadata of an object.</p>
</td>
</tr>
<tr id="en-us_topic_0066088967__en-us_topic_0071293615_row35565678"><td class="cellrowborder" rowspan="2" valign="top" width="19.55%" headers="mcps1.3.5.5.2.4.1.1 "><p id="en-us_topic_0066088967__p3315846717261">Access to ACL</p>
</td>
<td class="cellrowborder" valign="top" width="14.97%" headers="mcps1.3.5.5.2.4.1.2 "><p id="en-us_topic_0066088967__en-us_topic_0071293615_p62247688">READ_ACP</p>
</td>
<td class="cellrowborder" valign="top" width="65.48%" headers="mcps1.3.5.5.2.4.1.3 "><p id="en-us_topic_0066088967__en-us_topic_0071293615_p8897958">Allows a grantee to obtain the ACL of an object.</p>
<td class="cellrowborder" valign="top" width="65.48%" headers="mcps1.3.5.5.2.4.1.3 "><p id="en-us_topic_0066088967__en-us_topic_0071293615_p8897958">Used to obtain the ACL of an object.</p>
<p id="en-us_topic_0066088967__en-us_topic_0071293615_p12972762">The object owner has this permission permanently by default.</p>
</td>
</tr>
<tr id="en-us_topic_0066088967__en-us_topic_0071293615_row49646001"><td class="cellrowborder" valign="top" headers="mcps1.3.5.5.2.4.1.1 "><p id="en-us_topic_0066088967__en-us_topic_0071293615_p61903120">WRITE_ACP</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.5.5.2.4.1.2 "><p id="en-us_topic_0066088967__en-us_topic_0071293615_p48096812">Allows a grantee to update the ACL of an object.</p>
<td class="cellrowborder" valign="top" headers="mcps1.3.5.5.2.4.1.2 "><p id="en-us_topic_0066088967__en-us_topic_0071293615_p48096812">Used to update the ACL of an object.</p>
<p id="en-us_topic_0066088967__en-us_topic_0071293615_p30218124">The object owner has this permission permanently by default.</p>
</td>
</tr>
@ -173,8 +173,8 @@
</div>
</div>
<div class="section" id="en-us_topic_0066088967__section7479813113513"><h4 class="sectiontitle">Bucket ACL Application Scenarios</h4><p id="en-us_topic_0066088967__p47411659300">ACLs control the read and write permissions for accounts and groups. ACL permission granularity is not as fine as bucket policies and <span id="en-us_topic_0066088967__ph9419171385810">IAM policies</span>. Generally, it is recommended that you use <span id="en-us_topic_0066088967__ph278514422264">IAM policies</span> and bucket policies for access control.</p>
<p id="en-us_topic_0066088967__p1126835143516">It is recommended that you use bucket ACLs in the following scenarios:</p>
<ul id="en-us_topic_0066088967__ul15126135163517"><li id="en-us_topic_0066088967__li9126123513517">Grant the log delivery user with the write access to the target bucket, so that access logs can be delivered to the target bucket.</li><li id="en-us_topic_0066088967__li012611352351">Grant an account with the read and write access to a bucket, so that data in the bucket can be shared or the bucket can be mounted. </li></ul>
<p id="en-us_topic_0066088967__p1126835143516">You can configure bucket ACLs to:</p>
<ul id="en-us_topic_0066088967__ul15126135163517"><li id="en-us_topic_0066088967__li9126123513517">Grant the log delivery user write access to the target bucket that stores access logs.</li><li id="en-us_topic_0066088967__li012611352351">Grant an account read and write access to a bucket, so that data in the bucket can be shared or the bucket can be mounted. </li></ul>
</div>
<div class="section" id="en-us_topic_0066088967__section41561114217"><h4 class="sectiontitle">Object ACL Application Scenarios</h4><p id="en-us_topic_0066088967__p1343310247393">ACLs control the read and write permissions for accounts and groups. ACL permission granularity is not as fine as bucket policies and <span id="en-us_topic_0066088967__ph74341324193920">IAM policies</span>. Generally, it is recommended that you use <span id="en-us_topic_0066088967__ph943472423910">IAM policies</span> and bucket policies for access control.</p>
<p id="en-us_topic_0066088967__p14271741479">It is recommended that you use object ACLs in the following scenarios:</p>

6
docs/obs/umn/en-us_topic_0066176932.html
View File

@ -6,11 +6,11 @@
<div class="section" id="en-us_topic_0066176932__section1131791617239"><h4 class="sectiontitle">Background Information</h4><p id="en-us_topic_0066176932__p1083392434616"><strong id="en-us_topic_0066176932__b27993720241">Object Deletion with Versioning Enabled</strong></p>
<p id="en-us_topic_0066176932__p147385129300">When versioning is enabled for a bucket, OBS works slightly different when deleting different objects.</p>
<ul id="en-us_topic_0066176932__ul5868161543020"><li id="en-us_topic_0066176932__li8822832104419">Deleting a file or folder: The file or folder is not permanently deleted, but is retained in the <strong id="en-us_topic_0066176932__b689513916105">Deleted Objects</strong> list and marked with the <strong id="en-us_topic_0066176932__b148961939171017">Delete Marker</strong>.<ul id="en-us_topic_0066176932__ul09081947154417"><li id="en-us_topic_0066176932__li26965536448">To permanently delete the file or folder, delete it again from the <strong id="en-us_topic_0066176932__b56939582101">Deleted Objects</strong> list. For details, see <a href="en-us_topic_0045853756.html">Deleting an Object or Folder</a>.</li><li id="en-us_topic_0066176932__li51311246184417">To recover the deleted file, undelete it from the <strong id="en-us_topic_0066176932__b4465120151111">Deleted Objects</strong> list. For details, see <a href="#en-us_topic_0066176932__section50464659154530">Procedure</a>.</li></ul>
</li><li id="en-us_topic_0066176932__li133219167471">Deleting an object version: The version will be permanently deleted. If the deleted version is the latest one, the next latest version becomes the latest version.</li></ul>
</li><li id="en-us_topic_0066176932__li133219167471">Deleting an object version: The version will be permanently deleted and cannot be recovered. If the deleted version is the latest one, the next latest version becomes the latest version.</li></ul>
<p id="en-us_topic_0066176932__p1311123424916"><strong id="en-us_topic_0066176932__b916124532410">Object Recovery with Versioning Enabled</strong></p>
<p id="en-us_topic_0066176932__p1243170185618">When a bucket has the versioning function enabled, deleting a file from the <strong id="en-us_topic_0066176932__b17786191210505">Objects</strong> list does not permanently delete it. The deleted file will be retained with the <strong id="en-us_topic_0066176932__b17813143318514">Delete Marker</strong> in the <strong id="en-us_topic_0066176932__b174265012508">Deleted Objects</strong> list. You can recover the deleted file using the <strong id="en-us_topic_0066176932__b837013125151">Undelete</strong> operation.</p>
<p id="en-us_topic_0066176932__p5511204910562">Note the following points when you undelete objects:</p>
<ol id="en-us_topic_0066176932__ol637616985814"><li id="en-us_topic_0066176932__li5377169155818">Only deleted files but not folders can be undeleted.<p id="en-us_topic_0066176932__p7439123318321"><a name="en-us_topic_0066176932__li5377169155818"></a><a name="li5377169155818"></a>After you undelete a deleted file, the file is recovered and will appear in the <strong id="en-us_topic_0066176932__b53571722196">Objects</strong> list. Then you can perform basic operations on the file as you normally do on other objects. If the file was stored in a folder before the deletion, it will be recovered to its original path after you undelete it.</p>
<ol id="en-us_topic_0066176932__ol637616985814"><li id="en-us_topic_0066176932__li5377169155818">Only files can be undeleted but not folders.<p id="en-us_topic_0066176932__p7439123318321"><a name="en-us_topic_0066176932__li5377169155818"></a><a name="li5377169155818"></a>After you undelete a deleted file, the file is recovered and will appear in the <strong id="en-us_topic_0066176932__b53571722196">Objects</strong> list. Then you can perform basic operations on the file as you normally do on other objects. If the file was stored in a folder before the deletion, it will be recovered to its original path after you undelete it.</p>
</li><li id="en-us_topic_0066176932__li17851326114214">Deleted files in the <strong id="en-us_topic_0066176932__b171240132235">Deleted Objects</strong> also keep multiple versions. When deleting different versions of files, note the following points:<ul id="en-us_topic_0066176932__ul1081210216342"><li id="en-us_topic_0066176932__li4809233154212">If you delete a version with the <strong id="en-us_topic_0066176932__b1863323113242">Delete Marker</strong>, it actually recovers this version instead of permanently deleting it. For details, see <a href="#en-us_topic_0066176932__section27691114163422">Related Operations</a>.</li><li id="en-us_topic_0066176932__li38121521133418">If you delete a version without the <strong id="en-us_topic_0066176932__b555310505257">Delete Marker</strong>, that version is permanently deleted. This version will not be recovered, even if the object is recovered later.</li></ul>
</li><li id="en-us_topic_0066176932__li55101836134610">A deleted object must have at least one version without the <strong id="en-us_topic_0066176932__b20607195119472">Delete Marker</strong> in the <strong id="en-us_topic_0066176932__b8582151014810">Deleted Objects</strong> list. Otherwise, the object cannot be undeleted.</li></ol>
</div>
@ -20,7 +20,7 @@
</p></li></ol>
</div>
<div class="section" id="en-us_topic_0066176932__section27691114163422"><a name="en-us_topic_0066176932__section27691114163422"></a><a name="section27691114163422"></a><h4 class="sectiontitle">Related Operations</h4><p id="en-us_topic_0066176932__p1230015169212"><strong id="en-us_topic_0066176932__b24351655141415">Recover a file by deleting its version with the Delete Marker:</strong></p>
<ol id="en-us_topic_0066176932__ol12192133294220"><li id="en-us_topic_0066176932__li1615575915216"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0066176932__obs_03_0307_b144421021120_1">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0066176932__li93941045203316"><span>In the navigation pane, choose <strong id="en-us_topic_0066176932__obs_03_0307_b51941856151917_1">Objects</strong>.</span></li><li id="en-us_topic_0066176932__li329516215438"><span>Click <strong id="en-us_topic_0066176932__b52092018749">Deleted Objects</strong>.</span></li><li id="en-us_topic_0066176932__li1752911151435"><span>Click the deleted file that you want to recover. The file information is displayed.</span></li><li id="en-us_topic_0066176932__li7545162011816"><span>On the <strong id="en-us_topic_0066176932__b559745119414">Versions</strong> tab, view all versions of the file.</span><p><ul id="en-us_topic_0066176932__ul5868164471917"><li id="en-us_topic_0066176932__li7869174451920">If you delete a version with the <strong id="en-us_topic_0066176932__b124219471368">Delete Marker</strong>, the file is recovered and retained in the <strong id="en-us_topic_0066176932__b11649130114517">Objects</strong> list.</li><li id="en-us_topic_0066176932__li139976402512">If you delete a version without the <strong id="en-us_topic_0066176932__b9691173219362">Delete Marker</strong>, that version is permanently deleted.</li></ul>
<ol id="en-us_topic_0066176932__ol12192133294220"><li id="en-us_topic_0066176932__li1615575915216"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0066176932__obs_03_0307_b144421021120_1">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0066176932__li93941045203316"><span>In the navigation pane, choose <strong id="en-us_topic_0066176932__obs_03_0307_b51941856151917_1">Objects</strong>.</span></li><li id="en-us_topic_0066176932__li329516215438"><span>Click <strong id="en-us_topic_0066176932__b52092018749">Deleted Objects</strong>.</span></li><li id="en-us_topic_0066176932__li1752911151435"><span>Click the deleted file that you want to recover. The file information is displayed.</span></li><li id="en-us_topic_0066176932__li7545162011816"><span>On the <strong id="en-us_topic_0066176932__b559745119414">Versions</strong> tab, view all versions of the file.</span><p><ul id="en-us_topic_0066176932__ul5868164471917"><li id="en-us_topic_0066176932__li7869174451920">If you delete a version with the <strong id="en-us_topic_0066176932__b124219471368">Delete Marker</strong>, the file will be recovered and retained in the <strong id="en-us_topic_0066176932__b11649130114517">Objects</strong> list.</li><li id="en-us_topic_0066176932__li139976402512">If you delete a version without the <strong id="en-us_topic_0066176932__b9691173219362">Delete Marker</strong>, that version will be permanently deleted.</li></ul>
</p></li></ol>
</div>
</div>

2
docs/obs/umn/obs_03_0002.html
View File

@ -11,7 +11,7 @@
<div class="section" id="obs_03_0002__section50131461181156"><h4 class="sectiontitle">Application Scenarios</h4><ul id="obs_03_0002__ul36982438192019"><li id="obs_03_0002__li3811559192019">The same OBS resources need to be accessed in different locations. To minimize the access latency, you can use cross-region replication to create object copies in the nearest region.</li><li id="obs_03_0002__li1686595192758">Due to business reasons, you need to migrate OBS data to the data center in another region.</li><li id="obs_03_0002__li4182384193220">To ensure data security and availability, you need to create explicit backups for all data written to OBS in the data center of another region. Therefore, secure backup data is available if the source data is damaged irrevocably.</li></ul>
</div>
<div class="section" id="obs_03_0002__section14840141181339"><h4 class="sectiontitle">Limitations and Constraints</h4><p id="obs_03_0002__p51706951201127">Cross-region replication has the following limitations and constraints:</p>
<ul id="obs_03_0002__ul11966603201218"><li id="obs_03_0002__li42866360205234">Currently, only buckets of version 3.0 support cross-region replication. To check the bucket version, go to the <strong id="obs_03_0002__b2271161683219">Overview</strong> page of the bucket on OBS Console. Then you can view the bucket version in the <strong id="obs_03_0002__b152713167324">Basic Information</strong> area.</li><li id="obs_03_0002__li7599141585310">Objects cannot be copied to the destination bucket if they are uploaded before cross-region replication is enabled.</li><li id="obs_03_0002__li18566425205853">The source bucket and the destination bucket must belong to different regions separately. Data cannot be copied between buckets in the same region.</li><li id="obs_03_0002__li10298429571">Objects of the Cold storage class in the source bucket cannot be copied to the destination bucket through the cross-region replication function.</li><li id="obs_03_0002__li6643645201335">If the region where the destination bucket resides does not support the storage classes, object copies will be stored in the standard storage class.</li><li id="obs_03_0002__li40610889201447">The versioning status of the source bucket must be the same as that of the destination bucket.</li><li id="obs_03_0002__li51500545201552">Objects in a source bucket can be copied to only one destination bucket, and cannot be copied again from the destination bucket to another bucket. For example, bucket A and bucket B are in two different regions. You can copy data from bucket A to bucket B or the other way round. However, data copies in either bucket A or bucket B cannot be replicated anymore.</li><li id="obs_03_0002__li11992126115120">Object deletion actions made on the source bucket are usually not synchronized to the destination bucket when synchronous deletion of objects is disabled. The object deletion synchronization will happen only when both the source and destination buckets have versioning enabled and you delete an object from the source bucket without specifying a version.<p id="obs_03_0002__p1165317109511"><a name="obs_03_0002__li11992126115120"></a><a name="li11992126115120"></a>When synchronous deletion of objects is enabled, object deletion actions made on the source bucket will be synchronized to the destination bucket. Deleting an object from the source bucket also deletes the object from the destination bucket.</p>
<ul id="obs_03_0002__ul11966603201218"><li id="obs_03_0002__li42866360205234">Currently, only buckets of version 3.0 support cross-region replication. To check the bucket version, go to the <strong id="obs_03_0002__b2271161683219">Overview</strong> page of the bucket on OBS Console. Then you can view the bucket version in the <strong id="obs_03_0002__b152713167324">Basic Information</strong> area.</li><li id="obs_03_0002__li18566425205853">The source bucket and the destination bucket must belong to different regions separately. Data cannot be copied between buckets in the same region.</li><li id="obs_03_0002__li10298429571">Objects of the Cold storage class in the source bucket cannot be copied to the destination bucket through the cross-region replication function.</li><li id="obs_03_0002__li6643645201335">If the region where the destination bucket resides does not support the storage classes, object copies will be stored in the standard storage class.</li><li id="obs_03_0002__li40610889201447">The versioning status of the source bucket must be the same as that of the destination bucket.</li><li id="obs_03_0002__li51500545201552">Objects in a source bucket can be copied to only one destination bucket, and cannot be copied again from the destination bucket to another bucket. For example, bucket A and bucket B are in two different regions. You can copy data from bucket A to bucket B or the other way round. However, data copies in either bucket A or bucket B cannot be replicated anymore.</li><li id="obs_03_0002__li11992126115120">Object deletion actions made on the source bucket are usually not synchronized to the destination bucket when synchronous deletion of objects is disabled. The object deletion synchronization will happen only when both the source and destination buckets have versioning enabled and you delete an object from the source bucket without specifying a version.<p id="obs_03_0002__p1165317109511"><a name="obs_03_0002__li11992126115120"></a><a name="li11992126115120"></a>When synchronous deletion of objects is enabled, object deletion actions made on the source bucket will be synchronized to the destination bucket. Deleting an object from the source bucket also deletes the object from the destination bucket.</p>
</li><li id="obs_03_0002__li19172854103610">If you change the versioning status of the destination bucket when cross-region replication is enabled, the replication of objects will fail. If you want to change the versioning status of the source bucket, disable the cross-region replication first, and then make the change.</li><li id="obs_03_0002__li3170892203040">Ensure that owners of the source and destination buckets have the read and write permissions to the two buckets. Otherwise, data cannot be synchronized. If the system does not have the permissions to read the source bucket or write the destination bucket due to read/write permission errors, objects cannot be copied successfully, and such replication will not be resumed even if the permission error is rectified.</li><li id="obs_03_0002__li46188933212111">For a source bucket, you can create only one cross-region replication rule that applies to the whole bucket for replication of all objects in the bucket. However, you can create a maximum of 100 cross-region replication rules based on object prefixes for the replication of objects that match the prefixes.</li><li id="obs_03_0002__li841240821272">OBS currently only supports the replication between one source bucket and one destination bucket. Replication from one source bucket to multiple destination buckets is not supported. The destination bucket can be modified. However, modifying the destination bucket will change the destination bucket of all existing rules.</li><li id="obs_03_0002__li1176416269455">If you delete the OBS agency when the cross-region replication is enabled, the replication will be in the FAILED status.</li><li id="obs_03_0002__li1896562917467">Do not delete, overwrite object replicas in the destination bucket, or modify their ACLs, which may cause inconsistency of latest object versions or permission control settings between the destination bucket and the source bucket.</li><li id="obs_03_0002__li85430238574">After a replication with <strong id="obs_03_0002__b8262184619192">Synchronize Existing Objects</strong> enabled is complete, if the replication policy keeps unchanged, any ACL changes of source objects will be synchronized to object copies. However, ACL changes of source historical objects will not be synchronized to the copies of historical objects.</li></ul>
</div>
</div>

20
docs/obs/umn/obs_03_0003.html
View File

@ -1,7 +1,7 @@
<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 id="body1516351604726"><p id="obs_03_0003__p131341258783">To replicate objects from a source bucket to a destination bucket in a different region, you can configure a single cross-region replication rule that is applied to all objects in the bucket, or you can configure multiple rules that are applied to a set of objects by specifying a prefix.</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>
@ -15,20 +15,20 @@
</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 class="cellrowborder" valign="top" headers="mcps1.3.4.2.4.2.1.2.4.1.2 "><p id="obs_03_0003__p19169174012117">Indicates whether the rule is enabled or disabled after being created. The versioning status of the source and destination buckets must keep the same.</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__b2093655033">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 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 the objects the rule will apply to.</p>
<ul id="obs_03_0003__ul3169174015119"><li id="obs_03_0003__li316915403117"><strong id="obs_03_0003__b474022597">All objects</strong>: The rule applies to all objects in the bucket.</li><li id="obs_03_0003__li4169204013113"><strong id="obs_03_0003__b9219247824">Match by prefix</strong>: The rule applies only to objects with the specified 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__b77754925">Prefix</strong>.</li><li id="obs_03_0003__li14169114011110">When <strong id="obs_03_0003__b1316318046">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__b1469362262">abc</strong> exists in the system, another rule whose prefix starts with <strong id="obs_03_0003__b1736996033">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 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">To apply the rule to objects with the specified prefix, you must set <strong id="obs_03_0003__b12792252044">Prefix</strong> to a value no longer than 1,024 characters.</li><li id="obs_03_0003__li14169114011110">If the specified prefix overlaps with the prefix of an existing rule, OBS regards these two rules as one and the new rule cannot be configured. For example, if there is already a rule with prefix <strong id="obs_03_0003__b197214520510">abc</strong> in OBS, you cannot configure another rule whose prefix starts with <strong id="obs_03_0003__b199721752753">abc</strong>.</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>
@ -44,9 +44,9 @@
<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 for encrypting the object copy changes to the default key <strong id="obs_03_0003__b1196341174620">obs/default</strong> of the region where the destination bucket is located.</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__b1317415410118">KMS Administrator</strong> permission at both the source and destination ends are displayed in the drop-down list of <strong id="obs_03_0003__b217445420111">IAM Agency</strong> in the <strong id="obs_03_0003__b617415451120">Create Cross-Region Replication Rule</strong> 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__b475152181214">KMS Administrator</strong> permission at either the source or destination end are displayed in the drop-down list of <strong id="obs_03_0003__b27545201214">IAM Agency</strong> in the <strong id="obs_03_0003__b187595216123">Create Cross-Region Replication Rule</strong> 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__b13263951773">KMS Administrator</strong> permission in the source and destination regions, KMS encrypted objects 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 is replicated to the destination bucket, the key for encrypting the object copy changes to the default key <strong id="obs_03_0003__b669210713915">obs/default</strong> of the destination region.</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>
@ -63,7 +63,7 @@
</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 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 the source objects. 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>
@ -73,7 +73,7 @@
<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>
<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__b1356314283406">Replicate KMS encrypted objects</strong> is selected, you also need the <strong id="obs_03_0003__b9563528184017">KMS Administrator</strong> permission in the regions where the source and destination buckets are located.</p>
</div></div>
</td>
</tr>

4
docs/obs/umn/obs_03_0009.html
View File

@ -1,11 +1,11 @@
<a name="obs_03_0009"></a><a name="obs_03_0009"></a>
<h1 class="topictitle1">Monitoring OBS</h1>
<div id="body1523936504790"><div class="section" id="obs_03_0009__section36212810357"><h4 class="sectiontitle">Scenarios</h4><p id="obs_03_0009__p1613844418487">You may send PUT and GET requests continuously when using OBS, which generates upload and download traffic. You may also receive error responses from the server. Cloud Eye can perform automatic and real-time monitoring over your buckets. It triggers alarms and notifications upon operations to help you understand your bucket access requests, traffic, and error responses in a timely manner.</p>
<div id="body1523936504790"><div class="section" id="obs_03_0009__section36212810357"><h4 class="sectiontitle">Scenarios</h4><p id="obs_03_0009__p1613844418487">In the use of OBS, you may send PUT and GET requests that generate upload and download traffic, or receive error responses from the server. To learn the requests, traffic, and error responses in a timely manner, you can use Cloud Eye to perform automatic and real-time monitoring over your buckets.</p>
<p id="obs_03_0009__p104272043831">You do not need to separately subscribe to Cloud Eye. It starts automatically once you create a resource (a bucket, for example) in OBS. For more information about Cloud Eye, see <a href="https://docs.otc.t-systems.com/cloud-eye/umn" target="_blank" rel="noopener noreferrer">Cloud Eye User Guide</a>.</p>
<div class="fignone" id="obs_03_0009__fig203414262328"><span class="figcap"><b>Figure 1 </b>Cloud Eye monitoring</span><br><span><img id="obs_03_0009__image1944715455110" src="en-us_image_0198863546.png" title="Click to enlarge" class="imgResize"></span></div>
</div>
<div class="section" id="obs_03_0009__section667020353411"><h4 class="sectiontitle">Setting Alarm Rules</h4><p id="obs_03_0009__p176015241700">In addition to the automatic and real-time monitoring, you can configure alarm rules in Cloud Eye to send alarm notifications when specified situation occurs.</p>
<div class="section" id="obs_03_0009__section667020353411"><h4 class="sectiontitle">Setting Alarm Rules</h4><p id="obs_03_0009__p176015241700">In addition to automatic and real-time monitoring, you can configure alarm rules in Cloud Eye to receive alarm notifications when specified events happen.</p>
<p id="obs_03_0009__p2640168819">For details, see <a href="https://docs.otc.t-systems.com/cloud-eye/umn/using_the_alarm_function/creating_alarm_rules/index.html" target="_blank" rel="noopener noreferrer">Creating Alarm Rules</a> in <em id="obs_03_0009__i736314399519">Cloud Eye User Guide</em>.</p>
</div>
<div class="section" id="obs_03_0009__section12135192795316"><h4 class="sectiontitle">Viewing OBS Monitoring Metrics</h4><p id="obs_03_0009__p15766163865313">Cloud Eye monitors <a href="obs_03_0010.html">OBS monitoring metrics</a> in real time. You can view detailed monitoring statistics of each metric on the console of Cloud Eye.</p>

2
docs/obs/umn/obs_03_0010.html
View File

@ -81,7 +81,7 @@
<td class="cellrowborder" valign="top" width="16.548345165483454%" headers="mcps1.3.3.2.1.7.1.2 "><p id="obs_03_0010__p2073520208110">First Byte Download Delay</p>
</td>
<td class="cellrowborder" valign="top" width="34.6065393460654%" headers="mcps1.3.3.2.1.7.1.3 "><p id="obs_03_0010__p16735112016116">Specifies the average time from receiving a GET, HEAD, or OPTIONS request to the time that the system starts to respond in a measurement period.</p>
<p id="obs_03_0010__p12264143317512">Unit: millisecond</p>
<p id="obs_03_0010__p12264143317512">Unit: ms</p>
</td>
<td class="cellrowborder" valign="top" width="12.37876212378762%" headers="mcps1.3.3.2.1.7.1.4 "><p id="obs_03_0010__p1573515202113">≥ 0 ms</p>
</td>

25
docs/obs/umn/obs_03_0012.html
View File

@ -3,7 +3,7 @@
<h1 class="topictitle1">Storage Classes Overview</h1>
<div id="body8662426"><p id="obs_03_0012__en-us_topic_0050937852_p5495173433013">OBS supports tiered storage classes at the bucket level and object level.</p>
<p id="obs_03_0012__en-us_topic_0050937852_p59654135102119">OBS provides the following storage classes: Standard, Warm, and Cold.</p>
<div class="p" id="obs_03_0012__en-us_topic_0050937852_p2914586010533">Different storage classes meet different requirements for storage performance and costs.<ul id="obs_03_0012__en-us_topic_0050937852_ul3992358810533"><li id="obs_03_0012__en-us_topic_0050937852_li1693337310533">The Standard storage class features low access latency and high throughput. It is therefore suitable for storing a massive number of hot files (frequently accessed every month) or small files (less than 1 MB). The application scenarios include big data analytics, mobile apps, hot videos, and social apps.</li><li id="obs_03_0012__en-us_topic_0050937852_li61152206154814">The Warm storage class is ideal for storing data that is semi-frequently accessed (less than 12 times a year), with requirements for quick response. The application scenarios include file synchronization, file sharing, and enterprise backup.</li><li id="obs_03_0012__en-us_topic_0050937852_li57040773154825">The Cold storage class is suitable for archiving data that is rarely-accessed (averagely once a year). The application scenarios include data archiving and long-term data backups. The Cold storage class is secure, durable, and inexpensive, and can be used to replace tape libraries. To keep cost low, it may take hours to restore data from the Cold storage class.</li></ul>
<div class="p" id="obs_03_0012__en-us_topic_0050937852_p2914586010533">These storage classes can meet different needs for storage performance and costs.<ul id="obs_03_0012__en-us_topic_0050937852_ul3992358810533"><li id="obs_03_0012__en-us_topic_0050937852_li1693337310533">Standard: The Standard storage class features low latency and high throughput. It is therefore good for storing frequently (multiple times per month) accessed files or small files (less than 1 MB). Its application scenarios include big data analytics, mobile apps, hot videos, and social apps.</li><li id="obs_03_0012__en-us_topic_0050937852_li61152206154814">Warm: The Warm storage class is for storing data that is infrequently (less than 12 times per year) accessed, but when needed, the access has to be fast. It can be used for file synchronization, file sharing, enterprise backups, and many other scenarios.</li><li id="obs_03_0012__en-us_topic_0050937852_li57040773154825">Cold: The Cold storage class is ideal for storing data that is rarely (once per year) accessed. Its application scenarios include data archive and long-term backups. The Cold storage class is secure, durable, and inexpensive, and can be used to replace tape libraries. To keep cost low, it may take hours to restore data from the Cold storage class.</li></ul>
</div>
<div class="section" id="obs_03_0012__en-us_topic_0050937852_section510051131514"><h4 class="sectiontitle">Bucket Storage Classes vs. Object Storage Classes</h4><p id="obs_03_0012__en-us_topic_0050937852_p8262771203">When an object is uploaded, it inherits the storage class of the bucket by default, but you can change the default storage class when you upload the object.</p>
<p id="obs_03_0012__en-us_topic_0050937852_p15587122093216">Changing the storage class of a bucket does not change the storage classes of existing objects in the bucket, but newly uploaded objects will inherit the new storage class.</p>
@ -21,11 +21,11 @@
</thead>
<tbody><tr id="obs_03_0012__en-us_topic_0050937852_row103188419355"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="obs_03_0012__en-us_topic_0050937852_p131810412351">Feature</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="obs_03_0012__en-us_topic_0050937852_p2031818473511">Top-notch performance, highly reliable and available </p>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="obs_03_0012__en-us_topic_0050937852_p2031818473511">Top-notch performance, high reliability and availability</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.3 "><p id="obs_03_0012__en-us_topic_0050937852_p83181416352">Reliable, inexpensive, and real-time storage access</p>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.3 "><p id="obs_03_0012__en-us_topic_0050937852_p83181416352">Reliable, inexpensive storage with real-time access</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.4 "><p id="obs_03_0012__en-us_topic_0050937852_p19318134103517">Long-term storage for archived data at a very low cost</p>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.4 "><p id="obs_03_0012__en-us_topic_0050937852_p19318134103517">Long-term storage for Cold data at a low cost</p>
</td>
</tr>
<tr id="obs_03_0012__en-us_topic_0050937852_row265162715348"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="obs_03_0012__en-us_topic_0050937852_p46642711342">Application scenarios</p>
@ -37,9 +37,22 @@
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.4 "><p id="obs_03_0012__en-us_topic_0050937852_p186612743416">Archive, medical image storage, video material storage, and replacement of tape libraries</p>
</td>
</tr>
<tr id="obs_03_0012__en-us_topic_0050937852_row565445793616"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="obs_03_0012__en-us_topic_0050937852_p136541857183616">Minimum storage duration</p>
<tr id="obs_03_0012__en-us_topic_0050937852_row9115436175710"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="obs_03_0012__en-us_topic_0050937852_en-us_topic_0292412045_p13417642111516">Minimum measurement unit<sup id="obs_03_0012__en-us_topic_0050937852_sup15328648929">a</sup></p>
<div class="note" id="obs_03_0012__en-us_topic_0050937852_note142616439418"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_03_0012__en-us_topic_0050937852_p1148863415">a: Minimum measurement unit refers to a minimum billable object size. For example, a 32 KB Standard object will be billed as if it were 64 KB.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="obs_03_0012__en-us_topic_0050937852_p18654105712362">Not required</p>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="obs_03_0012__en-us_topic_0050937852_en-us_topic_0292412045_p1417164213154">64 KB</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.3 "><p id="obs_03_0012__en-us_topic_0050937852_en-us_topic_0292412045_p5270218151610">64 KB</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.4 "><p id="obs_03_0012__en-us_topic_0050937852_en-us_topic_0292412045_p5876152871616">64 KB</p>
</td>
</tr>
<tr id="obs_03_0012__en-us_topic_0050937852_row565445793616"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.1 "><p id="obs_03_0012__en-us_topic_0050937852_en-us_topic_0292412045_p136541857183616">Minimum storage duration<sup id="obs_03_0012__en-us_topic_0050937852_sup15155142520210">b</sup></p>
<div class="note" id="obs_03_0012__en-us_topic_0050937852_note146341423164216"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_03_0012__en-us_topic_0050937852_p14481866410">b: Minimum storage duration refers to a minimum billable storage duration. For example, an Infrequent Access object deleted when it was stored for 20 days will be billed for a full 30 days.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.2 "><p id="obs_03_0012__en-us_topic_0050937852_p18654105712362">N/A</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.5.1.3 "><p id="obs_03_0012__en-us_topic_0050937852_p12654145712368">30 days</p>
</td>

2
docs/obs/umn/obs_03_0016.html
View File

@ -13,7 +13,7 @@
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_faq_10000.html">FAQs</a></div>
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_faq_10000.html">FAQ</a></div>
</div>
</div>

11
docs/obs/umn/obs_03_0020.html
View File

@ -27,7 +27,7 @@
</tr>
<tr id="obs_03_0020__row16692106102914"><td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_03_0020__p0381113442619">Management</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_03_0020__p1669976112919">Deleting the CORS configuration a Bucket</p>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_03_0020__p1669976112919">Deleting the CORS configuration of a bucket</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_03_0020__p211018265198">bucket</p>
</td>
@ -88,15 +88,6 @@
<td class="cellrowborder" valign="top" width="31%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_03_0020__p67632642911">deleteBucketWebsite</p>
</td>
</tr>
<tr id="obs_03_0020__row876520620293"><td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_03_0020__p3671121313277">Management</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_03_0020__p97705682917">Deleting bucket data</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_03_0020__p551110308197">bucket</p>
</td>
<td class="cellrowborder" valign="top" width="31%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_03_0020__p147738614295">deleteBucketdata</p>
</td>
</tr>
<tr id="obs_03_0020__row4785166162919"><td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_03_0020__p66821613162710">Management</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_03_0020__p1378913662916">Creating a bucket</p>

2
docs/obs/umn/obs_03_0024.html
View File

@ -6,7 +6,7 @@
</div>
<div class="section" id="obs_03_0024__section986174914385"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0024__ol121691624398"><li id="obs_03_0024__li17941716113913"><span>Log in to OBS Browser.</span></li><li id="obs_03_0024__li1979413164397"><span>Click the bucket to which the file or folder will be uploaded.</span></li><li id="obs_03_0024__li11355155815398"><span>Click <strong id="obs_03_0024__b156161515316">Upload</strong>. The <strong id="obs_03_0024__b1267941813538">Upload Object</strong> dialog box is displayed. For details, see <a href="#obs_03_0024__fig1511502439">Figure 1</a>.</span><p><p id="obs_03_0024__p1822519516464">You can select either files or folders to upload. For details, see <a href="#obs_03_0024__li1356818523426">4</a> and <a href="#obs_03_0024__li018223074620">5</a>.</p>
<div class="fignone" id="obs_03_0024__fig1511502439"><a name="obs_03_0024__fig1511502439"></a><a name="fig1511502439"></a><span class="figcap"><b>Figure 1 </b>Uploading objects</span><br><span><img id="obs_03_0024__image1585285019506" src="en-us_image_0150044268.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="obs_03_0024__li1356818523426"><a name="obs_03_0024__li1356818523426"></a><a name="li1356818523426"></a><span>Click <strong id="obs_03_0024__b2029918566382">Select File</strong>. The local file browser dialog box is displayed. Select the file that you want to upload and click <strong id="obs_03_0024__b1890114866">Open</strong>.</span><p><p id="obs_03_0024__p113641020104919">You can upload a maximum of 500 files or folders at a time.</p>
</p></li><li id="obs_03_0024__li1356818523426"><a name="obs_03_0024__li1356818523426"></a><a name="li1356818523426"></a><span>Click <strong id="obs_03_0024__b2029918566382">Select File</strong>. The local file browser dialog box is displayed. Select the file that you want to upload and click <strong id="obs_03_0024__b1828579988">Open</strong>.</span><p><p id="obs_03_0024__p113641020104919">You can upload a maximum of 500 files or folders at a time.</p>
<div class="note" id="obs_03_0024__note1471316298112"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0024__obs_03_0307_p14504161520198">If the files that you want to upload to OBS are stored in Microsoft OneDrive, it is recommended that the names of these files contain a maximum of 32 characters to ensure compatibility.</p>
</div></div>
</p></li><li id="obs_03_0024__li018223074620"><a name="obs_03_0024__li018223074620"></a><a name="li018223074620"></a><span>Click <strong id="obs_03_0024__b510082520398">Select Folder</strong>, select a folder, and click <strong id="obs_03_0024__b20241163217391">OK</strong>.</span></li><li id="obs_03_0024__li1183611317537"><span>Select a storage class. If no storage class is selected, the object inherits the bucket storage class by default.</span></li><li id="obs_03_0024__li797732565116"><span>Click <strong id="obs_03_0024__b15904113325617">OK</strong> to upload the file or folder.</span></li></ol>

2
docs/obs/umn/obs_03_0032.html
View File

@ -1,7 +1,7 @@
<a name="obs_03_0032"></a><a name="obs_03_0032"></a>
<h1 class="topictitle1">Configuring a User-Defined Domain Name</h1>
<div id="body0000001508343717"><div class="section" id="obs_03_0032__section541719774011"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0032__ol7482417101117"><li id="obs_03_0032__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0032__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="obs_03_0032__li13225103917434"><span>In the navigation pane, choose <strong id="obs_03_0032__b112571336227">Domain Name Mgmt</strong>.</span></li><li id="obs_03_0032__li1780214214274"><span>Click <strong id="obs_03_0032__b1833051191011">Bind User Domain Name</strong>. In the displayed dialog box, enter the domain name to configure, as shown in <a href="#obs_03_0032__fig53010339108">Figure 1</a>.</span><p><p id="obs_03_0032__p7863173592419">The suffix of a user-defined domain name can contain 2 to 6 uppercase or lowercase letters.</p>
<div id="body0000001508343717"><div class="section" id="obs_03_0032__section541719774011"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0032__ol7482417101117"><li id="obs_03_0032__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0032__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="obs_03_0032__li13225103917434"><span>In the navigation pane, choose <strong id="obs_03_0032__b112571336227">Domain Name Mgmt</strong>.</span></li><li id="obs_03_0032__li1780214214274"><span>Click <strong id="obs_03_0032__b44123173194">Bind User Domain Name</strong>. In the displayed dialog box, enter the domain name to configure, as shown in <a href="#obs_03_0032__fig53010339108">Figure 1</a>. </span><p><p id="obs_03_0032__p7863173592419">The suffix of a user-defined domain name can contain 2 to 6 uppercase or lowercase letters.</p>
<div class="fignone" id="obs_03_0032__fig53010339108"><a name="obs_03_0032__fig53010339108"></a><a name="fig53010339108"></a><span class="figcap"><b>Figure 1 </b>Binding a user domain name</span><br><span><img id="obs_03_0032__image1886212815184" src="en-us_image_0000001458743966.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="obs_03_0032__li417413617312"><span>Click <strong id="obs_03_0032__b514602912318">OK</strong>.</span></li><li id="obs_03_0032__li313135810364"><span>Configure a CNAME record on the DNS, and map the user-defined domain name (for example, <strong id="obs_03_0032__b148053833110">example.com</strong>) to the domain name of the bucket. </span><p><p id="obs_03_0032__p161095613225">The CNAME configuration varies depending on DNS providers. For details, contact your DNS provider.</p>
</p></li></ol>

36
docs/obs/umn/obs_03_0035.html
View File

@ -2,7 +2,7 @@
<h1 class="topictitle1">Configuring User Permissions</h1>
<div id="body8662426"><p id="obs_03_0035__obs_03_0304_p77331243113019">If your cloud service account does not need individual IAM users, then you may skip this section. Your permissions to use OBS functions are not affected.</p>
<p id="obs_03_0035__obs_03_0304_p783465223215">If IAM users are required, you need to grant them access permissions on OBS, because OBS is separately deployed from other cloud resources.</p>
<p id="obs_03_0035__obs_03_0304_p783465223215">If IAM users are required, you need to grant them access permissions for OBS, because OBS is separately deployed from other cloud resources.</p>
<div class="section" id="obs_03_0035__obs_03_0304_section12521716448"><h4 class="sectiontitle">Process</h4><div class="fignone" id="obs_03_0035__obs_03_0304_obs_03_0122_fig292324264713"><span class="figcap"><b>Figure 1 </b>Process of granting an IAM user the OBS permissions</span><br><span><img id="obs_03_0035__obs_03_0304_obs_03_0122_image12924124212474" src="en-us_image_0170301902.png"></span></div>
</div>
<div class="section" id="obs_03_0035__obs_03_0304_section1056019017457"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0035__obs_03_0304_obs_03_0122_ol63831030102"><li id="obs_03_0035__obs_03_0304_obs_03_0122_li35354147174321"><span>Log in to the management console with your account.</span></li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li5853192561010"><span>On the top menu bar, choose <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b149371518121613">Service List</strong> &gt; <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b29379189163">Management &amp; Deployment</strong> &gt; <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b1293761819168">Identity and Access Management</strong>. The IAM console is displayed.</span></li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li257313485116"><span>Create a user group and assign OBS permissions to it.</span><p><div class="p" id="obs_03_0035__obs_03_0304_obs_03_0122_p371751915195">A user group is a collection of users. By assigning permissions to a user group, you assign permissions to the users in this group. After you create an IAM user, add it to one or more user groups, so that it can inherit the permissions from the groups.<ol type="a" id="obs_03_0035__obs_03_0304_obs_03_0122_ol28671118201912"><li id="obs_03_0035__obs_03_0304_obs_03_0122_li78661718151913">In the navigation pane, choose <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b0624202611174">User Groups</strong>. The <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b8624112618178">User Groups</strong> page is displayed.</li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li286617189195">Click <span class="uicontrol" id="obs_03_0035__obs_03_0304_obs_03_0122_uicontrol230942777211457"><b>Create User Group</b></span>.</li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li1886641801917">Enter a user group name and click <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b779483571714">OK</strong>.<p id="obs_03_0035__obs_03_0304_obs_03_0122_p3866171841910">The user group is displayed in the user group list once the creation is complete.</p>
@ -11,39 +11,7 @@
</div></div>
</li></ol>
</div>
</p></li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li17712194912"><span>Create a user.</span><p><ol type="a" id="obs_03_0035__obs_03_0304_obs_03_0122_ol6893174016015"><li id="obs_03_0035__obs_03_0304_obs_03_0122_li84578140715">In the navigation pane, choose <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b1645363019241">Users</strong>. The <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b174541830102416">Users</strong> page is displayed.</li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li75875232719">Click <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b16239139183714">Create User</strong>.</li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li08941740305">Set user information and click <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b897712100378">Next</strong>.
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0035__obs_03_0304_obs_03_0122_table127131345071" frame="border" border="1" rules="all"><caption><b>Table 1 </b>User parameters</caption><thead align="left"><tr id="obs_03_0035__obs_03_0304_obs_03_0122_row4714144517714"><th align="left" class="cellrowborder" valign="top" width="26.729999999999997%" id="mcps1.3.4.2.4.2.1.3.2.2.3.1.1"><p id="obs_03_0035__obs_03_0304_obs_03_0122_p137145451578">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="73.27%" id="mcps1.3.4.2.4.2.1.3.2.2.3.1.2"><p id="obs_03_0035__obs_03_0304_obs_03_0122_p1071417451679">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0035__obs_03_0304_obs_03_0122_row157141451376"><td class="cellrowborder" valign="top" width="26.729999999999997%" headers="mcps1.3.4.2.4.2.1.3.2.2.3.1.1 "><p id="obs_03_0035__obs_03_0304_obs_03_0122_p1971404515717">Username</p>
</td>
<td class="cellrowborder" valign="top" width="73.27%" headers="mcps1.3.4.2.4.2.1.3.2.2.3.1.2 "><p id="obs_03_0035__obs_03_0304_obs_03_0122_p1871494519719">The user name for logging in to the cloud service.</p>
</td>
</tr>
<tr id="obs_03_0035__obs_03_0304_obs_03_0122_row37141245171"><td class="cellrowborder" valign="top" width="26.729999999999997%" headers="mcps1.3.4.2.4.2.1.3.2.2.3.1.1 "><p id="obs_03_0035__obs_03_0304_obs_03_0122_p3714645874">Credential Type</p>
</td>
<td class="cellrowborder" valign="top" width="73.27%" headers="mcps1.3.4.2.4.2.1.3.2.2.3.1.2 "><div class="p" id="obs_03_0035__obs_03_0304_obs_03_0122_p1652150296">A credential refers to the identity credential used for user system authentication. In this example, password is selected.<ul id="obs_03_0035__obs_03_0304_obs_03_0122_ul194541357781"><li id="obs_03_0035__obs_03_0304_obs_03_0122_li1545412571989"><strong id="obs_03_0035__obs_03_0304_obs_03_0122_b293243261112">Password</strong>: Used for accessing cloud services using the console or development tools.</li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li1945475715812"><strong id="obs_03_0035__obs_03_0304_obs_03_0122_b4990439141110">Access key</strong>: Used for logging to the cloud service using development tools. This credential type is more secure, and is recommended if the user does not need to use the console.</li></ul>
</div>
</td>
</tr>
<tr id="obs_03_0035__obs_03_0304_obs_03_0122_row67141445471"><td class="cellrowborder" valign="top" width="26.729999999999997%" headers="mcps1.3.4.2.4.2.1.3.2.2.3.1.1 "><p id="obs_03_0035__obs_03_0304_obs_03_0122_p167148452713">User Groups</p>
</td>
<td class="cellrowborder" valign="top" width="73.27%" headers="mcps1.3.4.2.4.2.1.3.2.2.3.1.2 "><p id="obs_03_0035__obs_03_0304_obs_03_0122_p1471412456719">You can add a user to one or more user groups. Then the user will inherit the permissions granted to these user groups. The default user group <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b181532620463">admin</strong> has the administrator permissions and all of the permissions required to use all cloud resources.</p>
</td>
</tr>
<tr id="obs_03_0035__obs_03_0304_obs_03_0122_row16714184512714"><td class="cellrowborder" valign="top" width="26.729999999999997%" headers="mcps1.3.4.2.4.2.1.3.2.2.3.1.1 "><p id="obs_03_0035__obs_03_0304_obs_03_0122_p142481183015">Description</p>
</td>
<td class="cellrowborder" valign="top" width="73.27%" headers="mcps1.3.4.2.4.2.1.3.2.2.3.1.2 "><p id="obs_03_0035__obs_03_0304_obs_03_0122_p167144453719">(Optional) Brief description about the user.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li1878212359116">Select a type for password generation, set the email address and mobile number, and click <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b12462145916241">OK</strong>.</li></ol>
</p></li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li193181327107"><span>Use the created IAM user to log in to OBS Console and verify the user permissions.</span></li></ol>
</p></li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li7964155918166"><span>Create an IAM user. For details, see section "Creating an IAM User" in the <em id="obs_03_0035__obs_03_0304_obs_03_0122_i1898610457585">Identity and Access Management User Guide</em>.</span></li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li193181327107"><span>Use the created IAM user to log in to OBS Console and verify the user permissions.</span></li></ol>
</div>
</div>
<div>

2
docs/obs/umn/obs_03_0037.html
View File

@ -2,7 +2,7 @@
<h1 class="topictitle1">Creating an IAM Agency</h1>
<div id="body1530063787773"><p id="obs_03_0037__p73929984212">To use some OBS features, you need to use IAM agencies to grant required permissions to OBS for processing your data.</p>
<div class="section" id="obs_03_0037__section3206135419349"><h4 class="sectiontitle">Creating an Agency for Cross-Region Replication</h4><ol id="obs_03_0037__ol5996339393"><li id="obs_03_0037__li79915335394"><span>In the <strong id="obs_03_0037__b97842535191">Create Cross-Region Replication Rule</strong> dialog box on OBS Console, click <strong id="obs_03_0037__b187969242185">Create IAM agencies</strong> to jump to the <strong id="obs_03_0037__b978975301917">Agencies</strong> page on the IAM console.</span></li><li id="obs_03_0037__li8991133123911"><span>Click <strong id="obs_03_0037__b186681916102018">Create Agency</strong> to create an agency.</span></li><li id="obs_03_0037__li39953320399"><span>Enter an agency name.</span></li><li id="obs_03_0037__li69919331395"><span>Select <strong id="obs_03_0037__b5312917209">Cloud service</strong> for the <strong id="obs_03_0037__b193299207">Agency Type</strong>.</span></li><li id="obs_03_0037__li799113303916"><span>Select <strong id="obs_03_0037__b1667833713216">Object Storage Service (OBS)</strong> for <strong id="obs_03_0037__b13425519487">Cloud Service</strong>.</span></li><li id="obs_03_0037__li1499163316396"><span>Set a validity period.</span></li><li id="obs_03_0037__li19992332393"><span>In the <strong id="obs_03_0037__b115781718193914">Permissions</strong> area, select <strong id="obs_03_0037__b678817914419">Project View</strong>, locate <strong id="obs_03_0037__b14624142344120">Global service [Global]</strong>, and click <strong id="obs_03_0037__b194037253012">Modify Permissions</strong> in the <strong id="obs_03_0037__b114604341101">Operation</strong> column. The <strong id="obs_03_0037__b149276481508">Modify Permissions</strong> window is displayed.</span></li><li id="obs_03_0037__li1345055963015"><span>Click <strong id="obs_03_0037__b718063013313">Select Policy/Role</strong> in the <strong id="obs_03_0037__b185251022132513">Operation</strong> column of the row where <strong id="obs_03_0037__b09851216336">Global service [Global]</strong> is displayed. Search for <strong id="obs_03_0037__b12814123694512">Tenant Administrator</strong> and check the box next to it, and click <strong id="obs_03_0037__b981412365458">OK</strong>.</span></li><li id="obs_03_0037__li799173320395"><span>(Optional) If <strong id="obs_03_0037__b983321773610">Replicate KMS encrypted objects</strong> is selected when configuring the cross-region replication rule, the <strong id="obs_03_0037__b92132331367">KMS Administrator</strong> policy set must be configured in the regions where the source bucket and destination bucket are located.</span><p><ol type="a" id="obs_03_0037__ol10993338392"><li id="obs_03_0037__li79903311394">Click <strong id="obs_03_0037__b723135193019">Modify Permissions</strong> in the row of the region where the source/destination bucket resides. The <strong id="obs_03_0037__b934841623711">Modify Permissions</strong> dialog box is displayed.</li><li id="obs_03_0037__li18761184484018">Click <strong id="obs_03_0037__b10772132743413">Select Policy/Role</strong> in the row of the region where the source/destination bucket resides. The <strong id="obs_03_0037__b2448195713340">Select Policy/Role</strong> dialog box is displayed.</li><li id="obs_03_0037__li1799173393917">Search for <strong id="obs_03_0037__b13480727191618">KMS</strong> and check the box next to the <strong id="obs_03_0037__b1372953619167">KMS Administrator</strong> policy set.</li><li id="obs_03_0037__li2999337394">Click <strong id="obs_03_0037__b2134736173818">OK</strong>.</li></ol>
<div class="section" id="obs_03_0037__section3206135419349"><h4 class="sectiontitle">Creating an Agency for Cross-Region Replication</h4><ol id="obs_03_0037__ol5996339393"><li id="obs_03_0037__li79915335394"><span>In the <strong id="obs_03_0037__b97842535191">Create Cross-Region Replication Rule</strong> dialog box on OBS Console, click <strong id="obs_03_0037__b187969242185">Create IAM agencies</strong> to jump to the <strong id="obs_03_0037__b978975301917">Agencies</strong> page on the IAM console.</span></li><li id="obs_03_0037__li8991133123911"><span>Click <strong id="obs_03_0037__b186681916102018">Create Agency</strong>.</span></li><li id="obs_03_0037__li39953320399"><span>Enter an agency name.</span></li><li id="obs_03_0037__li69919331395"><span>Select <strong id="obs_03_0037__b5312917209">Cloud service</strong> for the <strong id="obs_03_0037__b193299207">Agency Type</strong>.</span></li><li id="obs_03_0037__li799113303916"><span>Select <strong id="obs_03_0037__b1667833713216">Object Storage Service (OBS)</strong> for <strong id="obs_03_0037__b13425519487">Cloud Service</strong>.</span></li><li id="obs_03_0037__li1499163316396"><span>Set a validity period.</span></li><li id="obs_03_0037__li19992332393"><span>In the <strong id="obs_03_0037__b115781718193914">Permissions</strong> area, select <strong id="obs_03_0037__b678817914419">Project View</strong>, locate <strong id="obs_03_0037__b14624142344120">Global service [Global]</strong>, and click <strong id="obs_03_0037__b194037253012">Modify Permissions</strong> in the <strong id="obs_03_0037__b114604341101">Operation</strong> column. The <strong id="obs_03_0037__b149276481508">Modify Permissions</strong> window is displayed.</span></li><li id="obs_03_0037__li1345055963015"><span>Click <strong id="obs_03_0037__b718063013313">Select Policy/Role</strong> in the <strong id="obs_03_0037__b185251022132513">Operation</strong> column of the row where <strong id="obs_03_0037__b09851216336">Global service [Global]</strong> is displayed. Search for <strong id="obs_03_0037__b12814123694512">Tenant Administrator</strong> and check the box next to it, and click <strong id="obs_03_0037__b981412365458">OK</strong>.</span></li><li id="obs_03_0037__li799173320395"><span>(Optional) If <strong id="obs_03_0037__b983321773610">Replicate KMS encrypted objects</strong> is selected when configuring the cross-region replication rule, the <strong id="obs_03_0037__b92132331367">KMS Administrator</strong> policy set must be configured in the regions where the source bucket and destination bucket are located.</span><p><ol type="a" id="obs_03_0037__ol10993338392"><li id="obs_03_0037__li79903311394">Click <strong id="obs_03_0037__b723135193019">Modify Permissions</strong> in the row of the region where the source/destination bucket resides. The <strong id="obs_03_0037__b934841623711">Modify Permissions</strong> dialog box is displayed.</li><li id="obs_03_0037__li18761184484018">Click <strong id="obs_03_0037__b10772132743413">Select Policy/Role</strong> in the row of the region where the source/destination bucket resides. The <strong id="obs_03_0037__b2448195713340">Select Policy/Role</strong> dialog box is displayed.</li><li id="obs_03_0037__li1799173393917">Search for <strong id="obs_03_0037__b13480727191618">KMS</strong> and check the box next to the <strong id="obs_03_0037__b1372953619167">KMS Administrator</strong> policy set.</li><li id="obs_03_0037__li2999337394">Click <strong id="obs_03_0037__b2134736173818">OK</strong>.</li></ol>
</p></li><li id="obs_03_0037__li3537171744411"><span>Click <strong id="obs_03_0037__b12842154895015">OK</strong> to complete the agency creation. </span></li></ol>
</div>
</div>

2
docs/obs/umn/obs_03_0038.html
View File

@ -11,7 +11,7 @@
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_faq_10000.html">FAQs</a></div>
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_faq_10000.html">FAQ</a></div>
</div>
</div>

4
docs/obs/umn/obs_03_0045.html
View File

@ -5,7 +5,7 @@
<p id="obs_03_0045__p13193648105813">You can use Identity and Access Management (IAM) to manage OBS permissions and control access to your resources. IAM provides identity authentication, permissions management, and access control.</p>
<p id="obs_03_0045__p1619484812588">You can create IAM users for your employees, and assign permissions to these users on a principle of least privilege (PoLP) basis to control their access to specific resource types. For example, you can create IAM users for software developers and assign specific permissions to allow them to use OBS resources but prevent them from being able to delete resources or perform any high-risk operations.</p>
<p id="obs_03_0045__p1019454825819">If your account does not require individual IAM users for permissions management, skip this section.</p>
<p id="obs_03_0045__p11451141517341">IAM is offered for free. You pay only for the resources in your account. For more information about IAM, see section "Service Overview" in the <em id="obs_03_0045__i184871456175014">Identity and Access Management User Guide</em>.</p>
<p id="obs_03_0045__p11451141517341">IAM is a free service. You only pay for the resources in your account. For more information about IAM, see section "Service Overview" in the <em id="obs_03_0045__i184871456175014">Identity and Access Management User Guide</em>.</p>
<div class="section" id="obs_03_0045__section9905344171915"><h4 class="sectiontitle">OBS Permissions</h4><p id="obs_03_0045__p11747826102111">By default, new IAM users do not have any permissions assigned. You can assign permissions to these users by adding them to one or more groups and attaching policies to the groups. IAM provides preset system policies that define common permissions for different services, such as full control access and read-only. You can directly use these preset policies.</p>
<p id="obs_03_0045__p4950115410203">OBS is a global service deployed and accessed without specifying any physical region. OBS permissions are assigned to users in the global project, and users do not need to switch regions when accessing OBS.</p>
<p id="obs_03_0045__p185553281274">RBAC policy: An RBAC policy consists of permissions for an entire service. Users in a group with such a policy assigned are granted all the required permissions, including permissions for accessing and managing that service. RBAC policies do not support operation-specific permission control.</p>
@ -724,7 +724,7 @@
</tbody>
</table>
</div>
<div class="section" id="obs_03_0045__section4856147369"><h4 class="sectiontitle">Managing OBS Resource Permissions</h4><p id="obs_03_0045__p69931629192117">Access to OBS buckets and objects can be controlled by IAM user permissions, bucket policies, and ACLs.</p>
<div class="section" id="obs_03_0045__section4856147369"><h4 class="sectiontitle">OBS Resource Permissions Management</h4><p id="obs_03_0045__p69931629192117">Access to OBS buckets and objects can be controlled by IAM user permissions, bucket policies, and ACLs.</p>
<p id="obs_03_0045__p1371410863810">For more information, see <a href="obs_03_0047.html">Overview</a>.</p>
</div>
</div>

4
docs/obs/umn/obs_03_0046.html
View File

@ -8,11 +8,11 @@
<p id="obs_03_0046__p936175214325">The temporary authentication information contains the <strong id="obs_03_0046__b191581710133314">AccessKeyId</strong>, <strong id="obs_03_0046__b11743171313331">Expires</strong>, <strong id="obs_03_0046__b1536761914331">x-obs-security-token</strong>, and <strong id="obs_03_0046__b139019248332">Signature</strong> parameters. <strong id="obs_03_0046__b17853173373317">AccessKeyId</strong>, <strong id="obs_03_0046__b3580542183317">x-obs-security-token</strong>, and <strong id="obs_03_0046__b910504711334">Signature</strong> are used for authentication. The <strong id="obs_03_0046__b275917572338">Expires</strong> parameter specifies the validity period of the authentication. </p>
<p id="obs_03_0046__p6131231352">After an object is shared on OBS Console, the system will generate a URL that contains the temporary authentication information, valid for five minutes since its generation by default. Each time you change the validity period of a URL, OBS obtains the authentication information again to generate a new URL for sharing, which takes effect since the time when the validity period is changed.</p>
</div>
<div class="section" id="obs_03_0046__section1524379204718"><h4 class="sectiontitle">Limitations and Constraints</h4><ul id="obs_03_0046__ul1476864319553"><li id="obs_03_0046__li19768743155510">An object shared from OBS Console can be valid for one minute to 18 hours. If you need a longer validity period for a shared object, use the client tool OBS Browser+ that supports a validity period from one minute to 30 days. Or, you can configure a <a href="en-us_topic_0045853745.html">bucket policy or object policy</a> to grant the access permissions of an object to other users permanently.</li><li id="obs_03_0046__li176586246567">Only buckets of version 3.0 support file sharing. You can view the bucket version in the <strong id="obs_03_0046__b137583459531">Basic Information</strong> area on the <strong id="obs_03_0046__b14463156155413">Overview</strong> page of a bucket.</li><li id="obs_03_0046__li15991193655713">Encrypted objects cannot be shared.</li><li id="obs_03_0046__li31603935010">To share a cold object, restore it first.</li></ul>
<div class="section" id="obs_03_0046__section1524379204718"><h4 class="sectiontitle">Limitations and Constraints</h4><ul id="obs_03_0046__ul1476864319553"><li id="obs_03_0046__li19768743155510">An object shared from OBS Console can be valid for one minute to 18 hours. If you need a longer validity period, use OBS Browser+ that allows a validity period from one minute to 30 days. Or, you can configure a <a href="en-us_topic_0045853745.html">bucket policy or object policy</a> to grant other users access to the object permanently.</li><li id="obs_03_0046__li176586246567">Only buckets of version 3.0 support object sharing. You can view the bucket version in the <strong id="obs_03_0046__b137583459531">Basic Information</strong> area on the <strong id="obs_03_0046__b14463156155413">Overview</strong> page of a bucket.</li><li id="obs_03_0046__li15991193655713">Encrypted objects cannot be shared.</li><li id="obs_03_0046__li31603935010">To share a cold object, restore it first.</li></ul>
</div>
<div class="section" id="obs_03_0046__section2745155111154"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0046__ol165136117163"><li id="obs_03_0046__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0046__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="obs_03_0046__li1733753692411"><span>In the navigation pane, choose <strong id="obs_03_0046__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="obs_03_0046__en-us_topic_0066036523_li55598663"><span>Locate the file to be shared and click <strong id="obs_03_0046__b71183914283">Share</strong> in the <strong id="obs_03_0046__b4398656122919">Operation</strong> column.</span><p><p id="obs_03_0046__p654141612312">Once the <strong id="obs_03_0046__b17315125693317">Share File</strong> dialog box is opened, the URL is effective and valid for five minutes by default. If you change the validity period, the authentication information in the URL changes accordingly, and the URL's new validity period starts upon the change.</p>
<div class="fignone" id="obs_03_0046__fig125731684458"><span class="figcap"><b>Figure 1 </b>Sharing a file</span><br><span><img id="obs_03_0046__image6573188144512" src="en-us_image_0000001523534634.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="obs_03_0046__li113111832018"><span>Operate the URL as follows:</span><p><ul id="obs_03_0046__ul36691545182112"><li id="obs_03_0046__li1167044516212">Click <strong id="obs_03_0046__b26901743105011">Open URL</strong> to preview the file on a new page or directly download it to your default download path.</li><li id="obs_03_0046__li475872122213">Click <strong id="obs_03_0046__b13582131814211">Copy Link</strong> to share the link to others for them to access this file using a browser.</li><li id="obs_03_0046__li18612549152314">Click <strong id="obs_03_0046__b10298451165318">Copy Path</strong> to share the file path to users who have access permissions to the bucket. The users then can search for the file by pasting the shared path to the search box of the bucket.</li></ul>
</p></li><li id="obs_03_0046__li113111832018"><span>Operate the URL as follows:</span><p><ul id="obs_03_0046__ul36691545182112"><li id="obs_03_0046__li1167044516212">Click <strong id="obs_03_0046__b26901743105011">Open URL</strong> to preview the file on a new page or directly download it to your default download path.</li><li id="obs_03_0046__li475872122213">Click <strong id="obs_03_0046__b13582131814211">Copy Link</strong> to share the link to others for them to access this file using a browser.</li><li id="obs_03_0046__li18612549152314">Click <strong id="obs_03_0046__b10298451165318">Copy Path</strong> to share the file path to users who have access to the bucket. The users then can search for the file by pasting the shared path to the search box of the bucket.</li></ul>
<div class="note" id="obs_03_0046__note27664672718"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0046__p57734614276">Within the URL validity period, anyone who has the URL can access the file.</p>
</div></div>
</p></li></ol>

2
docs/obs/umn/obs_03_0047.html
View File

@ -8,7 +8,7 @@
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0086.html">Permission Control</a></div>
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0086.html">Permissions Control</a></div>
</div>
</div>

4
docs/obs/umn/obs_03_0049.html
View File

@ -1,8 +1,8 @@
<a name="obs_03_0049"></a><a name="obs_03_0049"></a>
<h1 class="topictitle1">Principals</h1>
<div id="body1557026128761"><p id="obs_03_0049__p28805261528">The principals indicate the users which the bucket policies apply to. These users can be accounts, federated users or federated user groups, and IAM users. Target users can be specified in either of the following ways:</p>
<ul id="obs_03_0049__ul108801826115212"><li id="obs_03_0049__li7880926165213"><strong id="obs_03_0049__b1043613214332">Include</strong>: The policy takes effect on specified users.</li><li id="obs_03_0049__li1488092635210"><strong id="obs_03_0049__b1890962511336">Exclude</strong>: The policy takes effect on all users except the specified ones.</li></ul>
<div id="body1557026128761"><p id="obs_03_0049__p28805261528">The principals indicate the users bucket policies apply to. These users can be accounts, federated users or federated user groups, and IAM users. Target users can be specified in either of the following ways:</p>
<ul id="obs_03_0049__ul108801826115212"><li id="obs_03_0049__li7880926165213"><strong id="obs_03_0049__b1043613214332">Include</strong>: The policy applies to specified users.</li><li id="obs_03_0049__li1488092635210"><strong id="obs_03_0049__b1890962511336">Exclude</strong>: The policy applies to users except the specified ones.</li></ul>
<div class="section" id="obs_03_0049__section1896613422547"><h4 class="sectiontitle">Cloud Service User</h4><ul id="obs_03_0049__ul10202322105519"><li id="obs_03_0049__li20202822135510">IAM users in the current account<p id="obs_03_0049__p1350312548559"><a name="obs_03_0049__li20202822135510"></a><a name="li20202822135510"></a>With <strong id="obs_03_0049__b15586161432114">Principal</strong> set to <strong id="obs_03_0049__b195861514192116">Current account</strong>, you can select one or more IAM users under this account, so the bucket policy applies to the selected IAM users.</p>
</li><li id="obs_03_0049__li697612394557">Other account<p id="obs_03_0049__p1584215477567"><a name="obs_03_0049__li697612394557"></a><a name="li697612394557"></a>When the <strong id="obs_03_0049__b12296181019114">Principal</strong> is set to <strong id="obs_03_0049__b629711061111">Other account</strong>, you can enter the ID of other accounts. If you want to apply the bucket policy to IAM users under that account, you need to enter the user IDs, and use commas (,) to separate one from another.</p>
<div class="note" id="obs_03_0049__note8951376579"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0049__p145818142578">An authorized user can go to the <strong id="obs_03_0049__b5232132317110">My Credential</strong> page to obtain the domain ID and user ID after login.</p>

Some files were not shown because too many files have changed in this diff Show More