OBS UMN doc

Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
This commit is contained in:
zhangyue 2023-02-27 19:04:41 +00:00 committed by zuul
parent 55786917ca
commit 7492b7b30f
123 changed files with 1211 additions and 1161 deletions

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

Binary file not shown.

Before

Width:  |  Height:  |  Size: 195 B

After

Width:  |  Height:  |  Size: 107 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

View File

Before

Width:  |  Height:  |  Size: 63 KiB

After

Width:  |  Height:  |  Size: 63 KiB

View File

@ -25,8 +25,8 @@
</tbody>
</table>
</div>
</li><li id="en-us_topic_0045853504__li11906947104610">The latest objects in a bucket are returned by default after a GET Object request.</li><li id="en-us_topic_0045853504__li5044213017308">Objects can be downloaded by version IDs. By default, the latest object is downloaded if the version ID is not specified. For details, see <a href="obs_03_0327.html#obs_03_0327__section29772226">Follow-up Procedure</a> in <a href="obs_03_0327.html">Configuring Versioning</a>.</li><li id="en-us_topic_0045853504__li1922972904812">You can select an object and click <strong id="en-us_topic_0045853504__b1439112892814">Delete</strong> on the right to delete the object. After the object is deleted, OBS generates a <strong id="en-us_topic_0045853504__b887102583116">Delete Marker</strong> with a unique version ID for the deleted object, and the deleted object is displayed in the <strong id="en-us_topic_0045853504__b982755722818">Deleted Objects</strong> list. For details, see <a href="en-us_topic_0045853756.html">Deleting a File or Folder</a>. The 404 error will be returned if attempts are made to access this deleted object.<div class="fignone" id="en-us_topic_0045853504__fig12513111686"><span class="figcap"><b>Figure 3 </b>Object with a delete marker</span><br><span><img id="en-us_topic_0045853504__image106810213564" src="en-us_image_0135698309.png"></span></div>
</li><li id="en-us_topic_0045853504__li16974139482">You can recover a deleted object by deleting the object version that has the <strong id="en-us_topic_0045853504__b9737126133818">Delete Marker</strong>. For details, see <a href="en-us_topic_0066176932.html#en-us_topic_0066176932__section27691114163422">Follow-up Procedure</a> in <a href="en-us_topic_0066176932.html">Undeleting a File</a>.</li><li id="en-us_topic_0045853504__li65671427483">After an object is deleted, you can specify the version number in <strong id="en-us_topic_0045853504__b202463427396">Deleted Objects</strong> to permanently delete the object of the specified version. For details, see <a href="en-us_topic_0045853756.html#en-us_topic_0045853756__section089519314196">Follow-up Procedure</a> in <a href="en-us_topic_0045853756.html">Deleting a File or Folder</a>.</li><li id="en-us_topic_0045853504__li185772028101011">An object is displayed either in the object list or the list of deleted objects. It will never be displayed in both the lists at the same time.<p id="en-us_topic_0045853504__p11578112817100"><a name="en-us_topic_0045853504__li185772028101011"></a><a name="li185772028101011"></a>For example, after object <strong id="en-us_topic_0045853504__b153159177404">A</strong> is uploaded and deleted, it will be displayed in the <strong id="en-us_topic_0045853504__b113718469401">Deleted Objects</strong> list. If you upload an object named <strong id="en-us_topic_0045853504__b109891246104011">A</strong> again, the object <strong id="en-us_topic_0045853504__b1991114619403">A</strong> will be displayed in the <strong id="en-us_topic_0045853504__b92871340114115">Objects</strong> list, and the previously deleted object <strong id="en-us_topic_0045853504__b149921646144011">A</strong> will no longer be displayed in the <strong id="en-us_topic_0045853504__b585482374119">Deleted Objects</strong> list. For details, see <a href="#en-us_topic_0045853504__fig1469714544377">Figure 4</a>.</p>
</li><li id="en-us_topic_0045853504__li11906947104610">The latest objects in a bucket are returned by default after a GET Object request.</li><li id="en-us_topic_0045853504__li5044213017308">Objects can be downloaded by version IDs. By default, the latest object is downloaded if the version ID is not specified. For details, see <a href="obs_03_0327.html#obs_03_0327__section29772226">Related Operations</a> in <a href="obs_03_0327.html">Configuring Versioning</a>.</li><li id="en-us_topic_0045853504__li1922972904812">You can select an object and click <strong id="en-us_topic_0045853504__b1439112892814">Delete</strong> on the right to delete the object. After the object is deleted, OBS generates a <strong id="en-us_topic_0045853504__b887102583116">Delete Marker</strong> with a unique version ID for the deleted object, and the deleted object is displayed in the <strong id="en-us_topic_0045853504__b982755722818">Deleted Objects</strong> list. For details, see <a href="en-us_topic_0045853756.html">Deleting a File or Folder</a>. The 404 error will be returned if attempts are made to access this deleted object.<div class="fignone" id="en-us_topic_0045853504__fig12513111686"><span class="figcap"><b>Figure 3 </b>Object with a delete marker</span><br><span><img id="en-us_topic_0045853504__image106810213564" src="en-us_image_0135698309.png"></span></div>
</li><li id="en-us_topic_0045853504__li16974139482">You can recover a deleted object by deleting the object version that has the <strong id="en-us_topic_0045853504__b9737126133818">Delete Marker</strong>. For details, see <a href="en-us_topic_0066176932.html#en-us_topic_0066176932__section27691114163422">Related Operations</a> in <a href="en-us_topic_0066176932.html">Undeleting a File</a>.</li><li id="en-us_topic_0045853504__li65671427483">After an object is deleted, you can specify the version number in <strong id="en-us_topic_0045853504__b202463427396">Deleted Objects</strong> to permanently delete the object of the specified version. For details, see <a href="en-us_topic_0045853756.html#en-us_topic_0045853756__section089519314196">Related Operations</a> in <a href="en-us_topic_0045853756.html">Deleting a File or Folder</a>.</li><li id="en-us_topic_0045853504__li185772028101011">An object is displayed either in the object list or the list of deleted objects. It will never be displayed in both the lists at the same time.<p id="en-us_topic_0045853504__p11578112817100"><a name="en-us_topic_0045853504__li185772028101011"></a><a name="li185772028101011"></a>For example, after object <strong id="en-us_topic_0045853504__b153159177404">A</strong> is uploaded and deleted, it will be displayed in the <strong id="en-us_topic_0045853504__b113718469401">Deleted Objects</strong> list. If you upload an object named <strong id="en-us_topic_0045853504__b109891246104011">A</strong> again, the object <strong id="en-us_topic_0045853504__b1991114619403">A</strong> will be displayed in the <strong id="en-us_topic_0045853504__b92871340114115">Objects</strong> list, and the previously deleted object <strong id="en-us_topic_0045853504__b149921646144011">A</strong> will no longer be displayed in the <strong id="en-us_topic_0045853504__b585482374119">Deleted Objects</strong> list. For details, see <a href="#en-us_topic_0045853504__fig1469714544377">Figure 4</a>.</p>
<div class="fignone" id="en-us_topic_0045853504__fig1469714544377"><a name="en-us_topic_0045853504__fig1469714544377"></a><a name="fig1469714544377"></a><span class="figcap"><b>Figure 4 </b>Uploading a namesake object after the original one is deleted</span><br><span><img id="en-us_topic_0045853504__image7901510165611" src="en-us_image_0135706002.png"></span></div>
</li></ul>
</div>

View File

@ -4,10 +4,10 @@
<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>
<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">Fragments on OBS consume storage spaces that are charged according to price rates of storage space.</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 to be operated. The <strong id="en-us_topic_0045853514__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853514__li20098922"><span>In the navigation pane, click <strong id="en-us_topic_0045853514__b2103619822113655">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> on the top of fragment list to batch delete them.</p>
<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_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853514__li20098922"><span>In the navigation pane, click <strong id="en-us_topic_0045853514__b2103619822113655">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>
</div>

View File

@ -3,10 +3,10 @@
<h1 class="topictitle1">Logging Overview</h1>
<div id="body1499758606807"><p class="MsoNormal" id="en-us_topic_0045853553__p6143187">You can enable logging to facilitate analysis or audit as required. Access logs enable a bucket owner to analyze the property, type, or trend of requests to the bucket in depth. When the logging function of a bucket is enabled, OBS will log access requests for the bucket automatically, and write the generated log files to the specified bucket (target bucket).</p>
<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 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 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 id="en-us_topic_0045853553__p348350094022">Approximately fifteen minutes after log management is successfully configured, you can view the operation logs in the target bucket that stores the logs.</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
787f2f92b20943998a4fe2ab75eb09b8 281599BACAD9376ECE141B842B94535B REST.GET.BUCKET.LOCATION

View File

@ -1,8 +1,8 @@
<a name="en-us_topic_0045853662"></a><a name="en-us_topic_0045853662"></a>
<h1 class="topictitle1">Creating a Bucket</h1>
<div id="body1499753333226"><p id="en-us_topic_0045853662__p6357461175136">This section describes how to create a bucket on OBS Console. A bucket is a container that stores objects in OBS. Before you store data in OBS, you need to create a bucket first.</p>
<div class="note" id="en-us_topic_0045853662__note16099315174029"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853662__obs_03_0306_p10676115174029">An account can create a maximum of 100 buckets.</p>
<div id="body1499753333226"><p id="en-us_topic_0045853662__p6357461175136">A bucket is a container that stores objects in OBS. Before you store data in OBS, you need to create a bucket.</p>
<div class="note" id="en-us_topic_0045853662__note16099315174029"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853662__obs_03_0306_p10676115174029">An account can create a maximum of 100 buckets and parallel file systems.</p>
</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></li><li id="en-us_topic_0045853662__obs_03_0306_li14812171815257"><span>Configure bucket parameters.</span><p>
@ -14,14 +14,14 @@
</thead>
<tbody><tr id="en-us_topic_0045853662__obs_03_0306_row721018185364"><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_p12210111812361">Region</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_p480613549419">Geographic area where a bucket resides. For low network latency and quick resource access, select the nearest region. Once a bucket is created, the region cannot be changed.</p>
<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_p480613549419">Geographic area where a bucket resides. For low network latency and quick resource access, select the nearest region. Once the bucket is created, its region cannot be changed.</p>
</td>
</tr>
<tr id="en-us_topic_0045853662__obs_03_0306_row321061820361"><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_p6210181823616">Bucket Name</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_p18210191820365">Name of the bucket. A bucket name must be unique across all accounts and regions. Once a bucket is created, you cannot change its name.</p>
<p id="en-us_topic_0045853662__obs_03_0306_p404056794432">An OBS bucket must be named according to the globally applied DNS naming rules as follows:</p>
<ul id="en-us_topic_0045853662__obs_03_0306_ul5989254594432"><li id="en-us_topic_0045853662__obs_03_0306_li82963331566">A bucket name must be unique across all accounts and regions.</li><li id="en-us_topic_0045853662__obs_03_0306_li129710331567">A bucket name must contain 3 to 63 characters. Only lowercase letters, digits, hyphens (-), and periods (.) are allowed.</li><li id="en-us_topic_0045853662__obs_03_0306_li13300133317564">A bucket name cannot start or end with a period (.) or hyphen (-), and cannot contain two consecutive periods (..) or contain a period (.) and a hyphen (-) adjacent to each other.</li><li id="en-us_topic_0045853662__obs_03_0306_li2030213317560">A bucket name cannot be an IP address.<div class="note" id="en-us_topic_0045853662__obs_03_0306_note75966362413"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="en-us_topic_0045853662__obs_03_0306_p318821192413">When you access OBS through HTTPS using virtual hosted-style URLs, if the bucket name contains a period (.), the certificate verification will fail. To work around this issue, you are advised not to use periods (.) in bucket names.</p>
<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_p18210191820365">Name of the bucket. A bucket name must be unique across all accounts and regions. Once a bucket is created, its name cannot be changed.</p>
<p id="en-us_topic_0045853662__obs_03_0306_p404056794432">According to the globally applied DNS naming rules, an OBS bucket name:</p>
<ul id="en-us_topic_0045853662__obs_03_0306_ul5989254594432"><li id="en-us_topic_0045853662__obs_03_0306_li82963331566">Must be unique across all accounts and regions. The name of a deleted bucket can be reused for another bucket or a parallel file system at least 30 minutes later after the deletion.</li><li id="en-us_topic_0045853662__obs_03_0306_li129710331567">Must be 3 to 63 characters long. Only lowercase letters, digits, hyphens (-), and periods (.) are allowed.</li><li id="en-us_topic_0045853662__obs_03_0306_li13300133317564">Cannot start or end with a period (.) or hyphen (-), and cannot contain two consecutive periods (..) or contain a period (.) and a hyphen (-) adjacent to each other.</li><li id="en-us_topic_0045853662__obs_03_0306_li2030213317560">Cannot be formatted as an IP address.<div class="note" id="en-us_topic_0045853662__obs_03_0306_note75966362413"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="en-us_topic_0045853662__obs_03_0306_p318821192413">When you access OBS through HTTPS using virtual hosted-style URLs, if the bucket name contains a period (.), the certificate verification will fail. To work around this issue, you are advised not to use periods (.) in bucket names.</p>
</div></div>
</li></ul>
</td>
@ -29,7 +29,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 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.</li><li id="en-us_topic_0045853662__obs_03_0306_li113541355942">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.</li><li id="en-us_topic_0045853662__obs_03_0306_li1046755918114">The Archive storage class is suitable for archiving data that is rarely-accessed (averagely once a year), without requirements for quick response.</li></ul>
<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>
</tr>
@ -41,8 +41,8 @@
</tr>
<tr id="en-us_topic_0045853662__obs_03_0306_row521061883619"><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_p6210111812361">Default Encryption</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_p15210151810365">After the default encryption is enabled for a bucket, all objects uploaded to the bucket are encrypted. The <strong id="en-us_topic_0045853662__obs_03_0306_b15699471529">obs/default</strong> key is used for encryption by default. You can also click <strong id="en-us_topic_0045853662__obs_03_0306_b10403540175312">Create KMS Key</strong> to create a key on the KMS console. Then select the created key on OBS Console for KMS encryption.</p>
<p id="en-us_topic_0045853662__obs_03_0306_p1759222844812">If the default encryption is enabled for a bucket, uploaded objects are automatically encrypted.</p>
<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_p15210151810365">After default encryption is enabled for a bucket, all objects uploaded to the bucket are automatically encrypted. The <strong id="en-us_topic_0045853662__obs_03_0306_b15699471529">obs/default</strong> key is used by default. You can also click <strong id="en-us_topic_0045853662__obs_03_0306_b10403540175312">Create KMS Key</strong> to create a key on the KMS console. Then select the created key on OBS Console for encryption.</p>
<p id="en-us_topic_0045853662__obs_03_0306_p1759222844812">If the default encryption has been enabled for the bucket, uploaded objects are automatically encrypted.</p>
</td>
</tr>
<tr id="en-us_topic_0045853662__obs_03_0306_row179244845019"><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_p1934488501">Tags</p>
@ -56,7 +56,7 @@
</div>
</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">Follow-up Procedure</h4><p id="en-us_topic_0045853662__p52051693145756">You can specify its storage class when creating a bucket or change its storage class after bucket creation.</p>
<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>
</div></div>
</p></li></ol>

