doc-exports/docs/obs/umn/en-us_topic_0045853662.html

<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">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 id="en-us_topic_0045853662__obs_03_0306_p193383292614"></p>
<p id="en-us_topic_0045853662__obs_03_0306_p21281164513"></p>
</p></li><li id="en-us_topic_0045853662__obs_03_0306_li14812171815257"><span>Configure bucket parameters.</span><p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0045853662__obs_03_0306_table9210201853617" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Bucket parameters</caption><thead align="left"><tr id="en-us_topic_0045853662__obs_03_0306_row13210518113615"><th align="left" class="cellrowborder" valign="top" width="20.22%" id="mcps1.3.3.2.2.2.1.2.3.1.1"><p id="en-us_topic_0045853662__obs_03_0306_p1121013185365">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="79.78%" id="mcps1.3.3.2.2.2.1.2.3.1.2"><p id="en-us_topic_0045853662__obs_03_0306_p20210111833619">Description</p>
</th>
</tr>
</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 latency and faster access, select the region nearest to you. 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, 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 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>
</tr>
<tr id="en-us_topic_0045853662__obs_03_0306_row132101185362"><td class="cellrowborder" valign="top" width="20.22%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="en-us_topic_0045853662__obs_03_0306_p18210181833614">Storage Class</p>
</td>
<td class="cellrowborder" valign="top" width="79.78%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="en-us_topic_0045853662__obs_03_0306_p2914586010533">Storage classes of a bucket. Different storage classes meet different requirements for storage performance and costs.</p>

<ul id="en-us_topic_0045853662__obs_03_0306_ul386215378248"><li id="en-us_topic_0045853662__obs_03_0306_li16862137182411">The Standard storage class is for storing a large number of hot files or small files that are frequently accessed (multiple times per month on average) and require quick retrieval.</li><li id="en-us_topic_0045853662__obs_03_0306_li113541355942">The Warm storage class is for storing data that is less frequently accessed (less than 12 times per year on average) and requires quick retrieval.</li><li id="en-us_topic_0045853662__obs_03_0306_li1046755918114">The Cold storage class is for archiving data that is rarely accessed (once a year on average) and has no requirements for quick retrieval.</li></ul>
<p id="en-us_topic_0045853662__obs_03_0306_p859325514419">For details, see <a href="en-us_topic_0050937852.html">Storage Classes Overview</a>.</p>
</td>
</tr>
<tr id="en-us_topic_0045853662__obs_03_0306_row162107185362"><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_p1621051833618">Bucket Policy</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_p13250952104514">Controls read and write permissions for buckets.</p>
<ul id="en-us_topic_0045853662__obs_03_0306_ul1118618569194"><li id="en-us_topic_0045853662__obs_03_0306_li13186185612196"><strong id="en-us_topic_0045853662__obs_03_0306_b929114841213">Private</strong>: No access beyond the bucket ACL settings is granted.</li><li id="en-us_topic_0045853662__obs_03_0306_li181131478206"><strong id="en-us_topic_0045853662__obs_03_0306_b116813342311">Public Read</strong>: Anyone can read objects in the bucket.</li><li id="en-us_topic_0045853662__obs_03_0306_li147015152013"><strong id="en-us_topic_0045853662__obs_03_0306_b1492156122319">Public Read and Write</strong>: Anyone can read, write, or delete objects in the bucket.</li></ul>
</td>
</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"><span id="en-us_topic_0045853662__obs_03_0306_ph134131716113417">Server-Side Encryption</span></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_p101449501186">Select <strong id="en-us_topic_0045853662__obs_03_0306_b29702053411">SSE-KMS</strong>. For the encryption key type, you can choose <strong id="en-us_topic_0045853662__obs_03_0306_b579443413814">Default</strong> or <strong id="en-us_topic_0045853662__obs_03_0306_b10118103743814">Custom</strong>. If <strong id="en-us_topic_0045853662__obs_03_0306_b115871031133912">Default</strong> is chosen, the default key of the current region will be used to encrypt your objects. If there is no such a default key, OBS creates one the first time you upload an object. If <strong id="en-us_topic_0045853662__obs_03_0306_b151748569424">Custom</strong> is chosen, you can choose a custom key you created on the KMS console to encrypt your objects.</p>
<p id="en-us_topic_0045853662__obs_03_0306_p299191615618">If you do not need server-side encryption, keep the default selection of <strong id="en-us_topic_0045853662__obs_03_0306_b1395031416164">Disable</strong>.</p>
<p id="en-us_topic_0045853662__obs_03_0306_p1112821912617">After you enable server-side encryption for the bucket, any object you upload to it will inherit encryption from the bucket by default. You can also configure new encryption with SSE-KMS for the object.</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>
</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_p1337311331278">Optional. Tags are used to identify and classify buckets in OBS. Each tag is represented by a key-value pair.</p>
<p id="en-us_topic_0045853662__obs_03_0306_p293184875012">For more information, see <a href="en-us_topic_0059888284.html">Tag Overview</a>.</p>
</td>
</tr>
</tbody>
</table>
</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">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">If you do not specify a storage class for an object when uploading it, it inherits the bucket's storage class by default. After the bucket's storage class is changed, newly uploaded objects will inherit the new storage class of the bucket by default.</li></ul>
</div></div>
</p></li></ol>
<p id="en-us_topic_0045853662__p983108915817"></p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0311.html">Managing Buckets</a></div>
</div>
</div>


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