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

<a name="en-us_topic_0045853663"></a><a name="en-us_topic_0045853663"></a>

<h1 class="topictitle1">Uploading an Object</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">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 one 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 those with the same name 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, see <a href="obs_03_0316.html">Creating a Folder</a>.</li></ul>
</div>
<div class="section" id="en-us_topic_0045853663__section64292661113931"><h4 class="sectiontitle">Procedure</h4><ol id="en-us_topic_0045853663__obs_03_0307_ol658192291912"><li id="en-us_topic_0045853663__obs_03_0307_li1596440151221"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853663__obs_03_0307_b144421021120">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853663__obs_03_0307_li123641720664"><span>In the navigation pane, choose <strong id="en-us_topic_0045853663__obs_03_0307_b51941856151917">Objects</strong>.</span></li><li id="en-us_topic_0045853663__obs_03_0307_li46803166594"><span>Go to the folder where you want to upload files and click <strong id="en-us_topic_0045853663__obs_03_0307_b0882125105511">Upload Object</strong>. The <strong id="en-us_topic_0045853663__obs_03_0307_b6293181115555">Upload Object</strong> dialog box is displayed.</span><p><div class="note" id="en-us_topic_0045853663__obs_03_0307_note186461450113113"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853663__obs_03_0307_p14504161520198">If the files that you want to upload to OBS are stored in Microsoft OneDrive, it is recommended that the names of these files contain a maximum of 32 characters to ensure compatibility.</p>
</div></div>
<div class="fignone" id="en-us_topic_0045853663__obs_03_0307_fig188654349118"><span class="figcap"><b>Figure 1 </b>Uploading objects</span><br><span><img id="en-us_topic_0045853663__obs_03_0307_image10536191814483" src="en-us_image_0153827167.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="en-us_topic_0045853663__obs_03_0307_p1430017260138"></p>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li8341913385"><span>Select a storage class. If you do not specify a storage class, the objects you upload inherit the default storage class of the bucket.</span><p><div class="note" id="en-us_topic_0045853663__obs_03_0307_note27281163408"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0045853663__obs_03_0307_p15728186194013">An object can have a different storage class from its bucket. You can specify a storage class for an object when uploading it, or you can change the object storage class after the object is uploaded.</p>
</div></div>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li43271656164119"><span>In the <strong id="en-us_topic_0045853663__obs_03_0307_b120411138146">Upload Object</strong> area, drag and drop the files or folders you want to upload.</span><p><p id="en-us_topic_0045853663__obs_03_0307_p5316155610415">You can also click <strong id="en-us_topic_0045853663__obs_03_0307_b19478223144319">add files</strong> to select files.</p>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li74481344102111"><span>(Optional) Select <strong id="en-us_topic_0045853663__obs_03_0307_b16368281536">KMS encryption</strong> to encrypt the uploaded file. For details, see <a href="obs_03_0322.html">Enabling Server-Side Encryption When Uploading an Object</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 bucket has <span id="en-us_topic_0045853663__obs_03_0307_ph1851173616343">server-side encryption</span> enabled, any object you upload will inherit the KMS encryption from the bucket by default.</p>
</div></div>
</p></li><li id="en-us_topic_0045853663__obs_03_0307_li12125192695311"><span>Click <strong id="en-us_topic_0045853663__obs_03_0307_b1918611133719">Upload</strong>.</span></li></ol>
</div>
<div class="section" id="en-us_topic_0045853663__section2680481145652"><h4 class="sectiontitle">Related Operations</h4><p id="en-us_topic_0045853663__p61538082105347">When uploading an object, you can specify a storage class for it. After the object is uploaded, you can also change its storage class by doing as follows:</p>
<ol id="en-us_topic_0045853663__ol54196626"><li id="en-us_topic_0045853663__li94697228416"><span>In the bucket list, click the bucket you want to operate. The <strong id="en-us_topic_0045853663__obs_03_0307_b144421021120_1">Overview</strong> page is displayed.</span></li><li id="en-us_topic_0045853663__li1733753692411"><span>In the navigation pane, choose <strong id="en-us_topic_0045853663__obs_03_0307_b51941856151917_1">Objects</strong>.</span></li><li id="en-us_topic_0045853663__li45807892175717"><span>Select the target object and choose <strong id="en-us_topic_0045853663__b16331938401184">More</strong> &gt; <strong id="en-us_topic_0045853663__b4308642191184">Change Storage Class</strong> on the right.</span><p><p id="en-us_topic_0045853663__p7418134211011"></p>
</p></li><li id="en-us_topic_0045853663__li65518593175554"><span>Select the desired storage class and click <strong id="en-us_topic_0045853663__b6082718214515">OK</strong>.</span></li></ol>
<div class="note" id="en-us_topic_0045853663__note49933437105659"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0045853663__ul48955806162444"><li id="en-us_topic_0045853663__li8253143619589">You can manually change objects between storage classes. <ul id="en-us_topic_0045853663__ul14731091714"><li id="en-us_topic_0045853663__li4530321719">From Standard to Warm or Cold</li><li id="en-us_topic_0045853663__li102675352115">From Warm to Standard or Cold</li><li id="en-us_topic_0045853663__li18917418162447">From Cold to Standard or Warm. Before changing Cold objects, you must restore them first.</li></ul>
</li><li id="en-us_topic_0045853663__li377814260432">After an object is changed to Cold, its restore status changes to <strong id="en-us_topic_0045853663__b6402207131517">Unrestored</strong>.</li><li id="en-us_topic_0045853663__li20206156162444">You can also configure a lifecycle rule to change the storage class of an object. For details, see <a href="obs_03_0335.html">Configuring a Lifecycle Rule</a>.</li></ul>
</div></div>
</div>
<div class="section" id="en-us_topic_0045853663__section6158112111499"><h4 class="sectiontitle">Follow-up Procedure</h4><p id="en-us_topic_0045853663__p12984525104914">You can click <strong id="en-us_topic_0045853663__b749072512715">Copy Path</strong> on the right of an object to copy its path.</p>
<p id="en-us_topic_0045853663__p277211333145">You can share the path with others. Then they can open the bucket where the object is stored and enter the path in the search box above the object list to find the object.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0315.html">Managing Objects</a></div>
</div>
</div>


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