View File

@ -2,24 +2,28 @@
<h1 class="topictitle1">Uploading a File</h1>
<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 and the name of a newly uploaded file is the same as that of a file in the bucket, the newly uploaded file automatically overwrites the existing file and does not retain the ACL information of the existing file. If the name of the newly uploaded folder is the same as that of a folder in the bucket, the two folders will be merged, and files in the new folder will overwrite namesake files in the old folder.</li><li id="en-us_topic_0045853663__li2360182919422">If versioning is enabled and the name of a newly uploaded file is the same as that of a file in the bucket, a new version is added to the existing file. For details about versioning, see <a href="en-us_topic_0045853504.html">Versioning Overview</a>.</li></ul>
<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>
<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 to be operated. The <strong id="en-us_topic_0045853663__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853663__obs_03_0307_li51927620"><span>In the navigation pane, click <strong id="en-us_topic_0045853663__obs_03_0307_b47118221194931">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_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853663__obs_03_0307_li123641720664"><span>In the navigation pane, click <strong id="en-us_topic_0045853663__obs_03_0307_b47118221194931">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></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></li><li id="en-us_topic_0045853663__obs_03_0307_li4690584614321"><span>Select a storage class. If no storage class is selected, the file will inherit the storage class of the bucket.</span></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 Upload Object 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 Upload Object area to select files.</p>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li74481344102111"><span><strong id="en-us_topic_0045853663__obs_03_0307_b4955291917530">Optional</strong>: Select KMS encryption to encrypt the uploaded file. For details, see <a href="obs_03_0322.html">Uploading a File with Server-Side Encryption</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 is enabled for a bucket, uploaded objects are automatically encrypted.</p>
<p id="en-us_topic_0045853663__obs_03_0307_p739115241316"></p>
<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>
</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_li74481344102111"><span><strong id="en-us_topic_0045853663__obs_03_0307_b4955291917530">Optional</strong>: 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 a File with Server-Side Encryption</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">You can specify its storage class when uploading an object or change its storage class after the object is uploaded. The procedure is 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 to be operated. The <strong id="en-us_topic_0045853663__obs_03_0307_b1395123914108_1">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853663__li33462878175550"><span>In the navigation pane, click <strong id="en-us_topic_0045853663__b4277252771182">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></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 <strong id="en-us_topic_0045853663__b4301807811628">Standard</strong> to <strong id="en-us_topic_0045853663__b87217558711628">Warm</strong> or <strong id="en-us_topic_0045853663__b180206230911628">Cold</strong> storage class, or from <strong id="en-us_topic_0045853663__b15936610311643">Warm</strong> to <strong id="en-us_topic_0045853663__b10074348111643">Standard</strong> or <strong id="en-us_topic_0045853663__b159720291011643">Cold</strong> storage class, but objects in <strong id="en-us_topic_0045853663__b1218958111650">Cold</strong> storage class must be restored before being changed to <strong id="en-us_topic_0045853663__b36831581811650">Standard</strong> or <strong id="en-us_topic_0045853663__b43818910911650">Warm</strong> storage class. Changing from <strong id="en-us_topic_0045853663__b1616715153315">Warm</strong> or <strong id="en-us_topic_0045853663__b716315113314">Cold</strong> to other storage classes incurs restoration 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 <strong id="en-us_topic_0045853663__b21767813113">Cold</strong>, the object restoration 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="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>
<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_b1395123914108_1">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853663__li33462878175550"><span>In the navigation pane, click <strong id="en-us_topic_0045853663__b4277252771182">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></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></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 the path of the object.</p>
<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>
</div>
</div>

View File

@ -10,7 +10,7 @@
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0339.html">CORS</a></div>
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0339.html">Cross-Origin Resource Sharing</a></div>
</div>
</div>

View File

@ -1,9 +1,9 @@
<a name="en-us_topic_0045853681"></a><a name="en-us_topic_0045853681"></a>
<h1 class="topictitle1">About OBS</h1>
<div id="body1499741335747"><p class="MsoNormal" id="en-us_topic_0045853681__p41141913182819">Object Storage Service (OBS) is a cloud storage service optimized for storing massive amounts of data. It provides unlimited, secure, and highly reliable storage capabilities at a relatively low cost. On OBS, you can easily perform storage management operations, such as bucket creation, modification, and deletion, as well as object upload, download, and deletion.</p>
<p class="MsoNormal" id="en-us_topic_0045853681__p163741752183115">OBS provides users with unlimited storage capacity, stores files in any format, and caters to the needs of common users, websites, enterprises, and developers. Neither the entire OBS system nor any single bucket has limitations on storage capacity or the number of objects/files that can be stored. As a web service, OBS supports APIs over Hypertext Transfer Protocol (HTTP) and Hypertext Transfer Protocol Secure (HTTPS). You can use OBS Console or OBS clients to access and manage data stored in OBS anytime, anywhere. OBS is compatible with the REST APIs of Amazon S3, and supports SDKs. You can easily manage data stored in OBS and develop upper-layer service applications. OBS Console and OBS Browser are only compatible with the Amazon S3 APIs.</p>
<p class="MsoNormal" id="en-us_topic_0045853681__p2227137817531">Cloud service infrastructures can be deployed in multiple regions, delivering flexible expansion and enhanced reliability. You can deploy OBS in specific regions for faster access at an affordable price.</p>
<div id="body1499741335747"><p class="MsoNormal" id="en-us_topic_0045853681__p41141913182819">Object Storage Service (OBS) is a scalable service that provides secure, reliable, and cost-effective cloud storage for massive amounts of data. On OBS, you can easily manage your OBS resources, such as creating, modifying, and deleting buckets, or uploading, downloading, and deleting objects.</p>
<p class="MsoNormal" id="en-us_topic_0045853681__p163741752183115">OBS provides unlimited storage capacity for objects of any format, catering to the needs of common users, websites, enterprises, and developers. There is no limitation on the storage capacity of the entire OBS system or of a single bucket, and any number of objects can be stored. As a web service, OBS supports APIs over Hypertext Transfer Protocol (HTTP) and Hypertext Transfer Protocol Secure (HTTPS). You can use OBS Console or OBS Browser+ to access and manage data stored in OBS anytime, anywhere. OBS supports SDKs and is compatible with the REST APIs of Amazon S3. With the SDKs and APIs, you can easily manage data stored in OBS and develop upper-layer applications. OBS Console and OBS Browser are only compatible with the Amazon S3 APIs.</p>
<p class="MsoNormal" id="en-us_topic_0045853681__p2227137817531">Cloud service infrastructures can be deployed in multiple regions, delivering high scalability and reliability. You can deploy OBS in specific regions for faster access at an affordable price.</p>
</div>
<div>
<div class="familylinks">

View File

@ -15,7 +15,7 @@
</thead>
<tbody><tr id="en-us_topic_0045853707__r37b6d3a82f2c41ab9f69396983c71926"><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__a615391a7b87c446dbc6036f21444ec60">Version</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__ae3b32b0875da4e6a8eabc2becb00a9e8">The value can be <strong id="en-us_topic_0045853707__b1963142212265">2008-10-17</strong> or <strong id="en-us_topic_0045853707__b18974284267">2012-10-17</strong>.</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__ae3b32b0875da4e6a8eabc2becb00a9e8">The value can be <strong id="en-us_topic_0045853707__b488317716145">2008-10-17</strong>.</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__aa77b671e052e4e78b047b721a4f145a3">Optional</p>
</td>

View File

@ -1,8 +1,8 @@
<a name="en-us_topic_0045853710"></a><a name="en-us_topic_0045853710"></a>
<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__p6261255115402">Because OBS uploads data in the multipart mode, fragments may be generated due to any of the following data upload failures (but not limited to these failures):</p>
<ul id="en-us_topic_0045853710__ul5706301615405"><li id="en-us_topic_0045853710__li249374215405">The network is in poor condition, and the connection to the OBS server is interrupted frequently.</li><li id="en-us_topic_0045853710__li5398804015405">The upload task is manually interrupted.</li><li id="en-us_topic_0045853710__li32353015405">The device is faulty.</li><li id="en-us_topic_0045853710__li4524261415405">The device is powered off suddenly.</li></ul>
<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>
<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>

View File

@ -7,10 +7,10 @@
<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>
<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 the date and time 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 configured &lt;TargetPrefix&gt; ends with a slash (/), logs generated in the bucket are stored on OBS Console; if configured <em id="en-us_topic_0045853744__obs_03_0329_i13227201312463">&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>
<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>
<p id="en-us_topic_0045853744__obs_03_0329_p1511675981114">Example:</p>
<ul id="en-us_topic_0045853744__obs_03_0329_ul0116155913116"><li id="en-us_topic_0045853744__obs_03_0329_li12116195981110">If the bucket named <strong id="en-us_topic_0045853744__obs_03_0329_b184811348710">bucket</strong> is selected to save log files, and the log file name prefix is set to <strong id="en-us_topic_0045853744__obs_03_0329_b13814257812">bucket-log/</strong>, all log files delivered to the bucket are saved in the <strong id="en-us_topic_0045853744__obs_03_0329_b22749457817">bucket-log</strong> folder. A log file is named as follows: <strong id="en-us_topic_0045853744__obs_03_0329_b1454341506171617">2015-06-29-12-22-07-N7MXLAF1BDG7MPDV</strong>.</li><li id="en-us_topic_0045853744__obs_03_0329_li10116135911117">If the bucket named <strong id="en-us_topic_0045853744__obs_03_0329_b56011330299">bucket</strong> is selected to save log files, and the log file name prefix is set to <strong id="en-us_topic_0045853744__obs_03_0329_b186011030293">bucket-log</strong>, then no folder is created for log files delivered to the bucket. A log file is named as follows: <strong id="en-us_topic_0045853744__obs_03_0329_b783736649171726">bucket-log2015-06-29-12-22-07-N7MXLAF1BDG7MPDV</strong>.</li></ul>
<ul id="en-us_topic_0045853744__obs_03_0329_ul0116155913116"><li id="en-us_topic_0045853744__obs_03_0329_li12116195981110">If the bucket named <strong id="en-us_topic_0045853744__obs_03_0329_b184811348710">bucket</strong> is used to save log files, and the log file name prefix is set to <strong id="en-us_topic_0045853744__obs_03_0329_b13814257812">bucket-log/</strong>, all log files delivered to this bucket are saved in the <strong id="en-us_topic_0045853744__obs_03_0329_b22749457817">bucket-log</strong> folder. A log file is named as follows: <strong id="en-us_topic_0045853744__obs_03_0329_b1454341506171617">2015-06-29-12-22-07-N7MXLAF1BDG7MPDV</strong>.</li><li id="en-us_topic_0045853744__obs_03_0329_li10116135911117">If the bucket named <strong id="en-us_topic_0045853744__obs_03_0329_b56011330299">bucket</strong> is used to save log files, and the log file name prefix is set to <strong id="en-us_topic_0045853744__obs_03_0329_b186011030293">bucket-log</strong>, all log files are saved in the root directory of the bucket. A log file is named as follows: <strong id="en-us_topic_0045853744__obs_03_0329_b783736649171726">bucket-log2015-06-29-12-22-07-N7MXLAF1BDG7MPDV</strong>.</li></ul>
</p></li><li id="en-us_topic_0045853744__li115551710143313"><span>Click <strong id="en-us_topic_0045853744__b6404103912714">OK</strong>.</span></li><li id="en-us_topic_0045853744__li944717573486"><span>In the displayed dialog box, click <strong id="en-us_topic_0045853744__obs_03_0022_b19371431195919">Close</strong> to close the dialog box.</span></li></ol>
<p id="en-us_topic_0045853744__p6951181413581"></p>
</div>

View File

@ -9,7 +9,7 @@
<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 permission control and you want to authorize other accounts the permission to access your OBS resources, you can use bucket policies to authorize such permissions.</li><li id="en-us_topic_0045853745__li129735910199">You can configure different bucket policies to grant IAM users different access permissions to different 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__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__b917713334388">Public Read</strong>: Any user can read objects in the bucket.</li><li id="en-us_topic_0045853745__li66641044203514"><strong id="en-us_topic_0045853745__b624737913162154">Public Read and Write</strong>: Any user can read, write, and delete objects in the bucket.</li></ul>
<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>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0045853745__table12248152111227" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Standard bucket policies</caption><thead align="left"><tr id="en-us_topic_0045853745__row15249821152217"><th align="left" class="cellrowborder" valign="top" width="19%" id="mcps1.3.2.9.2.5.1.1"><p id="en-us_topic_0045853745__p122491621102215">Parameter</p>

View File

