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>
This commit is contained in:
zhangyue 2023-06-01 12:20:24 +00:00 committed by zuul
parent 94aa7bee24
commit 4e8841817b
21 changed files with 919 additions and 183 deletions

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -8,7 +8,14 @@
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0000__row9809112110017"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p764554411817">2023-01-30</p>
<tbody><tr id="obs_04_0000__row188561124124213"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p785616249428">2023-05-04</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p18848132264813">This is the sixth official release.</p>
<p id="obs_04_0000__p2085792414210">This issue incorporates the following change:</p>
<ul id="obs_04_0000__ul5519624320"><li id="obs_04_0000__li1517684310">Added APIs related to cross-region replication. For details, see <a href="obs_04_0046.html">Configuring Cross-Region Replication for a Bucket</a>, <a href="obs_04_0047.html">Obtaining the Cross-Region Replication Configuration of a Bucket</a>, and <a href="obs_04_0048.html">Deleting the Cross-Region Replication Configuration of a Bucket</a>.</li></ul>
</td>
</tr>
<tr id="obs_04_0000__row9809112110017"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p764554411817">2023-01-30</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p1259910249010">This is the fifth official release.</p>
<p id="obs_04_0000__p1459917241005">This issue incorporates the following changes:</p>

View File

@ -129,9 +129,24 @@
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p63334141820">Obtains the default storage class configuration of a bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row38862996"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p33548891"><a href="obs_04_0046.html">Configuring Cross-Region Replication for a Bucket</a></p>
</td>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p733154121819">Configures the cross-region replication function for a bucket. By activating the cross-region replication function, OBS can copy new objects and modified objects from a source bucket to destination buckets in different regions.</p>
</td>
</tr>
<tr id="obs_04_0005__row33504565"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p41925888"><a href="obs_04_0047.html">Obtaining the Cross-Region Replication Configuration of a Bucket</a></p>
</td>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p11331411184">Obtains the cross-region replication configuration of a specified bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row1149592412327"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p2925172593216"><a href="obs_04_0048.html">Deleting the Cross-Region Replication Configuration of a Bucket</a></p>
</td>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p103384161815">Deletes the cross-region replication configuration of a specified bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row293325416321"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p4935115411325"><a href="obs_04_0049.html">Configuring Tags for a Bucket</a></p>
</td>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p233104181813">Adds a tag to an existing bucket. <span style="color:#3D3F43;">After tags are added to a bucket, all charging data records (CDRs) generated by the requests for this bucket will have the same tags. Thus, CDR reports can be categorized for detailed cost analysis.</span></p>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p233104181813">Adds a tag to an existing bucket. <span style="color:#3D3F43;">After tags are added to a bucket, all service detail records (SDRs) generated by the requests for this bucket will have the same tags. You can categorize the SDRs for detailed cost analysis.</span></p>
</td>
</tr>
<tr id="obs_04_0005__row16359036133610"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p15359123613616"><a href="obs_04_0050.html">Obtaining Bucket Tags</a></p>
@ -288,7 +303,7 @@
</tr>
<tr id="obs_04_0005__row5345769"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p42768539"><a href="obs_04_0087.html">Restoring Cold Objects</a></p>
</td>
<td class="cellrowborder" valign="top" width="59.199999999999996%" headers="mcps1.3.4.2.2.3.1.2 "><p id="obs_04_0005__p99055582354">Restores Cold objects. These objects must be restored before they can be downloaded.</p>
<td class="cellrowborder" valign="top" width="59.199999999999996%" headers="mcps1.3.4.2.2.3.1.2 "><p id="obs_04_0005__p99055582354">Restores objects in the Cold storage class. You can download these objects only after they are restored.</p>
</td>
</tr>
<tr id="obs_04_0005__row55629712"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p48538422"><a href="obs_04_0089.html">Configuring an Object ACL</a></p>

View File

