doc-exports/docs/obs/api-ref/obs_04_0108.html
zhangyue a51a411ad8 OBS API DOC
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2023-10-27 13:05:29 +00:00

253 lines
17 KiB
HTML

<a name="obs_04_0108"></a><a name="obs_04_0108"></a>
<h1 class="topictitle1">API Operations Related to Server-Side Encryption</h1>
<div id="body33216193"><p class="msonormal" id="obs_04_0108__p65058073">This section lists the operations related to server-side encryption and describes HTTP protocols applicable to the operations. </p>
<p class="msonormal" id="obs_04_0108__p48651751">The following table describes the requirements on the transmission protocols used by the API operation related to server-side encryption.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0108__table35212576" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Requirements for the transmission protocol used by the operations related to the SSE-C</caption><thead align="left"><tr id="obs_04_0108__row64295802"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.3.1.1"><p id="obs_04_0108__p40577456">Operation</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.3.1.2"><p id="obs_04_0108__p65548540">Transfer Protocol</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0108__row7831491"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="obs_04_0108__p30371055">PutObject</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="obs_04_0108__p44136424">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row61683501"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="obs_04_0108__p30307651">PostObject</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="obs_04_0108__p39000666">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row15461677"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="obs_04_0108__p44436328">InitiateMultipartUpload</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="obs_04_0108__p42572791">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row47610802"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="obs_04_0108__p31269723">HeadObject</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="obs_04_0108__p49819596">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row45723183"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="obs_04_0108__p12590368">GetObject</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="obs_04_0108__p13186926">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row51573475"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="obs_04_0108__p16701959">UploadPart</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="obs_04_0108__p10681402">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row29023762"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.1 "><p id="obs_04_0108__p2114530">CompleteMultipartUpload</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2 "><p id="obs_04_0108__p37059222">HTTP or HTTPS</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0108__table48477735" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Requirements for the transfer protocol used by the operations related to the SSE-KMS</caption><thead align="left"><tr id="obs_04_0108__row16353437"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.2.3.1.1"><p id="obs_04_0108__p49560052">Operation</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.2.3.1.2"><p id="obs_04_0108__p54941238">Transfer Protocol</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0108__row21055309"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0108__p27758497">PutObject</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0108__p33845785">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row36176614"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0108__p44624656">PostObject</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0108__p57827411">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row50684653"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0108__p11816199">InitiateMultipartUpload</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0108__p17588045">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row24074685"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0108__p3892465">HeadObject</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0108__p46854278">HTTP or HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row19035324"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0108__p65466309">GetObject</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0108__p1170818">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row10537368"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0108__p48220479">UploadPart</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0108__p13544718">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row54793605"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0108__p9096996">CompleteMultipartUpload</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0108__p65768064">HTTP or HTTPS</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0108__table33646436" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Requirements for transfer protocol used by the CopyObject operation</caption><thead align="left"><tr id="obs_04_0108__row52435709"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.2.4.1.1"><p id="obs_04_0108__p19434056">Source Object</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.2.4.1.2"><p id="obs_04_0108__p30654716">Target Object</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.2.4.1.3"><p id="obs_04_0108__p4031">Transfer Protocol</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0108__row326588"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0108__p26453657">Non-encrypted object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0108__p62371454">Object encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0108__p18923028">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row36089529"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0108__p37570714">Object encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0108__p23329025">Object encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0108__p10602835">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row28316657"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0108__p11947857">Object encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0108__p28252370">Object encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0108__p6740635">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row60665723"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0108__p14976516">Non-encrypted object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0108__p5138282">Object encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0108__p13547668">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row54820150"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0108__p11247170">Object encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0108__p38605574">Object encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0108__p40043819">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row24850057"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0108__p66697634">Object encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0108__p33799279">Object encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0108__p53387097">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row10721828"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0108__p63161731">Non-encrypted object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0108__p15826611">Non-encrypted object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0108__p6887132">HTTP or HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row61984189"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0108__p54663373">Object encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0108__p65657065">Non-encrypted object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0108__p16622074">HTTP or HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row15380946"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0108__p37897133">Object encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0108__p49768945">Non-encrypted object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0108__p4752708">HTTP or HTTPS</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0108__table34382472" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Requirements for the transfer protocol used by the UploadPart-Copy operation</caption><thead align="left"><tr id="obs_04_0108__row5659985"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.2.4.1.1"><p id="obs_04_0108__p55805606">Source Object</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.2.4.1.2"><p id="obs_04_0108__p23960215">Target Part</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.2.4.1.3"><p id="obs_04_0108__p61729294">Transfer Protocol</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0108__row34016880"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="obs_04_0108__p3903911">Non-encrypted object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="obs_04_0108__p47781403">Part encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="obs_04_0108__p45088435">HTTP or HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row3142736"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="obs_04_0108__p53235098">Object encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="obs_04_0108__p17075709">Part encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="obs_04_0108__p40955168">HTTP or HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row33052193"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="obs_04_0108__p59981959">Object encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="obs_04_0108__p26700547">Part encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="obs_04_0108__p15260666">HTTP or HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row3128272"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="obs_04_0108__p52063502">Non-encrypted object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="obs_04_0108__p56394108">Part encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="obs_04_0108__p4520002">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row40680022"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="obs_04_0108__p6747476">Object encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="obs_04_0108__p9674687">Part encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="obs_04_0108__p45452158">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row6416241"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="obs_04_0108__p49953482">Object encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="obs_04_0108__p19700203">Part encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="obs_04_0108__p52212605">HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row151399"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="obs_04_0108__p12263397">Non-encrypted object</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="obs_04_0108__p53811111">Non-encrypted part</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="obs_04_0108__p63732758">HTTP or HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row36723913"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="obs_04_0108__p21847014">Object encrypted using SSE-KMS</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="obs_04_0108__p24777699">Non-encrypted part</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="obs_04_0108__p60836584">HTTP or HTTPS</p>
</td>
</tr>
<tr id="obs_04_0108__row10658350"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.1 "><p id="obs_04_0108__p58019987">Object encrypted using SSE-C</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.2 "><p id="obs_04_0108__p1998484">Non-encrypted part</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.4.1.3 "><p id="obs_04_0108__p27659547">HTTP or HTTPS</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0104.html">Server-Side Encryption</a></div>
</div>
</div>