@ -5,16 +5,16 @@
<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>
<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 a Cold File Stored in OBS</a>.</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>
</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 to be operated. The <strong id="en-us_topic_0045853755__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853755__li45818654181751"><span>(<strong id="en-us_topic_0045853755__b3184102521613">Optional</strong>) If the static website files in the bucket are not accessible to anonymous users, perform this step to configure them to be accessible to anonymous users. If the static website files are already accessible to anonymous users, skip this step.</span><p><p id="en-us_topic_0045853755__p18712161416268">Authorize anonymous users the permission to read files on the static website. For details, see <a href="obs_03_0132.html">Authorizing 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_b1395123914108">Overview</strong> page of the bucket 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">Authorize anonymous users the permission to read files on the static website. For details, see <a href="obs_03_0132.html">Authorizing Access Permissions to Anonymous Users</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 <strong id="en-us_topic_0045853755__b5680143417197">Hosting By</strong> to <strong id="en-us_topic_0045853755__b20448164911193">Current bucket</strong>. 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__li65471095155127"><span>Set the values of <strong id="en-us_topic_0045853755__b1155642796141955">Home Page</strong> and <strong id="en-us_topic_0045853755__b1864955982141955">404 Error Page</strong>.</span><p>
<ul id="en-us_topic_0045853755__ul58086424"><li id="en-us_topic_0045853755__li44406302"><strong id="en-us_topic_0045853755__b1884860305">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__b66751918375">index.html</strong> in the root directory of a bucket to function as the default homepage. That is to say, do not set the default homepage with a multi-level directory structure (for example, <strong id="en-us_topic_0045853755__b367614913718">/page/index.html</strong>).</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__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__b1280879152">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>

View File

@ -1,21 +1,20 @@
<a name="en-us_topic_0045853756"></a><a name="en-us_topic_0045853756"></a>
<h1 class="topictitle1">Deleting a File or Folder</h1>
<div id="body1499753333226"><div class="section" id="en-us_topic_0045853756__section13666357124317"><h4 class="sectiontitle">Scenarios</h4><p id="en-us_topic_0045853756__p57701715445">On OBS Console, you can delete unneeded files or folders to release space and reduce costs.</p>
<p id="en-us_topic_0045853756__p6814203916599">This topic describes how to manually delete files or folders on OBS Console.</p>
<p id="en-us_topic_0045853756__p7916121265313">OBS also provides the lifecycle management function to meet your requirements for periodically and automatically deleting files from a bucket or clearing all files and folders in a bucket. For details, see <a href="obs_03_0335.html">Configuring a Lifecycle Rule</a>.</p>
<div id="body1499753333226"><div class="section" id="en-us_topic_0045853756__section13666357124317"><h4 class="sectiontitle">Scenarios</h4><p id="en-us_topic_0045853756__p57701715445">On OBS Console, you can manually delete unneeded files or folders to release space and reduce costs.</p>
<p id="en-us_topic_0045853756__p7916121265313">Alternatively, you can configure lifecycle rules to periodically, automatically delete some or all of the files and folders from a bucket. For details, see <a href="obs_03_0335.html">Configuring a Lifecycle Rule</a>.</p>
</div>
<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 mechanism when versioning is enabled</strong></p>
<p id="en-us_topic_0045853756__p3811164916814">When versioning is enabled, OBS uses different deletion methods for different objects.</p>
<ul id="en-us_topic_0045853756__ul188111049680"><li id="en-us_topic_0045853756__li58113497814">Deleting a file or folder does not delete it permanently. The deleted file or folder will be retained in the <strong id="en-us_topic_0045853756__b14785115318335">Deleted Objects</strong> list and marked with the <strong id="en-us_topic_0045853756__b20896101773411">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">If you want to delete the file or folder permanently, you need to delete it from the <strong id="en-us_topic_0045853756__b69917109351">Deleted Objects</strong> list. For details, see <a href="#en-us_topic_0045853756__section56466209">Procedure</a> in this section.</li><li id="en-us_topic_0045853756__li138124491681">To recover a deleted file, you can cancel the deletion by the <strong id="en-us_topic_0045853756__b27833910361">Undelete</strong> operation. For details, see <a href="en-us_topic_0066176932.html">Undeleting a File</a>.</li></ul>
</li><li id="en-us_topic_0045853756__li108124498813">Deleting a version of an object will permanently delete that version. If the deleted version is the latest one, the next latest version becomes the latest version.</li></ul>
<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 a File</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>
</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 to be operated. The <strong id="en-us_topic_0045853756__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853756__en-us_topic_0066036524_li63197139"><span>In the navigation pane, click <strong id="en-us_topic_0045853756__a45b09ed447ba4ac28b5728a5d1eac2e8">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, you need to delete files or folders from the <strong id="en-us_topic_0045853756__b1489110814398">Deleted Objects</strong> list in order 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__b2111144363917">Permanently Delete</strong>.<p id="en-us_topic_0045853756__p63743352160">You can 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_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853756__en-us_topic_0066036524_li63197139"><span>In the navigation pane, click <strong id="en-us_topic_0045853756__a45b09ed447ba4ac28b5728a5d1eac2e8">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__b2111144363917">Permanently Delete</strong>.<p id="en-us_topic_0045853756__p63743352160">You can 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">Follow-up Procedure</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">If you delete a version with the <strong id="en-us_topic_0045853756__b124401227135111">Delete Marker</strong>, it actually recovers that specific version instead of permanently deleting it. For details, see <a href="en-us_topic_0066176932.html">Undeleting a File</a>.</li><li id="en-us_topic_0045853756__li14809143354215">If you delete a version without the <strong id="en-us_topic_0045853756__b135921220165316">Delete Marker</strong>, that specific version is deleted permanently. Even if the object is recovered later, this version will not be recovered.</li></ul>
<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 a File</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>

View File

@ -6,7 +6,7 @@
<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__b779464972">System Configuration</strong>. In the <strong id="en-us_topic_0045853764__b1591786097">System Configuration</strong> dialog box that is displayed, deselect <strong id="en-us_topic_0045853764__b1681299268">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>
</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>
</div>
</li></ul>
</li></ul>

View File

@ -1,7 +1,7 @@
<a name="en-us_topic_0045853783"></a><a name="en-us_topic_0045853783"></a>
<h1 class="topictitle1">Downloading OBS Browser</h1>
<div id="body8662426"><div class="section" id="en-us_topic_0045853783__s693e40d3507a46dca416d86f416cf72e"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853783__oa4af7acd6f594e58a6f3e55ba9527bf5"><li id="en-us_topic_0045853783__l9b6b955298024383a5c373c88f3b38ff"><span>Download the OBS Browser software package.</span><p><p class="MsoNormal" id="en-us_topic_0045853783__a7391633823474e1d96a3aa4b23f4b70f">The OBS Browser software package is integrated into OBS Console. You can log in to OBS Console and download it.</p>
<div id="body8662426"><div class="section" id="en-us_topic_0045853783__s693e40d3507a46dca416d86f416cf72e"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853783__oa4af7acd6f594e58a6f3e55ba9527bf5"><li id="en-us_topic_0045853783__l9b6b955298024383a5c373c88f3b38ff"><span>Download the OBS Browser software package.</span><p><p class="MsoNormal" id="en-us_topic_0045853783__a7391633823474e1d96a3aa4b23f4b70f">To download the package, click the OBS Browser package link on the homepage of OBS Console.</p>
</p></li><li id="en-us_topic_0045853783__lc89f24a8549f424395262bb1e008280e"><span>Decompress the OBS Browser software package to a local folder, and make sure the absolute path of the folder does not exceed the length of 130 characters.</span></li></ol>
</div>
</div>

View File

@ -4,7 +4,7 @@
<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 to be operated. The <strong id="en-us_topic_0045853821__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853821__li2931491252"><span>In the navigation pane, click <strong id="en-us_topic_0045853821__obs_03_0307_b47118221194931">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_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0045853821__li2931491252"><span>In the navigation pane, click <strong id="en-us_topic_0045853821__obs_03_0307_b47118221194931">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></div>
</p></li><li id="en-us_topic_0045853821__li1325219548272"><span>Click <strong id="en-us_topic_0045853821__b139855243117">Add</strong> to set the ACL permissions of a specific account. For details, see <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 on 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 objects</span><br><span><img id="en-us_topic_0045853821__image1665582616554" src="en-us_image_0168396382.png" title="Click to enlarge" class="imgResize"></span></div>

View File

@ -11,17 +11,17 @@
</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_b18681102115049">Current Version</strong>, and the object uploaded earlier is called <strong id="en-us_topic_0045853854__obs_03_0335_b6701786115051">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 <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_b18681102115049">Current Version</strong>, and the object uploaded earlier is called <strong id="en-us_topic_0045853854__obs_03_0335_b6701786115051">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></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 objects are configured to be transitioned to both <strong id="en-us_topic_0045853854__obs_03_0335_b16694849185111">Warm</strong> and <strong id="en-us_topic_0045853854__obs_03_0335_b199115317517">Cold</strong>, the number of days for transition to <strong id="en-us_topic_0045853854__obs_03_0335_b930823145214">Cold</strong> must be at least 30 days later than that for transition to <strong id="en-us_topic_0045853854__obs_03_0335_b7245135975112">Warm</strong>. If only transition to Cold is enabled and transition to <strong id="en-us_topic_0045853854__obs_03_0335_b1074062413145649">Warm</strong> is disabled, 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>
<div class="p" id="en-us_topic_0045853854__obs_03_0335_p50988061113345">For example, the following files are stored in OBS on January 7, 2015:<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>
<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>
<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">The following files are stored in OBS on January 10, 2015:<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 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>
<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_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 class="NotesText" id="en-us_topic_0045853854__obs_03_0335_p655103724317">The storage class transition and deletion of an object may be delayed after the time condition is met. Generally, the delay does not exceed 48 hours. If you change the configurations of an existing lifecycle rule, the effective time of the lifecycle rule will change according to the new configurations.</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>
</p></li><li id="en-us_topic_0045853854__li2060992818615"><span>Click <strong id="en-us_topic_0045853854__b11317349112312">Save</strong>.</span></li><li id="en-us_topic_0045853854__l4ac88903b3ce4de080616e61796a9321"><span>In the <strong id="en-us_topic_0045853854__b1416255842810">Create Lifecycle Rule</strong> dialog box, click <strong id="en-us_topic_0045853854__b133142085298">Save</strong>.</span></li><li id="en-us_topic_0045853854__li944717573486"><span>In the displayed dialog box, click <strong id="en-us_topic_0045853854__obs_03_0022_b19371431195919">Close</strong> to close the dialog box.</span></li></ol>
</div>

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. However, it may take hours to restore data from the Archive storage class.</li></ul>
<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>
<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>

View File

@ -2,9 +2,9 @@
<h1 class="topictitle1">Configuring CORS</h1>
<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 about how to configure static website hosting, see <a href="en-us_topic_0045853755.html">Configuring Static Website Hosting</a>.</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 to be operated. The <strong id="en-us_topic_0066036542__obs_03_0307_b1395123914108">Overview</strong> page of the bucket 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, select <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_b1395123914108">Overview</strong> page of the bucket 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, select <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>
</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">You can set a maximum of 100 CORS rules for one bucket.</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>
@ -59,13 +59,13 @@ https://*.vbs.example.com</pre>
</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 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">If 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>
<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>
</p></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0339.html">CORS</a></div>
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0339.html">Cross-Origin Resource Sharing</a></div>
</div>
</div>

View File

@ -1,14 +1,14 @@
<a name="en-us_topic_0066088957"></a><a name="en-us_topic_0066088957"></a>
<h1 class="topictitle1">Configuring Redirection</h1>
<div id="body1499758606807"><p id="en-us_topic_0066088957__p30121176153913">You can configure static website hosting by redirecting all requests for a bucket to another bucket or URL.</p>
<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>
<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 a Cold File Stored in OBS</a>.</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>
</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 to be operated. The <strong id="en-us_topic_0066088957__obs_03_0307_b1395123914108">Overview</strong> page of the bucket 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>
<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_b1395123914108">Overview</strong> page of the bucket 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_b3184102521613">Optional</strong>) If the static website files in the bucket are not accessible to anonymous users, perform this step to configure them to be accessible to anonymous users. 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">Authorize anonymous users the permission to read files on the static website. For details, see <a href="obs_03_0132.html">Authorizing Access Permissions to Anonymous Users</a>.</p>
</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">Authorize anonymous users the permission to read files on the static website. For details, see <a href="obs_03_0132.html">Authorizing Access Permissions to Anonymous Users</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>

View File

