doc-exports/docs/obs/s3api/en-us_topic_0125560363.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

51 lines
4.6 KiB
HTML

<a name="EN-US_TOPIC_0125560363"></a><a name="EN-US_TOPIC_0125560363"></a>
<h1 class="topictitle1">Sending a Request</h1>
<div id="body67085345"><p id="EN-US_TOPIC_0125560363__p3422742">OBS is based on a standard request and response model. A request sent to OBS must comply with HTTP 1.1 and headers of a request must contain OBS-defined parameters, for example, authentication fields.</p>
<p id="EN-US_TOPIC_0125560363__p30804683">Requests can be sent to OBS using multiple HTTP methods such as <strong id="EN-US_TOPIC_0125560363__b66897197">GET</strong>, <strong id="EN-US_TOPIC_0125560363__b65203863">PUT</strong>, <strong id="EN-US_TOPIC_0125560363__b49963856">POST</strong>, <strong id="EN-US_TOPIC_0125560363__b47021521">DELETE</strong>, and <strong id="EN-US_TOPIC_0125560363__b20540507">HEAD</strong>. You can send a <strong id="EN-US_TOPIC_0125560363__b50646839">GET</strong>, <strong id="EN-US_TOPIC_0125560363__b53168375">PUT</strong>, <strong id="EN-US_TOPIC_0125560363__b8753331">POST</strong>, <strong id="EN-US_TOPIC_0125560363__b11671115">DELETE</strong>, or <strong id="EN-US_TOPIC_0125560363__b37931178">HEAD</strong> request to read, create, update, delete, or obtain a resource. <a href="#EN-US_TOPIC_0125560363__table55931017">Table 1</a> describes the request methods supported by OBS REST APIs.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560363__table55931017"></a><a name="table55931017"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560363__table55931017" frame="border" border="1" rules="all"><caption><b>Table 1 </b>HTTP request methods supported by OBS REST APIs</caption><thead align="left"><tr id="EN-US_TOPIC_0125560363__row5662578"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.3.1.1"><p id="EN-US_TOPIC_0125560363__p56015673">Method</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.3.1.2"><p id="EN-US_TOPIC_0125560363__p40975656">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560363__row30693864"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560363__p3175073">GET</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560363__p55854330">Requests that the server returns a specific resource, for example, a bucket list or object.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560363__row32926922"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560363__p49834998">PUT</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560363__p10103063">Requests that the server creates a specific resource, for example, a bucket or object.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560363__row23818711"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560363__p50267458">POST</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560363__p45132310">Requests that the server performs specific operations on a specific resource, for example, initiating or completing a multipart upload.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560363__row3537606"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560363__p18110665">DELETE</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560363__p57677769">Requests that the server deletes a specific resource, for example, an object.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560363__row49337875"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560363__p36944920">HEAD</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560363__p39748558">Requests that the server returns the metadata of a specific resource, for example, object metadata.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0125560363__p12151395"></p>
<div class="section" id="EN-US_TOPIC_0125560363__section42253696"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560363__p65516636">Parameters must be specified in the headers of requests sent to OBS using OBS REST APIs. For details about headers common to OBS REST requests, see section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</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>