@ -757,7 +757,7 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<span class="k">else</span><span class="p">:</span>
<span class="n">hashed</span> <span class="o">=</span> <span class="n">hmac</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="n">yourSecretAccessKeyID</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">'UTF-8'</span><span class="p">),</span> <span class="n">canonical_string</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">'UTF-8'</span><span class="p">),</span><span class="n">hashlib</span><span class="o">.</span><span class="n">sha1</span><span class="p">)</span>
<span class="n">encode_canonical</span> <span class="o">=</span> <span class="n">binascii</span><span class="o">.</span><span class="n">b2a_base64</span><span class="p">(</span><span class="n">hashed</span><span class="o">.</span><span class="n">digest</span><span class="p">())[:</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s1">'UTF-8'</span><span class="p">)</span>
<span class="nb">print</span> <span class="n">encode_canonical</span>
<span class="nb">print</span><span class="p">(</span><span class="n">encode_canonical</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>

View File

@ -6,7 +6,7 @@
</div></div>
<p class="MsoNormal" id="obs_04_0021__p179081185526">A bucket name must be unique in OBS. If a user creates a bucket with the same name as that of an existing bucket under the same account and in the same region, a 200 code (indicating success) is returned. In scenarios other than the preceding one, the request for creating a bucket with the same name as that of an existing one will receive the 409 code (indicating that a namesake bucket already exists). To set an access control policy for the bucket to be created, you can add the <strong id="obs_04_0021__b9296141924716">x-obs-acl</strong> parameter to request headers.</p>
</div>
<div class="section" id="obs_04_0021__section63129189"><h4 class="sectiontitle">Storage Class</h4><p id="obs_04_0021__p1459963215332">You can create buckets with different storage classes. The <strong id="obs_04_0021__b1829607407">x-obs-storage-class</strong> header in a bucket creation request specifies the storage class for a bucket. If you do not specify a storage class when you upload an object to the bucket, the object inherits the storage class of the bucket. There are three storage classes: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class) If this header is not in the request, the storage class of the created bucket is Standard.</p>
<div class="section" id="obs_04_0021__section63129189"><h4 class="sectiontitle">Storage Class</h4><p id="obs_04_0021__p1459963215332">You can create buckets with different storage classes. The <strong id="obs_04_0021__b132269815">x-obs-storage-class</strong> header in a bucket creation request specifies the storage class for a bucket. If you do not specify a storage class when you upload an object to the bucket, the object inherits the storage class of the bucket. There are three storage classes: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class) If this header is not in the request, the storage class of the created bucket is Standard.</p>
<p class="MsoNormal" id="obs_04_0021__p148955">If the storage class of an object is not specified when it is uploaded to a bucket (see <a href="obs_04_0080.html">Uploading Objects - PUT</a>), the object will be stored in the default storage class of the bucket.</p>
<ul id="obs_04_0021__ul12065374"><li id="obs_04_0021__li41479503">OBS Standard features low access latency and high throughput. It is most suitable for storing frequently accessed (multiple times per month) hot files. Potential application scenarios include big data, mobile applications, trending videos, and social media images.</li><li id="obs_04_0021__li13303135113346">OBS Warm storage class is suitable for storing data that is infrequently accessed (less than 12 times a year) yet has quick response requirements. Potential application scenarios include file synchronization or sharing and enterprise backup. It provides the same durability, access latency, and throughput as the Standard storage class but at a lower price. However, the Warm storage class has lower availability than the Standard one.</li><li id="obs_04_0021__li16303751123411">OBS Cold storage class is applicable to archiving rarely-accessed (averagely once a year) data. The application scenarios include data archiving and long-term data retention for backup. The Cold storage class is secure, durable, and inexpensive, which can replace tape libraries. To keep cost low, it may take hours to restore data from the Cold storage class.</li></ul>
</div>
@ -53,7 +53,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0021__row4054265"><td class="cellrowborder" valign="top" width="24.490000000000002%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0021__p59960025">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p1638234817364">When creating a bucket, you can add this header to set the default storage class of the bucket. The default storage classes are as follows: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class). If this header is not in the request, the storage class of the bucket created is Standard.</p>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p1638234817364">When creating a bucket, you can add this header to specify the default storage class of the bucket. The default storage classes are as follows: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class). If this header is not in the request, the storage class of the bucket created is Standard.</p>
<p id="obs_04_0021__p22988206">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0021__p50105411">No</p>

View File

@ -36,6 +36,12 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0045.html">Obtaining Bucket Storage Class Information</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0046.html">Configuring Cross-Region Replication for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0047.html">Obtaining the Cross-Region Replication Configuration of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0048.html">Deleting the Cross-Region Replication Configuration of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0049.html">Configuring Tags for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0050.html">Obtaining Bucket Tags</a></strong><br>

View File