@ -4,9 +4,9 @@
<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 Notification</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 to be operated. The <strong id="en-us_topic_0066088963__obs_03_0307_b1395123914108">Overview</strong> page of the bucket 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__b18116181415472">Basic Configurations</strong> &gt; <strong id="en-us_topic_0066088963__b14777523184718">Event Notification</strong> in the navigation pane on the left.</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_b1395123914108">Overview</strong> page of the bucket 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>
</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 parameters. <a href="#en-us_topic_0066088963__aobs_console_0039_mmccppss_table01">Table 1</a> describes the parameters.</span><p>
</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>
</th>
<th align="left" class="cellrowborder" valign="top" width="66%" id="mcps1.3.3.2.4.2.1.2.3.1.2"><p id="en-us_topic_0066088963__p155758">Description</p>
@ -15,13 +15,13 @@
</thead>
<tbody><tr id="en-us_topic_0066088963__row12616447"><td class="cellrowborder" valign="top" width="34%" headers="mcps1.3.3.2.4.2.1.2.3.1.1 "><p id="en-us_topic_0066088963__p15299288">Name</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066088963__p31282850">Name of the event. If the event name is left blank, the system will automatically generate a unique ID as the event name.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066088963__p31282850">Name of the event. If the event name is left blank, the system will automatically assign a globally unique ID.</p>
</td>
</tr>
<tr id="en-us_topic_0066088963__row13110201"><td class="cellrowborder" valign="top" width="34%" headers="mcps1.3.3.2.4.2.1.2.3.1.1 "><p id="en-us_topic_0066088963__p55293359">Events</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066088963__p49577065">Various types of events. Currently, OBS supports event notification for the following event types:</p>
<ul id="en-us_topic_0066088963__ul43540403"><li id="en-us_topic_0066088963__li27132010154639"><strong id="en-us_topic_0066088963__b1048514225810">ObjectCreated</strong>: Indicates all kinds of object creation operations, including PUT, POST, and COPY of objects, as well as the merging of parts.<ul id="en-us_topic_0066088963__ul1323810371222"><li id="en-us_topic_0066088963__li30342728173714"><strong id="en-us_topic_0066088963__b67958315317">Put</strong>: Creates or overwrites an object using the PUT method.</li><li id="en-us_topic_0066088963__li1115034173727"><strong id="en-us_topic_0066088963__b1820810923211">Post</strong>: Creates or overwrites an object using the POST (browser-based upload) method.</li><li id="en-us_topic_0066088963__li56319311"><strong id="en-us_topic_0066088963__b7694413123218">Copy</strong>: Creates or overwrites an object using the COPY method.</li><li id="en-us_topic_0066088963__li197831545173313"><strong id="en-us_topic_0066088963__b157561432376">CompleteMultipartUpload</strong>: Merges parts of multipart tasks.</li></ul>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066088963__p49577065">Various types of events. Currently, OBS supports event notification for the following types of events:</p>
<ul id="en-us_topic_0066088963__ul43540403"><li id="en-us_topic_0066088963__li27132010154639"><strong id="en-us_topic_0066088963__b1048514225810">ObjectCreated</strong>: Indicates all kinds of object creation operations, including PUT, POST, and COPY of objects, as well as the merging of parts.<ul id="en-us_topic_0066088963__ul1323810371222"><li id="en-us_topic_0066088963__li30342728173714"><strong id="en-us_topic_0066088963__b67958315317">Put</strong>: Creates or overwrites an object using the PUT method.</li><li id="en-us_topic_0066088963__li1115034173727"><strong id="en-us_topic_0066088963__b1820810923211">Post</strong>: Creates or overwrites an object using the POST (browser-based upload) method.</li><li id="en-us_topic_0066088963__li56319311"><strong id="en-us_topic_0066088963__b7694413123218">Copy</strong>: Creates or overwrites an object using the COPY method.</li><li id="en-us_topic_0066088963__li197831545173313"><strong id="en-us_topic_0066088963__b157561432376">CompleteMultipartUpload</strong>: Merges parts of a multipart upload.</li></ul>
</li><li id="en-us_topic_0066088963__li17115829154654"><strong id="en-us_topic_0066088963__b1247145233716">ObjectRemoved</strong>: Deletes an object.<ul id="en-us_topic_0066088963__ul119351546723"><li id="en-us_topic_0066088963__li39439006"><strong id="en-us_topic_0066088963__b102321594591">Delete</strong>: Deletes an object with a specified version ID.</li><li id="en-us_topic_0066088963__li54653604"><strong id="en-us_topic_0066088963__b146469154595">DeleteMarkerCreated</strong>: Deletes an object without specifying a version ID.</li></ul>
</li></ul>
<p id="en-us_topic_0066088963__p64865822">Multiple event types can be applied to the same object. For example, if you have selected <strong id="en-us_topic_0066088963__b2091313193599">Put</strong>, <strong id="en-us_topic_0066088963__b1691461905913">Copy</strong>, and <strong id="en-us_topic_0066088963__b1591591955916">Delete</strong> in the same event notification rule, a notification will be sent to you when the specified object is uploaded to, copied to, or deleted from the bucket. <strong id="en-us_topic_0066088963__b10982172711591">ObjectCreated</strong> contains <strong id="en-us_topic_0066088963__b9983132755917">Put</strong>, <strong id="en-us_topic_0066088963__b15984827185911">Post</strong>, <strong id="en-us_topic_0066088963__b11984927175910">Copy</strong>, and <strong id="en-us_topic_0066088963__b79851127195916">CompleteMultipartUpload</strong>. If you select <strong id="en-us_topic_0066088963__b9986132712595">ObjectCreated</strong>, the events <strong id="en-us_topic_0066088963__b158921377114">ObjectCreated</strong> contains are automatically selected. Similarly, if you select <strong id="en-us_topic_0066088963__b918816366592">ObjectRemoved</strong>, <strong id="en-us_topic_0066088963__b818911360595">Delete</strong> and <strong id="en-us_topic_0066088963__b91901136185910">DeleteMarkerCreated</strong> are automatically selected.</p>
@ -29,14 +29,14 @@
</tr>
<tr id="en-us_topic_0066088963__row47353991"><td class="cellrowborder" valign="top" width="34%" headers="mcps1.3.3.2.4.2.1.2.3.1.1 "><p id="en-us_topic_0066088963__p10468038">Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066088963__p42604738">Object name prefix. The event notification rule applies to objects that have the same name prefix.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066088963__p42604738">Object name prefix for which notifications will be triggered.</p>
<div class="note" id="en-us_topic_0066088963__note13847653113412"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="en-us_topic_0066088963__p138481553193416">If neither the <strong id="en-us_topic_0066088963__b11129141033217">Prefix</strong> nor the <strong id="en-us_topic_0066088963__b3429101412321">Suffix</strong> is configured, the event notification rule applies to all objects in the bucket.</p>
</div></div>
</td>
</tr>
<tr id="en-us_topic_0066088963__row16547757"><td class="cellrowborder" valign="top" width="34%" headers="mcps1.3.3.2.4.2.1.2.3.1.1 "><p id="en-us_topic_0066088963__p65299951">Suffix</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066088963__p54804702">Object name suffix. The event notification rule applies to objects that have the same name suffix.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.3.2.4.2.1.2.3.1.2 "><p id="en-us_topic_0066088963__p54804702">Object name suffix for which notifications will be triggered.</p>
<div class="note" id="en-us_topic_0066088963__note64263792115"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="en-us_topic_0066088963__ul75801343183518"><li id="en-us_topic_0066088963__li195809435352">A folder path ends with a slash (/). Therefore, if you want to configure the event notification for operations on folders and you need to filter folders by suffix, the suffix must also end with a slash (/).</li><li id="en-us_topic_0066088963__li168661347193517">If neither the <strong id="en-us_topic_0066088963__b14649194213219">Prefix</strong> nor the <strong id="en-us_topic_0066088963__b16651104273212">Suffix</strong> is configured, the event notification rule applies to all objects in the bucket.</li></ul>
</div></div>
</td>
@ -49,7 +49,7 @@
</tr>
<tr id="en-us_topic_0066088963__row13603062"><td class="cellrowborder" valign="top" headers="mcps1.3.3.2.4.2.1.2.3.1.1 "><div class="p" id="en-us_topic_0066088963__p62009948">Topic: specifies the SMN topic that authorizes OBS to publish messages. You can create such topics on the SMN management console.<div class="note" id="en-us_topic_0066088963__note21218627"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="en-us_topic_0066088963__ul290173585413"><li class="NotesTextinTable" id="en-us_topic_0066088963__li849610397548">Once SMN topics are selected for pushing OBS event notifications, do not delete them or cancel their authorizations to OBS.</li><li class="NotesTextinTable" id="en-us_topic_0066088963__li174571750165410">If the topics are deleted or their authorizations to OBS are canceled, the following conditions may occur:<p class="NotesTextinTable" id="en-us_topic_0066088963__p162521921105510"><a name="en-us_topic_0066088963__li174571750165410"></a><a name="li174571750165410"></a>a. The subscriber of the topic cannot receive messages.</p>
<p class="NotesTextinTable" id="en-us_topic_0066088963__p198921517175511">b. Event notifications associated with unavailable topics are automatically cleared.</p>
</li><li id="en-us_topic_0066088963__li27046247563">For details, see sections "Creating a Topic", "Adding a Subscription to the Topic", and "Configuring a Topic Policy" in the <em id="en-us_topic_0066088963__i028282204217">Simple Message Notification User Guide</em>.</li></ul>
</li><li id="en-us_topic_0066088963__li27046247563">For details about how to use SMN, see sections "Creating a Topic", "Adding a Subscription", and "Configuring Topic Policies" in the <em id="en-us_topic_0066088963__i028282204217">Simple Message Notification User Guide</em>.</li></ul>
</div></div>
</div>
</td>
@ -59,8 +59,8 @@
</div>
</p></li><li id="en-us_topic_0066088963__li40751614144143"><span>Click <strong id="en-us_topic_0066088963__b148248112017144">OK</strong>.</span></li></ol>
</div>
<div class="section" id="en-us_topic_0066088963__section183921920123113"><h4 class="sectiontitle">Related Operations</h4><p id="en-us_topic_0066088963__p63278262318">You can click <strong id="en-us_topic_0066088963__b142889712509">Edit</strong> under the <strong id="en-us_topic_0066088963__b88459435509">Operation</strong> column of an event notification rule, to edit the notification rule. Also you can click <strong id="en-us_topic_0066088963__b7836162611519">Delete</strong> to delete it.</p>
<p id="en-us_topic_0066088963__p7112172923412">If you want to delete more than one event notification rules at a time, select them and click <strong id="en-us_topic_0066088963__b420214845319">Delete</strong> above the list.</p>
<div class="section" id="en-us_topic_0066088963__section183921920123113"><h4 class="sectiontitle">Related Operations</h4><p id="en-us_topic_0066088963__p63278262318">You can click <strong id="en-us_topic_0066088963__b142889712509">Edit</strong> in the <strong id="en-us_topic_0066088963__b88459435509">Operation</strong> column of an event notification rule, to edit the notification rule, or click <strong id="en-us_topic_0066088963__b7836162611519">Delete</strong> to delete the rule.</p>
<p id="en-us_topic_0066088963__p7112172923412">If you want to batch delete event notification rules, select them and click <strong id="en-us_topic_0066088963__b420214845319">Delete</strong> above the list.</p>
</div>
</div>
<div>

View File

@ -41,7 +41,7 @@
</div></div>
</td>
<td class="cellrowborder" valign="top" width="73%" headers="mcps1.3.4.3.2.3.1.2 "><p id="en-us_topic_0066088967__p11239175822012">A log delivery user only delivers access logs of buckets and objects to the specified target bucket. OBS does not create or upload any file to a bucket automatically. Therefore, if you want to record bucket access logs, you need to grant the permission to the log delivery user who will deliver the access logs to your specified target bucket. The user only delivers logs within the service scope of OBS.</p>
<div class="notice" id="en-us_topic_0066088967__note71171158122010"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="en-us_topic_0066088967__p7241158152013">After logging is enabled, the bucket write permission, as well as the ACL read permission for the target bucket will be enabled automatically for the log delivery user. If you manually disable such permissions, bucket logging fails.</p>
<div class="notice" id="en-us_topic_0066088967__note71171158122010"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="en-us_topic_0066088967__p7241158152013">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>
</div></div>
</td>
</tr>

View File

