doc-exports/docs/obs/api-ref/obs_04_0082.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

807 lines
80 KiB
HTML

<a name="obs_04_0082"></a><a name="obs_04_0082"></a>
<h1 class="topictitle1">Copying an Object</h1>
<div id="body61435126"><div class="section" id="obs_04_0082__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0082__p39464956">You can perform this operation to create a copy of an existing object in OBS.</p>
<p class="msonormal" id="obs_04_0082__p19640290">Users can determine whether to copy the metadata of the source object to the target object (by default) or replace the metadata of the target object with the metadata contained in the request. The ACL of the source object is not copied to the target object. By default, the ACL of the target object is private. You can set an ACL for the target object by sending an API request.</p>
<p class="msonormal" id="obs_04_0082__p42544890">The request for copying an object needs to carry the information about the bucket and object to be copied in the header field. The message body cannot be carried.</p>
<p class="msonormal" id="obs_04_0082__p47359691">This operation supports server-side encryption.</p>
<p id="obs_04_0082__p9615112319534">An object copy can be up to 5 GB in size. If the source object size exceeds 5 GB, you can only <a href="obs_04_0100.html">copy part of the object</a>.</p>
<div class="note" id="obs_04_0082__note1586114511116"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="cautiontext" id="obs_04_0082__p49467454">You cannot determine whether a request is executed successfully only using <strong id="obs_04_0082__b733137133204115">status_code</strong> in the header returned by HTTP. If 200 in <strong id="obs_04_0082__b1634619502204120">status_code</strong> is returned, the server has received the request and starts to process the request. The body in the response shows whether the copy succeeds. If the body contains ETag, the copy succeeds. Otherwise, the copy failed.</p>
</div></div>
</div>
<div class="section" id="obs_04_0082__section23584040"><h4 class="sectiontitle">Versioning</h4><p class="msonormal" id="obs_04_0082__p10189271">By default, <strong id="obs_04_0082__b48514746">x-obs-copy-source</strong> specifies the latest version of the source object. If the latest version of the source object is a delete marker, the object is considered deleted. You can add <strong id="obs_04_0082__b33979533">versionId</strong> to request header <strong id="obs_04_0082__b37380344">x-obs-copy-source</strong> to copy an object with the specified version ID.</p>
<p class="msonormal" id="obs_04_0082__p24594578">If a bucket has versioning enabled, the system automatically generates a unique version ID for the requested object in this bucket and returns the version ID in response header <strong id="obs_04_0082__b7909027">x-obs-version-id</strong>. If versioning is suspended for the bucket, the object version ID is <strong id="obs_04_0082__b6348185161214">null</strong>.</p>
<div class="notice" id="obs_04_0082__note11381267"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p class="cautiontext" id="obs_04_0082__p35322545">When the bucket versioning status is disabled, if you make a copy of object_A and save it as object_B, and an object named as object_B already exists, the new object_B will overwrite the existing one. After the copying is executed successfully, only new object_B can be downloaded because old object_B has been deleted. Therefore, before copying an object, ensure that there is no object with the same name as the object copy to prevent data from being deleted mistakenly. During the copying, object_A has no changes. </p>
</div></div>
</div>
<div class="section" id="obs_04_0082__section1475721115541"><h4 class="sectiontitle">WORM</h4><p id="obs_04_0082__p134973436414">If a bucket has WORM enabled, you can configure retention policies for objects in the bucket. You can specify the <strong id="obs_04_0082__b16286138101016">x-obs-object-lock-mode</strong> and <strong id="obs_04_0082__b142863861017">x-obs-object-lock-retain-until-date</strong> headers to configure a retention policy when you copy an object. 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 copied. You can also configure or update a WORM retention policy after an object is copied to the bucket.</p>
<div class="note" id="obs_04_0082__note7241205112419"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0082__p724113511418">In a copy operation, the object protection status is not copied, so the protection status of an object copy is independent of that of the source object. After the copy is complete, WORM retention changes made on the source object does not affect the object copy.</p>
</div></div>
</div>
<div class="section" id="obs_04_0082__section98331501719"><h4 class="sectiontitle">Object Tags</h4><p id="obs_04_0082__p1818281128">You can use the <strong id="obs_04_0082__b1950095517139">x-obs-tagging-directive</strong> header to specify how object tags will be processed during a copy. You can also configure tags for the object copy after the copy is complete.</p>
<div class="note" id="obs_04_0082__note1184967457"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0082__p58491717515">To copy tags of a source object, you must have the <strong id="obs_04_0082__b79661312315">GetObjectTagging</strong> permission for the source object. To copy tags of a source object version, you must have the <strong id="obs_04_0082__b6418133020241">GetObjectTagging</strong> and <strong id="obs_04_0082__b6620133122417">GetObjectVersionTagging</strong> permissions for the source object version. These permissions can be granted using object ACLs or bucket policies.</p>
<p id="obs_04_0082__p17554125119619">To add tags to an object copy, you must have the <strong id="obs_04_0082__b10759141112816">PutObjectTagging</strong> permission for the object copy. To add tags to an object copy version, you must have the <strong id="obs_04_0082__b7912117142919">PutObjectTagging</strong> and <strong id="obs_04_0082__b162411248295">PutObjectVersionTagging</strong> permissions for the object copy version. These permissions can be granted using bucket ACLs or bucket policies.</p>
</div></div>
</div>
<div class="section" id="obs_04_0082__section10929768"><h4 class="sectiontitle">Cold Objects</h4><p class="msonormal" id="obs_04_0082__p47440850">If source objects are in the Cold storage class, ensure that these objects have been restored before you copy them. If a source object is not restored or is being restored, its copy will fail and error <strong id="obs_04_0082__b1525193074015">403 Forbidden</strong> will be returned. The fault is described as follows:</p>
<p class="msonormal" id="obs_04_0082__p24314466">ErrorCode: InvalidObjectState</p>
<p class="msonormal" id="obs_04_0082__p17503605">ErrorMessage: Operation is not valid for the source object's storage class</p>
</div>
<div class="section" id="obs_04_0082__section31259054"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0082__screen53918951"><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></pre></div></td><td class="code"><div><pre><span></span>PUT<span class="w"> </span>/destinationObjectName<span class="w"> </span>HTTP/1.1<span class="w"> </span>
Host:<span class="w"> </span>bucketname.obs.region.example.com
x-obs-copy-source:<span class="w"> </span>/sourceBucket/sourceObject<span class="w"> </span>
x-obs-metadata-directive:<span class="w"> </span>metadata_directive
x-obs-copy-source-if-match:<span class="w"> </span>etag
x-obs-copy-source-if-none-match:<span class="w"> </span>etag
x-obs-copy-source-if-unmodified-since:<span class="w"> </span>time_stamp
x-obs-copy-source-if-modified-since:<span class="w"> </span>time_stamp
Authorization:<span class="w"> </span>signature
Date:<span class="w"> </span>date
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0082__section12896034"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0082__p48230284">This request contains no parameters.</p>
</div>
<div class="section" id="obs_04_0082__section48955445"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0082__p14338945">You can add optional headers to specify the object to be copied. <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a> describes the optional headers.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0082__table2068515551508" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request headers</caption><thead align="left"><tr id="obs_04_0082__row6685655507"><th align="left" class="cellrowborder" valign="top" width="19.009999999999998%" id="mcps1.3.8.3.2.5.1.1"><p id="obs_04_0082__p11685135512010">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.01%" id="mcps1.3.8.3.2.5.1.2"><p id="obs_04_0082__p159825271217"><strong id="obs_04_0082__b16512181913215">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="8.15%" id="mcps1.3.8.3.2.5.1.3"><p id="obs_04_0082__p166855556017"><strong id="obs_04_0082__b1410115314584">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="61.83%" id="mcps1.3.8.3.2.5.1.4"><p id="obs_04_0082__p468510550017"><strong id="obs_04_0082__b195138142714">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0082__row6685355707"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p106851055805">x-obs-acl</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p1983152719114">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p468535519020">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p7134184955020"><strong id="obs_04_0082__b145769165783819">Explanation</strong>:</p>
<p id="obs_04_0082__p116858554012">When copying an object, you can use this parameter to set a pre-defined ACL.</p>
<p id="obs_04_0082__p2068516558012">Example: <strong id="obs_04_0082__b1880151112716">x-obs-acl: acl</strong></p>
<p id="obs_04_0082__p947320541706"><strong id="obs_04_0082__b19473954707">Restrictions</strong>:</p>
<p id="obs_04_0082__p818015821010">Use character strings.</p>
<p id="obs_04_0082__p19473154006"><strong id="obs_04_0082__b14473115414011">Value range</strong>:</p>
<ul id="obs_04_0082__ul39591652185212"><li id="obs_04_0082__li1095965295215">private</li><li id="obs_04_0082__li129591526523">public-read</li><li id="obs_04_0082__li17959145217529">public-read-write</li></ul>
<p id="obs_04_0082__p1826012213119"></p>
<p id="obs_04_0082__p8473354005"><strong id="obs_04_0082__b1747315541806">Default value</strong>:</p>
<p id="obs_04_0082__p1953584113120">private</p>
</td>
</tr>
<tr id="obs_04_0082__row76852551011"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p13685125511015">x-obs-grant-read</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p898314270111">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p76858556014">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p1680025035316"><strong id="obs_04_0082__b171161465183819">Explanation</strong>:</p>
<p id="obs_04_0082__p1077132913216">When copying an object, 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_0082__p85391655111219"><strong id="obs_04_0082__b5539255141214">Restrictions</strong>:</p>
<p id="obs_04_0082__p19539195521210">None</p>
<p id="obs_04_0082__p1753910550124"><strong id="obs_04_0082__b1553995512124">Value range</strong>:</p>
<p id="obs_04_0082__p553925521217">None</p>
<p id="obs_04_0082__p16539155171210"><strong id="obs_04_0082__b16539115511122">Default value</strong>:</p>
<p id="obs_04_0082__p115396552122">None</p>
</td>
</tr>
<tr id="obs_04_0082__row126856551902"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p46856551606">x-obs-grant-read-acp</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p598313274115">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p9685105517012">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p205501453115310"><strong id="obs_04_0082__b209463697483819">Explanation</strong>:</p>
<p id="obs_04_0082__p1868519551709">When copying an object, you can use this header to grant all users in a domain the permissions to obtain the object ACL.</p>
<p id="obs_04_0082__p173019413139"><strong id="obs_04_0082__b183044121318">Restrictions</strong>:</p>
<p id="obs_04_0082__p10308481310">None</p>
<p id="obs_04_0082__p1130204201314"><strong id="obs_04_0082__b103012431320">Value range</strong>:</p>
<p id="obs_04_0082__p0307418130">None</p>
<p id="obs_04_0082__p203054111314"><strong id="obs_04_0082__b153010410133">Default value</strong>:</p>
<p id="obs_04_0082__p130840134">None</p>
</td>
</tr>
<tr id="obs_04_0082__row468555514015"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p1468517551704">x-obs-grant-write-acp</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p11983112716110">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p568614551010">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p184117564538"><strong id="obs_04_0082__b38655958783819">Explanation</strong>:</p>
<p id="obs_04_0082__p1255011130217">When copying an object, you can use this header to grant all users in a domain the permissions to write the object ACL.</p>
<p id="obs_04_0082__p1563451213138"><strong id="obs_04_0082__b763471231316">Restrictions</strong>:</p>
<p id="obs_04_0082__p6634201251312">None</p>
<p id="obs_04_0082__p76341212181310"><strong id="obs_04_0082__b1463418122134">Value range</strong>:</p>
<p id="obs_04_0082__p963481220132">None</p>
<p id="obs_04_0082__p563401217139"><strong id="obs_04_0082__b56341112141316">Default value</strong>:</p>
<p id="obs_04_0082__p6634181271319">None</p>
</td>
</tr>
<tr id="obs_04_0082__row156865551600"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p268665511011">x-obs-grant-full-control</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p1898316271811">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p2068617551013">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p10500135911530"><strong id="obs_04_0082__b72044976383819">Explanation</strong>:</p>
<p id="obs_04_0082__p17619163885516">When copying an object, you can use this header to grant the following permissions to all users in a domain:</p>
<p id="obs_04_0082__p1768619550014">Permissions to read objects, obtain object metadata, obtain object ACLs, and write object ACLs.</p>
<p id="obs_04_0082__p14915628181316"><strong id="obs_04_0082__b791562816139">Restrictions</strong>:</p>
<p id="obs_04_0082__p091562819135">None</p>
<p id="obs_04_0082__p29151928101310"><strong id="obs_04_0082__b1791512285136">Value range</strong>:</p>
<p id="obs_04_0082__p8915228171310">None</p>
<p id="obs_04_0082__p9915162815139"><strong id="obs_04_0082__b491511282135">Default value</strong>:</p>
<p id="obs_04_0082__p14915182814134">None</p>
</td>
</tr>
<tr id="obs_04_0082__row9686125510010"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p19686175513014">x-obs-copy-source</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p49837276112">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p14686455204">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p424317220547"><strong id="obs_04_0082__b52912285683819">Explanation</strong>:</p>
<p id="obs_04_0082__p10686175517017">Indicates names of the source bucket and the source object. If the source object has multiple versions, the versionId parameter can be used to specify the desired version.</p>
<p id="obs_04_0082__p206868551607">Example: <strong id="obs_04_0082__b2133077637">x-obs-copy-source: /source_bucket/sourceObject</strong></p>
<p id="obs_04_0082__p122441826542"><strong id="obs_04_0082__b1740512320277">Restrictions</strong>:</p>
<p id="obs_04_0082__p156864551701">Full-width characters and percent signs (%) must be URL-encoded.</p>
<p id="obs_04_0082__p1385504405611"><strong id="obs_04_0082__b1685564445616">Value range</strong>:</p>
<p id="obs_04_0082__p12855164416562">None</p>
<p id="obs_04_0082__p1855444105614"><strong id="obs_04_0082__b1485514449566">Default value</strong>:</p>
<p id="obs_04_0082__p20919449101311">None</p>
</td>
</tr>
<tr id="obs_04_0082__row1768614551009"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p86865551904">x-obs-metadata-directive</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p139833271014">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p4686135517011">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p1133312525412"><strong id="obs_04_0082__b155277457983819">Explanation</strong>:</p>
<p id="obs_04_0082__p16686655801">Indicates whether the metadata of the target object is copied from the source object or replaced with the metadata contained in the request.</p>
<p id="obs_04_0082__p668614551102">Example: <strong id="obs_04_0082__b1320575559">x-obs-metadata-directive: metadata_directive</strong></p>
<p id="obs_04_0082__p83331565417"><strong id="obs_04_0082__b9896123782718">Restrictions</strong>:</p>
<p id="obs_04_0082__p11686175519014">Values other than <strong id="obs_04_0082__b492112488311">COPY</strong> or <strong id="obs_04_0082__b18922144813320">REPLACE</strong> result in an immediate 400-based error response. If you need to modify the metadata (the same for both the source and target objects), this parameter must be set to <strong id="obs_04_0082__b169221480320">REPLACE</strong>. Otherwise, the request is invalid and the server returns a 400 HTTP status code error. This parameter cannot change an encrypted object to a non-encrypted one (for both the source and target objects). If you use this parameter to change the encryption of an object, OBS returns a 400 error.</p>
<p id="obs_04_0082__p183331512549"><strong id="obs_04_0082__b40572797084053">Value range</strong>:</p>
<ul id="obs_04_0082__ul2927122310346"><li id="obs_04_0082__li992782318345">COPY</li><li id="obs_04_0082__li1092752333415">REPLACE</li></ul>
<p id="obs_04_0082__p16334145155416"><strong id="obs_04_0082__b67627726284145">Default value</strong>:</p>
<p id="obs_04_0082__p1895324718">COPY</p>
</td>
</tr>
<tr id="obs_04_0082__row668615514015"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p1068612550011">x-obs-copy-source-if-match</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p598312271217">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p6686755209">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p173628916549"><strong id="obs_04_0082__b199670910483819">Explanation</strong>:</p>
<p id="obs_04_0082__p96861655207">Indicates that the source object is copied only if its ETag matches the one specified in this header. Otherwise, a 412 status code (failed precondition) is returned.</p>
<p id="obs_04_0082__p968625510014">Example: <strong id="obs_04_0082__b226006563">x-obs-copy-source-if-match: etag</strong></p>
<p id="obs_04_0082__p153631496549"><strong id="obs_04_0082__b19363796544">Restrictions</strong>:</p>
<p id="obs_04_0082__p20686115510014">This parameter can be used with <strong id="obs_04_0082__b197613591351">x-obs-copy-source-if-unmodified-since</strong> but cannot with other conditional copy headers.</p>
<p id="obs_04_0082__p13552342161415"><strong id="obs_04_0082__b155527424145">Value range</strong>:</p>
<p id="obs_04_0082__p1155274231414">None</p>
<p id="obs_04_0082__p105521842201410"><strong id="obs_04_0082__b15528422144">Default value</strong>:</p>
<p id="obs_04_0082__p755234218142">None</p>
</td>
</tr>
<tr id="obs_04_0082__row2686755206"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p1686105520016">x-obs-copy-source-if-none-match</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p1198313276116">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p18686195511019">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p1164819129543"><strong id="obs_04_0082__b168254224883819">Explanation</strong>:</p>
<p id="obs_04_0082__p1168625511013">Indicates that the source object is copied only if its ETag does not match the one specified in this header. Otherwise, a 412 status code (failed precondition) is returned.</p>
<p id="obs_04_0082__p1668616551806">Example: <strong id="obs_04_0082__b735832491">x-obs-copy-source-if-none-match: etag</strong></p>
<p id="obs_04_0082__p1764913123549"><strong id="obs_04_0082__b128511250132713">Restrictions</strong>:</p>
<p id="obs_04_0082__p168695513015">This parameter can be used with <strong id="obs_04_0082__b837319275719">x-obs-copy-source-if-modified-since</strong> but cannot with other conditional copy headers.</p>
<p id="obs_04_0082__p18381017151"><strong id="obs_04_0082__b1631910171520">Value range</strong>:</p>
<p id="obs_04_0082__p1735103158">None</p>
<p id="obs_04_0082__p73110111510"><strong id="obs_04_0082__b632103153">Default value</strong>:</p>
<p id="obs_04_0082__p1321020158">None</p>
</td>
</tr>
<tr id="obs_04_0082__row468617559011"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p8686155503">x-obs-copy-source-if-unmodified-since</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p1698316275115">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p268618551601">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p6485201565410"><strong id="obs_04_0082__b56351186883819">Explanation</strong>:</p>
<p id="obs_04_0082__p1768610559011">The source object is copied only if the source object has not been modified since the time specified by this parameter. Otherwise, a 412 status code (precondition failed) is returned.</p>
<p id="obs_04_0082__p1848571513545"><strong id="obs_04_0082__b11421175692714">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul133116558817"><li id="obs_04_0082__li12313553820">The time specified by this parameter cannot be later than the current server time (GMT time), or this parameter does not take effect.</li><li id="obs_04_0082__li83120557816">This parameter can be used with <strong id="obs_04_0082__b1901152111012">x-obs-copy-source-if-match</strong> but cannot with other conditional copy parameters.</li><li id="obs_04_0082__li731055781">Format: HTTP time string complying with the format specified at <strong id="obs_04_0082__b108779425">http://www.ietf.org/rfc/rfc2616.txt</strong>, which can be any of the following:<ol id="obs_04_0082__ol17686165517014"><li id="obs_04_0082__li2686155513016"><strong id="obs_04_0082__b227661145">EEE, dd MMM yyyy HH:mm:ss z</strong></li><li id="obs_04_0082__li16861155501"><strong id="obs_04_0082__b1930502677">EEEE, dd-MMM-yy HH:mm:ss z</strong></li><li id="obs_04_0082__li968685512019"><strong id="obs_04_0082__b432281832">EEE MMM dd HH:mm:ss yyyy</strong></li></ol>
<p id="obs_04_0082__p168616551806">Examples:</p>
<ol id="obs_04_0082__ol668616559010"><li id="obs_04_0082__li1368612557010"><strong id="obs_04_0082__b681725072">x-obs-copy-source-if-unmodified-since: Sun, 06 Nov 1994 08:49:37 GMT</strong></li><li id="obs_04_0082__li66862551908"><strong id="obs_04_0082__b585712521">x-obs-copy-source-if-unmodified-since: Sunday, 06-Nov-94 08:49:37 GMT</strong></li><li id="obs_04_0082__li106864551402"><strong id="obs_04_0082__b840275093">x-obs-copy-source-if-unmodified-since: Sun Nov 6 08:49:37 1994</strong></li></ol>
</li></ul>
<p id="obs_04_0082__p1560468118"><strong id="obs_04_0082__b11604128912">Value range</strong>:</p>
<p id="obs_04_0082__p57671119124713">None</p>
<p id="obs_04_0082__p10604982113"><strong id="obs_04_0082__b96042083111">Default value</strong>:</p>
<p id="obs_04_0082__p6604281817">None</p>
</td>
</tr>
<tr id="obs_04_0082__row96865551016"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p186861552003">x-obs-copy-source-if-modified-since</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p39837271212">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p206871255303">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p392511188546"><strong id="obs_04_0082__b207853094183819">Explanation</strong>:</p>
<p id="obs_04_0082__p1668620558013">The source object is copied only if the source object has been modified since the time specified by this parameter. Otherwise, a 412 status code (precondition failed) is returned.</p>
<p id="obs_04_0082__p19258183548"><strong id="obs_04_0082__b2091012262819">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul181578315917"><li id="obs_04_0082__li11578312916">The time specified by this parameter cannot be later than the current server time (GMT time), or this parameter does not take effect.</li><li id="obs_04_0082__li1315753110916">This parameter can be used with <strong id="obs_04_0082__b1640821181210">x-obs-copy-source-if-none-match</strong> but cannot with other conditional copy parameters.</li><li id="obs_04_0082__li315715313910">Format: HTTP time string complying with the format specified at <strong id="obs_04_0082__b1681637131">http://www.ietf.org/rfc/rfc2616.txt</strong>, which can be any of the following:<ol id="obs_04_0082__ol186865553012"><li id="obs_04_0082__li1686115520015"><strong id="obs_04_0082__b680711093">EEE, dd MMM yyyy HH:mm:ss z</strong></li><li id="obs_04_0082__li126868551605"><strong id="obs_04_0082__b368644872">EEEE, dd-MMM-yy HH:mm:ss z</strong></li><li id="obs_04_0082__li116876557016"><strong id="obs_04_0082__b1324666064">EEE MMM dd HH:mm:ss yyyy</strong></li></ol>
<p id="obs_04_0082__p9687755908">Examples:</p>
<ol id="obs_04_0082__ol86872551102"><li id="obs_04_0082__li0687355302">x-obs-copy-source-if-modified-since: Sun, 06 Nov 1994 08:49:37 GMT</li><li id="obs_04_0082__li9687155203">x-obs-copy-source-if-modified-since: Sunday, 06-Nov-94 08:49:37 GMT</li><li id="obs_04_0082__li156871855501">x-obs-copy-source-if-modified-since: Sun Nov 6 08:49:37 1994</li></ol>
</li></ul>
<p id="obs_04_0082__p194013111218"><strong id="obs_04_0082__b24023118112">Value range</strong>:</p>
<p id="obs_04_0082__p12311181417474">None</p>
<p id="obs_04_0082__p6402181110116"><strong id="obs_04_0082__b14021111717">Default value</strong>:</p>
<p id="obs_04_0082__p144021011919">None</p>
</td>
</tr>
<tr id="obs_04_0082__row156879552017"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p96871855605">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p169832271417">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p136871455105">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p1789222217545"><strong id="obs_04_0082__b178827361983819">Explanation</strong>:</p>
<p id="obs_04_0082__p368719552019">When copying an object, you can use this header to specify the storage class for the object. If you do not use this header, the object storage class is the default storage class of the destination bucket where the object is copied to.</p>
<p id="obs_04_0082__p126871455203">Example: <strong id="obs_04_0082__b944897287">x-obs-storage-class: STANDARD</strong></p>
<p id="obs_04_0082__p289202285410"><strong id="obs_04_0082__b113168109281">Restrictions</strong>:</p>
<p id="obs_04_0082__p6432218814">The value is case-sensitive.</p>
<p id="obs_04_0082__p2832131310116"><strong id="obs_04_0082__b148337131217">Value range</strong>:</p>
<ul id="obs_04_0082__ul1865543616468"><li id="obs_04_0082__li665563612464">STANDARD</li><li id="obs_04_0082__li8655123617461">WARM</li><li id="obs_04_0082__li996515402461">COLD</li></ul>
<p id="obs_04_0082__p158335130118"><strong id="obs_04_0082__b16833413312">Default value</strong>:</p>
<p id="obs_04_0082__p683320134113">By default, the storage class of the bucket is inherited.</p>
</td>
</tr>
<tr id="obs_04_0082__row868810551202"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p106881755701">x-obs-website-redirect-location</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p169831527610">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p206882559012">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p1147123015419"><strong id="obs_04_0082__b114678053583819">Explanation</strong>:</p>
<p id="obs_04_0082__p19688175511017">If a bucket is configured with the static website hosting function, it will redirect 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="obs_04_0082__p2471330145410"><strong id="obs_04_0082__b1631292832818">Restrictions</strong>:</p>
<p id="obs_04_0082__p94661739175818">The value must start with a slash (/), <strong id="obs_04_0082__b713921731418">http://</strong>, or <strong id="obs_04_0082__b313911179144">https://</strong> and cannot exceed 2K.</p>
<p id="obs_04_0082__p1347115302545"><strong id="obs_04_0082__b171219520984053">Value range</strong>:</p>
<p id="obs_04_0082__p997955231611">None</p>
<p id="obs_04_0082__p4471173012540"><strong id="obs_04_0082__b28340040584145">Default value</strong>:</p>
<p id="obs_04_0082__p16884551005">None</p>
</td>
</tr>
<tr id="obs_04_0082__row368820551008"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p26881355809">x-obs-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p1298342716117">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p1768817551107">No. This header is required when SSE-KMS is used.</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p225812337544"><strong id="obs_04_0082__b19305214083819">Explanation</strong>:</p>
<p id="obs_04_0082__p168815559019">Indicates that SSE-KMS is used for server-side encryption. Objects are encrypted using SSE-KMS. </p>
<p id="obs_04_0082__p86881155309">Example: <strong id="obs_04_0082__b19345174072814">x-obs-server-side-encryption: kms</strong></p>
<p id="obs_04_0082__p079217215171"><strong id="obs_04_0082__b1879262201718">Restrictions</strong>:</p>
<p id="obs_04_0082__p187927281718">None</p>
<p id="obs_04_0082__p1379222171715"><strong id="obs_04_0082__b147921127175">Value range</strong>:</p>
<ul id="obs_04_0082__ul187445911175"><li id="obs_04_0082__li374412916173">kms</li><li id="obs_04_0082__li187444910177">AES256</li></ul>
<p id="obs_04_0082__p107921420176"><strong id="obs_04_0082__b37923210173">Default value</strong>:</p>
<p id="obs_04_0082__p4792525171">None</p>
</td>
</tr>
<tr id="obs_04_0082__row1668855514016"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p106882553019">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p1998318271414">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p26881455805">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p424083991615"><strong id="obs_04_0082__b75611259183316">Explanation</strong>:</p>
<p id="obs_04_0082__p142401393169">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0082__p22402396165"><strong id="obs_04_0082__b836248552">Restrictions</strong>:</p>
<p id="obs_04_0082__p2240839181618">This header can only be used when you specify <strong id="obs_04_0082__b157521277812">kms</strong> for the <strong id="obs_04_0082__b2752127484">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0082__p8240173941615"><strong id="obs_04_0082__b670748192">Default value</strong>:</p>
<p id="obs_04_0082__p924033981613">If you specify <strong id="obs_04_0082__b249582099378">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_0082__row1768813551108"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p1268818558016">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p9983427216">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p1768915510012">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p1720613439543"><strong id="obs_04_0082__b203346107783819">Explanation</strong>:</p>
<p id="obs_04_0082__p7688125515015">The algorithm used to encrypt a target object.</p>
<p id="obs_04_0082__p1688955709">Example: <strong id="obs_04_0082__b546357463">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
<p id="obs_04_0082__p1720618432541"><strong id="obs_04_0082__b1754139192917">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul4352134151515"><li id="obs_04_0082__li235263451519">This header is used only when SSE-C is used.</li><li id="obs_04_0082__li1635311348157">This header must be used together with <strong id="obs_04_0082__b197736599534956">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0082__b188835851734956">x-obs-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0082__p120939191816"><strong id="obs_04_0082__b22012394189">Value range</strong>:</p>
<p id="obs_04_0082__p120193931817">AES256</p>
<p id="obs_04_0082__p420103991815"><strong id="obs_04_0082__b62063915183">Default value</strong>:</p>
<p id="obs_04_0082__p82017398186">None</p>
</td>
</tr>
<tr id="obs_04_0082__row196891855101"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p76895557018">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p199831427615">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p7689125510019">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p580424512541"><strong id="obs_04_0082__b113114245983819">Explanation</strong>:</p>
<p id="obs_04_0082__p1468920551508">The key used to encrypt a target object.</p>
<p id="obs_04_0082__p268910551012">Example: <strong id="obs_04_0082__b1632076671">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0082__p118051245145413"><strong id="obs_04_0082__b11328161719298">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul165601031131513"><li id="obs_04_0082__li2056013312156">This header is used only when SSE-C is used.</li><li id="obs_04_0082__li056019317158">This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0082__b191147554234956">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0082__b104258767034956">x-obs-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0082__p116922131324"><strong id="obs_04_0082__b1969261319212">Value range</strong>:</p>
<p id="obs_04_0082__p1069219131625">None</p>
<p id="obs_04_0082__p11692191320211"><strong id="obs_04_0082__b1969241310218">Default value</strong>:</p>
<p id="obs_04_0082__p126921013128">None</p>
</td>
</tr>
<tr id="obs_04_0082__row1968914555011"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p568925516010">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p1998316271916">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p168919551905">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p12620148185416"><strong id="obs_04_0082__b100668685083819">Explanation</strong>:</p>
<p id="obs_04_0082__p15689135515013">The MD5 value of the key used to encrypt a target object. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0082__p3689115517011">Example: <strong id="obs_04_0082__b224410713">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0082__p3620184816543"><strong id="obs_04_0082__b1344922510299">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul5993165215155"><li id="obs_04_0082__li9993195215154">This header is used only when SSE-C is used.</li><li id="obs_04_0082__li9993155216155">This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0082__b4981586834956">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0082__b54789205534956">x-obs-server-side-encryption-customer-key</strong>.</li></ul>
<p id="obs_04_0082__p16671920121919"><strong id="obs_04_0082__b1467122061914">Value range</strong>:</p>
<p id="obs_04_0082__p367182071918">MD5 value of the key.</p>
<p id="obs_04_0082__p367920191913"><strong id="obs_04_0082__b1167102041916">Default value</strong>:</p>
<p id="obs_04_0082__p186742011192">None</p>
</td>
</tr>
<tr id="obs_04_0082__row068915516016"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p96896551200">x-obs-copy-source-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p159832271911">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p6689105514010">No. This header is required when SSE-C is used to copy a source object.</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p757515516542"><strong id="obs_04_0082__b204651083583819">Explanation</strong>:</p>
<p id="obs_04_0082__p1168919558019">Indicates the algorithm used to decrypt a source object.</p>
<p id="obs_04_0082__p968920556018">Example: x-obs-copy-source-server-side-encryption-customer-algorithm: AES256</p>
<p id="obs_04_0082__p9575185165416"><strong id="obs_04_0082__b76313302297">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul106041841165"><li id="obs_04_0082__li1660415451610">This header is used only when SSE-C is used.</li><li id="obs_04_0082__li61329731618">This header must be used together with <strong id="obs_04_0082__b1217785282020">x-obs-copy-source-server-side-encryption-customer-key</strong> and <strong id="obs_04_0082__b161781524203">x-obs-copy-source-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0082__p2161739121919"><strong id="obs_04_0082__b716113991919">Value range</strong>:</p>
<p id="obs_04_0082__p111611239131913">AES256</p>
<p id="obs_04_0082__p13161153915198"><strong id="obs_04_0082__b1016119391191">Default value</strong>:</p>
<p id="obs_04_0082__p616111395191">None</p>
</td>
</tr>
<tr id="obs_04_0082__row168925519017"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p368912555010">x-obs-copy-source-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p1198319271416">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p26892551019">No. This header is required when SSE-C is used to copy a source object.</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p17551654115410"><strong id="obs_04_0082__b110577800783819">Explanation</strong>:</p>
<p id="obs_04_0082__p136895551405">Indicates the key used to decrypt a source object.</p>
<p id="obs_04_0082__p1968965515013">Example: <strong id="obs_04_0082__b184756598">x-obs-copy-source-server-side-encryption-customer-key: K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0082__p37554549543"><strong id="obs_04_0082__b97557546544">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul8396171915167"><li id="obs_04_0082__li8396151910165">This header is used only when SSE-C is used.</li><li id="obs_04_0082__li13664321121612">This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0082__b1357791112313">x-obs-copy-source-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0082__b105781911192311">x-obs-copy-source-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0082__p16818257171910"><strong id="obs_04_0082__b16818145711910">Value range</strong>:</p>
<p id="obs_04_0082__p669811211128">None</p>
<p id="obs_04_0082__p176981421725"><strong id="obs_04_0082__b126982215219">Default value</strong>:</p>
<p id="obs_04_0082__p114011574201">None</p>
</td>
</tr>
<tr id="obs_04_0082__row5689255309"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p196891255306">x-obs-copy-source-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p1398310271118">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p76913551013">No. This header is required when SSE-C is used to copy a source object.</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p148011157135419"><strong id="obs_04_0082__b190226268383819">Explanation</strong>:</p>
<p id="obs_04_0082__p4689455903">Indicates the MD5 value of the key used to decrypt a source object. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0082__p196892556018">Example: <strong id="obs_04_0082__b80398172">x-obs-copy-source-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0082__p4801155714544"><strong id="obs_04_0082__b1280145711549">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul3567103410166"><li id="obs_04_0082__li3567634111615">This header is used only when SSE-C is used.</li><li id="obs_04_0082__li136376365161">This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0082__b3577840152315">x-obs-copy-source-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0082__b145777401231">x-obs-copy-source-server-side-encryption-customer-key</strong>.</li></ul>
<p id="obs_04_0082__p14735630182012"><strong id="obs_04_0082__b87351530192012">Value range</strong>:</p>
<p id="obs_04_0082__p1735103092017">MD5 value of the key.</p>
<p id="obs_04_0082__p117355308205"><strong id="obs_04_0082__b2735103032015">Default value</strong>:</p>
<p id="obs_04_0082__p1573511303207">None</p>
</td>
</tr>
<tr id="obs_04_0082__row369155516014"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p7691105512013">success-action-redirect</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p59835278117">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p196917552006">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p9838900558"><strong id="obs_04_0082__b94266178483819">Explanation</strong>:</p>
<p id="obs_04_0082__p96914554013">The redirection address used when requests were successfully responded to.</p>
<ul id="obs_04_0082__ul1969119552019"><li id="obs_04_0082__li116911955605">If the value is valid and the request is successful, OBS returns status code 303. <strong id="obs_04_0082__b1974260028">Location</strong> contains <strong id="obs_04_0082__b1810972480">success_action_redirect</strong> as well as the bucket name, object name, and object ETag.</li><li id="obs_04_0082__li10691195520015">If this parameter value is invalid, OBS ignores this parameter. In such case, the <strong id="obs_04_0082__b1167342993">Location</strong> header is the object address, and OBS returns the response code based on whether the operation succeeds or fails.</li></ul>
<p id="obs_04_0082__p0121559204"><strong id="obs_04_0082__b1412145511201">Restrictions</strong>:</p>
<p id="obs_04_0082__p201217556208">The value must be a valid URL, for example, <strong id="obs_04_0082__b59515118334956">http://</strong><em id="obs_04_0082__i90047598734956">domainname</em> or <strong id="obs_04_0082__b64536850834956">https://</strong><em id="obs_04_0082__i97073207534956">domainname</em>.</p>
<p id="obs_04_0082__p21212551205"><strong id="obs_04_0082__b111220556204">Value range</strong>:</p>
<p id="obs_04_0082__p912195513205">URL</p>
<p id="obs_04_0082__p91295513203"><strong id="obs_04_0082__b7121455182010">Default value</strong>:</p>
<p id="obs_04_0082__p1012195514209">None</p>
</td>
</tr>
<tr id="obs_04_0082__row8692055101"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p166921755008">x-obs-tagging-directive</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p17983727413">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p20692555507">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p440516765512"><strong id="obs_04_0082__b161579279683819">Explanation</strong>:</p>
<p id="obs_04_0082__p9692355609">Used to specify how object tags are copied. If this header is not contained, tags are not copied from source objects to destination ones.</p>
<p id="obs_04_0082__p769211558015">Example: <strong id="obs_04_0082__b188701757112914">x-obs-ta</strong><strong id="obs_04_0082__b1787035752915">gging-directiv</strong><strong id="obs_04_0082__b20870115702912">e</strong><strong id="obs_04_0082__b10870135792918">:COPY</strong></p>
<p id="obs_04_0082__p040511711555"><strong id="obs_04_0082__b186111158172914">Restrictions</strong>:</p>
<p id="obs_04_0082__p133765191864">None</p>
<p id="obs_04_0082__p1405374552"><strong id="obs_04_0082__b150902604184053">Value range</strong>:</p>
<ul id="obs_04_0082__ul76921455108"><li id="obs_04_0082__li4692185513017"><strong id="obs_04_0082__b1738112612255">COPY</strong>: Tags of source objects are copied to the target objects.</li><li id="obs_04_0082__li176924552014"><strong id="obs_04_0082__b402306911">REPLACE</strong>: The tags specified in the request are added to the target objects.</li></ul>
<p id="obs_04_0082__p1919133661720"><strong id="obs_04_0082__b15919133631718">Default value</strong>:</p>
<p id="obs_04_0082__p54058715514">REPLACE</p>
</td>
</tr>
<tr id="obs_04_0082__row269220551707"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p76928558014">x-obs-object-lock-mode</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p098352718111">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p1069216551102">No, but required when <strong id="obs_04_0082__b19570171133012">x-obs-object-lock-retain-until-date</strong> is present</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p433141045510"><strong id="obs_04_0082__b122544485083819">Explanation</strong>:</p>
<p id="obs_04_0082__p16927551104">WORM mode applied to the object.</p>
<p id="obs_04_0082__p1969211554012">Example: <strong id="obs_04_0082__b104073526">x-obs-object-lock-mode:COMPLIANCE</strong></p>
<p id="obs_04_0082__p325143017184"><strong id="obs_04_0082__b5251113013186">Restrictions</strong>:</p>
<p id="obs_04_0082__p18331151095518">This parameter must be used together with <strong id="obs_04_0082__b962773716269">x-obs-object-lock-retain-until-date</strong>.</p>
<p id="obs_04_0082__p1597094542113"><strong id="obs_04_0082__b99704456214">Value range</strong>:</p>
<p id="obs_04_0082__p297064532114">COMPLIANCE</p>
<p id="obs_04_0082__p59704452213"><strong id="obs_04_0082__b15970945102111">Default value</strong>:</p>
<p id="obs_04_0082__p19970154512118">None</p>
</td>
</tr>
<tr id="obs_04_0082__row5693755807"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p1369318551304">x-obs-object-lock-retain-until-date</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p0983927914">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p469395518018">No, but required when <strong id="obs_04_0082__b664986299">x-obs-object-lock-mode</strong> is present.</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p3283171315552"><strong id="obs_04_0082__b112974814083819">Explanation</strong>:</p>
<p id="obs_04_0082__p1069395511010">When the WORM policy of the object expires.</p>
<p id="obs_04_0082__p126936551702">Example: <strong id="obs_04_0082__b1652232081911">x-obs-object-lock-retain-until-date:2015-07-01T04:11:15Z</strong></p>
<p id="obs_04_0082__p2283121385514"><strong id="obs_04_0082__b9283213155510">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul575073916193"><li id="obs_04_0082__li775010390195">The value must be a UTC time that complies with the ISO 8601 standard. Example: <strong id="obs_04_0082__b11142146142618">2015-07-01T04:11:15Z</strong></li><li id="obs_04_0082__li17750163917191">This parameter must be used together with <strong id="obs_04_0082__b4829194842617">x-obs-object-lock-mode</strong>.</li></ul>
<p id="obs_04_0082__p1101886229"><strong id="obs_04_0082__b510118852215">Value range</strong>:</p>
<p id="obs_04_0082__p13101138112218">The time must be later than the current time.</p>
<p id="obs_04_0082__p610111842216"><strong id="obs_04_0082__b410198172213">Default value</strong>:</p>
<p id="obs_04_0082__p151014811227">None</p>
</td>
</tr>
<tr id="obs_04_0082__row149891162344"><td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.3.8.3.2.5.1.1 "><p id="obs_04_0082__p10711853165610">x-obs-tagging</p>
</td>
<td class="cellrowborder" valign="top" width="11.01%" headers="mcps1.3.8.3.2.5.1.2 "><p id="obs_04_0082__p2041830182218">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.8.3.2.5.1.3 "><p id="obs_04_0082__p132921733155719">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.83%" headers="mcps1.3.8.3.2.5.1.4 "><p id="obs_04_0082__p880111715466"><strong id="obs_04_0082__b339472590">Explanation</strong>:</p>
<p id="obs_04_0082__p11210177463">Object's tag information in key-value pairs. Multiple tags can be added at the same time.</p>
<p id="obs_04_0082__p371145313567">Example: <strong id="obs_04_0082__b1483233717">x-obs-tagging:TagA=A&amp;TagB&amp;TagC</strong></p>
<p id="obs_04_0082__p1980217164618"><strong id="obs_04_0082__b11811172466">Restrictions</strong>:</p>
<ul id="obs_04_0082__ul5711115314567"><li id="obs_04_0082__li15711753145610">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_0082__li18711205325612">If there is no equal sign (=) in a configuration, the tag value is considered left blank.</li></ul>
<p id="obs_04_0082__p48121711464"><strong id="obs_04_0082__b1805401229">Value range</strong>:</p>
<p id="obs_04_0082__p4681111562410">None</p>
<p id="obs_04_0082__p4811917164619"><strong id="obs_04_0082__b1701702777">Default value</strong>:</p>
<p id="obs_04_0082__p65732176242">None</p>
</td>
</tr>
</tbody>
</table>
</div>
<p class="msonormal" id="obs_04_0082__p38343271">For details about other headers, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="obs_04_0082__section37945824"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0082__p34957751">This request contains no elements.</p>
</div>
<div class="section" id="obs_04_0082__section5968100"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0082__screen39796368"><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></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>status_code
Content-Type:<span class="w"> </span>application/xml<span class="w"> </span>
Date:<span class="w"> </span>date
Content-Length:<span class="w"> </span>length
<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;CopyObjectResult</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;LastModified&gt;</span>modifiedDate<span class="nt">&lt;/LastModified&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;ETag&gt;</span>etagValue<span class="nt">&lt;/ETag&gt;</span><span class="w"> </span>
<span class="nt">&lt;/CopyObjectResult&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0082__section53712907"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0082__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>
<p class="msonormal" id="obs_04_0082__p50494524">In addition to the common response headers, the headers listed in <a href="#obs_04_0082__table4450547517">Table 2</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0082__table4450547517"></a><a name="table4450547517"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0082__table4450547517" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0082__row84518542516"><th align="left" class="cellrowborder" valign="top" width="31.3%" id="mcps1.3.11.4.2.4.1.1"><p id="obs_04_0082__p174525417512">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.58%" id="mcps1.3.11.4.2.4.1.2"><p id="obs_04_0082__p259215161062"><strong id="obs_04_0082__b15376111817327">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.120000000000005%" id="mcps1.3.11.4.2.4.1.3"><p id="obs_04_0082__p84585411513">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0082__row445125414518"><td class="cellrowborder" valign="top" width="31.3%" headers="mcps1.3.11.4.2.4.1.1 "><p id="obs_04_0082__p12452541517">x-obs-copy-source-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="13.58%" headers="mcps1.3.11.4.2.4.1.2 "><p id="obs_04_0082__p124510547515">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.11.4.2.4.1.3 "><p id="obs_04_0082__p17743181995510"><strong id="obs_04_0082__b99636237083819">Explanation</strong>:</p>
<p id="obs_04_0082__p468411215415">Version ID of the source object</p>
<p id="obs_04_0082__p10908681229"><strong id="obs_04_0082__b11908187210">Restrictions</strong>:</p>
<p id="obs_04_0082__p161484984214">None</p>
<p id="obs_04_0082__p189081981218"><strong id="obs_04_0082__b18908081523">Value range</strong>:</p>
<p id="obs_04_0082__p126022514426">None</p>
<p id="obs_04_0082__p20908881526"><strong id="obs_04_0082__b5908186212">Default value</strong>:</p>
<p id="obs_04_0082__p194682466398">None</p>
</td>
</tr>
<tr id="obs_04_0082__row124515543512"><td class="cellrowborder" valign="top" width="31.3%" headers="mcps1.3.11.4.2.4.1.1 "><p id="obs_04_0082__p194516541854">x-obs-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="13.58%" headers="mcps1.3.11.4.2.4.1.2 "><p id="obs_04_0082__p1455195415210">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.11.4.2.4.1.3 "><p id="obs_04_0082__p21231622105512"><strong id="obs_04_0082__b114247567183819">Explanation</strong>:</p>
<p id="obs_04_0082__p124512543511">Version ID of the target object</p>
<p id="obs_04_0082__p2035892242112"><strong id="obs_04_0082__b5358172222117">Restrictions</strong>:</p>
<p id="obs_04_0082__p220963315425">None</p>
<p id="obs_04_0082__p133581522142110"><strong id="obs_04_0082__b143589225211">Value range</strong>:</p>
<p id="obs_04_0082__p579733914214">None</p>
<p id="obs_04_0082__p14358132212213"><strong id="obs_04_0082__b17358122210211">Default value</strong>:</p>
<p id="obs_04_0082__p141051941144216">None</p>
</td>
</tr>
<tr id="obs_04_0082__row9451454451"><td class="cellrowborder" valign="top" width="31.3%" headers="mcps1.3.11.4.2.4.1.1 "><p id="obs_04_0082__p94513541556">x-obs-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="13.58%" headers="mcps1.3.11.4.2.4.1.2 "><p id="obs_04_0082__p265515514216">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.11.4.2.4.1.3 "><p id="obs_04_0082__p18343152565512"><strong id="obs_04_0082__b109789453783819">Explanation</strong>:</p>
<p id="obs_04_0082__p11577114514216">The encryption method used by the server.</p>
<p id="obs_04_0082__p15452541953">Example: <strong id="obs_04_0082__b750873861">x-obs-server-side-encryption: kms</strong></p>
<p id="obs_04_0082__p434412585511"><strong id="obs_04_0082__b1637426133012">Restrictions</strong>:</p>
<p id="obs_04_0082__p2052815390">This header is included in a response if SSE-KMS is used. </p>
<p id="obs_04_0082__p133441525125513"><strong id="obs_04_0082__b31794998084053">Value range</strong>:</p>
<ul id="obs_04_0082__ul18214715432"><li id="obs_04_0082__li108212077439">kms</li><li id="obs_04_0082__li158219764311">AES256</li></ul>
<p id="obs_04_0082__p133447251555"><strong id="obs_04_0082__b3474189484145">Default value</strong>:</p>
<p id="obs_04_0082__p1727885374218">None</p>
</td>
</tr>
<tr id="obs_04_0082__row845554758"><td class="cellrowborder" valign="top" width="31.3%" headers="mcps1.3.11.4.2.4.1.1 "><p id="obs_04_0082__p14575418518">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="13.58%" headers="mcps1.3.11.4.2.4.1.2 "><p id="obs_04_0082__p8664756129">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.11.4.2.4.1.3 "><p id="obs_04_0082__p157014516175"><strong id="obs_04_0082__b88408119381">Explanation</strong>:</p>
<p id="obs_04_0082__p10570134517170">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0082__p11570134571713"><strong id="obs_04_0082__b1108139673">Restrictions</strong>:</p>
<p id="obs_04_0082__p257012452179">This header can only be used when you specify <strong id="obs_04_0082__b1503352773378">kms</strong> for the <strong id="obs_04_0082__b398074157378">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0082__p1757074521716"><strong id="obs_04_0082__b2137139081">Default value</strong>:</p>
<p id="obs_04_0082__p05701345151714">If you specify <strong id="obs_04_0082__b163055085378">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_0082__row2461541157"><td class="cellrowborder" valign="top" width="31.3%" headers="mcps1.3.11.4.2.4.1.1 "><p id="obs_04_0082__p446125417512">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="13.58%" headers="mcps1.3.11.4.2.4.1.2 "><p id="obs_04_0082__p187213576217">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.11.4.2.4.1.3 "><p id="obs_04_0082__p1214163111550"><strong id="obs_04_0082__b22210248683819">Explanation</strong>:</p>
<p id="obs_04_0082__p14645420518">The algorithm used for encryption.</p>
<p id="obs_04_0082__p44619541452">Example: <strong id="obs_04_0082__b439240706">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
<p id="obs_04_0082__p18214173135519"><strong id="obs_04_0082__b1238917371308">Restrictions</strong>:</p>
<p id="obs_04_0082__p1343194014393">This header is included in a response if SSE-C is used for server-side encryption.</p>
<p id="obs_04_0082__p16472614393"><strong id="obs_04_0082__b104721183917">Value range</strong>:</p>
<p id="obs_04_0082__p831737154419">AES256</p>
<p id="obs_04_0082__p847211173917"><strong id="obs_04_0082__b04725114393">Default value</strong>:</p>
<p id="obs_04_0082__p10472111123919">None</p>
</td>
</tr>
<tr id="obs_04_0082__row184655415510"><td class="cellrowborder" valign="top" width="31.3%" headers="mcps1.3.11.4.2.4.1.1 "><p id="obs_04_0082__p3466544510">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="13.58%" headers="mcps1.3.11.4.2.4.1.2 "><p id="obs_04_0082__p101541259327">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.11.4.2.4.1.3 "><p id="obs_04_0082__p3540123310557"><strong id="obs_04_0082__b95626462083819">Explanation</strong>:</p>
<p id="obs_04_0082__p1646354552">The MD5 value of the key used for encryption.</p>
<p id="obs_04_0082__p44615549512">Example: <strong id="obs_04_0082__b98133403">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0082__p165411933125513"><strong id="obs_04_0082__b857255433013">Restrictions</strong>:</p>
<p id="obs_04_0082__p14578851123917">This header is included in a response if SSE-C is used for server-side encryption.</p>
<p id="obs_04_0082__p17990193143911"><strong id="obs_04_0082__b139901532393">Value range</strong>:</p>
<p id="obs_04_0082__p78011632104510">Base64-encoded MD5 value of the key ID.</p>
<p id="obs_04_0082__p10990123123913"><strong id="obs_04_0082__b1399053183917">Default value</strong>:</p>
<p id="obs_04_0082__p1699014316397">None</p>
</td>
</tr>
<tr id="obs_04_0082__row18463541958"><td class="cellrowborder" valign="top" width="31.3%" headers="mcps1.3.11.4.2.4.1.1 "><p id="obs_04_0082__p154615413515">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="13.58%" headers="mcps1.3.11.4.2.4.1.2 "><p id="obs_04_0082__p111287016320">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.11.4.2.4.1.3 "><p id="obs_04_0082__p0380143765513"><strong id="obs_04_0082__b32391054883819">Explanation</strong>:</p>
<p id="obs_04_0082__p59031214237">Storage class of an object.</p>
<p id="obs_04_0082__p1738093717556"><strong id="obs_04_0082__b114735963016">Restrictions</strong>:</p>
<p id="obs_04_0082__p117812179429">This header is returned when the storage class of an object is not Standard.</p>
<p id="obs_04_0082__p15380937185515"><strong id="obs_04_0082__b177544285084053">Value range</strong>:</p>
<ul id="obs_04_0082__ul4897125717463"><li id="obs_04_0082__li1389775714617">WARM</li><li id="obs_04_0082__li989765714614">COLD</li></ul>
<p id="obs_04_0082__p2038010377555"><strong id="obs_04_0082__b55075756884145">Default value</strong>:</p>
<p id="obs_04_0082__p3321132718463">Storage class of an object.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0082__section13654116"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0082__p59035875">This response contains elements of a copy result. <a href="#obs_04_0082__table48091256869">Table 3</a> describes the elements.</p>
<div class="tablenoborder"><a name="obs_04_0082__table48091256869"></a><a name="table48091256869"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0082__table48091256869" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response elements</caption><thead align="left"><tr id="obs_04_0082__row188101756269"><th align="left" class="cellrowborder" valign="top" width="27.1%" id="mcps1.3.12.3.2.4.1.1"><p id="obs_04_0082__p1781025618618"><strong id="obs_04_0082__b16283729193111">Element</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.18%" id="mcps1.3.12.3.2.4.1.2"><p id="obs_04_0082__p126243512710"><strong id="obs_04_0082__b196955158711">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60.72%" id="mcps1.3.12.3.2.4.1.3"><p id="obs_04_0082__p1881035614610"><strong id="obs_04_0082__b888484053114">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0082__row381014561164"><td class="cellrowborder" valign="top" width="27.1%" headers="mcps1.3.12.3.2.4.1.1 "><p id="obs_04_0082__p118100561767">CopyObjectResult</p>
</td>
<td class="cellrowborder" valign="top" width="12.18%" headers="mcps1.3.12.3.2.4.1.2 "><p id="obs_04_0082__p18103566613">XML</p>
</td>
<td class="cellrowborder" valign="top" width="60.72%" headers="mcps1.3.12.3.2.4.1.3 "><p id="obs_04_0082__p1327904219553"><strong id="obs_04_0082__b17440961983819">Explanation</strong>:</p>
<p id="obs_04_0082__p188104561362">The copy results</p>
<p id="obs_04_0082__p1727944219552"><strong id="obs_04_0082__b259319452310">Restrictions</strong>:</p>
<p id="obs_04_0082__p9500174720471">None</p>
<p id="obs_04_0082__p3279842165519"><strong id="obs_04_0082__b25749082384053">Value range</strong>:</p>
<p id="obs_04_0082__p4128550154716">None</p>
<p id="obs_04_0082__p1827934295515"><strong id="obs_04_0082__b28190293384145">Default value</strong>:</p>
<p id="obs_04_0082__p7549751114716">None</p>
</td>
</tr>
<tr id="obs_04_0082__row681012561764"><td class="cellrowborder" valign="top" width="27.1%" headers="mcps1.3.12.3.2.4.1.1 "><p id="obs_04_0082__p118103568619">LastModified</p>
</td>
<td class="cellrowborder" valign="top" width="12.18%" headers="mcps1.3.12.3.2.4.1.2 "><p id="obs_04_0082__p481010561461">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.72%" headers="mcps1.3.12.3.2.4.1.3 "><p id="obs_04_0082__p17443121362118"><strong id="obs_04_0082__b1137086988">Explanation</strong>:</p>
<p id="obs_04_0082__p11578105615309">Time (UTC) when an object was last modified</p>
<p id="obs_04_0082__p1057885663013"><strong id="obs_04_0082__b4443713102119">Restrictions</strong>:</p>
<p id="obs_04_0082__p6391542182417">The date is in the ISO8601 format.</p>
<p id="obs_04_0082__p1639184212244">Example: <strong id="obs_04_0082__b55826253134956">2018-01-01T00:00:00.000Z</strong></p>
<p id="obs_04_0082__p144431013152118"><strong id="obs_04_0082__b194433139211">Value range</strong>:</p>
<p id="obs_04_0082__p14299133332516">None</p>
<p id="obs_04_0082__p193723477614"><strong id="obs_04_0082__b437216472614">Default value</strong>:</p>
<p id="obs_04_0082__p1737218473610">None</p>
</td>
</tr>
<tr id="obs_04_0082__row118100563614"><td class="cellrowborder" valign="top" width="27.1%" headers="mcps1.3.12.3.2.4.1.1 "><p id="obs_04_0082__p481016561369">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="12.18%" headers="mcps1.3.12.3.2.4.1.2 "><p id="obs_04_0082__p1326213171048">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.72%" headers="mcps1.3.12.3.2.4.1.3 "><p id="obs_04_0082__p1195014635517"><strong id="obs_04_0082__b152766520283819">Explanation</strong>:</p>
<p id="obs_04_0082__p126051723445">128-bit MD5 digest of the Base64 code of a new object. ETag is the unique identifier of the object content. It can be used to determine whether the object content is changed. For example, if the ETag value is <strong id="obs_04_0082__b1029680006">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0082__b1423172441">B</strong> when the object is downloaded, it indicates that the object content has been changed.</p>
<p id="obs_04_0082__p17483185510485"><strong id="obs_04_0082__b144835559488">Restrictions</strong>:</p>
<p id="obs_04_0082__p6483205564810">If an object is encrypted using server-side encryption, the ETag is not the MD5 value of the object.</p>
<p id="obs_04_0082__p184832559489"><strong id="obs_04_0082__b1548355514813">Value range</strong>:</p>
<p id="obs_04_0082__p648375512487">The value must contain 32 characters.</p>
<p id="obs_04_0082__p124831355194810"><strong id="obs_04_0082__b1448314558481">Default value</strong>:</p>
<p id="obs_04_0082__p1948318551488">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0082__section55778186"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0082__p44383267">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0082__section14482163815396"><h4 class="sectiontitle">Sample Request: Copying an Object</h4><p id="obs_04_0082__p16927133602512">Copy the object <strong id="obs_04_0082__b16732163364411">srcobject</strong> in bucket <strong id="obs_04_0082__b1895185144413">bucket</strong> to the <strong id="obs_04_0082__b18111165554415">destobject</strong> object in bucket <strong id="obs_04_0082__b14247820457">examplebucket</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0082__screen8484163863919"><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></pre></div></td><td class="code"><div><pre><span></span>PUT<span class="w"> </span>/destobject<span class="w"> </span>HTTP/1.1
User-Agent:<span class="w"> </span>curl/7.29.0
Host:<span class="w"> </span>examplebucket.obs.region.example.com
Accept:<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>04:19:21<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:2rZR+iaH8xUewvUKuicLhLHpNoU=
x-obs-copy-source:<span class="w"> </span>/bucket/srcobject
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0082__section16705110192513"><h4 class="sectiontitle">Sample Response: Copying an Object</h4><div class="codecoloring" codetype="Xml" id="obs_04_0082__screen1217910182511"><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></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>200<span class="w"> </span>OK
Server:<span class="w"> </span>OBS
x-obs-request-id:<span class="w"> </span>001B21A61C6C00000134031BE8005293
x-obs-id-2:<span class="w"> </span>MDAxQjIxQTYxQzZDMDAwMDAxMzQwMzFCRTgwMDUyOTNBQUFBQUFBQWJiYmJiYmJi
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>04:19:21<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>249
<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;</span>
<span class="nt">&lt;CopyObjectResult</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;LastModified&gt;</span>2015-07-01T00:48:07.706Z<span class="nt">&lt;/LastModified&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;ETag&gt;</span>&quot;507e3fff69b69bf57d303e807448560b&quot;<span class="nt">&lt;/ETag&gt;</span><span class="w"> </span>
<span class="nt">&lt;/CopyObjectResult&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0082__section8758150152520"><h4 class="sectiontitle">Sample Request: Copying an Object Version</h4><p id="obs_04_0082__p18398511122614">Copy a multi-version object and copy the object <strong id="obs_04_0082__b11699433114514">srcobject</strong> whose version number is <strong id="obs_04_0082__b14166151204517">AAABQ4uBLdLc0vycq3gAAAAEVURTRkha</strong> in bucket <strong id="obs_04_0082__b17236115612454">bucket</strong> to the <strong id="obs_04_0082__b655770134611">destobject</strong> object in bucket <strong id="obs_04_0082__b131832420467">examplebucket</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0082__screen18745619263"><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></pre></div></td><td class="code"><div><pre><span></span>PUT<span class="w"> </span>/destobject<span class="w"> </span>HTTP/1.1
User-Agent:<span class="w"> </span>curl/7.29.0
Host:<span class="w"> </span>examplebucket.obs.region.example.com
Accept:<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>04:20:29<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:4BLYv+1UxfRSHBMvrhVLDszxvcY=
x-obs-copy-source:<span class="w"> </span>/bucket/srcobject?versionId=AAABQ4uBLdLc0vycq3gAAAAEVURTRkha
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0082__section13963521142616"><h4 class="sectiontitle">Sample Response: Copying an Object Version</h4><div class="codecoloring" codetype="Xml" id="obs_04_0082__screen168691651144711"><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>
<span class="normal">14</span>
<span class="normal">15</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>200<span class="w"> </span>OK
Server:<span class="w"> </span>OBS
x-obs-request-id:<span class="w"> </span>DCD2FC9CAB78000001438B8A9C898B79
x-obs-id-2:<span class="w"> </span>DB/qBZmbN6AIoX9mrrSNYdLxwvbO0tLR/l6/XKTT4NmZspzharwp5Z74ybAYVOgr
Content-Type:<span class="w"> </span>application/xml
x-obs-version-id:<span class="w"> </span>AAABQ4uKnOrc0vycq3gAAAAFVURTRkha
x-obs-copy-source-version-id:<span class="w"> </span>AAABQ4uBLdLc0vycq3gAAAAEVURTRkha
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>04:20:29<span class="w"> </span>GMT
Transfer-Encoding:<span class="w"> </span>chunked
<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;</span>
<span class="nt">&lt;CopyObjectResult</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;LastModified&gt;</span>2015-07-01T01:48:07.706Z<span class="nt">&lt;/LastModified&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;ETag&gt;</span>&quot;507e3fff69b69bf57d303e807448560b&quot;<span class="nt">&lt;/ETag&gt;</span><span class="w"> </span>
<span class="nt">&lt;/CopyObjectResult&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_0079.html">Operations on Objects</a></div>
</div>
</div>