vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/s3api/en-us_topic_0125560479.html
Jawei, Li 1a4c1a720a OBS s3api 2.0.38.SP5 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Jawei, Li <lijiawei5@huawei.com>
Co-committed-by: Jawei, Li <lijiawei5@huawei.com>
2022-11-16 14:51:13 +00:00

129 lines
12 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="EN-US_TOPIC_0125560479"></a><a name="EN-US_TOPIC_0125560479"></a>
<h1 class="topictitle1">Locating a Resource</h1>
<div id="body22942434"><p id="EN-US_TOPIC_0125560479__p10311542151516">In REST, specific network information or data on a network is represented by a resource, which is identified with a uniform resource identifier (URI). Clients on a network can locate resources using unified resource locator (URL).</p>
<p id="EN-US_TOPIC_0125560479__p15318420155">In OBS, a resource can be a bucket, object, or specific resource related to a bucket or object. These resources are identified by a URL and can be operated after requests are sent using the URL.</p>
<p id="EN-US_TOPIC_0125560479__p48390935">The following provides a common URL format. The parameters in brackets ([ ]) are optional.</p>
<p id="EN-US_TOPIC_0125560479__p32865237"><strong id="EN-US_TOPIC_0125560479__b86395508261">protocol://<strong id="EN-US_TOPIC_0125560479__b11957194218255">[</strong>bucket.<strong id="EN-US_TOPIC_0125560479__b2290144912250">]</strong>domain[:port][/object][?param]</strong></p>
<p id="EN-US_TOPIC_0125560479__p27351677"><a href="#EN-US_TOPIC_0125560479__table6854763">Table 1</a> describes URL parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560479__table6854763"></a><a name="table6854763"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560479__table6854763" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URL parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0125560479__row62517084"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.2.4.1.1"><p id="EN-US_TOPIC_0125560479__p30719029">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.2.4.1.2"><p id="EN-US_TOPIC_0125560479__p5213419">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.2.4.1.3"><p id="EN-US_TOPIC_0125560479__p19633765">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560479__row46831115"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p35224007">protocol</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p34572286">Indicates the protocol used for sending requests. Available values are HTTP and HTTPS.</p>
<p id="EN-US_TOPIC_0125560479__p42715124">You can specify HTTPS to ensure secure access to resources.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p37373042">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560479__row9725192119323"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p1795522173216">bucket</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p2795122233217">Indicates the path of a bucket. Each path identifies a unique bucket in OBS.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p379542210327">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560479__row1551231193113"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p135344812156">domain</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p323103261516">Domain name or IP address of the server for saving resources.</p>
<div class="notice" id="EN-US_TOPIC_0125560479__note3123154303113"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="EN-US_TOPIC_0125560479__p18123164318319">The name of the host in this document is used as an example. Please refer to the actual information when accessing OBS. Obtain this value from <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p125929367153">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560479__row14240860"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p12659036">port</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p18749013">Indicates the port enabled for protocols used for sending requests. The value varies with software server deployment. If the value is not specified, default ports are enabled. Normally, ports <strong id="EN-US_TOPIC_0125560479__b34523390">80</strong> and <strong id="EN-US_TOPIC_0125560479__b42275054">443</strong> are enabled by default for HTTP and HTTPS, respectively. In the OBS, ports <strong id="EN-US_TOPIC_0125560479__b3401794814523">80</strong> and <strong id="EN-US_TOPIC_0125560479__b171211557194911">443</strong> are enabled by default for HTTP and HTTPS, respectively.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p5694497">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560479__row17855085"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p36975818">object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p42251271">Indicates the path of an object.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p66909772">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560479__row65317042"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p56189015">param</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p55016344">Indicates the specific resource related to a bucket or object. If this parameter is not specified, the bucket or object itself is operated.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p27138911">Optional</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="notice" id="EN-US_TOPIC_0125560479__note8040347"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0125560479__p198361550141610">The recommended protocol is HTTPS, because HTTP security is inefficient.</p>
<p id="EN-US_TOPIC_0125560479__p20836135011165">HTTPS supports TLS1.1 and TLS1.2, but not TLS1.0.</p>
</div></div>
<div class="section" id="EN-US_TOPIC_0125560479__section2151171715919"><h4 class="sectiontitle">Basic Concepts Involved in Regions and Domain Name-based Access</h4><p id="EN-US_TOPIC_0125560479__p122601515930">The following table describes the concepts involved in regions and domain name–based access, for example, global domain name.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560479__table1103414015930" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Basic concepts</caption><thead align="left"><tr id="EN-US_TOPIC_0125560479__row6693569315930"><th align="left" class="cellrowborder" valign="top" width="26.529999999999998%" id="mcps1.3.8.3.2.4.1.1"><p id="EN-US_TOPIC_0125560479__p5308203515930">Concept</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="26.529999999999998%" id="mcps1.3.8.3.2.4.1.2"><p id="EN-US_TOPIC_0125560479__p467761515930">Example</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.94%" id="mcps1.3.8.3.2.4.1.3"><p id="EN-US_TOPIC_0125560479__p4334250215930">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560479__row2108179415930"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p2990378715930">Global domain name</p>
</td>
<td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p628768815930">obs.example.com</p>
</td>
<td class="cellrowborder" valign="top" width="46.94%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p3954073815930">Unique global domain name of the multi-region cluster. The domain name serves as the unified access point of OBS in the cluster.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560479__row2032232515930"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p3549562015930">Region type</p>
</td>
<td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p5657299615930">Default region</p>
</td>
<td class="cellrowborder" valign="top" width="46.94%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p1900998115930">Regions are divided into the default region and non-default region. There is only one default region in a multi-region cluster. Other regions are non-default regions.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560479__row3687210215930"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p3385024615930">Region name</p>
</td>
<td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p5751537815930">region2</p>
</td>
<td class="cellrowborder" valign="top" width="46.94%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p2823406715930">Name of the default region or a non-default region.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560479__row5278001915930"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p4732316615930">Region domain name</p>
</td>
<td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p797125015930">region2.example.com</p>
</td>
<td class="cellrowborder" valign="top" width="46.94%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p4169147715930">Each region can have a domain name, which serves as the access point of OBS in the region.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560479__row3967898115930"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560479__p5988090115930">Virtual hosting style</p>
</td>
<td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560479__p1851479315930">mybucket.region2.example.com or mybucket.obs.example.com</p>
</td>
<td class="cellrowborder" valign="top" width="46.94%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560479__p2330325815930">The virtual hosting style is a style where buckets are accessed as hosts.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0125560479__p3717521119046">In cross-region interaction, requests may be redirected. The system will handle all requests from client, but not all of the requests will be recorded in metering file. (eg. 301 redirect request.)</p>
<p id="EN-US_TOPIC_0125560479__p5840208119046">It does not incur re-metering problems. (If users access the global firstly and then jump to a local bucket, there is only one Charging Data Record.)</p>
<p id="EN-US_TOPIC_0125560479__p6706291915930">OBS supports virtual hosting-style access to all regions.</p>
<p id="EN-US_TOPIC_0125560479__p2899977715930">If you want to use virtual hosting-style access, the correct URI is <strong id="EN-US_TOPIC_0125560479__b5967140315930">http://mybucket.region2.example.com</strong> or <strong id="EN-US_TOPIC_0125560479__b17172215930">http://mybucket.obs.example.com</strong>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560289.html">OBS REST APIs</a></div>
</div>
</div>
View Git Blame Copy Permalink