@ -1,26 +1,26 @@
<a name="en-us_topic_0066176932"></a><a name="en-us_topic_0066176932"></a>
<h1 class="topictitle1">Undeleting a File</h1>
<div id="body1499776428443"><div class="section" id="en-us_topic_0066176932__section1428382164518"><h4 class="sectiontitle">Scenarios</h4><p id="en-us_topic_0066176932__p14210182321916">If a bucket has the <a href="obs_03_0327.html">versioning</a> function enabled, you can restore a deleted object through the <strong id="en-us_topic_0066176932__b166041245105914">Undelete</strong> operation.</p>
<div id="body1499776428443"><div class="section" id="en-us_topic_0066176932__section1428382164518"><h4 class="sectiontitle">Scenarios</h4><p id="en-us_topic_0066176932__p14210182321916">If a bucket has <a href="obs_03_0327.html">versioning</a> enabled, you can recover a deleted object by undeleting it.</p>
</div>
<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 mechanism when versioning is enabled</strong></p>
<p id="en-us_topic_0066176932__p147385129300">When versioning is enabled, OBS uses different deletion methods for different objects.</p>
<ul id="en-us_topic_0066176932__ul5868161543020"><li id="en-us_topic_0066176932__li8822832104419">Deleting a file or folder does not delete it permanently. The deleted file or folder will be 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">If you want to delete the file or folder permanently, you need to delete it from the <strong id="en-us_topic_0066176932__b56939582101">Deleted Objects</strong> list. For details, see <a href="en-us_topic_0045853756.html">Deleting a File or Folder</a>.</li><li id="en-us_topic_0066176932__li51311246184417">To recover a deleted file, you can cancel the deletion by the <strong id="en-us_topic_0066176932__b4465120151111">Undelete</strong> operation. For details, see <a href="#en-us_topic_0066176932__section50464659154530">Procedure</a> in this section.</li></ul>
</li><li id="en-us_topic_0066176932__li133219167471">Deleting a version of an object will permanently delete that version. 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 mechanism when versioning is 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 a deleted object by the <strong id="en-us_topic_0066176932__b837013125151">Undelete</strong> operation.</p>
<p id="en-us_topic_0066176932__p5511204910562">When performing the <strong id="en-us_topic_0066176932__b10458175191517">Undelete</strong> operation, note the following points:</p>
<ol id="en-us_topic_0066176932__ol637616985814"><li id="en-us_topic_0066176932__li5377169155818">You can only undelete deleted files 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 have 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 that specific version instead of permanently deleting it. For details, see <a href="#en-us_topic_0066176932__section27691114163422">Follow-up Procedure</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 specific version is deleted permanently. Even if the object is recovered later, this version will not be recovered.</li></ul>
</li><li id="en-us_topic_0066176932__li55101836134610">At least one version without the <strong id="en-us_topic_0066176932__b20607195119472">Delete Marker</strong> exists in the <strong id="en-us_topic_0066176932__b8582151014810">Deleted Objects</strong> list. Otherwise, the deletion cannot be canceled.</li></ol>
<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 a File 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>
<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>
</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>
<div class="section" id="en-us_topic_0066176932__section64593482542"><h4 class="sectiontitle">Prerequisites</h4><ul id="en-us_topic_0066176932__ul146338141003"><li id="en-us_topic_0066176932__li18633131416020">Versioning has been enabled for the bucket. For details about how to enable versioning, see <a href="obs_03_0327.html">Configuring Versioning</a>.</li><li id="en-us_topic_0066176932__li75846169010">The file to be recovered is in the <strong id="en-us_topic_0066176932__b56809455399">Deleted Objects</strong> list, and at least one version without the <strong id="en-us_topic_0066176932__b675333534013">Delete Marker</strong> exists.</li></ul>
<div class="section" id="en-us_topic_0066176932__section64593482542"><h4 class="sectiontitle">Prerequisites</h4><ul id="en-us_topic_0066176932__ul146338141003"><li id="en-us_topic_0066176932__li18633131416020">Versioning has been enabled for the bucket. For details, see <a href="obs_03_0327.html">Configuring Versioning</a>.</li><li id="en-us_topic_0066176932__li75846169010">The file to be recovered is in the <strong id="en-us_topic_0066176932__b56809455399">Deleted Objects</strong> list, and has at least one version without the <strong id="en-us_topic_0066176932__b675333534013">Delete Marker</strong>.</li></ul>
</div>
<div class="section" id="en-us_topic_0066176932__section50464659154530"><a name="en-us_topic_0066176932__section50464659154530"></a><a name="section50464659154530"></a><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0066176932__ol36405904"><li id="en-us_topic_0066176932__li99821455306"><span>In the bucket list, click the bucket to be operated. The <strong id="en-us_topic_0066176932__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0066176932__en-us_topic_0066036524_li63197139"><span>In the navigation pane, click <strong id="en-us_topic_0066176932__b4423332716533">Objects</strong>.</span></li><li id="en-us_topic_0066176932__li240974320413"><span>Click <strong id="en-us_topic_0066176932__b1428610442012">Deleted Objects</strong>.</span></li><li id="en-us_topic_0066176932__li1463890417452"><span>In the row of the deleted object that you want to recover, click <strong id="en-us_topic_0066176932__b965520271615">Undelete</strong> on the right.</span><p><p id="en-us_topic_0066176932__p5609203818384">You can select multiple files and click <strong id="en-us_topic_0066176932__b14936278415">Undelete</strong> above the object list to batch recover them.</p>
<div class="section" id="en-us_topic_0066176932__section50464659154530"><a name="en-us_topic_0066176932__section50464659154530"></a><a name="section50464659154530"></a><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0066176932__ol36405904"><li id="en-us_topic_0066176932__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0066176932__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0066176932__en-us_topic_0066036524_li63197139"><span>In the navigation pane, click <strong id="en-us_topic_0066176932__b4423332716533">Objects</strong>.</span></li><li id="en-us_topic_0066176932__li240974320413"><span>Click <strong id="en-us_topic_0066176932__b1428610442012">Deleted Objects</strong>.</span></li><li id="en-us_topic_0066176932__li1463890417452"><span>In the row of the deleted object that you want to recover, click <strong id="en-us_topic_0066176932__b965520271615">Undelete</strong> on the right.</span><p><p id="en-us_topic_0066176932__p5609203818384">You can select multiple files and click <strong id="en-us_topic_0066176932__b14936278415">Undelete</strong> above the object list to batch recover them.</p>
</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">Follow-up Procedure</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 to be operated. The <strong id="en-us_topic_0066176932__obs_03_0307_b1395123914108_1">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0066176932__li3295020431"><span>In the navigation pane, click <strong id="en-us_topic_0066176932__b1720819159417">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 will appear 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>
<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_b1395123914108_1">Overview</strong> page of the bucket is displayed.</span></li><li id="en-us_topic_0066176932__li3295020431"><span>In the navigation pane, click <strong id="en-us_topic_0066176932__b1720819159417">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>
</p></li></ol>
</div>
</div>

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. However, it may take hours to restore data from the Archive storage class.</li></ul>
<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>
<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>

View File

@ -2,7 +2,7 @@
<h1 class="topictitle1">Adding a Bucket</h1>
<div id="body1524538563904"><p id="obs_03_0022__p8060118">A bucket is a container that stores objects in OBS. Before you store data in OBS, you need to create a bucket first.</p>
<div class="note" id="obs_03_0022__note14401833152"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0022__obs_03_0306_p10676115174029">An account can create a maximum of 100 buckets.</p>
<div class="note" id="obs_03_0022__note14401833152"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0022__obs_03_0306_p10676115174029">An account can create a maximum of 100 buckets and parallel file systems.</p>
</div></div>
<div class="section" id="obs_03_0022__section166665169537"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0022__o3dc069cdcbba4416a3683f6520f3ecce"><li id="obs_03_0022__l0204956d1e384b6ba74c2d480eae6b31"><span>Log in to OBS Browser.</span></li><li id="obs_03_0022__li01851538185010"><span>Click <strong id="obs_03_0022__b20369115342911">Add Bucket</strong> on the upper left of the page. The <strong id="obs_03_0022__b0561135842917">Add Bucket</strong> dialog box is displayed.</span></li><li id="obs_03_0022__li1127441645716"><span>Select <strong id="obs_03_0022__b2063314911316">Create new bucket</strong>.</span></li><li id="obs_03_0022__li1075791115914"><span>Select a region.</span></li><li id="obs_03_0022__li133562414114"><span>Select the Storage Class according to your actual needs.</span></li><li id="obs_03_0022__li1917124351119"><span>Enter a name in the text box of <strong id="obs_03_0022__b156851934165012">Bucket Name</strong>. You can move the pointer over <span><img id="obs_03_0022__image5838133555913" src="en-us_image_0237531616.png"></span> next to the <strong id="obs_03_0022__a7c8186d9923a4902abdad9e907b36156">Bucket Name</strong> text box to view the naming rules for a bucket.</span><p><div class="fignone" id="obs_03_0022__fig43772663175835"><span class="figcap"><b>Figure 1 </b>Adding a bucket</span><br><span><img id="obs_03_0022__image14851687350" src="en-us_image_0129772318.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="obs_03_0022__l69c01107d6fe48fe9cefcc9f6a140144"><span>Click <strong id="obs_03_0022__b117037197110197">OK</strong>.</span></li><li id="obs_03_0022__li944717573486"><span>In the displayed dialog box, click <strong id="obs_03_0022__b19371431195919">Close</strong> to close the dialog box.</span></li></ol>

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__b651870990">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__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>
<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>

View File

@ -4,7 +4,7 @@
<div id="body1524538563904"><p class="MsoNormal" id="obs_03_0027__p26278299497">You can delete unwanted buckets on OBS Console to free up the quota of buckets.</p>
<div class="section" id="obs_03_0027__section6620131524520"><h4 class="sectiontitle">Prerequisites</h4><ul id="obs_03_0027__obs_03_0411_u5e0dda95ed53456fbac7f7a6776ddb3c"><li id="obs_03_0027__obs_03_0411_en-us_topic_0066036516_li37541158">All objects in the bucket have been deleted.</li><li id="obs_03_0027__obs_03_0411_l9d03f2e3371a47489740448d2f8e3c3a">This operation can be performed only by the bucket owner.</li></ul>
</div>
<div class="section" id="obs_03_0027__section17334620468"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0027__obs_03_0411_of9152a51f159417c92569521957c8e79"><li id="obs_03_0027__obs_03_0411_l7ec00c36001c40aa8a1c8750be64f350"><span>Log in to OBS Browser.</span></li><li id="obs_03_0027__obs_03_0411_l00ce2580a3214e83b41b2a7f9069daf4"><span>Click the blank area in the row of the bucket and choose <strong id="obs_03_0027__obs_03_0411_b6106362315481">More</strong> &gt; <strong id="obs_03_0027__obs_03_0411_b633050921614">Delete</strong>.</span><p><div class="note" id="obs_03_0027__obs_03_0411_nc0986f48d8b64e4bb5b6b5c7aafa99af"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0027__obs_03_0411_a558d2271b685418c8342f82ec227723e">The name of a deleted bucket can be reused for a bucket at least 30 minutes after the deletion.</p>
<div class="section" id="obs_03_0027__section17334620468"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0027__obs_03_0411_of9152a51f159417c92569521957c8e79"><li id="obs_03_0027__obs_03_0411_l7ec00c36001c40aa8a1c8750be64f350"><span>Log in to OBS Browser.</span></li><li id="obs_03_0027__obs_03_0411_l00ce2580a3214e83b41b2a7f9069daf4"><span>Click the blank area in the row of the bucket and choose <strong id="obs_03_0027__obs_03_0411_b6106362315481">More</strong> &gt; <strong id="obs_03_0027__obs_03_0411_b633050921614">Delete</strong>.</span><p><div class="note" id="obs_03_0027__obs_03_0411_nc0986f48d8b64e4bb5b6b5c7aafa99af"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0027__obs_03_0411_a558d2271b685418c8342f82ec227723e">The name of a deleted bucket can be reused for a bucket or a parallel file system at least 30 minutes after the deletion.</p>
</div></div>
</p></li><li id="obs_03_0027__obs_03_0411_li1053115268465"><span>In the displayed dialog box, click <strong id="obs_03_0027__obs_03_0411_en-us_topic_0045853551_b142752461210">Yes</strong>.</span></li><li id="obs_03_0027__obs_03_0411_li944717573486"><span>In the displayed dialog box, click <strong id="obs_03_0027__obs_03_0411_obs_03_0022_b19371431195919">Close</strong> to close the dialog box.</span></li></ol>
</div>

View File

@ -1,12 +1,12 @@
<a name="obs_03_0030"></a><a name="obs_03_0030"></a>
<h1 class="topictitle1">User-Defined Domain Name Binding</h1>
<h1 class="topictitle1">Configuring User-Defined Domain Names</h1>
<div id="body1527042452553"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_03_0031.html">User-Defined Domain Name Binding Overview</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_03_0031.html">Overview</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_03_0032.html">Binding a User-Defined Domain Name</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_03_0032.html">Configuring a User-Defined Domain Name</a></strong><br>
</li>
</ul>

View File

@ -1,16 +1,16 @@
<a name="obs_03_0031"></a><a name="obs_03_0031"></a>
<h1 class="topictitle1">User-Defined Domain Name Binding Overview</h1>
<div id="body1528266904098"><div class="section" id="obs_03_0031__section1527515016443"><h4 class="sectiontitle">Application Scenario</h4><p id="obs_03_0031__p759020183106">After a file is uploaded to a bucket, you can access this file using the bucket's domain name by default. If you want to access the file using a user-defined domain name, you can bind this domain name to the bucket.</p>
<p id="obs_03_0031__p1268192674512">Assuming that you have a domain name <strong id="obs_03_0031__b3866548183611">www.example.com</strong> and there is an image <strong id="obs_03_0031__b1550171510379">image.png</strong> in an OBS bucket, after you bind <strong id="obs_03_0031__b19316255153714">www.example.com</strong> to the bucket, you can use <strong id="obs_03_0031__b13967193216388">http://www.example.com/image.png</strong> to access image <strong id="obs_03_0031__b6741171917387">image.png</strong>. The steps below describe the configurations:</p>
<ol id="obs_03_0031__ol19681926114513"><li id="obs_03_0031__li36811261454">Create a bucket on OBS and upload file <strong id="obs_03_0031__b19875581437">image.png</strong> to the bucket.</li><li id="obs_03_0031__li86812026134511">On OBS Console, bind <strong id="obs_03_0031__b573119188431">www.example.com</strong> to the created bucket.</li><li id="obs_03_0031__li20681126144511">On the DNS server, add a CNAME record and map <strong id="obs_03_0031__b1866544108151256">www.example.com</strong> to the domain name of the bucket.</li><li id="obs_03_0031__li15870194016401">Send a request for image <strong id="obs_03_0031__b17648549125016">image.png</strong>. After the request for <strong id="obs_03_0031__b1769811184014">http://www.example.com/image.png</strong> reaches OBS, OBS finds the mapping between the <strong id="obs_03_0031__b126994124012">www.example.com</strong> and the bucket's domain name, and redirects it to the <strong id="obs_03_0031__b870011114019">image.png</strong> file stored in the bucket. That is, a request for <strong id="obs_03_0031__b5565194016405">http://www.example.com/image.png</strong> actually accesses <strong id="obs_03_0031__b1357310406403">http://</strong><em id="obs_03_0031__i75741540134010">Bucket domain name</em><strong id="obs_03_0031__b1557564064010">/image.png</strong>.</li></ol>
<h1 class="topictitle1">Overview</h1>
<div id="body1528266904098"><div class="section" id="obs_03_0031__section1527515016443"><h4 class="sectiontitle">Application Scenario</h4><p id="obs_03_0031__p759020183106">After you upload a file to a bucket, you can access this file using the bucket's access domain name by default. If you want to use a custom domain name to access the file, bind the custom domain name to the bucket.</p>
<p id="obs_03_0031__p1268192674512">Assume that you have a domain name <strong id="obs_03_0031__b3866548183611">www.example.com</strong> and you upload an image <strong id="obs_03_0031__b1550171510379">image.png</strong> to an OBS bucket. As long as you bind <strong id="obs_03_0031__b19316255153714">www.example.com</strong> to the bucket, you can use <strong id="obs_03_0031__b13967193216388">http://www.example.com/image.png</strong> to access <strong id="obs_03_0031__b6741171917387">image.png</strong>. The steps below describe the configurations:</p>
<ol id="obs_03_0031__ol19681926114513"><li id="obs_03_0031__li36811261454">Create a bucket on OBS and upload file <strong id="obs_03_0031__b19875581437">image.png</strong> to the bucket.</li><li id="obs_03_0031__li86812026134511">On OBS Console, bind <strong id="obs_03_0031__b573119188431">www.example.com</strong> to the created bucket.</li><li id="obs_03_0031__li20681126144511">On the DNS server, add a CNAME record and map <strong id="obs_03_0031__b1866544108151256">www.example.com</strong> to the domain name of the bucket.</li><li id="obs_03_0031__li15870194016401">Send a request for image <strong id="obs_03_0031__b17648549125016">image.png</strong>. After the request for <strong id="obs_03_0031__b1769811184014">http://www.example.com/image.png</strong> reaches OBS, OBS finds the mapping between the <strong id="obs_03_0031__b126994124012">www.example.com</strong> and the bucket's domain name, and redirects the request to the <strong id="obs_03_0031__b870011114019">image.png</strong> file stored in the bucket. This way, a request for <strong id="obs_03_0031__b5565194016405">http://www.example.com/image.png</strong> actually accesses <strong id="obs_03_0031__b1357310406403">http://</strong><em id="obs_03_0031__i75741540134010">Bucket domain name</em><strong id="obs_03_0031__b1557564064010">/image.png</strong>.</li></ol>
</div>
<div class="section" id="obs_03_0031__section1817425811574"><h4 class="sectiontitle">Limitations and Constraints</h4><ol id="obs_03_0031__ol731571145812"><li id="obs_03_0031__li83151511175819">Only buckets whose version is 3.0 support user-defined domain name binding. The version number of a bucket is displayed in the <strong id="obs_03_0031__b0191171144610">Basic Information</strong> area.</li><li id="obs_03_0031__li7811214712">Currently, user domain names bound to OBS only allow access requests over HTTP.</li><li id="obs_03_0031__li1749152513012">A user-defined domain name can be bound to only one bucket.</li><li id="obs_03_0031__li5192942182414">Currently, the suffix of a user-defined domain name can contain 2 to 6 uppercase and lowercase letters.</li></ol>
<div class="section" id="obs_03_0031__section1817425811574"><h4 class="sectiontitle">Limitations and Constraints</h4><ol id="obs_03_0031__ol731571145812"><li id="obs_03_0031__li83151511175819">Only buckets with version 3.0 or later support user-defined domain name configuration. The version number of a bucket is displayed in the <strong id="obs_03_0031__b0191171144610">Basic Information</strong> area.</li><li id="obs_03_0031__li7811214712">User-defined domain names currently allow requests over only HTTP, but not HTTPS.</li><li id="obs_03_0031__li1749152513012">A user-defined domain name can be bound to only one bucket.</li><li id="obs_03_0031__li5192942182414">The suffix of a user-defined domain name can contain 2 to 6 uppercase or lowercase letters.</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0030.html">User-Defined Domain Name Binding</a></div>
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0030.html">Configuring User-Defined Domain Names</a></div>
</div>
</div>

