vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/s3api/en-us_topic_0125560339.html
zhangyue 6fcdbfd13e OBS S3 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-02-26 11:17:13 +00:00

277 lines
28 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0125560339"></a><a name="EN-US_TOPIC_0125560339"></a>
<h1 class="topictitle1">Initiate Multipart Upload</h1>
<div id="body6635160"><p id="EN-US_TOPIC_0125560339__p1427265302116">You can use this operation to obtain a globally unique upload ID.</p>
<p id="EN-US_TOPIC_0125560339__p1673416115225">This upload ID is used to associate all parts in the specific multipart upload. You can specify this upload ID in each of your subsequent requests such as <strong id="EN-US_TOPIC_0125560339__b175956820168">Upload Part</strong>, <strong id="EN-US_TOPIC_0125560339__b1673410152214">Complete Multipart Upload</strong>, and <strong id="EN-US_TOPIC_0125560339__b1673420192217">List Parts</strong>.</p>
<p id="EN-US_TOPIC_0125560339__p7150181092210">The key of the object for which a multipart upload is intended can be the same as an existing object. You can initiate one or more multipart uploads for one object.</p>
<p id="EN-US_TOPIC_0125560339__p27073581">An <strong id="EN-US_TOPIC_0125560339__b28398200">Initiate Multipart Upload</strong> request can contain multiple headers such as <strong id="EN-US_TOPIC_0125560339__b54257211">x-amz-acl</strong>, <strong id="EN-US_TOPIC_0125560339__b18552854">x-amz-meta-*</strong>, <strong id="EN-US_TOPIC_0125560339__b32757962">Content-Type</strong>, and <strong id="EN-US_TOPIC_0125560339__b26386209">Content-Encoding</strong>. The headers are recorded in the metadata of parts uploaded for the specific multipart upload.</p>
<p id="EN-US_TOPIC_0125560339__p1761948317319">This operation makes server-side encryption available.</p>
<div class="section" id="EN-US_TOPIC_0125560339__section93175917597"><h4 class="sectiontitle">WORM</h4><p id="EN-US_TOPIC_0125560339__p1566012417013">If a bucket has WORM enabled, you can configure object-level retention policies when initiating multipart uploads. You can specify the <strong id="EN-US_TOPIC_0125560339__b613882112528">x-amz-object-lock-mode</strong> and <strong id="EN-US_TOPIC_0125560339__b813852113524">x-amz-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, see section <a href="en-us_topic_0000001806154009.html">Configuring WORM Retention for an Object</a>.</p>
<p id="EN-US_TOPIC_0125560339__p3483153720114">Different from uploads with PUT and POST, a multipart upload only requires that the date specified in the <strong id="EN-US_TOPIC_0125560339__b11495105433716">x-amz-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="EN-US_TOPIC_0125560339__section55982574"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560339__screen6767804114029">POST /ObjectName?uploads HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: signatureValue </pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560339__section34081122"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560339__p58625234">This request uses a parameter to specify a multipart upload. <a href="#EN-US_TOPIC_0125560339__table13291134">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560339__table13291134"></a><a name="table13291134"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560339__table13291134" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameter</caption><thead align="left"><tr id="EN-US_TOPIC_0125560339__row3756927"><th align="left" class="cellrowborder" valign="top" width="25.662566256625663%" id="mcps1.3.8.3.2.4.1.1"><p id="EN-US_TOPIC_0125560339__p35875689">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.62456245624562%" id="mcps1.3.8.3.2.4.1.2"><p id="EN-US_TOPIC_0125560339__p20249687">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="28.712871287128717%" id="mcps1.3.8.3.2.4.1.3"><p id="EN-US_TOPIC_0125560339__p29611954">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560339__row49758049"><td class="cellrowborder" valign="top" width="25.662566256625663%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p3870157">uploads</p>
</td>
<td class="cellrowborder" valign="top" width="45.62456245624562%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p45047261">Indicates the ID of the multipart upload to be initiated.</p>
<p id="EN-US_TOPIC_0125560339__p2772166">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="28.712871287128717%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p23218888">Mandatory</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560339__section38294646"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560339__p15135864">This request uses common headers. For details about common request headers, see section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
<p id="EN-US_TOPIC_0125560339__p28191617">This request also uses one optional header, as described in <a href="#EN-US_TOPIC_0125560339__table46028401">Table 2</a>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560339__table46028401"></a><a name="table46028401"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560339__table46028401" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="EN-US_TOPIC_0125560339__row33955681"><th align="left" class="cellrowborder" valign="top" width="26.652665266526654%" id="mcps1.3.9.4.2.4.1.1"><p id="EN-US_TOPIC_0125560339__p66055606">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.44444444444445%" id="mcps1.3.9.4.2.4.1.2"><p id="EN-US_TOPIC_0125560339__p48903847">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="28.9028902890289%" id="mcps1.3.9.4.2.4.1.3"><p id="EN-US_TOPIC_0125560339__p1788702">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560339__row181128589338"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p163061637105">x-amz-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p7305518157">When creating an object, you can add this header in the request to set the storage class of the object. If you do not add this header, the object will use the default storage class of the bucket.</p>
<p id="EN-US_TOPIC_0125560339__p183055181656">Type: String</p>
<p id="EN-US_TOPIC_0125560339__p83054181511">Note: The storage class can be <strong id="EN-US_TOPIC_0125560339__b4305121814519">STANDARD</strong> (OBS Standard), <strong id="EN-US_TOPIC_0125560339__b1830516181052">STANDARD_IA</strong> (OBS Warm), or <strong id="EN-US_TOPIC_0125560339__b43051018859">GLACIER</strong> (OBS Cold). Note that the three storage class values are case-sensitive.</p>
<p id="EN-US_TOPIC_0125560339__p63051018859">Example: x-amz-storage-class: STANDARD</p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p1157872174110">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row10667136"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p58731703">x-amz-website-redirect-location</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p59647531">If a bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. OBS stores the value of this header in the object metadata.</p>
<p id="EN-US_TOPIC_0125560339__p67065735">Type: String</p>
<p id="EN-US_TOPIC_0125560339__p66720707">Default: None</p>
<p id="EN-US_TOPIC_0125560339__p63615456">Constraint: The value must be prefixed by a slash (/), <strong id="EN-US_TOPIC_0125560339__b35668200">http://</strong>, or <strong id="EN-US_TOPIC_0125560339__b1977818131160">https://</strong>. The length of the value cannot exceed 2 K.</p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p30987661">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row2007564010347"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p421387661741">x-amz-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p577968631741">Indicates that SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560339__p504097261741">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p510343581741">Example: x-amz-server-side-encryption:aws:kms</p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p401422961741">No. This header is mandatory when SSE-KMS is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row10741677103426"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p42695821741">x-amz-server-side-encryption-aws-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p102918711741">Indicates the master key ID. This header is used in SSE-KMS mode. If the customer does not provide the master key, the default master key will be used.</p>
<p id="EN-US_TOPIC_0125560339__p255179791741">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p283352241741">Example: x-amz-server-side-encryption-aws-kms-key-id:arn:aws:kms:sichuan:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p134518421741">No</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row21510552103418"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p146481841741">x-amz-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p456522781741">Indicates an encryption algorithm. The header is used in SSE-C mode.</p>
<p id="EN-US_TOPIC_0125560339__p82173191741">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p68470121741">Example: x-amz-server-side-encryption-customer-algorithm:AES256</p>
<p id="EN-US_TOPIC_0125560339__p616231081741">Constraints: This header must be used together with <strong id="EN-US_TOPIC_0125560339__b177370661741">x-amz-server-side-encryption-customer-key</strong> and <strong id="EN-US_TOPIC_0125560339__b254158701741">x-amz-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p454195801741">No. This header is mandatory when SSE-C is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row28371036103415"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p262042561741">x-amz-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p421700091741">Indicates a key used to encrypt objects. The header is used in SSE-C mode.</p>
<p id="EN-US_TOPIC_0125560339__p439857621741">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p603275381741">Example: x-amz-server-side-encryption-customer-key:K7QkYpBkM5+hcs27fsNkUnNVaobncnLht/rCB2o/9Cw=</p>
<p id="EN-US_TOPIC_0125560339__p60769301741">Constraints: This header is a base64-encoded 256-bit or 512-bit key and must be used together with <strong id="EN-US_TOPIC_0125560339__b546923711741">x-amz-server-side-encryption-customer-algorithm</strong> and <strong id="EN-US_TOPIC_0125560339__b224692941741">x-amz-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p80735511741">No. This header is mandatory when SSE-C is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row66494507103411"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p471482181741">x-amz-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p609093261741">Indicates the MD5 value of a key used to encrypt objects. The header is used in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key.</p>
<p id="EN-US_TOPIC_0125560339__p113130221741">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p347083371741">Example: x-amz-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</p>
<p id="EN-US_TOPIC_0125560339__p439395851741">Constraints: This header is a base64-encoded 128-bit MD5 value and must be used together with <strong id="EN-US_TOPIC_0125560339__b599119501741">x-amz-server-side-encryption-customer-algorithm</strong> and <strong id="EN-US_TOPIC_0125560339__b23366411741">x-amz-server-side-encryption-customer-key</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p550502131741">No. This header is mandatory when SSE-C is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row123906544396"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p257218553398">x-amz-security-token</p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p1457265563919">Header field used to identify the request of a federated user. When the federal authentication function is enabled, users sending such requests are identified as federated users.</p>
<p id="EN-US_TOPIC_0125560339__p1757218551392">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p157275523911">Optional. This parameter must be carried in the request sent by federated users.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row19567621397"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p5180191819182"><span style="color:#494949;">x-amz-object-lock-mode</span></p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p6180918151813">WORM mode that will be applied to the object. Currently, only <strong id="EN-US_TOPIC_0125560339__b65681335105413">COMPLIANCE</strong> is supported. This header must be used together with <strong id="EN-US_TOPIC_0125560339__b1256918351543">x-amz-object-lock-retain-until-date</strong>.</p>
<p id="EN-US_TOPIC_0125560339__p14496145181918">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p154228537191">Example: <strong id="EN-US_TOPIC_0125560339__b20869162612916">x-amz-object-lock-mode:COMPLIANCE</strong></p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p2180181810184">No, but required when <strong id="EN-US_TOPIC_0125560339__b984610174410">x-amz-object-lock-retain-until-date</strong> is present.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row652717510916"><td class="cellrowborder" valign="top" width="26.652665266526654%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560339__p14809920131812"><span style="color:#494949;">x-amz-object-lock-retain-until-date</span></p>
</td>
<td class="cellrowborder" valign="top" width="44.44444444444445%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560339__p97201718162111">Indicates the expiration time of the Object Lock retention. The value must be a UTC time that complies with ISO 8601, for example, <strong id="EN-US_TOPIC_0125560339__b489005844910">2015-07-01T04:11:15Z</strong>. This header must be used together with <strong id="EN-US_TOPIC_0125560339__b68916582492">x-amz-object-lock-mode</strong>.</p>
<p id="EN-US_TOPIC_0125560339__p1972081822113">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p372031872119">Example: <strong id="EN-US_TOPIC_0125560339__b18468113517910">x-amz-object-lock-retain-until-date:2015-07-01T04:11:15Z</strong></p>
</td>
<td class="cellrowborder" valign="top" width="28.9028902890289%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560339__p080992031813">No, but required when <strong id="EN-US_TOPIC_0125560339__b129028313556">x-amz-object-lock-mode</strong> is present.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0125560339__p26972592">For details about common request headers, see section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560339__section9107499"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560339__p1102679">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560339__section6423738"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560339__screen4875348114046">HTTP/1.1 status_code
Server: server
x-amz-id-2: id
x-amz-request-id: request id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Content-Type: type
Content-Length: length
Date: date
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;InitiateMultipartUploadResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Bucket&gt;BucketName&lt;/Bucket&gt;
&lt;Key&gt;ObjectName&lt;/Key&gt;
&lt;UploadId&gt;uploadID&lt;/UploadId&gt;
&lt;/InitiateMultipartUploadResult&gt; </pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560339__section57813648"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560339__p30856521">This response uses common headers. For details about common response headers, see section <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560339__table13282587103527" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response Headers</caption><thead align="left"><tr id="EN-US_TOPIC_0125560339__row65459064103527"><th align="left" class="cellrowborder" valign="top" width="44.440000000000005%" id="mcps1.3.12.3.2.3.1.1"><p id="EN-US_TOPIC_0125560339__p42924963103629">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.559999999999995%" id="mcps1.3.12.3.2.3.1.2"><p id="EN-US_TOPIC_0125560339__p54369994103629">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560339__row6462231103527"><td class="cellrowborder" valign="top" width="44.440000000000005%" headers="mcps1.3.12.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560339__p1450872317433">x-amz-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="55.559999999999995%" headers="mcps1.3.12.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560339__p3435594617433">This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560339__p4076805817433">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p3136820417433">Example: x-amz-server-side-encryption:aws:kms</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row7303564103527"><td class="cellrowborder" valign="top" width="44.440000000000005%" headers="mcps1.3.12.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560339__p5040745817433">x-amz-server-side-encryption-aws-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="55.559999999999995%" headers="mcps1.3.12.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560339__p5647230717433">Indicates the master key ID. This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560339__p3848871917433">Example: x-amz-server-side-encryption-aws-kms-key-id:arn:aws:kms:sichuan:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row26606372103527"><td class="cellrowborder" valign="top" width="44.440000000000005%" headers="mcps1.3.12.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560339__p677147817433">x-amz-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="55.559999999999995%" headers="mcps1.3.12.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560339__p1161887317433">Indicates an encryption algorithm. This header is included in a response if SSE-C is used.</p>
<p id="EN-US_TOPIC_0125560339__p3746099517433">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p160463617433">Example: x-amz-server-side-encryption-customer-algorithm:AES256</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row61167020103527"><td class="cellrowborder" valign="top" width="44.440000000000005%" headers="mcps1.3.12.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560339__p2892905917433">x-amz-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="55.559999999999995%" headers="mcps1.3.12.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560339__p6155247917433">Indicates the MD5 value of a key used to encrypt objects. This header is included in a response if SSE-C is used.</p>
<p id="EN-US_TOPIC_0125560339__p1710139917433">Type: string</p>
<p id="EN-US_TOPIC_0125560339__p1969487017433">Example: x-amz-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560339__section50560785"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560339__p49304160">This response contains elements to indicate the upload ID and the key (name) of the object (bucket) for which the multipart upload was initiated. The returned information is used in the subsequent <strong id="EN-US_TOPIC_0125560339__b20160182118164">Upload Part</strong> and <strong id="EN-US_TOPIC_0125560339__b34214014">Complete Multipart Upload</strong> operations. <a href="#EN-US_TOPIC_0125560339__table6651816">Table 4</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560339__table6651816"></a><a name="table6651816"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560339__table6651816" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560339__row10894532"><th align="left" class="cellrowborder" valign="top" width="45.129999999999995%" id="mcps1.3.13.3.2.3.1.1"><p id="EN-US_TOPIC_0125560339__p10041872">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="54.87%" id="mcps1.3.13.3.2.3.1.2"><p id="EN-US_TOPIC_0125560339__p8085329">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560339__row50931951"><td class="cellrowborder" valign="top" width="45.129999999999995%" headers="mcps1.3.13.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560339__p31847377">InitiateMultipartUploadResult</p>
</td>
<td class="cellrowborder" valign="top" width="54.87%" headers="mcps1.3.13.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560339__p29500768">Indicates the container for the response.</p>
<p id="EN-US_TOPIC_0125560339__p64180323">Type: XML</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row40752003"><td class="cellrowborder" valign="top" width="45.129999999999995%" headers="mcps1.3.13.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560339__p12577955">Bucket</p>
</td>
<td class="cellrowborder" valign="top" width="54.87%" headers="mcps1.3.13.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560339__p12181415">Indicates the name of the bucket for which the multipart upload was initiated.</p>
<p id="EN-US_TOPIC_0125560339__p42523874">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row47170552"><td class="cellrowborder" valign="top" width="45.129999999999995%" headers="mcps1.3.13.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560339__p62718333">Key</p>
</td>
<td class="cellrowborder" valign="top" width="54.87%" headers="mcps1.3.13.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560339__p47020190">Indicates the key of the object for which the multipart upload was initiated.</p>
<p id="EN-US_TOPIC_0125560339__p20528533">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560339__row50539077"><td class="cellrowborder" valign="top" width="45.129999999999995%" headers="mcps1.3.13.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560339__p24535">UploadId</p>
</td>
<td class="cellrowborder" valign="top" width="54.87%" headers="mcps1.3.13.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560339__p1987390">Indicates the ID for the initiated multipart upload. This ID is used for the subsequent <strong id="EN-US_TOPIC_0125560339__b107946278162">Upload Part</strong> operation.</p>
<p id="EN-US_TOPIC_0125560339__p26760930">Type: String</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560339__section52393888"><h4 class="sectiontitle">Error Responses</h4><ul id="EN-US_TOPIC_0125560339__ul6112255152317"><li id="EN-US_TOPIC_0125560339__li10112145519235">If an AK or signature is invalid, OBS returns status code <strong id="EN-US_TOPIC_0125560339__b9112105592312">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560339__b19112165572315">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560339__li5112455192311">If the requested bucket does not exist, OBS returns status code <strong id="EN-US_TOPIC_0125560339__b71129554236">404 Not Found</strong> and error code <strong id="EN-US_TOPIC_0125560339__b1511215518234">NoSuchBucket</strong>.</li><li id="EN-US_TOPIC_0125560339__li18112455152314">If the requester does not have <strong id="EN-US_TOPIC_0125560339__b711235522314">WRITE</strong> permission for the requested bucket, OBS returns status code <strong id="EN-US_TOPIC_0125560339__b61121555132311">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560339__b1211235542318">AccessDenied</strong>.</li></ul>
<p id="EN-US_TOPIC_0125560339__p57641498">For details about other error responses, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560339__section44716440"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560339__screen1442250111410">POST /objectkey?uploads HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:VGhpcyBtZXNzYWdlIHNpZ25lZGGieSRlbHZpbmc=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560339__section66903647"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560339__screen17473936114110">HTTP/1.1 200 OK
Server: OBS
x-amz-id-2: Weag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==
x-amz-request-id: 996c76696e6727732072657175657374
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Type: application/xml
Content-Length: 146
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;InitiateMultipartUploadResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Bucket&gt;bucket01&lt;/Bucket&gt;
&lt;Key&gt;objectkey&lt;/Key&gt;
&lt;UploadId&gt;DCD2FC98B4F70000013DF578ACA318E7&lt;/UploadId&gt;
&lt;/InitiateMultipartUploadResult&gt;</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560489.html">Operations on Objects</a></div>
</div>
</div>
View Git Blame Copy Permalink