doc-exports/docs/obs/umn/obs_03_0046.html
zhangyue b55201d729 OBS UMN DOC
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2024-03-18 15:39:30 +00:00

33 lines
5.5 KiB
HTML

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