doc-exports/docs/obs/tool/obs_03_1041.html

<a name="obs_03_1041"></a><a name="obs_03_1041"></a>

<h1 class="topictitle1">Creating a Bucket</h1>
<div id="body0000001194570596"><p id="obs_03_1041__p478014851820">Buckets are containers that store objects in OBS. To store data in OBS, you must first create a bucket.</p>
<div class="section" id="obs_03_1041__section14471551102314"><h4 class="sectiontitle">Procedure</h4><ol id="obs_03_1041__ol149378171240"><li id="obs_03_1041__li13937101742418"><span>Log in to OBS Browser+.</span></li><li id="obs_03_1041__li057214120241"><span>In the upper part of the page, click <strong id="obs_03_1041__b9582938202612">Create Bucket</strong>.</span></li><li id="obs_03_1041__li65531125122714"><span>In the displayed dialog box, configure bucket parameters, as shown in <a href="#obs_03_1041__fig3347646295529">Figure 1</a>.</span><p><div class="fignone" id="obs_03_1041__fig3347646295529"><a name="obs_03_1041__fig3347646295529"></a><a name="fig3347646295529"></a><span class="figcap"><b>Figure 1 </b>Creating a bucket</span></div>
<p id="obs_03_1041__p11670415135711"></p>
<p id="obs_03_1041__p199762196017"></p>
<p id="obs_03_1041__p15670141511570"></p>
<p id="obs_03_1041__p19670101525716"><span><img id="obs_03_1041__image1185416511242" src="en-us_image_0000001267755821.png" title="Click to enlarge" class="imgResize"></span></p>