@ -4,7 +4,7 @@
<div id="body33721912"><div class="section" id="obs_04_0034__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0034__p44290180">This operation configures lifecycle rules that can delete or migrate objects from a bucket at a specified time. Typical application scenarios:</p>
<ul id="obs_04_0034__ul63067307"><li id="obs_04_0034__li35061754">Delete periodically uploaded files. Some files uploaded periodically need only to be retained for only one week or one month.</li><li id="obs_04_0034__li47120336">Delete files that are frequently accessed within a certain period of time but are seldom accessed afterward. You can archive these files and then schedule the time for deletion.</li><li id="obs_04_0034__li49751354242">The minimum time for the transition of the bucket storage to Warm or to Cold can be configured. The value ranges from <strong id="obs_04_0034__b842352706193456">24</strong> to <strong id="obs_04_0034__b84235270619350">8640</strong>.</li></ul>
<p class="msonormal" id="obs_04_0034__p30734851">You can perform this operation to create or update the lifecycle configuration of a bucket.</p>
<div class="note" id="obs_04_0034__note45356040"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="obs_04_0034__p21859552">Objects are permanently deleted upon the expiration of their lifecycle time, and the deleted objects cannot be restored.</p>
<div class="note" id="obs_04_0034__note45356040"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_04_0034__ul8398111715918"><li class="text" id="obs_04_0034__li33981517096">Expired objects deleted based on a lifecycle rule cannot be recovered.</li></ul>
</div></div>
<p class="msonormal" id="obs_04_0034__p8178206">To perform this operation, you must have the <strong id="obs_04_0034__b34476226">PutLifecycleConfiguration</strong> permission. By default, only the bucket owner can perform this operation. The bucket owner can grant the permission to other users by configuring the bucket policy or user policy.</p>
<p class="msonormal" id="obs_04_0034__p6494998">The lifecycle configuration enables OBS to delete objects and transition object storage classes at a scheduled time. To prevent a user from doing so, the following permissions granted to the user must be revoked:</p>
@ -126,7 +126,8 @@ Content-MD5:<span class="w"> </span>MD5
<p id="obs_04_0034__p41266197278">If the object of the latest version has the DeleteMarker and the object has this version only, this version will be deleted.</p>
<p id="obs_04_0034__p312681912275">If the object of the latest version has the DeleteMarker and the object has other versions, all versions of the object remain unchanged.</p>
</li></ul>
</li><li class="msonormal" id="obs_04_0034__li49157541956">The following lists the processing when the versioning is enabled or suspended for a bucket and objects of the latest versions meet the transition rules:</li><li class="msonormal" id="obs_04_0034__li1241419577520">If the latest version of the object has the DeleteMarker, the storage class of this version will not be transitioned.</li><li class="msonormal" id="obs_04_0034__li1240125919514">If the latest version of the object does not have the DeleteMarker and meets the transition rule, the storage class of this version will be transitioned.</li></ul>
</li><li class="msonormal" id="obs_04_0034__li49157541956">The following lists the processing when the versioning is enabled or suspended for a bucket and objects of the latest versions meet the transition rules:<ul id="obs_04_0034__ul1312555284313"><li class="msonormal" id="obs_04_0034__li1241419577520">If the latest version of the object has the DeleteMarker, the storage class of this version will not be transitioned.</li><li class="msonormal" id="obs_04_0034__li1240125919514">If the latest version of the object does not have the DeleteMarker and meets the transition rule, the storage class of this version will be transitioned.</li></ul>
</li></ul>
<div class="tablenoborder"><a name="obs_04_0034__table49391898171726"></a><a name="table49391898171726"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0034__table49391898171726" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements for lifecycle configuration</caption><thead align="left"><tr id="obs_04_0034__row22939932"><th align="left" class="cellrowborder" valign="top" width="27.27%" id="mcps1.3.5.4.2.4.1.1"><p id="obs_04_0034__p46195190">Name</p>
</th>
@ -219,7 +220,7 @@ Content-MD5:<span class="w"> </span>MD5
<p id="obs_04_0034__p20305823">Children node: NoncurrentDays, StorageClass</p>
<p id="obs_04_0034__p48534684">Ancestor node: Rule</p>
</td>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p38995332">Required if the <strong id="obs_04_0034__b2001973235">Transition</strong>, <strong id="obs_04_0034__b921484426">Expiration</strong>, <strong id="obs_04_0034__b187701445812">AbortIncompleteMultipartUpload</strong>, or <strong id="obs_04_0034__b937105170">NoncurrentVersionExpiration</strong> element is absent.</p>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p38995332">Required if the <strong id="obs_04_0034__b1052720015">Transition</strong>, <strong id="obs_04_0034__b2077837494">Expiration</strong>, <strong id="obs_04_0034__b187701445812">AbortIncompleteMultipartUpload</strong>, or <strong id="obs_04_0034__b2021471685">NoncurrentVersionExpiration</strong> element is absent.</p>
</td>
</tr>
<tr id="obs_04_0034__row15413673"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0034__p40548035">NoncurrentVersionExpiration</p>
@ -255,7 +256,7 @@ Content-MD5:<span class="w"> </span>MD5
</tr>
<tr id="obs_04_0034__row40331056"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0034__p45590100">Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="52.53%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0034__p1810649">Object name prefix identifying one or more objects to which the rule applies.</p>
<td class="cellrowborder" valign="top" width="52.53%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0034__p1810649">Object name prefix that identifies one or more objects to which the rule applies.</p>
<p id="obs_04_0034__p16295847">Type: string</p>
<p id="obs_04_0034__p12444903">Ancestor node: Rule</p>
<p id="obs_04_0034__p179517215526">Constraints:</p>
@ -298,7 +299,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0034__section47227600"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0034__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
</div>
<div class="section" id="obs_04_0034__section22395217"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0034__p49591759">This response contains no elements.</p>
<div class="section" id="obs_04_0034__section22395217"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0034__p49591759">This response involves no elements.</p>
</div>
<div class="section" id="obs_04_0034__section230369"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0034__p57509508">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>