View File

@ -1,17 +1,17 @@
<a name="obs_03_0032"></a><a name="obs_03_0032"></a>
<h1 class="topictitle1">Binding a User-Defined Domain Name</h1>
<div id="body1528266904098"><div class="section" id="obs_03_0032__section16552733193411"><h4 class="sectiontitle">Prerequisites</h4><p id="obs_03_0032__p52272611352">A bucket has been created and website files have been uploaded to the bucket.</p>
<h1 class="topictitle1">Configuring a User-Defined Domain Name</h1>
<div id="body0000001508343717"><div class="section" id="obs_03_0032__section16552733193411"><h4 class="sectiontitle">Prerequisites</h4><p id="obs_03_0032__p52272611352">You have created a bucket and uploaded your website file to it.</p>
</div>
<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 to be operated. The <strong id="obs_03_0032__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0032__li13225103917434"><span>In the navigation pane, select <strong id="obs_03_0032__b10675844017">Domain Name Mgmt</strong>.</span></li><li id="obs_03_0032__li1780214214274"><span>Click <strong id="obs_03_0032__b1765111818338">Bind User Domain Name</strong> and enter the user-defined domain name to be bound, as shown in <a href="#obs_03_0032__fig53010339108">Figure 1</a>.</span><p><p id="obs_03_0032__p7863173592419">Currently, the suffix of a user-defined domain name can contain 2 to 6 uppercase and 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_0000001167932237.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="obs_03_0032__li14150152174510"><span>Click <strong id="obs_03_0032__b2819650151614">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__b16268128101720">example.com</strong>) to the domain name of a bucket. </span><p><p id="obs_03_0032__p161095613225">The CNAME configuration varies according to different DNS providers. For details, contact your DNS provider.</p>
<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_b1395123914108">Overview</strong> page of the bucket 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__b12674133062813">Bind User Domain Name</strong> and enter the domain name to be configured, 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>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0030.html">User-Defined Domain Name Binding</a></div>
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0030.html">Configuring User-Defined Domain Names</a></div>
</div>
</div>

View File

@ -3,7 +3,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 OBS access permissions to the users, 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>Granting an IAM user the access permissions to OBS</span><br><span><img id="obs_03_0035__obs_03_0304_obs_03_0122_image12924124212474" src="en-us_image_0170301902.png"></span></div>
<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 using a cloud service account.</span></li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li5853192561010"><span>On the top navigation menu, choose <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b19603113671814">Service List</strong> &gt; <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b3603103615186">Management &amp; Deployment</strong> &gt; <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b460310368184">Identity and Access Management</strong>. The IAM console page is displayed.</span></li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li257313485116"><span>Create a user group and grant the OBS permissions to the user group.</span><p><div class="p" id="obs_03_0035__obs_03_0304_obs_03_0122_p371751915195">User groups facilitate centralized user management and streamlined permissions management. Users in the same user group have the same permissions. Users created in IAM inherit permissions from the groups to which they belong.<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 on the left, click <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b17624165682216">User Groups</strong>. The <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b4625115617224">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">On the <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b1190011522266">Create User Group</strong> page, enter a name for the user group and click <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b7542112222713">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 completes.</p>
</li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li19866191819199">Click <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b1406172416567">Modify</strong> in the <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b12813112718562">Operation</strong> column of the row where the created user group resides.</li><li id="obs_03_0035__obs_03_0304_obs_03_0122_li1286721818193">In the <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b1813981018595">Group Permissions</strong> area, locate <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b166361281309">OBS (S3)</strong>, click <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b145811817302">Attach Policy</strong> in the <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b151884218015">Operation</strong> column, select the policy name, and click <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b112537337019">OK</strong>.<div class="note" id="obs_03_0035__obs_03_0304_obs_03_0122_note12867161811198"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0035__obs_03_0304_obs_03_0122_p128671018121916">In the <strong id="obs_03_0035__obs_03_0304_obs_03_0122_b1318212383618">Policy Information</strong> area, you can view the details about the policy.</p>

View File

@ -4,10 +4,10 @@
<div id="body1532488949235"><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>
<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. To assign permissions to these new users, add them to one or more groups, and attach permissions policies to these 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>
<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>
<div class="note" id="obs_03_0045__note1402619155515"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0045__p124023197557">Due to data caching, an RBAC policy involving OBS actions will take effect 10 to 15 minutes after it is attached to a user and user group.</p>
<div class="note" id="obs_03_0045__note1402619155515"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0045__p124023197557">Due to data caching, an RBAC policy involving OBS actions will take effect 10 to 15 minutes after it is attached to a user and a user group.</p>
</div></div>
<p id="obs_03_0045__p3506155772411"><a href="#obs_03_0045__table358116162418">Table 1</a> lists all system policies of OBS.</p>
@ -295,7 +295,7 @@
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.2.5.1.4 "><p id="obs_03_0045__p1588219345328">No</p>
</td>
</tr>
<tr id="obs_03_0045__row19882153413329"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.2.5.1.1 "><p id="obs_03_0045__p88821934163215">Managing tags</p>
<tr id="obs_03_0045__row19882153413329"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.2.5.1.1 "><p id="obs_03_0045__p88821934163215">Managing tags</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.2.5.1.2 "><p id="obs_03_0045__p2882134113215">Yes</p>
</td>
@ -403,7 +403,7 @@
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.2.5.1.4 "><p id="obs_03_0045__p789315313510">No</p>
</td>
</tr>
<tr id="obs_03_0045__row17345184735011"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.2.5.1.1 "><p id="obs_03_0045__p9345114714501">Canceling multipart tasks</p>
<tr id="obs_03_0045__row17345184735011"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.2.5.1.1 "><p id="obs_03_0045__p9345114714501">Canceling multipart uploads</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.2.5.1.2 "><p id="obs_03_0045__p352114115111">Yes</p>
</td>

View File

@ -1,15 +1,15 @@
<a name="obs_03_0049"></a><a name="obs_03_0049"></a>
<h1 class="topictitle1">Principal</h1>
<div id="body1557026128761"><p id="obs_03_0049__p28805261528">This parameter specifies users on whom the bucket policy takes effect, including accounts, federated users or federated user groups, and IAM users. Target users can be specified in either of the following ways:</p>
<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__b9396124819353">Include</strong>: Specifies the user on whom the bucket policy statement takes effect.</li><li id="obs_03_0049__li1488092635210"><strong id="obs_03_0049__b13188853163520">Exclude</strong>: Specifies that on all users except the specified user the bucket policy statement takes effect.</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>When the <strong id="obs_03_0049__b6309548104">Principal</strong> is set to <strong id="obs_03_0049__b1032554141017">Current account</strong>, you can select IAM users in the account, so that the bucket policy applies to the selected 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 in that account, you need to enter the user IDs, and use commas (,) to separate one from another.</p>
<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>
<p id="obs_03_0049__p118769434404">For <strong id="obs_03_0049__b5667118525">Account ID</strong>, input the <strong id="obs_03_0049__b048315353525">Domain ID</strong> that can be found on the <strong id="obs_03_0049__b5867174917527">My Credential</strong> page.</p>
<p id="obs_03_0049__p118769434404">For <strong id="obs_03_0049__b5667118525">Account ID</strong>, enter the <strong id="obs_03_0049__b048315353525">Domain ID</strong> that can be found on the <strong id="obs_03_0049__b5867174917527">My Credential</strong> page.</p>
</div></div>
</li><li id="obs_03_0049__li10921011195615">Anyone (anonymous users)<p id="obs_03_0049__p17789143015711"><a name="obs_03_0049__li10921011195615"></a><a name="li10921011195615"></a>To grant the bucket access permission to anyone, set the <strong id="obs_03_0049__b026918469112">Principal</strong> to <strong id="obs_03_0049__b327084641116">Other account</strong> and enter an asterisk (*) as the account ID.</p>
<div class="caution" id="obs_03_0049__note161581126115819"><span class="cautiontitle"><img src="public_sys-resources/caution_3.0-en-us.png"> </span><div class="cautionbody"><p id="obs_03_0049__p1413394815576">Exercise caution when granting the bucket access permissions to anonymous users. If you grant the bucket access permission to anonymous users, anyone can access your bucket, and the traffic and storage fees generated will be borne by the bucket owner (cloud service account). You are advised to set restrictions on access requests. For example, you can allow the access request from only one IP address.</p>
<div class="caution" id="obs_03_0049__note161581126115819"><span class="cautiontitle"><img src="public_sys-resources/caution_3.0-en-us.png"> </span><div class="cautionbody"><p id="obs_03_0049__p1413394815576">Exercise caution when granting the bucket access permissions to anonymous users. If you grant the bucket access permission to anonymous users, anyone can access your bucket, and the traffic and storage fees generated will be borne by the bucket owner (cloud service account). You are advised to set restrictions on access requests. For example, you can allow the access requests from only one IP address.</p>
</div></div>
</li></ul>
</div>

View File

@ -79,12 +79,12 @@
</tr>
<tr id="obs_03_0051__row18541541155513"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.1 "><p id="obs_03_0051__p35424175510">GetBucketVersioning</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.2 "><p id="obs_03_0051__p25694120558">Obtains the versioning information of the bucket.</p>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.2 "><p id="obs_03_0051__p25694120558">Obtains the versioning information of a bucket.</p>
</td>
</tr>
<tr id="obs_03_0051__row1556124110550"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.1 "><p id="obs_03_0051__p256114114557">PutBucketVersioning</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.2 "><p id="obs_03_0051__p8561041165514">Configures versioning for the bucket.</p>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.2 "><p id="obs_03_0051__p8561041165514">Configures versioning for a bucket.</p>
</td>
</tr>
<tr id="obs_03_0051__row1956174175518"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.1 "><p id="obs_03_0051__p105616414553">GetBucketLocation</p>
@ -99,7 +99,7 @@
</tr>
<tr id="obs_03_0051__row25624135520"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.1 "><p id="obs_03_0051__p8576412557">PutBucketLogging</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.2 "><p id="obs_03_0051__p65794105515">Configures logging for the bucket.</p>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.2 "><p id="obs_03_0051__p65794105515">Configures logging for a bucket.</p>
</td>
</tr>
<tr id="obs_03_0051__row1457341125512"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.4.1.1 "><p id="obs_03_0051__p125714418556">GetBucketWebsite</p>
@ -166,7 +166,7 @@
</td>
<td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.5.2.2.4.1.2 "><p id="obs_03_0051__p7206134213245">GetObject</p>
</td>
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.5.2.2.4.1.3 "><p id="obs_03_0051__p8206242122419">Obtains the object and its metadata.</p>
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.5.2.2.4.1.3 "><p id="obs_03_0051__p8206242122419">Obtains an object and its metadata.</p>
</td>
</tr>
<tr id="obs_03_0051__row120674272415"><td class="cellrowborder" valign="top" headers="mcps1.3.5.2.2.4.1.1 "><p id="obs_03_0051__p162069427248">GetObjectVersion</p>

View File