<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_1041__table1667181525716" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Bucket creation parameters</caption><thead align="left"><tr id="obs_03_1041__row1867061545716"><th align="left" class="cellrowborder" valign="top" width="24.43%" id="mcps1.3.2.2.3.2.6.2.3.1.1"><p id="obs_03_1041__p17670115195713">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.57000000000001%" id="mcps1.3.2.2.3.2.6.2.3.1.2"><p id="obs_03_1041__p667013152572">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_1041__row567061515574"><td class="cellrowborder" valign="top" width="24.43%" headers="mcps1.3.2.2.3.2.6.2.3.1.1 "><p id="obs_03_1041__p467016150573">Region</p>
</td>
<td class="cellrowborder" valign="top" width="75.57000000000001%" headers="mcps1.3.2.2.3.2.6.2.3.1.2 "><p id="obs_03_1041__p83041812183015">Enter the region where you want to create a bucket. Once the bucket is created, its region cannot be changed.</p>
</td>
</tr>
<tr id="obs_03_1041__row367031515713"><td class="cellrowborder" valign="top" width="24.43%" headers="mcps1.3.2.2.3.2.6.2.3.1.1 "><p id="obs_03_1041__p16701615205713">Storage Class</p>
</td>
<td class="cellrowborder" valign="top" width="75.57000000000001%" headers="mcps1.3.2.2.3.2.6.2.3.1.2 "><p id="obs_03_1041__p7670161515712">Storage class of the bucket. Different storage classes meet customers' needs for storage performance and costs.</p>
<ul id="obs_03_1041__ul36702157575"><li id="obs_03_1041__li1067019155573"><strong id="obs_03_1041__b109311371120">Standard</strong>: applicable to scenarios where a large number of hot files or small files need to be accessed frequently (multiple times per month on average) and require fast access response.</li><li id="obs_03_1041__li56705159577"><strong id="obs_03_1041__b1517111442318">Warm</strong>: ideal for storing data that is not frequently accessed (less than 12 times per year on average) but requires fast access response.</li><li id="obs_03_1041__li267091535715"><strong id="obs_03_1041__b1916215138413">Cold</strong>: suitable for archiving data that is rarely accessed (averagely once a year) and has no requirements for quick response.</li></ul>
</td>
</tr>
<tr id="obs_03_1041__row4671111519579"><td class="cellrowborder" valign="top" width="24.43%" headers="mcps1.3.2.2.3.2.6.2.3.1.1 "><p id="obs_03_1041__p1367061518578">Bucket ACL</p>
</td>
<td class="cellrowborder" valign="top" width="75.57000000000001%" headers="mcps1.3.2.2.3.2.6.2.3.1.2 "><p id="obs_03_1041__p967091545718">Controls read and write permissions on buckets.</p>
<ul id="obs_03_1041__ul16716158579"><li id="obs_03_1041__li17670121515719"><strong id="obs_03_1041__b15797142310467">Private</strong>: Only users granted permissions by the ACL can access the bucket.</li><li id="obs_03_1041__li567121595717"><strong id="obs_03_1041__b628912018482">Public Read</strong>: Anyone can read objects in the bucket.</li><li id="obs_03_1041__li16671111575714"><strong id="obs_03_1041__b15584185464711">Public Read and Write</strong>: Anyone can read, write, or delete objects in the bucket.</li></ul>
</td>
</tr>
<tr id="obs_03_1041__row1967112154572"><td class="cellrowborder" valign="top" width="24.43%" headers="mcps1.3.2.2.3.2.6.2.3.1.1 "><p id="obs_03_1041__p8671181515575">Bucket Name</p>
</td>
<td class="cellrowborder" valign="top" width="75.57000000000001%" headers="mcps1.3.2.2.3.2.6.2.3.1.2 "><p id="obs_03_1041__p5671171535712">Name of the bucket you want to create, which must be globally unique. A bucket name:</p>
<ul id="obs_03_1041__ul1467131545716"><li id="obs_03_1041__li0671315125716">Must be 3 to 63 characters long and start with a digit or letter. Only lowercase letters, digits, hyphens (-), and periods (.) are allowed.</li><li id="obs_03_1041__li11671181513570">Cannot be formatted as an IP address.</li><li id="obs_03_1041__li2067131514573">Cannot start or end with a hyphen (-) or period (.).</li><li id="obs_03_1041__li5671181512575">Cannot contain two consecutive periods (..), for example, <strong id="obs_03_1041__b15775104017247">my..bucket</strong>.</li><li id="obs_03_1041__li267119159578">Cannot contain a period (.) and a hyphen (-) adjacent to each other, for example, <strong id="obs_03_1041__b4902103102510">my-.bucket</strong> or <strong id="obs_03_1041__b14902193122512">my.-bucket</strong>.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<p id="obs_03_1041__p26711815135714">You can click <span><img id="obs_03_1041__image12639151414615" src="en-us_image_0000001195698772.png"></span> next to the bucket name to learn about the bucket naming rules. A user can create a maximum of 100 buckets in OBS.</p>
<div class="note" id="obs_03_1041__note1367141519577"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_03_1041__ul16711615135714"><li class="text" id="obs_03_1041__li46711615195712">When a URL is used to access a bucket, the bucket name will become part of the URL. According to the DNS rule, URLs do not support uppercase letters and cannot recognize buckets whose name contains uppercase letters. Therefore, a bucket name can contain only lowercase letters, digits, hyphens (-), and periods (.) For example, if you attempt to access bucket <strong id="obs_03_1041__b8213105914312">MyBucket</strong> using a URL, the URL will parse <strong id="obs_03_1041__b14219113486">MyBucket</strong> as <strong id="obs_03_1041__b421311599311">mybucket</strong>. This results in an access error.</li><li id="obs_03_1041__li36715152577">DNS naming rules can standardize bucket names globally, facilitating the resolution during bucket access. With the DNS naming rules used, you can benefit from new functions and optimized features, and configure static website hosting for buckets.</li><li id="obs_03_1041__li1667191575717">Once a bucket is created, its name cannot be changed. Make sure that the bucket name you set is appropriate.</li></ul>
</div></div>
</p></li><li id="obs_03_1041__li23801610122814"><span>Click <strong id="obs_03_1041__b1995417261451">OK</strong>. If the bucket is successfully created, it is displayed in the bucket list. If the creation fails, an error message will be displayed.</span></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_1040.html">Basic Bucket Operations</a></div>
</div>
</div>


<script language="JavaScript">
<!--
image_size('.imgResize');
var msg_imageMax = "view original image";
var msg_imageClose = "close";
//--></script>