View File

@ -46,7 +46,7 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>
<td class="cellrowborder" valign="top" width="51%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0044__p23397285">Specifies the default storage class for a bucket.</p>
<p id="obs_04_0044__p4701910132510">Type: string</p>
<p id="obs_04_0044__p78072113256">Value options: STANDARD | WARM | COLD</p>
<p id="obs_04_0044__p15884183444011">There are three storage classes: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class) Therefore, the following values can be configured: <strong id="obs_04_0044__b278871917">STANDARD</strong>, <strong id="obs_04_0044__b880845233">WARM</strong>, and <strong id="obs_04_0044__b635928987">COLD</strong>.</p>
<p id="obs_04_0044__p15884183444011">The available storage classes include Standard (<strong id="obs_04_0044__b116747265409">STANDARD</strong>), Warm (<strong id="obs_04_0044__b13777134919406">WARM</strong>), and Cold (<strong id="obs_04_0044__b0223652194012">COLD</strong>).</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0044__p10969390">Yes</p>
</td>

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,74 @@
<a name="obs_04_0048"></a><a name="obs_04_0048"></a>
<h1 class="topictitle1">Deleting the Cross-Region Replication Configuration of a Bucket</h1>
<div id="body36851735"><div class="section" id="obs_04_0048__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0048__p25416923">You can perform this operation to delete the bucket replication configuration. To perform this operation, you must have the <strong id="obs_04_0048__b17330132392219">DeleteReplicationConfiguration</strong> permission.</p>
</div>
<div class="section" id="obs_04_0048__section27425723"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0048__screen32200572"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span>DELETE<span class="w"> </span>/?replication<span class="w"> </span>HTTP/1.1<span class="w"> </span>
Host:<span class="w"> </span>bucketname.obs.region.example.com
Date:<span class="w"> </span>date<span class="w"> </span>
Authorization:<span class="w"> </span>authorization<span class="w"> </span>string
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0048__section45504922"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0048__p11140229">This request contains no message parameters.</p>
</div>
<div class="section" id="obs_04_0048__section6891122"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0048__p29943339">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="obs_04_0048__section62020098"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0048__p18314015">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0048__section21309972"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0048__screen7040276"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>204<span class="w"> </span>No<span class="w"> </span>Content<span class="w"> </span>
Server:<span class="w"> </span>OBS<span class="w"> </span>
Date:<span class="w"> </span>date<span class="w"> </span>
Connection:<span class="w"> </span>keep-alive
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0048__section57572026"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0048__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
</div>
<div class="section" id="obs_04_0048__section48386187"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0048__p18525005">This response involves no elements.</p>
</div>
<div class="section" id="obs_04_0048__section32822506"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0048__p24130428">No special error responses are returned for this request.</p>
</div>
<div class="section" id="obs_04_0048__section14482163815396"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0048__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></pre></div></td><td class="code"><div><pre><span></span>DELETE<span class="w"> </span>/?replication<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>27<span class="w"> </span>Jun<span class="w"> </span>2018<span class="w"> </span>13:45:50<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:3ycNYD0CfMf0gOmmXzdGJ58KjHU=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0048__section76081155815"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0048__screen8485113814"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>204<span class="w"> </span>No<span class="w"> </span>Content
Server:<span class="w"> </span>OBS
x-obs-request-id:<span class="w"> </span>900B000001643FE6BBCC9C9F54FA7A7E
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABSAAgAAEAABAAAQAAEAABCS8Exs52zCf9duxPLnBircmGa/JOCjec
Date:<span class="w"> </span>Wed,<span class="w"> </span>27<span class="w"> </span>Jun<span class="w"> </span>2018<span class="w"> </span>13:45:50<span class="w"> </span>GMT
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0026.html">Advanced Bucket Settings</a></div>
</div>
</div>

View File