@ -16,7 +16,7 @@
</tr>
<tr id="obs_03_0054__row2742419211311"><td class="cellrowborder" valign="top" width="34%" headers="mcps1.3.2.2.3.1.1 "><p id="obs_03_0054__p676711911311"><a href="obs_03_0315.html">Basic object operations</a></p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.2.2.3.1.2 "><p id="obs_03_0054__p1979955161418">Allow you to manage objects, including uploading, multipart uploading, downloading, changing object storage classes, restoring archived objects, and deleting.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.2.2.3.1.2 "><p id="obs_03_0054__p1979955161418">Allow you to manage objects, including uploads, multipart uploads, downloads, storage class change, restore of archived objects, and deletion.</p>
</td>
</tr>
<tr id="obs_03_0054__row275312461116"><td class="cellrowborder" valign="top" width="34%" headers="mcps1.3.2.2.3.1.1 "><p id="obs_03_0054__p73666084410"><a href="obs_03_0321.html">Server-side encryption</a></p>
@ -74,7 +74,7 @@
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.2.2.3.1.2 "><p id="obs_03_0054__p26144036153422">Supports the hosting of static website content in buckets, and supports redirection of bucket access requests to specific hosts.</p>
</td>
</tr>
<tr id="obs_03_0054__row88451951104118"><td class="cellrowborder" valign="top" width="34%" headers="mcps1.3.2.2.3.1.1 "><p id="obs_03_0054__p17123787916"><a href="obs_03_0030.html">User-defined domain name binding</a></p>
<tr id="obs_03_0054__row88451951104118"><td class="cellrowborder" valign="top" width="34%" headers="mcps1.3.2.2.3.1.1 "><p id="obs_03_0054__p17123787916"><a href="obs_03_0030.html">User-defined domain name configuration</a></p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.2.2.3.1.2 "><p id="obs_03_0054__p171231287913">Binds your website domain names to bucket domain names. This function applies to the following scenario: migrating files from a website to OBS without modifying the code of the web page, and keeping the link of the website unchanged.</p>
</td>

View File

@ -6,7 +6,7 @@
<div class="section" id="obs_03_0062__section1898792812813"><h4 class="sectiontitle">Bucket Policy</h4><p id="obs_03_0062__p1885475013710">A bucket owner can edit a bucket policy to implement fine-grained bucket access control.</p>
<p id="obs_03_0062__p6971236162512">A bucket policy can be used to control access to the bucket and objects in the bucket. Specifically, you can define the effect, authorized users, resources, actions, and conditions of a bucket policy. Permissions attached to a bucket apply to all the objects in the bucket. After a bucket policy is created, access requests to the bucket are controlled by the bucket policy. The bucket policy controls access requests by allowing or denying the requests.</p>
</div>
<div class="section" id="obs_03_0062__section685651513912"><h4 class="sectiontitle">ACL</h4><p id="obs_03_0062__p18390162651418">A bucket or object ACL can assign the following users the read and write permissions to OBS resources:</p>
<div class="section" id="obs_03_0062__section685651513912"><h4 class="sectiontitle">ACLs</h4><p id="obs_03_0062__p18390162651418">A bucket or object ACL can assign the following users the read and write permissions to OBS resources:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0062__table177445813209" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Users supported by OBS</caption><thead align="left"><tr id="obs_03_0062__row5236185882019"><th align="left" class="cellrowborder" valign="top" width="27%" id="mcps1.3.4.3.2.3.1.1"><p id="obs_03_0062__p4236185812209">Principal</p>
</th>

View File

@ -6,7 +6,7 @@
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_03_0115.html">Effect</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_03_0049.html">Principal</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_03_0049.html">Principals</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_03_0118.html">Resources</a></strong><br>
</li>

View File

@ -1,8 +1,8 @@
<a name="obs_03_0075"></a><a name="obs_03_0075"></a>
<h1 class="topictitle1">Configuring an Object Policy</h1>
<div id="body1557123327164"><p id="obs_03_0075__p18416184972615">An object policy applies to a specific object, which is also part of a bucket policy. The resource of an object policy is the selected object, and the actions and conditions are the object related actions and conditions configured in the bucket policy.</p>
<div class="section" id="obs_03_0075__section1427668152517"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0075__ol3653067817298"><li id="obs_03_0075__li99821455306"><span>In the bucket list, click the bucket to be operated. The <strong id="obs_03_0075__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0075__li51927620"><span>In the navigation pane, click <strong id="obs_03_0075__obs_03_0307_b47118221194931">Objects</strong>.</span></li><li id="obs_03_0075__li27180413161423"><span>On the right of the object to be operated, choose <strong id="obs_03_0075__b622031814208">More</strong> &gt; <strong id="obs_03_0075__b156481323142016">Configure Object Policy</strong>. The <strong id="obs_03_0075__b1787252862012">Configure Object Policy</strong> dialog box is displayed.</span></li><li id="obs_03_0075__li141801159171718"><span>Select a proper policy mode as required. Valid options are as follows:</span><p><ul id="obs_03_0075__ul1974615162010"><li id="obs_03_0075__li97411532015">Read-only mode: The authorized user has the read permission to the object. For follow-up procedure, see <a href="#obs_03_0075__li3552175452220">5</a>.</li><li id="obs_03_0075__li390172213204">Read and write mode: The authorized user has the read and write permissions to the object. For follow-up procedure, see <a href="#obs_03_0075__li3552175452220">5</a>.</li><li id="obs_03_0075__li4483132516202">Customized: The authorized user will be granted with customized permissions to the object. For detailed configuration, see <a href="#obs_03_0075__li588503161565">6</a>.</li></ul>
<div id="body1557123327164"><p id="obs_03_0075__p18416184972615">Object policies are applied to the objects in a bucket. With an object policy, you can configure conditions and actions for objects in a bucket.</p>
<div class="section" id="obs_03_0075__section1427668152517"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0075__ol3653067817298"><li id="obs_03_0075__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0075__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0075__li51927620"><span>In the navigation pane, click <strong id="obs_03_0075__obs_03_0307_b47118221194931">Objects</strong>.</span></li><li id="obs_03_0075__li27180413161423"><span>On the right of the object to be operated, choose <strong id="obs_03_0075__b622031814208">More</strong> &gt; <strong id="obs_03_0075__b156481323142016">Configure Object Policy</strong>. The <strong id="obs_03_0075__b1787252862012">Configure Object Policy</strong> dialog box is displayed.</span></li><li id="obs_03_0075__li141801159171718"><span>Select a proper policy mode as required. Valid options are as follows:</span><p><ul id="obs_03_0075__ul1974615162010"><li id="obs_03_0075__li97411532015">Read-only mode: The authorized user has the read permission to the object. For follow-up procedure, see <a href="#obs_03_0075__li3552175452220">5</a>.</li><li id="obs_03_0075__li390172213204">Read and write mode: The authorized user has the read and write permissions to the object. For follow-up procedure, see <a href="#obs_03_0075__li3552175452220">5</a>.</li><li id="obs_03_0075__li4483132516202">Customized: The authorized user will be granted with customized permissions to the object. For detailed configuration, see <a href="#obs_03_0075__li588503161565">6</a>.</li></ul>
<div class="note" id="obs_03_0075__note3389183318244"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0075__p6390333192416">You can configure only one object policy at a time.</p>
</div></div>
</p></li><li id="obs_03_0075__li3552175452220"><a name="obs_03_0075__li3552175452220"></a><a name="li3552175452220"></a><span>For read-only and read and write modes, enter information about the authorized user in the following format and click <strong id="obs_03_0075__b1320965261618">OK</strong>.</span><p><div class="fignone" id="obs_03_0075__fig17275162821520"><span class="figcap"><b>Figure 1 </b>Parameter settings of an object policy in the read-only or read and write mode</span><br><span><img id="obs_03_0075__image127510288156" src="en-us_image_0189257108.png" title="Click to enlarge" class="imgResize"></span></div>

View File

@ -3,7 +3,7 @@
<h1 class="topictitle1">Granting an IAM User with the Operation Permissions for a Specified Bucket</h1>
<div id="body1557026128761"><p id="obs_03_0080__p1919519475574">Create an IAM user under in an account. The IAM user has no permission to any resource before it is added to any user group. The bucket owner (root account) or other accounts and IAM users, who have the permission to set bucket policies, can configure bucket policies to grant the bucket operation permissions to IAM users.</p>
<p id="obs_03_0080__p2058382155214">The following is an example about how to authorize an IAM user with the bucket access and object upload permissions.</p>
<div class="section" id="obs_03_0080__section13279211683"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0080__ol549119194012"><li id="obs_03_0080__li99821455306"><span>In the bucket list, click the bucket to be operated. The <strong id="obs_03_0080__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0080__li2836319145514"><span>In the navigation pane on the left, click <strong id="obs_03_0080__obs_03_0142_b63882047163712">Permissions</strong> to go to the permission management page.</span></li><li id="obs_03_0080__li8120153165517"><span>Choose <strong id="obs_03_0080__b19801124353">Bucket Policies</strong> &gt; <strong id="obs_03_0080__b880311214357">Custom Bucket Policies</strong>.</span></li><li id="obs_03_0080__li81441540133419"><span>Click <strong id="obs_03_0080__b17165141553511">Create Bucket Policy</strong>. The <strong id="obs_03_0080__b61661215173517">Create Bucket Policy</strong> dialog box is displayed.</span></li><li id="obs_03_0080__li17931032163517"><span>Set the following parameters to authorize the IAM user with the permission to access the bucket (listing objects in the bucket).</span><p>
<div class="section" id="obs_03_0080__section13279211683"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0080__ol549119194012"><li id="obs_03_0080__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0080__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0080__li2836319145514"><span>In the navigation pane on the left, click <strong id="obs_03_0080__obs_03_0142_b63882047163712">Permissions</strong> to go to the permission management page.</span></li><li id="obs_03_0080__li8120153165517"><span>Choose <strong id="obs_03_0080__b19801124353">Bucket Policies</strong> &gt; <strong id="obs_03_0080__b880311214357">Custom Bucket Policies</strong>.</span></li><li id="obs_03_0080__li81441540133419"><span>Click <strong id="obs_03_0080__b17165141553511">Create Bucket Policy</strong>. The <strong id="obs_03_0080__b61661215173517">Create Bucket Policy</strong> dialog box is displayed.</span></li><li id="obs_03_0080__li17931032163517"><span>Set the following parameters to authorize the IAM user with the permission to access the bucket (listing objects in the bucket).</span><p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0080__table7531653104420" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters for authorizing the permission to access a specified bucket</caption><thead align="left"><tr id="obs_03_0080__row2532105311447"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.5.2.1.2.3.1.1"><p id="obs_03_0080__p16532195364414">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.5.2.1.2.3.1.2"><p id="obs_03_0080__p15532145310443">Value</p>

View File

@ -7,7 +7,7 @@
<ol id="obs_03_0081__ol7853716103516"><li id="obs_03_0081__li685301693514">Configure a bucket policy to allow IAM users to access the bucket.</li><li id="obs_03_0081__li888244323516">Configure <span id="obs_03_0081__ph135373523355">IAM policies</span> for the account to which the authorized IAM user belongs, to allow the IAM user to access the bucket.</li></ol>
<p id="obs_03_0081__p1345162763720">Only permissions that are allowed by both the bucket policy and <span id="obs_03_0081__ph5939236183712">IAM policies</span> can take effect.</p>
</div></div>
<div class="section" id="obs_03_0081__section435994418812"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0081__ol549119194012"><li id="obs_03_0081__li99821455306"><span>In the bucket list, click the bucket to be operated. The <strong id="obs_03_0081__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0081__li13508181724617"><span>In the navigation pane on the left, click <strong id="obs_03_0081__obs_03_0142_b63882047163712">Permissions</strong> to go to the permission management page.</span></li><li id="obs_03_0081__li8120153165517"><span>Choose <strong id="obs_03_0081__b942110816513">Bucket Policies</strong> &gt; <strong id="obs_03_0081__b7422287515">Custom Bucket Policies</strong>.</span></li><li id="obs_03_0081__li81441540133419"><span>Click <strong id="obs_03_0081__b111286107515">Create Bucket Policy</strong>. The <strong id="obs_03_0081__b14129191013513">Create Bucket Policy</strong> dialog box is displayed.</span></li><li id="obs_03_0081__li17931032163517"><span>Set the following parameters to authorize another account with the permission to access the bucket:</span><p>
<div class="section" id="obs_03_0081__section435994418812"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0081__ol549119194012"><li id="obs_03_0081__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0081__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0081__li13508181724617"><span>In the navigation pane on the left, click <strong id="obs_03_0081__obs_03_0142_b63882047163712">Permissions</strong> to go to the permission management page.</span></li><li id="obs_03_0081__li8120153165517"><span>Choose <strong id="obs_03_0081__b942110816513">Bucket Policies</strong> &gt; <strong id="obs_03_0081__b7422287515">Custom Bucket Policies</strong>.</span></li><li id="obs_03_0081__li81441540133419"><span>Click <strong id="obs_03_0081__b111286107515">Create Bucket Policy</strong>. The <strong id="obs_03_0081__b14129191013513">Create Bucket Policy</strong> dialog box is displayed.</span></li><li id="obs_03_0081__li17931032163517"><span>Set the following parameters to authorize another account with the permission to access the bucket:</span><p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0081__table7531653104420" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters for authorizing the permission to access a specified bucket</caption><thead align="left"><tr id="obs_03_0081__row2532105311447"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.2.5.2.1.2.3.1.1"><p id="obs_03_0081__p16532195364414">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.2.5.2.1.2.3.1.2"><p id="obs_03_0081__p15532145310443">Value</p>

View File

