vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/api-ref/obs_04_0098.html
zhangyue 7d2a7ec198 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>
2024-11-05 16:37:11 +00:00

616 lines
60 KiB
HTML
Raw Permalink Blame History

<a name="obs_04_0098"></a><a name="obs_04_0098"></a>
<h1 class="topictitle1">Initiating a Multipart Upload</h1>
<div id="body13564861"><div class="section" id="obs_04_0098__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0098__p65136078">Before using this operation, make an API operation call to create a multipart upload task. The system will return a globally unique upload ID as the multipart upload identifier. You can use this ID to upload, assemble, and list parts. Create a multipart upload task does not affect the object that has the same name as object to be uploaded in multiple parts. You can create more than one multipart upload tasks for an object. This operation request can contain headers <strong id="obs_04_0098__b4711005316425">x-obs-acl</strong>, <strong id="obs_04_0098__b2532526016425">x-obs-meta-*</strong>, <strong id="obs_04_0098__b2503398216425">Content-Type</strong>, and <strong id="obs_04_0098__b4850503416425">Content-Encoding</strong>. The headers are recorded in the multipart upload metadata.</p>
<p class="msonormal" id="obs_04_0098__p49353797">This operation supports server-side encryption.</p>
</div>
<div class="section" id="obs_04_0098__section93175917597"><h4 class="sectiontitle">WORM</h4><p id="obs_04_0098__p1566012417013">If a bucket has WORM enabled, you can configure object-level retention policies when initiating multipart uploads. You can specify the <strong id="obs_04_0098__b613882112528">x-obs-object-lock-mode</strong> and <strong id="obs_04_0098__b813852113524">x-obs-object-lock-retain-until-date</strong> headers when you initiate a multipart upload to protect the object assembled. If you do not specify these two headers but have configured a default bucket-level WORM policy, this default policy automatically applies to the object newly assembled. You can also configure or update a WORM retention policy after the object is assembled.</p>
<p id="obs_04_0098__p3483153720114">Different from uploads with PUT and POST, a multipart upload only requires that the date specified in the <strong id="obs_04_0098__b11495105433716">x-obs-object-lock-retain-until-date</strong> header be no later than the initiation time, but does not have to be later than the completion time of the multipart upload. When the default bucket-level WORM policy is applied, the protection starts when the object parts are assembled and ends once the default bucket-level protection period expires. Before assembling the object parts uploaded, the multipart upload can be canceled and will not be affected by the WORM configuration.</p>
</div>
<div class="section" id="obs_04_0098__section41530990"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0098__screen2968700"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span>POST<span class="w"> </span>/ObjectName?uploads<span class="w"> </span>HTTP/1.1<span class="w"> </span>
Host:<span class="w"> </span>bucketname.obs.region.example.com
Date:<span class="w"> </span>date
Authorization:<span class="w"> </span>authorization
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0098__section38234596"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0098__p16698915">This request uses parameters to specify a multipart upload. <a href="#obs_04_0098__table53801997507">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="obs_04_0098__table53801997507"></a><a name="table53801997507"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0098__table53801997507" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0098__row638113965010"><th align="left" class="cellrowborder" valign="top" width="24.77752224777522%" id="mcps1.3.4.3.2.5.1.1"><p id="obs_04_0098__p13811996503">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="8.999100089991002%" id="mcps1.3.4.3.2.5.1.2"><p id="obs_04_0098__p15151524165012"><strong id="obs_04_0098__b186443011174">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="8.31916808319168%" id="mcps1.3.4.3.2.5.1.3"><p id="obs_04_0098__p13811695509"><strong id="obs_04_0098__b83371121715">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.90420957904209%" id="mcps1.3.4.3.2.5.1.4"><p id="obs_04_0098__p6381169195017"><strong id="obs_04_0098__b828217213179">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0098__row153818914502"><td class="cellrowborder" valign="top" width="24.77752224777522%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0098__p1138119915011">uploads</p>
</td>
<td class="cellrowborder" valign="top" width="8.999100089991002%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0098__p6381159115013">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.31916808319168%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0098__p7381298503">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="57.90420957904209%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0098__p7134184955020"><strong id="obs_04_0098__b83762767383837">Explanation</strong>:</p>
<p id="obs_04_0098__p1381149205014">Indicates a multipart upload.</p>
<p id="obs_04_0098__p3134134945010"><strong id="obs_04_0098__b64024601717">Restrictions</strong>:</p>
<ul id="obs_04_0098__ul476135615439"><li id="obs_04_0098__li1738119155017">This parameter is an empty string.</li><li id="obs_04_0098__li1677185674315">If this parameter is not included, the request is treated as an ordinary POST upload.</li></ul>
<p id="obs_04_0098__p147214508149"><strong id="obs_04_0098__b124721750171415">Value range</strong>:</p>
<p id="obs_04_0098__p134721501143">An empty string.</p>
<p id="obs_04_0098__p104721950131413"><strong id="obs_04_0098__b747217506144">Default value</strong>:</p>
<p id="obs_04_0098__p447220502147">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0098__section8567047"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0098__p9642950">The request can use additional headers shown in <a href="#obs_04_0098__table4401755105011">Table 2</a>.</p>
<div class="tablenoborder"><a name="obs_04_0098__table4401755105011"></a><a name="table4401755105011"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0098__table4401755105011" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="obs_04_0098__row94018552507"><th align="left" class="cellrowborder" valign="top" width="21.790000000000003%" id="mcps1.3.5.3.2.5.1.1"><p id="obs_04_0098__p1340265535013">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="7.539999999999999%" id="mcps1.3.5.3.2.5.1.2"><p id="obs_04_0098__p1972863945119"><strong id="obs_04_0098__b10953111195817">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="8.16%" id="mcps1.3.5.3.2.5.1.3"><p id="obs_04_0098__p1415123085213"><strong id="obs_04_0098__b4478333191713">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="62.51%" id="mcps1.3.5.3.2.5.1.4"><p id="obs_04_0098__p4402165535019"><strong id="obs_04_0098__b389643419177">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0098__row640211553505"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p174021855195018">x-obs-acl</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p772813392512">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p171583013526">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p17248521047"><strong id="obs_04_0098__b47315621583837">Explanation</strong>:</p>
<p id="obs_04_0098__p125310579394">When initiating a multipart upload, you can add this header to set an object ACL.</p>
<p id="obs_04_0098__p194029555509">Example: <strong id="obs_04_0098__b725368793">x-obs-acl: public-read-write</strong></p>
<p id="obs_04_0098__p12489211947"><strong id="obs_04_0098__b1594038965">Restrictions</strong>:</p>
<p id="obs_04_0098__p814483614720">Use character strings.</p>
<p id="obs_04_0098__p62481217412"><strong id="obs_04_0098__b157791482084110">Value range</strong>:</p>
<ul id="obs_04_0098__ul26251214144017"><li id="obs_04_0098__li3625111419408">private</li><li id="obs_04_0098__li176256144405">public-read</li><li id="obs_04_0098__li1862571484015">public-read-write</li></ul>
<p id="obs_04_0098__p1902171104017"></p>
<p id="obs_04_0098__p7248121849"><strong id="obs_04_0098__b12009952268422">Default value</strong>:</p>
<p id="obs_04_0098__p19443178123911">private</p>
</td>
</tr>
<tr id="obs_04_0098__row1340210550509"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p15402455105010">x-obs-grant-read</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p972833914515">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p19151430145217">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p16467424945"><strong id="obs_04_0098__b165889650283837">Explanation</strong>:</p>
<p id="obs_04_0098__p12402155555018">When initiating a multipart upload, you can use this header to grant all users in a domain the permissions to read the object and obtain the object metadata.</p>
<p id="obs_04_0098__p17402055175014">Example: <strong id="obs_04_0098__b39100090">x-obs-grant-read: ID=domainID</strong>.</p>
<p id="obs_04_0098__p346810240412"><strong id="obs_04_0098__b5458359792">Restrictions</strong>:</p>
<p id="obs_04_0098__p132731033154014">If multiple accounts are authorized, separate them with commas (,).</p>
<p id="obs_04_0098__p24681124147"><strong id="obs_04_0098__b161629228384110">Value range</strong>:</p>
<p id="obs_04_0098__p9630639131616">None</p>
<p id="obs_04_0098__p6468112415415"><strong id="obs_04_0098__b19284265838422">Default value</strong>:</p>
<p id="obs_04_0098__p124514101615">None</p>
</td>
</tr>
<tr id="obs_04_0098__row540275514506"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p540211556507">x-obs-grant-read-acp</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p1672893920518">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p161583015526">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p20737172710411"><strong id="obs_04_0098__b771703683837">Explanation</strong>:</p>
<p id="obs_04_0098__p740205514500">When initiating a multipart upload, you can use this header to grant all users in a domain the permissions to obtain the object ACL.</p>
<p id="obs_04_0098__p540225520509">Example: <strong id="obs_04_0098__b605675562">x-obs-grant-read-acp: ID=domainID</strong>.</p>
<p id="obs_04_0098__p1673718272411"><strong id="obs_04_0098__b10839022121019">Restrictions</strong>:</p>
<p id="obs_04_0098__p17739305429">If multiple accounts are authorized, separate them with commas (,).</p>
<p id="obs_04_0098__p156281015201711"><strong id="obs_04_0098__b26281815151715">Value range</strong>:</p>
<p id="obs_04_0098__p17629111515174">None</p>
<p id="obs_04_0098__p562971517174"><strong id="obs_04_0098__b1443567470">Default value</strong>:</p>
<p id="obs_04_0098__p16629181512171">None</p>
</td>
</tr>
<tr id="obs_04_0098__row34025559501"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p540211559502">x-obs-grant-write-acp</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p14728203975116">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p10154305521">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p1556412304412"><strong id="obs_04_0098__b39115568283837">Explanation</strong>:</p>
<p id="obs_04_0098__p18402185516503">When initiating a multipart upload, you can use this header to grant all users in a domain the permissions to write the object ACL.</p>
<p id="obs_04_0098__p204021355175017">Example: <strong id="obs_04_0098__b57631747171013">x-obs-grant-write-acp: ID=</strong><em id="obs_04_0098__i886794941017">domainID</em></p>
<p id="obs_04_0098__p05641301546"><strong id="obs_04_0098__b6189188181112">Restrictions</strong>:</p>
<p id="obs_04_0098__p167056373612">If multiple accounts are authorized, separate them with commas (,).</p>
<p id="obs_04_0098__p727119171717"><strong id="obs_04_0098__b42701991711">Value range</strong>:</p>
<p id="obs_04_0098__p2271419171711">None</p>
<p id="obs_04_0098__p1727101911711"><strong id="obs_04_0098__b396709332">Default value</strong>:</p>
<p id="obs_04_0098__p14280199172">None</p>
</td>
</tr>
<tr id="obs_04_0098__row1240215585017"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p8402655145010">x-obs-grant-full-control</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p1572943935113">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p201533011521">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p573413317415"><strong id="obs_04_0098__b6324349983837">Explanation</strong>:</p>
<p id="obs_04_0098__p357010531572">When initiating a multipart upload, you can use this header to grant all users in a domain the following permissions:</p>
<p id="obs_04_0098__p540215556506">Permissions to read objects, obtain object metadata, obtain object ACLs, and write object ACLs.</p>
<p id="obs_04_0098__p14402175585020">Example: <strong id="obs_04_0098__b2047984667">x-obs-grant-full-control: ID=domainID</strong>.</p>
<p id="obs_04_0098__p773413318412"><strong id="obs_04_0098__b495785621113">Restrictions</strong>:</p>
<p id="obs_04_0098__p184403547615">If multiple accounts are authorized, separate them with commas (,).</p>
<p id="obs_04_0098__p1478792241713"><strong id="obs_04_0098__b20787112213176">Value range</strong>:</p>
<p id="obs_04_0098__p8787172281714">None</p>
<p id="obs_04_0098__p2787322151717"><strong id="obs_04_0098__b300187981">Default value</strong>:</p>
<p id="obs_04_0098__p578719222171">None</p>
</td>
</tr>
<tr id="obs_04_0098__row440295555014"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p8402155525010">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p177291139145115">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p18152030145214">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p2557173617410"><strong id="obs_04_0098__b192629780283837">Explanation</strong>:</p>
<p id="obs_04_0098__p1840210551508">When initiating a multipart upload, you can add this header to specify the storage class for the object.</p>
<p id="obs_04_0098__p040235545011">Example: <strong id="obs_04_0098__b20666105281711">x-obs-storage-class: STANDARD</strong></p>
<p id="obs_04_0098__p855710361041"><strong id="obs_04_0098__b159543141211">Restrictions</strong>:</p>
<ul id="obs_04_0098__ul166939396100"><li id="obs_04_0098__li769343911016">If you do not use this header, the object storage class is the default storage class of the bucket.</li><li id="obs_04_0098__li136931939121016">The value is case-sensitive.</li></ul>
<p id="obs_04_0098__p21332571922"><strong id="obs_04_0098__b4133165719210">Value range</strong>:</p>
<ul id="obs_04_0098__ul612416012117"><li id="obs_04_0098__li16585131131110">STANDARD</li><li id="obs_04_0098__li15851911151115">WARM</li><li id="obs_04_0098__li85857116114">COLD</li></ul>
<p id="obs_04_0098__p413315576212"><strong id="obs_04_0098__b181331957322">Default value</strong>:</p>
<p id="obs_04_0098__p15939430111810">By default, the storage class of the bucket is inherited.</p>
</td>
</tr>
<tr id="obs_04_0098__row15403175595012"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p1140305516500">x-obs-website-redirect-location</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p872933925112">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p181583010521">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p13733102794914"><strong id="obs_04_0098__b1432355110">Explanation</strong>:</p>
<p id="obs_04_0098__p52720700">If the bucket is configured with website hosting, the request for obtaining the object can be redirected to another object in the bucket or an external URL.</p>
<p id="obs_04_0098__p21367535">To another object in the same bucket:</p>
<p id="obs_04_0098__p58090092">x-obs-website-redirect-location:/anotherPage.html</p>
<p id="obs_04_0098__p53048785">To an external URL:</p>
<p id="obs_04_0098__p7677024">x-obs-website-redirect-location:http://www.example.com/</p>
<p id="obs_04_0098__p1495145813353">OBS obtains the specified value from the header and stores it in the object metadata <strong id="obs_04_0098__b17106152111197">WebsiteRedirectLocation</strong>.</p>
<p id="obs_04_0098__p13943114015018"><strong id="obs_04_0098__b1275269059">Restrictions</strong>:</p>
<ul id="obs_04_0098__ul785643713715"><li id="obs_04_0098__li1985614370378">The value must start with a slash (/), <strong id="obs_04_0098__b106163111552457">http://</strong>, or <strong id="obs_04_0098__b148136475852457">https://</strong> and cannot exceed 2 KB.</li><li id="obs_04_0098__li16856103743717">OBS supports redirection for objects in the root directory of a bucket, not for those in folders.</li></ul>
<p id="obs_04_0098__p17944184095017"><strong id="obs_04_0098__b294412404504">Default value</strong>:</p>
<p id="obs_04_0098__p18644175513271">None</p>
</td>
</tr>
<tr id="obs_04_0098__row14031955205012"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p4403195513506">x-obs-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p37297395512">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p18152304523">No. This header is required when SSE-KMS is used.</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p79126461247"><strong id="obs_04_0098__b126502999183837">Explanation</strong>:</p>
<p id="obs_04_0098__p2040315552500">Indicates that SSE-KMS is used. </p>
<p id="obs_04_0098__p540355510503">Example: <strong id="obs_04_0098__b572712720181">x-obs-server-side-encryption: kms</strong></p>
<p id="obs_04_0098__p89408586197"><strong id="obs_04_0098__b2115108500">Restrictions</strong>:</p>
<p id="obs_04_0098__p10940165815196">None</p>
<p id="obs_04_0098__p694065811198"><strong id="obs_04_0098__b8940205871919">Value range</strong>:</p>
<ul id="obs_04_0098__ul1558194142015"><li id="obs_04_0098__li1258344204">kms</li><li id="obs_04_0098__li1958144142012">AES256</li></ul>
<p id="obs_04_0098__p69401358141914"><strong id="obs_04_0098__b15940155861912">Default value</strong>:</p>
<p id="obs_04_0098__p99401858131913">None</p>
</td>
</tr>
<tr id="obs_04_0098__row540375595015"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p14403195513507">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p972918399519">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p115143055215">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p0733529122216"><strong id="obs_04_0098__b8013583814">Explanation</strong>:</p>
<p id="obs_04_0098__p1273316293225">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0098__p167341929172212"><strong id="obs_04_0098__b1137912401">Restrictions</strong>:</p>
<p id="obs_04_0098__p17341729152210">This header can only be used when you specify <strong id="obs_04_0098__b54884714511521">kms</strong> for the <strong id="obs_04_0098__b67579606711521">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0098__p3734112916221"><strong id="obs_04_0098__b1557537823">Default value</strong>:</p>
<p id="obs_04_0098__p973462982214">If you specify <strong id="obs_04_0098__b206886820711521">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
</td>
</tr>
<tr id="obs_04_0098__row34045557508"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p20404175514509">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p672903913512">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p5166307522">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p111611136553"><strong id="obs_04_0098__b193476631183837">Explanation</strong>:</p>
<p id="obs_04_0098__p1440414557500">The algorithm used for encryption.</p>
<p id="obs_04_0098__p5404135514508">Example: <strong id="obs_04_0098__b257224370">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
<p id="obs_04_0098__p20162163619510"><strong id="obs_04_0098__b856462710181">Restrictions</strong>:</p>
<ul id="obs_04_0098__ul0628105664014"><li id="obs_04_0098__li1962819561403">This header is used only when SSE-C is used.</li><li id="obs_04_0098__li462835613406">This header must be used together with <strong id="obs_04_0098__b159987147552457">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0098__b106830354952457">x-obs-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0098__p5431310112117"><strong id="obs_04_0098__b1431121018215">Value range</strong>:</p>
<p id="obs_04_0098__p94311410172113">AES256</p>
<p id="obs_04_0098__p3431110182116"><strong id="obs_04_0098__b11431151012218">Default value</strong>:</p>
<p id="obs_04_0098__p1843115103215">None</p>
</td>
</tr>
<tr id="obs_04_0098__row44044558502"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p124041555175011">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p272918396516">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p161613095211">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p1693318381459"><strong id="obs_04_0098__b124229845883837">Explanation</strong>:</p>
<p id="obs_04_0098__p0404655135016">The key used for encrypting an object.</p>
<p id="obs_04_0098__p7404135511507">Example: <strong id="obs_04_0098__b32339889">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0098__p1293314380512"><strong id="obs_04_0098__b516502210226">Restrictions</strong>:</p>
<ul id="obs_04_0098__ul953010508417"><li id="obs_04_0098__li2530950134117">This header is used only when SSE-C is used.</li><li id="obs_04_0098__li16530175024114">This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0098__b100856295952457">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0098__b156283245952457">x-obs-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0098__p8933638155"><strong id="obs_04_0098__b188226904284110">Value range</strong>:</p>
<p id="obs_04_0098__p411014042118">None</p>
<p id="obs_04_0098__p49331438152"><strong id="obs_04_0098__b2439038838422">Default value</strong>:</p>
<p id="obs_04_0098__p18843144115211">None</p>
</td>
</tr>
<tr id="obs_04_0098__row3404955105012"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p540435595011">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p9729739135111">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p14164301528">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p39713411659"><strong id="obs_04_0098__b197622014083837">Explanation</strong>:</p>
<p id="obs_04_0098__p164043552506">The MD5 value of the encryption key. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0098__p1540475535019">Example: <strong id="obs_04_0098__b1705524229">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0098__p497113411851"><strong id="obs_04_0098__b121101341101817">Restrictions</strong>:</p>
<ul id="obs_04_0098__ul9169195814216"><li id="obs_04_0098__li516935874211">This header is used only when SSE-C is used.</li><li id="obs_04_0098__li11169358154218">This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0098__b60779307252457">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0098__b167834391452457">x-obs-server-side-encryption-customer-key</strong>.</li></ul>
<p id="obs_04_0098__p143941658222"><strong id="obs_04_0098__b53941558225">Value range</strong>:</p>
<p id="obs_04_0098__p163943532214">Base64-encoded MD5 value of the key ID.</p>
<p id="obs_04_0098__p73943516221"><strong id="obs_04_0098__b4394155182212">Default value</strong>:</p>
<p id="obs_04_0098__p439411517229">None</p>
</td>
</tr>
<tr id="obs_04_0098__row140475516506"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p134041555125014">x-obs-expires</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p1159445735010">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p91663065215">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p768618441956"><strong id="obs_04_0098__b65754123583837">Explanation</strong>:</p>
<p id="obs_04_0098__p15404125515015">Specifies when an object expires. It is measured in days. Once the object expires, it is automatically deleted. (The calculation starts from when the object was last modified).</p>
<p id="obs_04_0098__p124041955125013">Example: <strong id="obs_04_0098__b14100544141820">x-obs-expires:3</strong></p>
<p id="obs_04_0098__p2055248122211"><strong id="obs_04_0098__b1453653828">Restrictions</strong>:</p>
<p id="obs_04_0098__p1755164812227">This parameter can be configured only when uploading the object. It cannot be modified by calling a metadata modification API.</p>
<p id="obs_04_0098__p19554487224"><strong id="obs_04_0098__b255104815221">Value range</strong>:</p>
<p id="obs_04_0098__p65524832218">An integer greater than or equal to 0, in days</p>
<p id="obs_04_0098__p1155184822215"><strong id="obs_04_0098__b208563872252457">Default value</strong>:</p>
<p id="obs_04_0098__p1555248182219">None</p>
</td>
</tr>
<tr id="obs_04_0098__row740435515011"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p8404165565010">x-obs-tagging</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p17729183918510">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p13169303521">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p484220471657"><strong id="obs_04_0098__b190485140583837">Explanation</strong>:</p>
<p id="obs_04_0098__p1440425514509">An object's tag information in key-value pairs. Multiple tags can be added at the same time.</p>
<p id="obs_04_0098__p9404155195019">Example: <strong id="obs_04_0098__b221177554">x-obs-tagging:TagA=A&amp;TagB&amp;TagC</strong></p>
<p id="obs_04_0098__p10842184710518"><strong id="obs_04_0098__b11923947121817">Restrictions</strong>:</p>
<ul id="obs_04_0098__ul640416559509"><li id="obs_04_0098__li1640415525011">If a tag key or value contains special characters, equal signs (=), or full-width characters, it must be URL-encoded.</li><li id="obs_04_0098__li174044557506">If there is no equal sign (=) in a configuration, the tag value is considered left blank.</li></ul>
<p id="obs_04_0098__p1684217471454"><strong id="obs_04_0098__b117053421484110">Value range</strong>:</p>
<p id="obs_04_0098__p4178208237">None</p>
<p id="obs_04_0098__p884212471359"><strong id="obs_04_0098__b4987896048422">Default value</strong>:</p>
<p id="obs_04_0098__p19325521122319">None</p>
</td>
</tr>
<tr id="obs_04_0098__row5404355205010"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p144041355195018">x-obs-object-lock-mode</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p14729183925115">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p4161030155211">No, but required when <strong id="obs_04_0098__b309041662">x-obs-object-lock-retain-until-date</strong> is present.</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p986418501557"><strong id="obs_04_0098__b197525758783837">Explanation</strong>:</p>
<p id="obs_04_0098__p34041255145020">WORM mode to be applied to an object.</p>
<p id="obs_04_0098__p10404115510501">Example: <strong id="obs_04_0098__b18315135251812">x-obs-object-lock-mode:COMPLIANCE</strong></p>
<p id="obs_04_0098__p138641150956"><strong id="obs_04_0098__b177711713249">Restrictions</strong>:</p>
<p id="obs_04_0098__p755818252460">This parameter must be used together with <strong id="obs_04_0098__b108281635247">x-obs-object-lock-retain-until-date</strong>.</p>
<p id="obs_04_0098__p1586413509514"><strong id="obs_04_0098__b108295402884110">Value range</strong>:</p>
<p id="obs_04_0098__p679186114616">Only COMPLIANCE (compliance mode) is supported.</p>
<p id="obs_04_0098__p8864135014512"><strong id="obs_04_0098__b5831471598422">Default value</strong>:</p>
<p id="obs_04_0098__p571215407467">None</p>
</td>
</tr>
<tr id="obs_04_0098__row540475545013"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p1440485511500">x-obs-object-lock-retain-until-date</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p1472918398514">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p1816730115217">No, but required when <strong id="obs_04_0098__b859122499">x-obs-object-lock-mode</strong> is present.</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p54211541359"><strong id="obs_04_0098__b35393222783837">Explanation</strong>:</p>
<p id="obs_04_0098__p4404125575014">When the WORM policy of the object expires.</p>
<p id="obs_04_0098__p20405555185020">Example: <strong id="obs_04_0098__b20518185513183">x-obs-object-lock-retain-until-date:2015-07-01T04:11:15Z</strong></p>
<p id="obs_04_0098__p5421054154"><strong id="obs_04_0098__b891412812249">Restrictions</strong>:</p>
<ul id="obs_04_0098__ul1115062514710"><li id="obs_04_0098__li0150125174710">The value must be a UTC time that complies with the ISO 8601 standard. Example: <strong id="obs_04_0098__b18610430122418">2015-07-01T04:11:15Z</strong></li><li id="obs_04_0098__li3150725104716">This parameter must be used together with <strong id="obs_04_0098__b17290143318242">x-obs-object-lock-mode</strong>.</li></ul>
<p id="obs_04_0098__p11981359102316"><strong id="obs_04_0098__b151985596235">Value range</strong>:</p>
<p id="obs_04_0098__p18198459122311">The time must be later than the current time.</p>
<p id="obs_04_0098__p19198959172310"><strong id="obs_04_0098__b61981359102316">Default value</strong>:</p>
<p id="obs_04_0098__p1198155982316">None</p>
</td>
</tr>
<tr id="obs_04_0098__row104052559505"><td class="cellrowborder" valign="top" width="21.790000000000003%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0098__p140595513507">x-obs-meta-*</p>
</td>
<td class="cellrowborder" valign="top" width="7.539999999999999%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0098__p172943911513">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0098__p91653013522">No</p>
</td>
<td class="cellrowborder" valign="top" width="62.51%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0098__p1830516111966"><strong id="obs_04_0098__b126635731083837">Explanation</strong>:</p>
<p id="obs_04_0098__p16405205519505">When initiating a multipart upload, you can use a header starting with <strong id="obs_04_0098__b332204715328">x-obs-meta-</strong> in the HTTP request to define object metadata for easy management. The custom metadata will be returned in the response when you retrieve the object or query the object metadata. </p>
<p id="obs_04_0098__p12405955105012">Example: <strong id="obs_04_0098__b13653154198">x-obs-meta-test: test metadata</strong></p>
<p id="obs_04_0098__p815818915274"><strong id="obs_04_0098__b654022675">Restrictions</strong>:</p>
<p id="obs_04_0098__p31581898272">This parameter can only be passed in HTTP request headers and cannot exceed 8 KB.</p>
<p id="obs_04_0098__p1315869152717"><strong id="obs_04_0098__b915814902716">Value range</strong>:</p>
<p id="obs_04_0098__p1515879122719">None</p>
<p id="obs_04_0098__p14158209132719"><strong id="obs_04_0098__b1580913320">Default value</strong>:</p>
<p id="obs_04_0098__p1615819922712">None</p>
</td>
</tr>
</tbody>
</table>
</div>
<p class="msonormal" id="obs_04_0098__p66759527">For details about other common message headers, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="obs_04_0098__section9994560"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0098__p13769319">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0098__section22842176"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0098__screen49213403"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>status_code
Date:<span class="w"> </span>date
Content-Length:<span class="w"> </span>length
Connection:<span class="w"> </span>status
<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;yes&quot;?&gt;</span><span class="w"> </span>
<span class="nt">&lt;InitiateMultipartUploadResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;http://obs.region.example.com/doc/2015-06-30/&quot;</span><span class="nt">&gt;</span>
<span class="w"> </span><span class="nt">&lt;Bucket&gt;</span>BucketName<span class="nt">&lt;/Bucket&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>ObjectName<span class="nt">&lt;/Key&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;UploadId&gt;</span>uploadID<span class="nt">&lt;/UploadId&gt;</span><span class="w"> </span>
<span class="nt">&lt;/InitiateMultipartUploadResult&gt;</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0098__section4252992"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0098__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0098__table194388461549" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0098__row144391846135410"><th align="left" class="cellrowborder" valign="top" width="30.37%" id="mcps1.3.8.3.2.4.1.1"><p id="obs_04_0098__p9439134614545">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.51%" id="mcps1.3.8.3.2.4.1.2"><p id="obs_04_0098__p21539592546"><strong id="obs_04_0098__b58256591112">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.12%" id="mcps1.3.8.3.2.4.1.3"><p id="obs_04_0098__p1043974617541">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0098__row194391346115417"><td class="cellrowborder" valign="top" width="30.37%" headers="mcps1.3.8.3.2.4.1.1 "><p id="obs_04_0098__p104391746115416">x-obs-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="10.51%" headers="mcps1.3.8.3.2.4.1.2 "><p id="obs_04_0098__p151531059145418">String</p>
</td>
<td class="cellrowborder" valign="top" width="59.12%" headers="mcps1.3.8.3.2.4.1.3 "><p id="obs_04_0098__p1427125582710"><strong id="obs_04_0098__b1377561157">Explanation</strong>:</p>
<p id="obs_04_0098__p9282055182718">The encryption method used by the server.</p>
<p id="obs_04_0098__p0286557277">Example: <strong id="obs_04_0098__b164733500">x-obs-server-side-encryption: kms</strong></p>
<p id="obs_04_0098__p42813554275"><strong id="obs_04_0098__b1040417858">Restrictions</strong>:</p>
<p id="obs_04_0098__p7281455122711">This header is included in a response if SSE-KMS is used. </p>
<p id="obs_04_0098__p202885552711"><strong id="obs_04_0098__b82814559272">Value range</strong>:</p>
<ul id="obs_04_0098__ul8271134162811"><li id="obs_04_0098__li42711842283">kms</li><li id="obs_04_0098__li14271646287">AES256</li></ul>
<p id="obs_04_0098__p12281755122713"><strong id="obs_04_0098__b6281555182719">Default value</strong>:</p>
<p id="obs_04_0098__p92812556273">None</p>
</td>
</tr>
<tr id="obs_04_0098__row184393463549"><td class="cellrowborder" valign="top" width="30.37%" headers="mcps1.3.8.3.2.4.1.1 "><p id="obs_04_0098__p2439114619548">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="10.51%" headers="mcps1.3.8.3.2.4.1.2 "><p id="obs_04_0098__p17153195945418">String</p>
</td>
<td class="cellrowborder" valign="top" width="59.12%" headers="mcps1.3.8.3.2.4.1.3 "><p id="obs_04_0098__p3214132319233"><strong id="obs_04_0098__b3483111403">Explanation</strong>:</p>
<p id="obs_04_0098__p8214192316237">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0098__p3214162382314"><strong id="obs_04_0098__b13178848">Restrictions</strong>:</p>
<p id="obs_04_0098__p122145230238">This header can only be used when you specify <strong id="obs_04_0098__b25698914011521">kms</strong> for the <strong id="obs_04_0098__b160893788911521">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0098__p1621411238232"><strong id="obs_04_0098__b2120479933">Default value</strong>:</p>
<p id="obs_04_0098__p721442392316">If you specify <strong id="obs_04_0098__b197194334811521">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
</td>
</tr>
<tr id="obs_04_0098__row2439154611547"><td class="cellrowborder" valign="top" width="30.37%" headers="mcps1.3.8.3.2.4.1.1 "><p id="obs_04_0098__p243994611547">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="10.51%" headers="mcps1.3.8.3.2.4.1.2 "><p id="obs_04_0098__p415345910544">String</p>
</td>
<td class="cellrowborder" valign="top" width="59.12%" headers="mcps1.3.8.3.2.4.1.3 "><p id="obs_04_0098__p11825323863"><strong id="obs_04_0098__b186607973983837">Explanation</strong>:</p>
<p id="obs_04_0098__p14439746165418">The algorithm used for encryption.</p>
<p id="obs_04_0098__p943920466541">Example: <strong id="obs_04_0098__b863131818196">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
<p id="obs_04_0098__p682514231561"><strong id="obs_04_0098__b165221634163310">Restrictions</strong>:</p>
<p id="obs_04_0098__p1763844204118">This header is included in a response if SSE-C is used for server-side encryption.</p>
<p id="obs_04_0098__p14363614293"><strong id="obs_04_0098__b443936162915">Value range</strong>:</p>
<p id="obs_04_0098__p16432369294">AES256</p>
<p id="obs_04_0098__p114373622916"><strong id="obs_04_0098__b1943143622919">Default value</strong>:</p>
<p id="obs_04_0098__p5441236162913">None</p>
</td>
</tr>
<tr id="obs_04_0098__row1843914645414"><td class="cellrowborder" valign="top" width="30.37%" headers="mcps1.3.8.3.2.4.1.1 "><p id="obs_04_0098__p44399462542">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="10.51%" headers="mcps1.3.8.3.2.4.1.2 "><p id="obs_04_0098__p16153145914540">String</p>
</td>
<td class="cellrowborder" valign="top" width="59.12%" headers="mcps1.3.8.3.2.4.1.3 "><p id="obs_04_0098__p13601927263"><strong id="obs_04_0098__b102641148483837">Explanation</strong>:</p>
<p id="obs_04_0098__p34396468543">The MD5 value of the encryption key.</p>
<p id="obs_04_0098__p8439246145410">Example: <strong id="obs_04_0098__b1422418034">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0098__p136013274619"><strong id="obs_04_0098__b54105562338">Restrictions</strong>:</p>
<p id="obs_04_0098__p892115517422">This header is included in a response if SSE-C is used for server-side encryption.</p>
<p id="obs_04_0098__p19639134419293"><strong id="obs_04_0098__b2639044182914">Value range</strong>:</p>
<p id="obs_04_0098__p13639644172917">Base64-encoded MD5 value of the key ID.</p>
<p id="obs_04_0098__p163934417294"><strong id="obs_04_0098__b76397445299">Default value</strong>:</p>
<p id="obs_04_0098__p1163944417291">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0098__section38276929"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0098__p41154964">This response contains elements that indicate the multipart upload ID and the bucket and object names, which are used for uploading and assembling parts. <a href="#obs_04_0098__table66924188560">Table 4</a> describes the elements.</p>
<div class="tablenoborder"><a name="obs_04_0098__table66924188560"></a><a name="table66924188560"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0098__table66924188560" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response elements</caption><thead align="left"><tr id="obs_04_0098__row18692111812564"><th align="left" class="cellrowborder" valign="top" width="25.89%" id="mcps1.3.9.3.2.4.1.1"><p id="obs_04_0098__p10692131813562">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.3.9.3.2.4.1.2"><p id="obs_04_0098__p11319728145612"><strong id="obs_04_0098__b112891653114420">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="66.59%" id="mcps1.3.9.3.2.4.1.3"><p id="obs_04_0098__p1069241835610"><strong id="obs_04_0098__b6262526141919">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0098__row9692618145610"><td class="cellrowborder" valign="top" width="25.89%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0098__p13692181814564">InitiateMultipartUploadResult</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0098__p12351719456">XML</p>
</td>
<td class="cellrowborder" valign="top" width="66.59%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0098__p2065015341965"><strong id="obs_04_0098__b86688427683837">Explanation</strong>:</p>
<p id="obs_04_0098__p847311154510">Container of a multipart upload task.</p>
<p id="obs_04_0098__p176816156309"><strong id="obs_04_0098__b1259122318">Restrictions</strong>:</p>
<p id="obs_04_0098__p768141514302">None</p>
<p id="obs_04_0098__p1568161513010"><strong id="obs_04_0098__b1468191512306">Value range</strong>:</p>
<p id="obs_04_0098__p136871514307">None</p>
<p id="obs_04_0098__p1681715103016"><strong id="obs_04_0098__b759628968">Default value</strong>:</p>
<p id="obs_04_0098__p116891553012">None</p>
</td>
</tr>
<tr id="obs_04_0098__row4692121835612"><td class="cellrowborder" valign="top" width="25.89%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0098__p1969251895619">Bucket</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0098__p1969218182564">String</p>
</td>
<td class="cellrowborder" valign="top" width="66.59%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_p1220104418140"><strong id="obs_04_0098__b125952207152457">Explanation</strong>:</p>
<p id="obs_04_0098__en-us_topic_0262985973_p32073719">Indicates the bucket name in the multipart upload.</p>
<p id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_p122939219202"><strong id="obs_04_0098__b157892380">Restrictions</strong>:</p>
<ul id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_ul251944415616"><li id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_li1747116491368">A bucket name must be unique across all accounts and regions.</li><li id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_li1547114915618">A bucket name:<ul id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_ul1347124916617"><li id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_li1147114918618">Must be 3 to 63 characters long and start with a digit or letter. Lowercase letters, digits, hyphens (-), and periods (.) are allowed.</li><li id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_li64714491363">Cannot be formatted as an IP address.</li><li id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_li1347116499615">Cannot start or end with a hyphen (-) or period (.).</li><li id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_li14471249369">Cannot contain two consecutive periods (..), for example, <strong id="obs_04_0098__b7348554452457">my..bucket</strong>.</li><li id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_li2047144917615">Cannot contain a period (.) and a hyphen (-) adjacent to each other, for example, <strong id="obs_04_0098__b70580916952457">my-.bucket</strong> or <strong id="obs_04_0098__b175808699552457">my.-bucket</strong>.</li></ul>
</li><li id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_li24713498610">If you repeatedly create buckets of the same name in the same region, no error will be reported and the bucket attributes comply with those set in the first creation request.</li></ul>
<p id="obs_04_0098__p8120125213309"><strong id="obs_04_0098__b17120652163010">Value range</strong>:</p>
<p id="obs_04_0098__p11120185273012">None</p>
<p id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_p979441872218"><strong id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_b1378053102313">Default value</strong>:</p>
<p id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_p15326115514446">None</p>
</td>
</tr>
<tr id="obs_04_0098__row10692111819563"><td class="cellrowborder" valign="top" width="25.89%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0098__p569281845618">Key</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0098__p944661810454">String</p>
</td>
<td class="cellrowborder" valign="top" width="66.59%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_p19847193395017"><strong id="obs_04_0098__b1136175395">Explanation</strong>:</p>
<p id="obs_04_0098__en-us_topic_0262985973_p33116486">Name of the object in the multipart upload. An object is uniquely identified by an object name in a bucket. An object name is a complete path that does not contain the bucket name.</p>
<p id="obs_04_0098__p192389501818"><strong id="obs_04_0098__b1913176016">Restrictions</strong>:</p>
<p id="obs_04_0098__p33341343104318">None</p>
<p id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_p198471833135015"><strong id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_b1684719331506">Value range</strong>:</p>
<p id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_p8926340131620">The value must contain 1 to 1,024 characters.</p>
<p id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_p9847143320504"><strong id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_b48470333502">Default value</strong>:</p>
<p id="obs_04_0098__en-us_topic_0262985973_en-us_topic_0000001592569149_p123955911715">None</p>
</td>
</tr>
<tr id="obs_04_0098__row569291810563"><td class="cellrowborder" valign="top" width="25.89%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0098__p6692318175620">UploadId</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0098__p868201914450">String</p>
</td>
<td class="cellrowborder" valign="top" width="66.59%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0098__p954714015325"><strong id="obs_04_0098__b254273846">Explanation</strong>:</p>
<p id="obs_04_0098__p10547203323">ID of the multipart upload, which is used to specify a multipart upload in uploading parts</p>
<p id="obs_04_0098__p175471702323"><strong id="obs_04_0098__b2060847369">Restrictions</strong>:</p>
<p id="obs_04_0098__p754760123211">None</p>
<p id="obs_04_0098__p1754719073212"><strong id="obs_04_0098__b65471603321">Value range</strong>:</p>
<p id="obs_04_0098__p05474019329">The value must contain 1 to 32 characters.</p>
<p id="obs_04_0098__p1954718063216"><strong id="obs_04_0098__b154730133211">Default value</strong>:</p>
<p id="obs_04_0098__p454719018325">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0098__section8948044"><h4 class="sectiontitle">Error Responses</h4><ol id="obs_04_0098__ol42288265419"><li class="msonormal" id="obs_04_0098__li5228102610411">If the AK or signature was invalid, OBS returns <strong id="obs_04_0098__b27732538952457">403 Forbidden</strong> and the error code is <strong id="obs_04_0098__b3826544652457">AccessDenied</strong>.</li><li class="msonormal" id="obs_04_0098__li72281726745">If the bucket was not found, OBS returns <strong id="obs_04_0098__b10140151110417">404 Not Found</strong> and the error code is <strong id="obs_04_0098__b16140191164116">NoSuchBucket</strong>.</li><li class="msonormal" id="obs_04_0098__li0228102616410">If the user did not have the write permission for the specified bucket, OBS returns <strong id="obs_04_0098__b734810226410">403 Forbidden</strong> and the error code is <strong id="obs_04_0098__b17348152274115">AccessDenied</strong>.</li></ol>
<p class="msonormal" id="obs_04_0098__p42187440">Other errors are included in <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0098__section14231133313369"><h4 class="sectiontitle">Sample Request: Initiating a Multipart Upload</h4><div class="codecoloring" codetype="Xml" id="obs_04_0098__screen1859153673612"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span>POST<span class="w"> </span>/objectkey?uploads<span class="w"> </span>HTTP/1.1<span class="w"> </span>
Host:<span class="w"> </span>examplebucket.obs.region.example.com
Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>05:14:52<span class="w"> </span>GMT<span class="w"> </span>
Authorization:<span class="w"> </span>OBS<span class="w"> </span>AKIAIOSFODNN7EXAMPLE:VGhpcyBtZXNzYWdlIHNpZ25lZGGieSRlbHZpbmc=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0098__section6143226163010"><h4 class="sectiontitle">Sample Response: Initiating a Multipart Upload</h4><div class="codecoloring" codetype="Xml" id="obs_04_0098__screen8391613101913"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>200<span class="w"> </span>OK<span class="w"> </span>
Server:<span class="w"> </span>OBS
x-obs-id-2:<span class="w"> </span>Weag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==<span class="w"> </span>
x-obs-request-id:<span class="w"> </span>996c76696e6727732072657175657374<span class="w"> </span>
Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>05:14:52<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>303
<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;yes&quot;?&gt;</span><span class="w"> </span>
<span class="nt">&lt;InitiateMultipartUploadResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;http://obs.region.example.com/doc/2015-06-30/&quot;</span><span class="nt">&gt;</span>
<span class="w"> </span><span class="nt">&lt;Bucket&gt;</span>bucketname<span class="nt">&lt;/Bucket&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>objectkey<span class="nt">&lt;/Key&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;UploadId&gt;</span>DCD2FC98B4F70000013DF578ACA318E7<span class="nt">&lt;/UploadId&gt;</span><span class="w"> </span>
<span class="nt">&lt;/InitiateMultipartUploadResult&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0098__section123644113018"><h4 class="sectiontitle">Sample Request: Initiating a Multipart Upload (with the ACL Configured)</h4><div class="codecoloring" codetype="Xml" id="obs_04_0098__screen746465893020"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span>POST<span class="w"> </span>/objectkey?uploads<span class="w"> </span>HTTP/1.1<span class="w"> </span>
Host:<span class="w"> </span>examplebucket.obs.region.example.com
Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>05:15:43<span class="w"> </span>GMT
x-obs-grant-write-acp:ID=52f24s3593as5730ea4f722483579ai7,ID=a93fcas852f24s3596ea8366794f7224
Authorization:<span class="w"> </span>OBS<span class="w"> </span>AKIAIOSFODNN7EXAMPLE:VGhpcyBtZXNzYWdlIHNpZ25lZGGieSRlbHZpbmc=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0098__section199516233110"><h4 class="sectiontitle">Sample Response: Initiating a Multipart Upload (with the ACL Configured)</h4><div class="codecoloring" codetype="Xml" id="obs_04_0098__screen18092664012"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>200<span class="w"> </span>OK<span class="w"> </span>
Server:<span class="w"> </span>OBS
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCTnv+daB51p+IVhAvWN7s5rSKhcWqDFs<span class="w"> </span>
x-obs-request-id:<span class="w"> </span>BB78000001648457112DF37FDFADD7AD<span class="w"> </span>
Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>05:15:43<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>303
<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;yes&quot;?&gt;</span><span class="w"> </span>
<span class="nt">&lt;InitiateMultipartUploadResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;http://obs.region.example.com/doc/2015-06-30/&quot;</span><span class="nt">&gt;</span>
<span class="w"> </span><span class="nt">&lt;Bucket&gt;</span>bucketname<span class="nt">&lt;/Bucket&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>objectkey<span class="nt">&lt;/Key&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;UploadId&gt;</span>000001648453845DBB78F2340DD460D8<span class="nt">&lt;/UploadId&gt;</span><span class="w"> </span>
<span class="nt">&lt;/InitiateMultipartUploadResult&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0096.html">Operations on Multipart Upload</a></div>
</div>
</div>
View Git Blame Copy Permalink