@ -8,7 +8,7 @@
<p class="msonormal" id="obs_04_0080__p64200303">You can also specify the value of the <strong id="obs_04_0080__b1461685225154325">x-obs-acl</strong> parameter to configure an access control policy for the object. If the <strong id="obs_04_0080__b8947184165818">x-obs-acl</strong> parameter is not specified when an anonymous user uploads an object, the object can be accessed by all OBS users by default.</p>
<p class="msonormal" id="obs_04_0080__p40931822">This operation supports server-side encryption.</p>
<p id="obs_04_0080__p1017591824310">For a single upload, the size of the object to be uploaded ranges [0, 5 GB]. To upload a file greater than 5 GB, see <a href="obs_04_0096.html">Operations on Multipart Upload</a>.</p>
<p id="obs_04_0080__p1130673486">OBS does not have real folders. To facilitate data management, OBS provides a method to simulate a folder by adding a slash (/) to the object name, for example, <strong id="obs_04_0080__b16916144518106">test/123.jpg</strong>. You can simulate <strong id="obs_04_0080__b1183114613107">test</strong> as a folder and <strong id="obs_04_0080__b183314461104">123.jpg</strong> as the name of a file under the <strong id="obs_04_0080__b19834154641019">test</strong> folder. However, the object key remains <strong id="obs_04_0080__b148351346101015">test/123.jpg</strong>. Objects named in this format appear as folders on the console.</p>
<p id="obs_04_0080__p1130673486">OBS does not have real folders. To facilitate data management, OBS provides a method to simulate a folder by adding a slash (/) to the object name, for example, <strong id="obs_04_0080__b16916144518106">test/123.jpg</strong>. You can simulate <strong id="obs_04_0080__b1183114613107">test</strong> as a folder and <strong id="obs_04_0080__b183314461104">123.jpg</strong> as the name of a file under the <strong id="obs_04_0080__b19834154641019">test</strong> folder. However, the object key remains <strong id="obs_04_0080__b148351346101015">test/123.jpg</strong>. Objects named in this format appear as folders on the console. When you upload an object larger than 0 in size using this format, an empty folder will be displayed on the console, but the occupied storage capacity is the actual object size.</p>
</div>
<div class="section" id="obs_04_0080__section9125142514612"><h4 class="sectiontitle">Differences Between PUT and POST Methods</h4><p id="obs_04_0080__p154258324469">Parameters are passed through the request header if the PUT method is used to upload objects; if the POST method is used to upload objects, parameters are passed through the form field in the message body.</p>
<p id="obs_04_0080__p92971585546">With the PUT method, you need to specify the object name in the URL, but object name is not required with the POST method, which uses the bucket domain name as the URL. The request lines of the two methods are as follows:</p>
@ -196,7 +196,7 @@ Date:<span class="w"> </span>date
<tr id="obs_04_0080__row849053217272"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0080__p16490173217273">success-action-redirect</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p28747278">Indicates the address (URL) to which a successfully responded request is redirected.</p>
<ul id="obs_04_0080__ul57398910"><li id="obs_04_0080__li46828145">If the value is valid and the request is successful, OBS returns status code 303. <strong id="obs_04_0080__b50725990">Location</strong> contains <strong id="obs_04_0080__b8423527069138">success_action_redirect</strong> as well as the bucket name, object name, and object ETag.</li><li id="obs_04_0080__li18800129">If this parameter is invalid, OBS ignores this parameter. The response code is 204, and the <strong id="obs_04_0080__b1941394117223">Location</strong> is the object address.</li></ul>
<ul id="obs_04_0080__ul57398910"><li id="obs_04_0080__li46828145">If the value is valid and the request is successful, OBS returns status code 303. <strong id="obs_04_0080__b50725990">Location</strong> contains <strong id="obs_04_0080__b8423527069138">success_action_redirect</strong> as well as the bucket name, object name, and object ETag.</li><li id="obs_04_0080__li18800129">If this parameter value is invalid, OBS ignores this parameter. In such case, the <strong id="obs_04_0080__b170793813459">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_0080__p34983438">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0080__p134912032112711">No</p>
@ -230,7 +230,7 @@ Content-Type:<span class="w"> </span>type
<div class="section" id="obs_04_0080__section3742912"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0080__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_0080__p30613480">In addition to the common response headers, the following message headers may also be used. For details, see <a href="#obs_04_0080__table24122936102344">Table 2</a>.</p>
<div class="tablenoborder"><a name="obs_04_0080__table24122936102344"></a><a name="table24122936102344"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0080__table24122936102344" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0080__row36471658"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.9.4.2.3.1.1"><p id="obs_04_0080__p1414299">Header</p>
<div class="tablenoborder"><a name="obs_04_0080__table24122936102344"></a><a name="table24122936102344"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0080__table24122936102344" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0080__row36471658"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.9.4.2.3.1.1"><p id="obs_04_0080__p1414299">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.9.4.2.3.1.2"><p id="obs_04_0080__p47449426">Description</p>
</th>

View File