@ -2,12 +2,12 @@
<h1 class="topictitle1">Bucket Default Encryption</h1>
<div id="body1551323631371"><p id="obs_03_0088__p725032142814">OBS enables you to configure default encryption for a bucket. After the configuration, objects uploaded to the bucket are automatically encrypted using the specified KMS key, improving data storage security.</p>
<p id="obs_03_0088__p855995918245">You can enable the default encryption when creating a bucket. For details, see <a href="en-us_topic_0045853662.html">Creating a Bucket</a>. You can also enable or disable the default encryption for an existing bucket.</p>
<p id="obs_03_0088__p4926171015014">OBS encrypts only the objects uploaded after the default encryption function is enabled. The encryption status of existing objects in the bucket remains unchanged. Disabling default encryption does not change the encryption status of existing objects in a bucket. After this function is disabled, you can still manually encrypt objects upon upload.</p>
<div class="section" id="obs_03_0088__section3892114117330"><h4 class="sectiontitle">Enabling Default Encryption for a Bucket</h4><ol id="obs_03_0088__ol93829311363"><li id="obs_03_0088__li99821455306"><span>In the bucket list, click the bucket to be operated. The <strong id="obs_03_0088__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0088__li18830181855820"><span>In the right <strong id="obs_03_0088__b26567116474">Basic Configurations</strong> area, click <strong id="obs_03_0088__b188978911477">Default Encryption</strong>. The <strong id="obs_03_0088__b87694251478">Default Encryption</strong> dialog box is displayed.</span></li><li id="obs_03_0088__li185861427134716"><span>Select <strong id="obs_03_0088__b158241243144713">Enable</strong>.</span><p><p id="obs_03_0088__p181834121475">Key <strong id="obs_03_0088__b36819471">obs/default</strong> is selected by default for KMS encryption. You can also click <strong id="obs_03_0088__b42672114811">Create KMS Key</strong> to switch to the management console of KMS and create customer master keys. Then back to OBS Console and select the key from the drop-down list box for KMS encryption.</p>
<p id="obs_03_0088__p855995918245">You can enable the default encryption when creating a bucket. For details, see <a href="en-us_topic_0045853662.html">Creating a Bucket</a>. You can also enable or disable the default encryption after a bucket is created.</p>
<p id="obs_03_0088__p4926171015014">OBS encrypts only the objects uploaded after the default encryption function is enabled, and does not encrypt those uploaded before. After default encryption is disabled, the encryption status of existing objects keeps unchanged, and you can still manually encrypt objects upon upload.</p>
<div class="section" id="obs_03_0088__section3892114117330"><h4 class="sectiontitle">Enabling Default Encryption for a Bucket</h4><ol id="obs_03_0088__ol93829311363"><li id="obs_03_0088__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0088__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0088__li18830181855820"><span>In the right <strong id="obs_03_0088__b26567116474">Basic Configurations</strong> area, click <strong id="obs_03_0088__b188978911477">Default Encryption</strong>. The <strong id="obs_03_0088__b87694251478">Default Encryption</strong> dialog box is displayed.</span></li><li id="obs_03_0088__li185861427134716"><span>Select <strong id="obs_03_0088__b158241243144713">Enable</strong>.</span><p><p id="obs_03_0088__p181834121475">Key <strong id="obs_03_0088__b309598757">obs/default</strong> is selected by default for KMS encryption. You can also click <strong id="obs_03_0088__b42672114811">Create KMS Key</strong> to switch to the management console of KMS and create customer master keys. Then back to OBS Console and select the key from the drop-down list box for KMS encryption.</p>
</p></li><li id="obs_03_0088__li950544814498"><span>Click <strong id="obs_03_0088__b74262294910">OK</strong>.</span></li></ol>
</div>
<div class="section" id="obs_03_0088__section1434134116310"><h4 class="sectiontitle">Disabling Default Encryption for a Bucket</h4><ol id="obs_03_0088__ol03353441319"><li id="obs_03_0088__li1933611448318"><span>In the bucket list, click the bucket to be operated. The <strong id="obs_03_0088__obs_03_0307_b1395123914108_1">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0088__li11336244153118"><span>In the right <strong id="obs_03_0088__b1365043122112">Basic Configurations</strong> area, click <strong id="obs_03_0088__b5651153142118">Default Encryption</strong>. The <strong id="obs_03_0088__b26513319217">Default Encryption</strong> dialog box is displayed.</span></li><li id="obs_03_0088__li18336114433120"><span>Select <strong id="obs_03_0088__b842352706195129">Disable</strong>.</span></li><li id="obs_03_0088__li93366443315"><span>Click <strong id="obs_03_0088__b2007098214">OK</strong>.</span></li></ol>
<div class="section" id="obs_03_0088__section1434134116310"><h4 class="sectiontitle">Disabling Default Encryption for a Bucket</h4><ol id="obs_03_0088__ol03353441319"><li id="obs_03_0088__li1933611448318"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0088__obs_03_0307_b1395123914108_1">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0088__li11336244153118"><span>In the right <strong id="obs_03_0088__b1365043122112">Basic Configurations</strong> area, click <strong id="obs_03_0088__b5651153142118">Default Encryption</strong>. The <strong id="obs_03_0088__b26513319217">Default Encryption</strong> dialog box is displayed.</span></li><li id="obs_03_0088__li18336114433120"><span>Select <strong id="obs_03_0088__b842352706195129">Disable</strong>.</span></li><li id="obs_03_0088__li93366443315"><span>Click <strong id="obs_03_0088__b1845125900">OK</strong>.</span></li></ol>
</div>
</div>
<div>

View File

@ -2,7 +2,7 @@
<h1 class="topictitle1">Authorizing Folder Access Permissions to Anonymous Users</h1>
<div id="body1557026128762"><p id="obs_03_0096__p517314258104">If all objects in a folder need to be accessible to anonymous users, you can configure a bucket policy or an object policy to grant anonymous users the permission to access the folder. In this example, a bucket policy is used. If you want to use an object policy to authorize the permission, select the target folder and configure the object policy directly. Parameters are the same as those in the bucket policy.</p>
<div class="section" id="obs_03_0096__section17557163019204"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0096__en-us_topic_0056349953_ol62991470"><li id="obs_03_0096__li99821455306"><span>In the bucket list, click the bucket to be operated. The <strong id="obs_03_0096__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0096__li19853957175612"><span>In the navigation pane on the left, click <strong id="obs_03_0096__obs_03_0142_b63882047163712">Permissions</strong> to go to the permission management page.</span></li><li id="obs_03_0096__li8120153165517"><span>Choose <strong id="obs_03_0096__b23113213129">Bucket Policies</strong> &gt; <strong id="obs_03_0096__b19512328126">Custom Bucket Policies</strong>.</span></li><li id="obs_03_0096__li81441540133419"><span>Click <strong id="obs_03_0096__b4839432131212">Create Bucket Policy</strong>. The <strong id="obs_03_0096__b984273212127">Create Bucket Policy</strong> dialog box is displayed.</span></li><li id="obs_03_0096__li17931032163517"><span>Configure parameters according to the following table, so that you can grant anonymous users the permission to access the folder and objects in it:</span><p>
<div class="section" id="obs_03_0096__section17557163019204"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0096__en-us_topic_0056349953_ol62991470"><li id="obs_03_0096__li99821455306"><span>In the bucket list, click the bucket you want to operate. The <strong id="obs_03_0096__obs_03_0307_b1395123914108">Overview</strong> page of the bucket is displayed.</span></li><li id="obs_03_0096__li19853957175612"><span>In the navigation pane on the left, click <strong id="obs_03_0096__obs_03_0142_b63882047163712">Permissions</strong> to go to the permission management page.</span></li><li id="obs_03_0096__li8120153165517"><span>Choose <strong id="obs_03_0096__b23113213129">Bucket Policies</strong> &gt; <strong id="obs_03_0096__b19512328126">Custom Bucket Policies</strong>.</span></li><li id="obs_03_0096__li81441540133419"><span>Click <strong id="obs_03_0096__b4839432131212">Create Bucket Policy</strong>. The <strong id="obs_03_0096__b984273212127">Create Bucket Policy</strong> dialog box is displayed.</span></li><li id="obs_03_0096__li17931032163517"><span>Configure parameters according to the following table, so that you can grant anonymous users the permission to access the folder and objects in it:</span><p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0096__table7531653104420" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters for authorizing the permission to access a specified bucket</caption><thead align="left"><tr id="obs_03_0096__row2532105311447"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.2.2.5.2.1.2.3.1.1"><p id="obs_03_0096__p16532195364414">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.2.2.5.2.1.2.3.1.2"><p id="obs_03_0096__p15532145310443">Value</p>

View File

@ -5,7 +5,7 @@
<p id="obs_03_0110__p1917517275013"><span id="obs_03_0110__ph9419171385810">IAM policies</span> define the actions that can be performed on your cloud resources. In other words, <span id="obs_03_0110__ph236280132513">IAM policies</span> specify what actions are allowed or denied.</p>
<p id="obs_03_0110__p05651517436"><span id="obs_03_0110__ph1176871632515">IAM policies</span> with OBS permissions take effect on all OBS buckets and objects. To grant an IAM user the permission to operate OBS resources, you need to assign one or more OBS permission sets to the user group to which the user belongs.</p>
<p id="obs_03_0110__p91962611510">For details about OBS permissions controlled by IAM policies, see <a href="obs_03_0045.html">Permissions Management</a>.</p>
<div class="section" id="obs_03_0110__section01904185241"><h4 class="sectiontitle">IAM Policies Application Scenarios</h4><p id="obs_03_0110__p101714434165"><span id="obs_03_0110__ph3383454122516">IAM policies</span> are used to authorize IAM users under an account.</p>
<div class="section" id="obs_03_0110__section01904185241"><h4 class="sectiontitle"><span id="obs_03_0110__ph6172205042519">IAM policies</span> Application Scenarios</h4><p id="obs_03_0110__p101714434165"><span id="obs_03_0110__ph3383454122516">IAM policies</span> are used to authorize IAM users under an account.</p>
<ul id="obs_03_0110__ul319124042416"><li id="obs_03_0110__li244101111715">Controlling permissions to cloud resources as a whole under an account</li><li id="obs_03_0110__li81911640122419">Controlling permissions to all OBS buckets and objects under an account</li></ul>
</div>
<div class="section" id="obs_03_0110__section9268135516548"><h4 class="sectiontitle">Policy Structure and Syntax</h4><p id="obs_03_0110__p232429165515">A policy consists of a version and statements. Each policy can have multiple statements.</p>
@ -51,7 +51,7 @@
</table>
</div>
</div>
<div class="section" id="obs_03_0110__section477513429495"><h4 class="sectiontitle">Authentication of IAM Policies</h4><p id="obs_03_0110__p15598157105013">The authentication of <span id="obs_03_0110__ph594911718268">IAM policies</span> starts from the Deny statements. The following figure shows the authentication logic for resource access.</p>
<div class="section" id="obs_03_0110__section477513429495"><h4 class="sectiontitle">Authentication of <span id="obs_03_0110__ph34931313182620">IAM policies</span></h4><p id="obs_03_0110__p15598157105013">The authentication of <span id="obs_03_0110__ph594911718268">IAM policies</span> starts from the Deny statements. The following figure shows the authentication logic for resource access.</p>
<div class="fignone" id="obs_03_0110__fig1757455075016"><span class="figcap"><b>Figure 2 </b>Authentication logic</span><br><span><img id="obs_03_0110__image957465075018" src="en-us_image_0170555653.png"></span></div>
<div class="note" id="obs_03_0110__note45325275118"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0110__p874985965112">The actions in each policy bear the OR relationship.</p>
</div></div>

View File

@ -1,7 +1,7 @@
<a name="obs_03_0122"></a><a name="obs_03_0122"></a>
<h1 class="topictitle1">Creating a User and Granting OBS Permissions</h1>
<div id="body1558061572625"><div class="section" id="obs_03_0122__section35143124418"><h4 class="sectiontitle">Process</h4><div class="fignone" id="obs_03_0122__fig292324264713"><span class="figcap"><b>Figure 1 </b>Granting an IAM user the access permissions to OBS</span><br><span><img id="obs_03_0122__image12924124212474" src="en-us_image_0170301902.png"></span></div>
<div id="body1558061572625"><div class="section" id="obs_03_0122__section35143124418"><h4 class="sectiontitle">Process</h4><div class="fignone" id="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_0122__image12924124212474" src="en-us_image_0170301902.png"></span></div>
</div>
<div class="section" id="obs_03_0122__section2074420567337"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_0122__ol63831030102"><li id="obs_03_0122__li35354147174321"><span>Log in to the management console using a cloud service account.</span></li><li id="obs_03_0122__li5853192561010"><span>On the top navigation menu, choose <strong id="obs_03_0122__b19603113671814">Service List</strong> &gt; <strong id="obs_03_0122__b3603103615186">Management &amp; Deployment</strong> &gt; <strong id="obs_03_0122__b460310368184">Identity and Access Management</strong>. The IAM console page is displayed.</span></li><li id="obs_03_0122__li257313485116"><span>Create a user group and grant the OBS permissions to the user group.</span><p><div class="p" id="obs_03_0122__p371751915195">User groups facilitate centralized user management and streamlined permissions management. Users in the same user group have the same permissions. Users created in IAM inherit permissions from the groups to which they belong.<ol type="a" id="obs_03_0122__ol28671118201912"><li id="obs_03_0122__li78661718151913">In the navigation pane on the left, click <strong id="obs_03_0122__b17624165682216">User Groups</strong>. The <strong id="obs_03_0122__b4625115617224">User Groups</strong> page is displayed.</li><li id="obs_03_0122__li286617189195">Click <span class="uicontrol" id="obs_03_0122__uicontrol230942777211457"><b>Create User Group</b></span>.</li><li id="obs_03_0122__li1886641801917">On the <strong id="obs_03_0122__b1190011522266">Create User Group</strong> page, enter a name for the user group and click <strong id="obs_03_0122__b7542112222713">OK</strong>.<p id="obs_03_0122__p3866171841910">The user group is displayed in the user group list once the creation completes.</p>
</li><li id="obs_03_0122__li19866191819199">Click <strong id="obs_03_0122__b1406172416567">Modify</strong> in the <strong id="obs_03_0122__b12813112718562">Operation</strong> column of the row where the created user group resides.</li><li id="obs_03_0122__li1286721818193">In the <strong id="obs_03_0122__b1813981018595">Group Permissions</strong> area, locate <strong id="obs_03_0122__b166361281309">OBS (S3)</strong>, click <strong id="obs_03_0122__b145811817302">Attach Policy</strong> in the <strong id="obs_03_0122__b151884218015">Operation</strong> column, select the policy name, and click <strong id="obs_03_0122__b112537337019">OK</strong>.<div class="note" id="obs_03_0122__note12867161811198"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0122__p128671018121916">In the <strong id="obs_03_0122__b1318212383618">Policy Information</strong> area, you can view the details about the policy.</p>

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