@ -312,7 +312,7 @@ Upload<span class="w"> </span>to<span class="w"> </span>OBS<span class="w"> </sp
<tr id="obs_04_0081__row14129871"><td class="cellrowborder" valign="top" width="29.592959295929592%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0081__p3668922">success_action_redirect</p>
</td>
<td class="cellrowborder" valign="top" width="61.22612261226122%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0081__p28747278">Indicates the address (URL) to which a successfully responded request is redirected.</p>
<ul id="obs_04_0081__ul57398910"><li id="obs_04_0081__li46828145">If the value is valid and the request is successful, OBS returns status code 303. <strong id="obs_04_0081__b50725990">Location</strong> contains <strong id="obs_04_0081__b8423527069138">success_action_redirect</strong> as well as the bucket name, object name, and object ETag.</li><li id="obs_04_0081__li18800129">If this parameter is invalid, OBS ignores this parameter. The response code is 204, and the <strong id="obs_04_0081__b1758312784816">Location</strong> is the object address.</li></ul>
<ul id="obs_04_0081__ul57398910"><li id="obs_04_0081__li46828145">If the value is valid and the request is successful, OBS returns status code 303. <strong id="obs_04_0081__b50725990">Location</strong> contains <strong id="obs_04_0081__b8423527069138">success_action_redirect</strong> as well as the bucket name, object name, and object ETag.</li><li id="obs_04_0081__li18800129">If this parameter value is invalid, OBS ignores this parameter. In such case, the <strong id="obs_04_0081__b198741629194916">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_0081__p34983438">Type: string</p>
<p id="obs_04_0081__p46415489">An example is provided as follows:</p>
<p id="obs_04_0081__p15086219">In POLICY: {"success_action_redirect": "http://123458.com"},</p>
@ -436,7 +436,7 @@ ETag:<span class="w"> </span>etag
<div class="section" id="obs_04_0081__section18864917"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0081__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_0081__p15525038">In addition to the common response headers, the following message headers may also be used. For details, see <a href="#obs_04_0081__table35215532173747">Table 3</a>.</p>
<div class="tablenoborder"><a name="obs_04_0081__table35215532173747"></a><a name="table35215532173747"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0081__table35215532173747" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0081__row9381568"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.9.4.2.3.1.1"><p id="obs_04_0081__p21709532">Header</p>
<div class="tablenoborder"><a name="obs_04_0081__table35215532173747"></a><a name="table35215532173747"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0081__table35215532173747" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0081__row9381568"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.9.4.2.3.1.1"><p id="obs_04_0081__p21709532">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.9.4.2.3.1.2"><p id="obs_04_0081__p13641628">Description</p>
</th>

View File

@ -260,7 +260,7 @@ Date:<span class="w"> </span>date
<tr id="obs_04_0082__row1736618368212"><td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.6.3.2.4.1.1 "><p id="obs_04_0082__p3668922">success_action_redirect</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0082__p28747278">Indicates the address (URL) to which a successfully responded request is redirected.</p>
<ul id="obs_04_0082__ul57398910"><li id="obs_04_0082__li46828145">If the value is valid and the request is successful, OBS returns status code 303. <strong id="obs_04_0082__b10498135144020">Location</strong> contains <strong id="obs_04_0082__b2499193511401">success_action_redirect</strong> as well as the bucket name, object name, and object ETag.</li><li id="obs_04_0082__li18800129">If this parameter is invalid, OBS ignores this parameter. The response code is 204, and the <strong id="obs_04_0082__b2198454114017">Location</strong> is the object address.</li></ul>
<ul id="obs_04_0082__ul57398910"><li id="obs_04_0082__li46828145">If the value is valid and the request is successful, OBS returns status code 303. <strong id="obs_04_0082__b10498135144020">Location</strong> contains <strong id="obs_04_0082__b2499193511401">success_action_redirect</strong> as well as the bucket name, object name, and object ETag.</li><li id="obs_04_0082__li18800129">If this parameter value is invalid, OBS ignores this parameter. In such case, the <strong id="obs_04_0082__b954018371494">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__p34983438">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.6.3.2.4.1.3 "><p id="obs_04_0082__p59109014">No</p>
@ -299,7 +299,7 @@ Content-Length:<span class="w"> </span>length
<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 following message headers may also be used. For details, see <a href="#obs_04_0082__table45458228101549">Table 2</a>.</p>
<div class="tablenoborder"><a name="obs_04_0082__table45458228101549"></a><a name="table45458228101549"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0082__table45458228101549" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0082__row55626814"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.9.4.2.3.1.1"><p id="obs_04_0082__p9478074">Header</p>
<div class="tablenoborder"><a name="obs_04_0082__table45458228101549"></a><a name="table45458228101549"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0082__table45458228101549" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0082__row55626814"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.9.4.2.3.1.1"><p id="obs_04_0082__p9478074">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.9.4.2.3.1.2"><p id="obs_04_0082__p29526490">Description</p>
</th>

View File

@ -120,7 +120,7 @@ Last-Modified:<span class="w"> </span>time
<div class="section" id="obs_04_0084__section35159826"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0084__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_0084__p56384785">In addition to the common response headers, the following message headers may also be used. For details, see <a href="#obs_04_0084__table53333691145218">Table 3</a>.</p>
<div class="tablenoborder"><a name="obs_04_0084__table53333691145218"></a><a name="table53333691145218"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0084__table53333691145218" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0084__row48853136"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0084__p64789980">Header</p>
<div class="tablenoborder"><a name="obs_04_0084__table53333691145218"></a><a name="table53333691145218"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0084__table53333691145218" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0084__row48853136"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0084__p64789980">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.8.4.2.3.1.2"><p id="obs_04_0084__p13496995">Description</p>
</th>
@ -213,7 +213,7 @@ Last-Modified:<span class="w"> </span>time
</tr>
<tr id="obs_04_0084__row14185683"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.8.4.2.3.1.1 "><p id="obs_04_0084__p8189661">x-obs-restore</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0084__p59382824">This header is returned when a Cold object is being restored or has been restored. It represents the object's restore status, which can be <strong id="obs_04_0084__b498324182620">ongoing-request="true"</strong> (the object is being restored) or <strong id="obs_04_0084__b515710509266">ongoing-request="false", expiry-date="Wed, 07 Nov 2012 00:00:00 GMT"</strong> (the object has been restored). In these statuses, <strong id="obs_04_0084__b1657562310287">expiry-date</strong> indicates when the restored object will expire.</p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0084__p59382824">This header is returned when a Cold object is being restored or has been restored. It represents the object's restore status, which can be <strong id="obs_04_0084__b498324182620">ongoing-request="true"</strong> (the object is being restored) or <strong id="obs_04_0084__b515710509266">ongoing-request="false", expiry-date="Wed, 7 Nov 2012 00:00:00 GMT"</strong> (the object has been restored). In these statuses, <strong id="obs_04_0084__b1657562310287">expiry-date</strong> indicates when the restored object will expire.</p>
<p id="obs_04_0084__p64683373">Type: string</p>
</td>
</tr>

View File

@ -53,9 +53,9 @@ Date:<span class="w"> </span>date
</div>
</div>
<div class="section" id="obs_04_0085__section1814760"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0085__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_0085__p24800784">In addition to the common response headers, the following message headers may also be used. For details, see <a href="#obs_04_0085__table862048515455">Table 2</a>.</p>
<p class="msonormal" id="obs_04_0085__p24800784">If versioning is enabled for the bucket, the headers listed in <a href="#obs_04_0085__table862048515455">Table 2</a> may also be used.</p>
<div class="tablenoborder"><a name="obs_04_0085__table862048515455"></a><a name="table862048515455"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0085__table862048515455" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0085__row25289386"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0085__p35174418">Header</p>
<div class="tablenoborder"><a name="obs_04_0085__table862048515455"></a><a name="table862048515455"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0085__table862048515455" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0085__row25289386"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0085__p35174418">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.8.4.2.3.1.2"><p id="obs_04_0085__p30555594">Description</p>
</th>
@ -73,7 +73,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0085__p3614399">Object version ID. If the object has no version number specified, the response does not contain this header.</p>
<p id="obs_04_0085__p32529595">Valid value: character string</p>
<p id="obs_04_0085__p24330907">There is no default value.</p>
<p id="obs_04_0085__p24330907">Default value: none</p>
</td>
</tr>
</tbody>

View File

@ -77,8 +77,8 @@ Content-MD5: <em id="obs_04_0087__i52653375">MD5</em>
<tr id="obs_04_0087__row32763158"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.2.4.1.1 "><p id="obs_04_0087__p36570173">Tier</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.2.4.1.2 "><p id="obs_04_0087__p9393999">Restore options: <strong id="obs_04_0087__b73716351645">Expedited</strong> | <strong id="obs_04_0087__b178334417418">Standard</strong></p>
<p id="obs_04_0087__p17437133"><strong id="obs_04_0087__b11741217382">Expedited</strong> indicates that objects can be quickly restored within 1 to 5 minutes from Archive storage and within 3 to 5 hours from Deep Archive storage.</p>
<p id="obs_04_0087__p22716470"><strong id="obs_04_0087__b854013204398">Standard</strong> indicates that objects can be restored within 3 to 5 hours from Archive storage and within 5 to 12 hours from Deep Archive storage.</p>
<p id="obs_04_0087__p17437133"><strong id="obs_04_0087__b11741217382">Expedited</strong> indicates that objects can be quickly restored from Archive storage within 1 to 5 minutes.</p>
<p id="obs_04_0087__p22716470"><strong id="obs_04_0087__b854013204398">Standard</strong> indicates that objects can be restored from Archive storage within 3 to 5 hours.</p>
<p id="obs_04_0087__p3121645">The default value is <strong id="obs_04_0087__b106617291510">Standard</strong>.</p>
<p id="obs_04_0087__p28094810">Type: string</p>
</td>

View File

@ -139,7 +139,7 @@ Date:<span class="w"> </span>date
<div class="section" id="obs_04_0102__section4676100"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0102__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 id="obs_04_0102__p27104446">In addition to the common response headers, the following message headers may also be used. For details, see <a href="#obs_04_0102__table31698209142128">Table 3</a>.</p>
<div class="tablenoborder"><a name="obs_04_0102__table31698209142128"></a><a name="table31698209142128"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0102__table31698209142128" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0102__row6742918"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0102__p9305492">Header</p>
<div class="tablenoborder"><a name="obs_04_0102__table31698209142128"></a><a name="table31698209142128"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0102__table31698209142128" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0102__row6742918"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0102__p9305492">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.8.4.2.3.1.2"><p id="obs_04_0102__p15547427">Description</p>
</th>

View File

@ -27,6 +27,8 @@
</tbody>
</table>
</div>
<div class="note" id="obs_04_0114__note18624733101916"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0114__p1667644071915">Send API requests using the HTTP/HTTPS format that complies with <strong id="obs_04_0114__b223863943417">https://www.ietf.org/rfc/rfc2616.txt</strong>.</p>
</div></div>
</div>
<div>
<div class="familylinks">

View File

@ -160,18 +160,19 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p8446421130">EntityTooLarge</p>
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p244618211833">The size of the object uploaded using the POST method exceeds the upper limit.</p>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><ul id="obs_04_0115__ul10382105518364"><li id="obs_04_0115__li203821155143612">The size of the file uploaded using the PUT, POST, or Append methods of SDKs or APIs exceeds 5 GB.</li><li id="obs_04_0115__li4636310163320">The part uploaded is larger than 5 GB in size.</li><li id="obs_04_0115__li5546223151411">The size of the bucket configurations exceeds 20 KB.</li><li id="obs_04_0115__li5357134013920">The file size exceeds the upper limit defined in the policy of the POST form.</li></ul>
<ul id="obs_04_0115__ul145911429122913"><li id="obs_04_0115__li66048411305">The size of the file uploaded using the multipart upload of SDKs or APIs or the resumable upload of SDKs exceeds 48.8 TB.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p1544619211938">Modify the conditions specified in the policy when posting the object or reduce the object size.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p1544619211938">Modify the conditions specified in the upload policy or reduce the object size.</p>
</td>
</tr>
<tr id="obs_04_0115__row50429802"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p15446132113311">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p144617213313">EntityTooSmall</p>
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p10446192114317">The size of the object uploaded using the POST method does not reach the lower limit.</p>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><ul id="obs_04_0115__ul1064144510535"><li id="obs_04_0115__li0641164545318">The part uploaded, except the last one, is smaller than 100 KB.</li><li id="obs_04_0115__li1156205117535">The file size is smaller than the lower limit defined in the policy of the POST form.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p10446132110320">Modify the conditions specified in the policy when posting the object or increase the object size.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p10446132110320">Modify the conditions specified in the upload policy or increase the object size.</p>
</td>
</tr>
<tr id="obs_04_0115__row25015010"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p194465215318">400 Bad Request</p>
@ -228,6 +229,24 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p1044613211311">Change the bucket name.</p>
</td>
</tr>
<tr id="obs_04_0115__row10807152218223"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p5606345172211">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p1360674592214">InvalidContentLength</p>
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p1606204582210">Invalid Content-Length value.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p18606204592212">Check the encapsulation header or contact technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row14913292594"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p156809312597">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p18680103114592">InvalidDefaultStorageClass</p>
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p20680173105919">The default storage class is invalid.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p1368019317598">Check which storage classes can be used.</p>
</td>
</tr>
<tr id="obs_04_0115__row47770559"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p544614211936">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p34467216314">InvalidEncryptionAlgorithmError</p>
@ -444,6 +463,15 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p24191590310">Provide required headers.</p>
</td>
</tr>
<tr id="obs_04_0115__row26491442122314"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p334316543232">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p1434345442317">MultipleContentLengths</p>
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p0343454102318">There are multiple Content-Length headers.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p634319547230">Check the encapsulation header or contact technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row56710568"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p442115591313">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p442185917315">TooManyBuckets</p>