vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity

OBS S3 API DOC

Browse Source 
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 2024-02-26 11:17:13 +00:00 committed by zuul
parent c62a547174
commit 6fcdbfd13e
30 changed files with 3057 additions and 493 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1009
docs/obs/s3api/ALL_META.TXT.json
View File

File diff suppressed because it is too large Load Diff

164
docs/obs/s3api/CLASS.TXT.json
View File

File diff suppressed because it is too large Load Diff

2
docs/obs/s3api/en-us_topic_0000001080550512.html
View File

@ -120,7 +120,7 @@ User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="EN-US_TOPIC_0000001080550512__i12367117502">region</em>.example.com
Accept: */*
Date: Thu, 21 Feb 2019 03:05:34 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:DpSAlmLX/BTdjxU5HOEwflhM0WI=</pre>
Authorization: authorization</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000001080550512__section22471632"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0000001080550512__screen47322359204949">HTTP/1.1 200 OK
Server: OBS

2
docs/obs/s3api/en-us_topic_0000001080838596.html
View File

@ -145,7 +145,7 @@ 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>Thu,<span class="w"> </span>21<span class="w"> </span>Feb<span class="w"> </span>2019<span class="w"> </span>03:05:34<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:DpSAlmLX/BTdjxU5HOEwflhM0WI=
Authorization:<span class="w"> </span>authorization
Content-Length:<span class="w"> </span>778
<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>

2
docs/obs/s3api/en-us_topic_0000001127815293.html
View File

@ -53,7 +53,7 @@ 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>Tue,<span class="w"> </span>08<span class="w"> </span>Jan<span class="w"> </span>2019<span class="w"> </span>13:18:35<span class="w"> </span>+0000
Authorization:<span class="w"> </span>OBS<span class="w"> </span>UDSIAMSTUBTEST000001:UT9F2YUgaFu9uFGMmxFj2CBgQHs=
Authorization:<span class="w"> </span>authorization
</pre></div></td></tr></table></div>
</div>

198
docs/obs/s3api/en-us_topic_0000001635744308.html Normal file
View File

File diff suppressed because it is too large Load Diff

46
docs/obs/s3api/en-us_topic_0000001684063985.html Normal file
View File

@ -0,0 +1,46 @@
<a name="EN-US_TOPIC_0000001684063985"></a><a name="EN-US_TOPIC_0000001684063985"></a>
<h1 class="topictitle1">DELETE Bucket Replication</h1>
<div id="body0000001684063985"><p class="msonormal" id="EN-US_TOPIC_0000001684063985__p30355189">This operation deletes the bucket replication configuration. Only users have the <strong id="EN-US_TOPIC_0000001684063985__b50297679">s3:DeleteReplicationConfiguration</strong> permission can perform this operation.</p>
<div class="section" id="EN-US_TOPIC_0000001684063985__section57518732"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0000001684063985__screen42357575">DELETE /?replication HTTP/1.1
Host: <em id="EN-US_TOPIC_0000001684063985__i123151210135">bucketname</em>.obs.<em id="EN-US_TOPIC_0000001684063985__i11315151191312">region</em>.example.com
Date: date
Authorization: authorization string</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000001684063985__section30408220"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="EN-US_TOPIC_0000001684063985__p66660433">This request contains no parameter.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001684063985__section5238527"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="EN-US_TOPIC_0000001684063985__p30785969">This request uses common headers. For details about common request headers, see the section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001684063985__section47146745"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="EN-US_TOPIC_0000001684063985__p10635570">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001684063985__section46270551"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0000001684063985__screen26997610122811">HTTP/1.1 204 No Content
Server: OBS
x-amz-id-2:id
x-amz-request-id:id
Date: date
Connection: keep-alive</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000001684063985__section39682040"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="EN-US_TOPIC_0000001684063985__p4179377">This response uses common headers. For details about common response headers, see the section <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001684063985__section21594040"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="EN-US_TOPIC_0000001684063985__p2985227">This response involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001684063985__section60128634"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0000001684063985__p8258615">No special error responses are returned. For details about error responses, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001684063985__section32323009"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0000001684063985__screen64813472204553">DELETE /?replication HTTP/1.1
Host: examplebucket.obs.<em id="EN-US_TOPIC_0000001684063985__i12367117502">region</em>.example.com
Date: Wed, 11 Feb 2015 05:37:16 GMT
Authorization: signatureValue</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000001684063985__section22471632"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0000001684063985__screen47322359204949">HTTP/1.1 204 No Content
Server: OBS
x-amz-id-2: Uuag1LuByRx9e6j5OnimrSAMPLEtRPfTaOAa==
x-amz-request-id: 656c76696e672example
Date: Wed, 11 Feb 2015 05:37:16 GMT</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560493.html">Operations on Buckets</a></div>
</div>
</div>

222
docs/obs/s3api/en-us_topic_0000001684183953.html Normal file
View File

File diff suppressed because it is too large Load Diff

174
docs/obs/s3api/en-us_topic_0000001759314566.html Normal file
View File

File diff suppressed because it is too large Load Diff

165
docs/obs/s3api/en-us_topic_0000001806154009.html Normal file
View File

File diff suppressed because it is too large Load Diff

189
docs/obs/s3api/en-us_topic_0000001806313033.html Normal file
View File

File diff suppressed because it is too large Load Diff

28
docs/obs/s3api/en-us_topic_0125560258.html
View File

@ -143,20 +143,20 @@
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;CORSConfiguration xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;CORSRule&gt;
&lt;AllowedMethod&gt;POST&lt;/AllowedMethod&gt;
&lt;AllowedMethod&gt;GET&lt;/AllowedMethod&gt;
&lt;AllowedMethod&gt;HEAD&lt;/AllowedMethod&gt;
&lt;AllowedMethod&gt;PUT&lt;/AllowedMethod&gt;
&lt;AllowedMethod&gt;DELETE&lt;/AllowedMethod&gt;
&lt;AllowedOrigin&gt;obs.example.com&lt;/AllowedOrigin&gt;
&lt;AllowedOrigin&gt;www.example.com&lt;/AllowedOrigin&gt;
&lt;AllowedHeader&gt;AllowedHeader_1&lt;/AllowedHeader&gt;
&lt;AllowedHeader&gt;AllowedHeader_2&lt;/AllowedHeader&gt;
&lt;MaxAgeSeconds&gt;100&lt;/MaxAgeSeconds&gt;
&lt;ExposeHeader&gt;ExposeHeader_1&lt;/ExposeHeader&gt;
&lt;ExposeHeader&gt;ExposeHeader_2&lt;/ExposeHeader&gt;
&lt;/CORSRule&gt;
&lt;CORSRule&gt;
&lt;AllowedMethod&gt;POST&lt;/AllowedMethod&gt;
&lt;AllowedMethod&gt;GET&lt;/AllowedMethod&gt;
&lt;AllowedMethod&gt;HEAD&lt;/AllowedMethod&gt;
&lt;AllowedMethod&gt;PUT&lt;/AllowedMethod&gt;
&lt;AllowedMethod&gt;DELETE&lt;/AllowedMethod&gt;
&lt;AllowedOrigin&gt;obs.example.com&lt;/AllowedOrigin&gt;
&lt;AllowedOrigin&gt;www.example.com&lt;/AllowedOrigin&gt;
&lt;AllowedHeader&gt;AllowedHeader_1&lt;/AllowedHeader&gt;
&lt;AllowedHeader&gt;AllowedHeader_2&lt;/AllowedHeader&gt;
&lt;MaxAgeSeconds&gt;100&lt;/MaxAgeSeconds&gt;
&lt;ExposeHeader&gt;ExposeHeader_1&lt;/ExposeHeader&gt;
&lt;ExposeHeader&gt;ExposeHeader_2&lt;/ExposeHeader&gt;
&lt;/CORSRule&gt;
&lt;/CORSConfiguration&gt;</pre>
</div>
</div>

254
docs/obs/s3api/en-us_topic_0125560263.html
View File

File diff suppressed because it is too large Load Diff

19
docs/obs/s3api/en-us_topic_0125560276.html
View File

@ -6,11 +6,26 @@
<th valign="bottom" align="left" id="stentry13652467194436" width="69.36%"><p id="EN-US_TOPIC_0125560276__p55763344194436">What's New</p>
</th>
</tr>
<tr id="EN-US_TOPIC_0125560276__strow424922518459"><td valign="top" id="stentry13249132513459" headers="stentry41593773194436"><p id="EN-US_TOPIC_0125560276__p110883410430">2024-01-19</p>
</td>
<td valign="top" id="stentry524962510454" headers="stentry13652467194436"><p id="EN-US_TOPIC_0125560276__p10453155212431">Updated the following content:</p>
<ul id="EN-US_TOPIC_0125560276__ul11748132910481"><li id="EN-US_TOPIC_0125560276__li10449016114711">Updated remarks about the GET Bucket location API in the "Compatibility of OBS REST APIs" section.</li><li id="EN-US_TOPIC_0125560276__li1144914168473">Added WORM-related APIs:<ul id="EN-US_TOPIC_0125560276__ul660013211477"><li id="EN-US_TOPIC_0125560276__li174842984811"><a href="en-us_topic_0000001806313033.html">Configuring a Default WORM Policy for a Bucket</a></li><li id="EN-US_TOPIC_0125560276__li1986464017481"><a href="en-us_topic_0000001759314566.html">Obtaining the Default WORM Policy of a Bucket</a></li><li id="EN-US_TOPIC_0125560276__li10248145214819"><a href="en-us_topic_0000001806154009.html">Configuring WORM Retention for an Object</a></li></ul>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560276__strow156027385539"><td valign="top" id="stentry5603183819531" headers="stentry41593773194436"><p id="EN-US_TOPIC_0125560276__p360317381538">2023-08-18</p>
</td>
<td valign="top" id="stentry1960393816539" headers="stentry13652467194436"><p id="EN-US_TOPIC_0125560276__p3603123865319">Updated the following content:</p>
<p id="EN-US_TOPIC_0125560276__p1979395605718">Added the APIs related to cross-region replication.</p>
<ul id="EN-US_TOPIC_0125560276__ul171861385011"><li id="EN-US_TOPIC_0125560276__li161869381901"><a href="en-us_topic_0000001684183953.html">PUT Bucket Replication</a></li><li id="EN-US_TOPIC_0125560276__li86144573011"><a href="en-us_topic_0000001635744308.html">GET Bucket Replication</a></li><li id="EN-US_TOPIC_0125560276__li472671014114"><a href="en-us_topic_0000001684063985.html">DELETE Bucket Replication</a></li></ul>
<p id="EN-US_TOPIC_0125560276__p1526374511573">Added the APIs related to the requester-pays function.</p>
<ul id="EN-US_TOPIC_0125560276__ul19263144514577"><li id="EN-US_TOPIC_0125560276__li626314575715"><a href="en-us_topic_0250433782.html">PUT Bucket request payment</a></li><li id="EN-US_TOPIC_0125560276__li1626344516575"><a href="en-us_topic_0250433783.html">GET Bucket request payment</a></li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560276__strow123383162428"><td valign="top" id="stentry123381160425" headers="stentry41593773194436"><p id="EN-US_TOPIC_0125560276__p8775141974216">2022-10-30</p>
</td>
<td valign="top" id="stentry333911611427" headers="stentry13652467194436"><p id="EN-US_TOPIC_0125560276__p16775171918424">Updated the following content:</p>
<ul id="EN-US_TOPIC_0125560276__ul1369618124312"><li id="EN-US_TOPIC_0125560276__li119843424313"><p id="EN-US_TOPIC_0125560276__p1788511190434"><a name="EN-US_TOPIC_0125560276__li119843424313"></a><a name="li119843424313"></a>Added <a href="en-us_topic_0000001358895697.html">GET Bucket V2 (List Objects V2)</a>.</p>
</li><li id="EN-US_TOPIC_0125560276__li185782013132010">Deleted the descriptions about header <strong id="EN-US_TOPIC_0125560276__b16851212122820">x-amz-epid</strong> from <a href="en-us_topic_0125560305.html">PUT Bucket</a> and <a href="en-us_topic_0125560467.html">HEAD Bucket</a>.</li></ul>
<ul id="EN-US_TOPIC_0125560276__ul1369618124312"><li id="EN-US_TOPIC_0125560276__li119843424313">Added <a href="en-us_topic_0000001358895697.html">GET Bucket V2 (List Objects V2)</a>.</li><li id="EN-US_TOPIC_0125560276__li185782013132010">Deleted the descriptions about header <strong id="EN-US_TOPIC_0125560276__b16851212122820">x-amz-epid</strong> from <a href="en-us_topic_0125560305.html">PUT Bucket</a> and <a href="en-us_topic_0125560467.html">HEAD Bucket</a>.</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560276__strow2971551161516"><td valign="top" id="stentry1597165111150" headers="stentry41593773194436"><p id="EN-US_TOPIC_0125560276__p3394195913158">2022-09-07</p>

29
docs/obs/s3api/en-us_topic_0125560305.html
View File

@ -2,7 +2,7 @@
<h1 class="topictitle1">PUT Bucket</h1>
<div id="body18564111"><p id="EN-US_TOPIC_0125560305__p54806219">You can send the <strong id="EN-US_TOPIC_0125560305__b32859274">PUT Bucket</strong> request to create a bucket with the specified name.</p>
<div class="note" id="EN-US_TOPIC_0125560305__note23493928"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="EN-US_TOPIC_0125560305__p27298012">You can create a maximum of 100 buckets.</p>
<div class="note" id="EN-US_TOPIC_0125560305__note23493928"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0125560305__ul4191742113612"><li class="text" id="EN-US_TOPIC_0125560305__li14981545154119">You can create a maximum of 100 buckets.</li><li id="EN-US_TOPIC_0125560305__li1531317173514">You can enable WORM when you create a bucket, but you cannot enable WORM for an existing bucket. In a bucket with WORM enabled, you can further configure retention policies for objects you upload to this bucket. For more information, see <a href="en-us_topic_0000001806313033.html">Configuring a Default WORM Policy for a Bucket</a>. Once enabled, WORM cannot be disabled for a bucket. When you create a bucket with WORM enabled, OBS automatically enables versioning for the bucket and the versioning cannot be suspended for that bucket. When you create a parallel file system, you cannot enable WORM for it.</li></ul>
</div></div>
<p id="EN-US_TOPIC_0125560305__p10118767">The name of a bucket must be unique in OBS. If a user repeatedly creates namesake buckets in the same region, status code <strong id="EN-US_TOPIC_0125560305__b76377311489">200</strong> is returned. If namesake buckets are repeatedly created in other cases, status code <strong id="EN-US_TOPIC_0125560305__b1857441374811">409</strong> is returned. You can set the ACL of a bucket by adding optional header <strong id="EN-US_TOPIC_0125560305__b44355518">x-amz-acl</strong> to a request.</p>
<div class="note" id="EN-US_TOPIC_0125560305__note23960039"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0125560305__p55170850161711">In multiple regions scenarios, if user A creates a bucket, deletes the bucket later, and immediately creates a bucket with the same name in different regions, the system will respond <strong id="EN-US_TOPIC_0125560305__b1970124344814">409</strong>. If user A creates a bucket with the same name in different regions 30 minutes later, the system will respond <strong id="EN-US_TOPIC_0125560305__b10199133994817">200</strong>.</p>
@ -60,6 +60,15 @@
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.8.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560305__p1063603061316">Optional. This parameter must be carried in the request sent by federated users.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560305__row1620161134216"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.8.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560305__p04291941114615">x-amz-bucket-object-lock-enabled</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.8.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560305__p1883212934612">When creating a bucket, you can use this header to enable WORM for the bucket.</p>
<p id="EN-US_TOPIC_0125560305__p136881949174813">Type: string</p>
<p id="EN-US_TOPIC_0125560305__p373012503474">Example: <strong id="EN-US_TOPIC_0125560305__b02545418234">x-amz-bucket-object-lock-enabled:true</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.8.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560305__p16832229194616">No</p>
</td>
</tr>
</tbody>
</table>
</div>
@ -178,6 +187,24 @@ Content-Length:<span class="w"> </span>0
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560305__section62827378569"><h4 class="sectiontitle">Sample Request for Creating a Bucket with WORM Enabled</h4><pre class="screen" id="EN-US_TOPIC_0125560305__screen9331457195713">PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: authorization
x-amz-bucket-object-lock-enabled:true
Content-Length: 0</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560305__section21791905571"><h4 class="sectiontitle">Sample Response for Creating a Bucket with WORM Enabled</h4><pre class="screen" id="EN-US_TOPIC_0125560305__screen3134132318214">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: 00000184C11AC7A6809F881341842C02
x-reserved-indicator: Unauthorized
Location: /examplebucket
x-amz-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0</pre>
</div>
</div>
<div>
<div class="familylinks">

53
docs/obs/s3api/en-us_topic_0125560315.html
View File

@ -129,7 +129,13 @@
</td>
<td class="cellrowborder" valign="top" width="16.73%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0125560315__p13624576">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p29848903">None</p>
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p174447438720">OBS and S3 have different response bodies in XML.</p>
<p id="EN-US_TOPIC_0125560315__p8444643879">An XML response body of OBS:</p>
<p id="EN-US_TOPIC_0125560315__p0444643374">&lt;Location&gt;RegionID&lt;/Location&gt;</p>
<p id="EN-US_TOPIC_0125560315__p8444144320719">An XML response body of S3:</p>
<p id="EN-US_TOPIC_0125560315__p9444243270">&lt;CreateBucketConfiguration&gt;</p>
<p id="EN-US_TOPIC_0125560315__p1444164318710">&lt;LocationConstraint&gt;RegionID&lt;/LocationConstraint&gt;</p>
<p id="EN-US_TOPIC_0125560315__p544454315714">&lt;/CreateBucketConfiguration&gt;</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560315__row204671"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0125560315__p16578375">GET Bucket logging</p>
@ -168,6 +174,15 @@
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p28303447">None</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560315__row53404434"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0125560315__p30791867">GET Bucket requestPayment</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0125560315__p11113260">Obtains the request payment configuration of a bucket.</p>
</td>
<td class="cellrowborder" valign="top" width="16.73%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0125560315__p27758862">No</p>
</td>
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p33875336">None</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560315__row36442574"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0125560315__p66167392">GET Bucket versioning</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0125560315__p57958559">Obtains the versioning state of a bucket.</p>
@ -344,6 +359,15 @@
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p53814239">OBS supports only some conditions. For details, see section <a href="en-us_topic_0125560422.html">Bucket Policy</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560315__row39004066"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0125560315__p5212777">PUT Bucket requestPayment</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0125560315__p19581784">Sets the request payment configuration of a bucket.</p>
</td>
<td class="cellrowborder" valign="top" width="16.73%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0125560315__p42620696">No</p>
</td>
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p29724369">None</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560315__row66192730"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0125560315__p60010874">PUT Bucket versioning</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0125560315__p29042598">Sets the versioning state of a bucket.</p>
@ -430,6 +454,33 @@
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p16283872">None</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560315__row845615437359"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0125560315__p16082194712"><span style="color:#494949;">PutBucketObjectLockConfiguration</span></p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0125560315__p688775262115">Configuring a Default WORM Policy for a Bucket.</p>
</td>
<td class="cellrowborder" valign="top" width="16.73%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0125560315__p115855374202">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p758513370209">None</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560315__row1287114613351"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0125560315__p2049215239472"><span style="color:#494949;">GetBucketObjectLockConfiguration</span></p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0125560315__p53829920222">Obtaining the Default WORM Policy of a Bucket.</p>
</td>
<td class="cellrowborder" valign="top" width="16.73%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0125560315__p356124012017">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p1256144082016">None</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560315__row519015557354"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.1 "><p id="EN-US_TOPIC_0125560315__p7797192624719"><span style="color:#494949;">PutObjectRetention</span></p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.5.1.2 "><p id="EN-US_TOPIC_0125560315__p18675151772117">Configuring WORM Retention for an Object.</p>
</td>
<td class="cellrowborder" valign="top" width="16.73%" headers="mcps1.3.4.2.5.1.3 "><p id="EN-US_TOPIC_0125560315__p19440141172020">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.269999999999996%" headers="mcps1.3.4.2.5.1.4 "><p id="EN-US_TOPIC_0125560315__p5440194112200">None</p>
</td>
</tr>
</tbody>
</table>
</div>

78
docs/obs/s3api/en-us_topic_0125560338.html
View File

File diff suppressed because it is too large Load Diff

127
docs/obs/s3api/en-us_topic_0125560339.html
View File

File diff suppressed because it is too large Load Diff

180
docs/obs/s3api/en-us_topic_0125560348.html
View File

File diff suppressed because it is too large Load Diff

14
docs/obs/s3api/en-us_topic_0125560379.html
View File

@ -217,6 +217,20 @@
<p id="EN-US_TOPIC_0125560379__p4676876220407">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row35695312710"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p5180191819182"><span style="color:#494949;">x-amz-object-lock-mode</span></p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p6180918151813">WORM mode that will be applied to the object. Currently, only <strong id="EN-US_TOPIC_0125560379__b2443165812187">COMPLIANCE</strong> is supported. This header is returned only when the object has any object-level retention policy configured or has the default bucket-level WORM policy applied. To configure this header, the <strong id="EN-US_TOPIC_0125560379__b335715924120">GetObjectRetention</strong> permission is required.</p>
<p id="EN-US_TOPIC_0125560379__p14496145181918">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p154228537191">Example: <strong id="EN-US_TOPIC_0125560379__b773731920020">x-amz-object-lock-mode:COMPLIANCE</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row34811551872"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p14809920131812"><span style="color:#494949;">x-amz-object-lock-retain-until-date</span></p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p97201718162111">Indicates the expiration time of the WORM retention. The value must be a UTC time that complies with ISO 8601, for example, <strong id="EN-US_TOPIC_0125560379__b937161762618">2015-07-01T04:11:15Z</strong>. This header is returned only when the object has any object-level retention policy configured or has the default bucket-level WORM policy applied. To configure this header, the <strong id="EN-US_TOPIC_0125560379__b10371151782610">GetObjectRetention</strong> permission is required.</p>
<p id="EN-US_TOPIC_0125560379__p1972081822113">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p372031872119">Example: <strong id="EN-US_TOPIC_0125560379__b131940433014">x-amz-object-lock-retain-until-date:2015-07-01T04:11:15Z</strong></p>
</td>
</tr>
</tbody>
</table>
</div>

152
docs/obs/s3api/en-us_topic_0125560399.html
View File

File diff suppressed because it is too large Load Diff

128
docs/obs/s3api/en-us_topic_0125560406.html
View File

File diff suppressed because it is too large Load Diff

4
docs/obs/s3api/en-us_topic_0125560422.html
View File

@ -143,10 +143,10 @@
<ul id="EN-US_TOPIC_0125560422__ul3730555162911"><li id="EN-US_TOPIC_0125560422__li1791021143013"><strong id="EN-US_TOPIC_0125560422__b1891117183016">Action</strong> or <strong id="EN-US_TOPIC_0125560422__b4911411309">NotAction</strong></li><li id="EN-US_TOPIC_0125560422__li19592105143012"><strong id="EN-US_TOPIC_0125560422__b1259275143019">Resource</strong> or <strong id="EN-US_TOPIC_0125560422__b15592185143015">NotResource</strong></li><li id="EN-US_TOPIC_0125560422__li773017559294"><strong id="EN-US_TOPIC_0125560422__b2073075582919">Principal</strong> or <strong id="EN-US_TOPIC_0125560422__b15730115562916">NotPrincipal</strong></li></ul>
</div></div>
<p id="EN-US_TOPIC_0125560422__p37526105">In OBS, <strong id="EN-US_TOPIC_0125560422__b12339111335514">Action</strong> can be the following operations on buckets:</p>
<ul id="EN-US_TOPIC_0125560422__ul27551653123019"><li id="EN-US_TOPIC_0125560422__li157491853203013">s3:DeleteBucket</li><li id="EN-US_TOPIC_0125560422__li375016538302">s3:ListBucket</li><li id="EN-US_TOPIC_0125560422__li4750145314309">s3:ListBucketVersions</li><li id="EN-US_TOPIC_0125560422__li13750353103012">s3:ListBucketMultipartUploads</li><li id="EN-US_TOPIC_0125560422__li6750195317308">s3:GetBucketAcl</li><li id="EN-US_TOPIC_0125560422__li1975035343014">s3:PutBucketAcl</li><li id="EN-US_TOPIC_0125560422__li1475110532305">s3:GetBucketCORS</li><li id="EN-US_TOPIC_0125560422__li12751185393012">s3:PutBucketCORS</li><li id="EN-US_TOPIC_0125560422__li107511553143016">s3:GetBucketVersioning</li><li id="EN-US_TOPIC_0125560422__li117531453113013">s3:PutBucketVersioning</li><li id="EN-US_TOPIC_0125560422__li14753145312304">s3:GetBucketLocation</li><li id="EN-US_TOPIC_0125560422__li187531053103017">s3:GetBucketLogging</li><li id="EN-US_TOPIC_0125560422__li12753175323015">s3:PutBucketLogging</li><li id="EN-US_TOPIC_0125560422__li197532532304">s3:GetBucketWebsite</li><li id="EN-US_TOPIC_0125560422__li3753135310305">s3:PutBucketWebsite</li><li id="EN-US_TOPIC_0125560422__li197531953143010">s3:DeleteBucketWebsite</li><li id="EN-US_TOPIC_0125560422__li37559537302">s3:GetLifecycleConfiguration</li><li id="EN-US_TOPIC_0125560422__li1475518531305">s3:PutLifecycleConfiguration</li><li id="EN-US_TOPIC_0125560422__li32250409143352">s3:GetBucketNotification</li><li id="EN-US_TOPIC_0125560422__li62787262143432">s3:PutBucketNotification</li><li id="EN-US_TOPIC_0125560422__li141617197236">s3:PutBucketPolicy</li><li id="EN-US_TOPIC_0125560422__li1925583419230">s3:GetBucketPolicy</li><li id="EN-US_TOPIC_0125560422__li658904219231">s3:DeleteBucketPolicy</li><li id="EN-US_TOPIC_0125560422__li2838104862315">s3:PutBucketQuota</li><li id="EN-US_TOPIC_0125560422__li5849172311246">s3:GetBucketQuota</li><li id="EN-US_TOPIC_0125560422__li10853304249">s3:PutBucketStoragePolicy</li><li id="EN-US_TOPIC_0125560422__li151116732517">s3:GetBucketStoragePolicy</li><li id="EN-US_TOPIC_0125560422__li219942582512">s3:GetBucketStorage</li><li id="EN-US_TOPIC_0125560422__li8574858262">s3:PutBucketTagging</li><li id="EN-US_TOPIC_0125560422__li19267117122611">s3:GetBucketTagging</li></ul>
<ul id="EN-US_TOPIC_0125560422__ul27551653123019"><li id="EN-US_TOPIC_0125560422__li157491853203013">s3:DeleteBucket</li><li id="EN-US_TOPIC_0125560422__li375016538302">s3:ListBucket</li><li id="EN-US_TOPIC_0125560422__li4750145314309">s3:ListBucketVersions</li><li id="EN-US_TOPIC_0125560422__li13750353103012">s3:ListBucketMultipartUploads</li><li id="EN-US_TOPIC_0125560422__li6750195317308">s3:GetBucketAcl</li><li id="EN-US_TOPIC_0125560422__li1975035343014">s3:PutBucketAcl</li><li id="EN-US_TOPIC_0125560422__li1475110532305">s3:GetBucketCORS</li><li id="EN-US_TOPIC_0125560422__li12751185393012">s3:PutBucketCORS</li><li id="EN-US_TOPIC_0125560422__li107511553143016">s3:GetBucketVersioning</li><li id="EN-US_TOPIC_0125560422__li117531453113013">s3:PutBucketVersioning</li><li id="EN-US_TOPIC_0125560422__li14753145312304">s3:GetBucketLocation</li><li id="EN-US_TOPIC_0125560422__li187531053103017">s3:GetBucketLogging</li><li id="EN-US_TOPIC_0125560422__li12753175323015">s3:PutBucketLogging</li><li id="EN-US_TOPIC_0125560422__li197532532304">s3:GetBucketWebsite</li><li id="EN-US_TOPIC_0125560422__li3753135310305">s3:PutBucketWebsite</li><li id="EN-US_TOPIC_0125560422__li197531953143010">s3:DeleteBucketWebsite</li><li id="EN-US_TOPIC_0125560422__li37559537302">s3:GetLifecycleConfiguration</li><li id="EN-US_TOPIC_0125560422__li1475518531305">s3:PutLifecycleConfiguration</li><li id="EN-US_TOPIC_0125560422__li32250409143352">s3:GetBucketNotification</li><li id="EN-US_TOPIC_0125560422__li62787262143432">s3:PutBucketNotification</li><li id="EN-US_TOPIC_0125560422__li141617197236">s3:PutBucketPolicy</li><li id="EN-US_TOPIC_0125560422__li1925583419230">s3:GetBucketPolicy</li><li id="EN-US_TOPIC_0125560422__li658904219231">s3:DeleteBucketPolicy</li><li id="EN-US_TOPIC_0125560422__li2838104862315">s3:PutBucketQuota</li><li id="EN-US_TOPIC_0125560422__li5849172311246">s3:GetBucketQuota</li><li id="EN-US_TOPIC_0125560422__li10853304249">s3:PutBucketStoragePolicy</li><li id="EN-US_TOPIC_0125560422__li151116732517">s3:GetBucketStoragePolicy</li><li id="EN-US_TOPIC_0125560422__li219942582512">s3:GetBucketStorage</li><li id="EN-US_TOPIC_0125560422__li8574858262">s3:PutBucketTagging</li><li id="EN-US_TOPIC_0125560422__li19267117122611">s3:GetBucketTagging</li><li id="EN-US_TOPIC_0125560422__li625213151196"><span style="color:#494949;">s3:PutBucketObjectLockConfiguration</span></li><li id="EN-US_TOPIC_0125560422__li18744143218811">s3:<span style="color:#494949;">GetBucketObjectLockConfiguration</span></li></ul>
<p id="EN-US_TOPIC_0125560422__p1906716182417"></p>
<p id="EN-US_TOPIC_0125560422__p37494488">In OBS, <strong id="EN-US_TOPIC_0125560422__b295072015550">Action</strong> can be the following operations on objects:</p>
<ul id="EN-US_TOPIC_0125560422__ul5538123133114"><li id="EN-US_TOPIC_0125560422__li7537123203110">s3:GetObject (applies to GET Object and HEAD Object)</li><li id="EN-US_TOPIC_0125560422__li35378316315">s3:GetObjectVersion</li><li id="EN-US_TOPIC_0125560422__li1553711323114">s3:PutObject (applies to PUT Object, POST Object, Initiate Multipart Upload, Upload Part, and Complete Multipart Upload)</li><li id="EN-US_TOPIC_0125560422__li35371032314">s3:GetObjectAcl</li><li id="EN-US_TOPIC_0125560422__li753711333117">s3:GetObjectVersionAcl</li><li id="EN-US_TOPIC_0125560422__li1753715314311">s3:PutObjectAcl</li><li id="EN-US_TOPIC_0125560422__li12537123163110">s3:PutObjectVersionAcl</li><li id="EN-US_TOPIC_0125560422__li17537103153116">s3:DeleteObject</li><li id="EN-US_TOPIC_0125560422__li1553793153114">s3:DeleteObjectVersion</li><li id="EN-US_TOPIC_0125560422__li853815303119">s3:ListMultipartUploadParts</li><li id="EN-US_TOPIC_0125560422__li453810314318">s3:AbortMultipartUpload</li><li id="EN-US_TOPIC_0125560422__li1880293012217">s3:RestoreObject</li></ul>
<ul id="EN-US_TOPIC_0125560422__ul5538123133114"><li id="EN-US_TOPIC_0125560422__li7537123203110">s3:GetObject (applies to GET Object and HEAD Object)</li><li id="EN-US_TOPIC_0125560422__li35378316315">s3:GetObjectVersion</li><li id="EN-US_TOPIC_0125560422__li1553711323114">s3:PutObject (applies to PUT Object, POST Object, Initiate Multipart Upload, Upload Part, and Complete Multipart Upload)</li><li id="EN-US_TOPIC_0125560422__li35371032314">s3:GetObjectAcl</li><li id="EN-US_TOPIC_0125560422__li753711333117">s3:GetObjectVersionAcl</li><li id="EN-US_TOPIC_0125560422__li1753715314311">s3:PutObjectAcl</li><li id="EN-US_TOPIC_0125560422__li12537123163110">s3:PutObjectVersionAcl</li><li id="EN-US_TOPIC_0125560422__li17537103153116">s3:DeleteObject</li><li id="EN-US_TOPIC_0125560422__li1553793153114">s3:DeleteObjectVersion</li><li id="EN-US_TOPIC_0125560422__li853815303119">s3:ListMultipartUploadParts</li><li id="EN-US_TOPIC_0125560422__li453810314318">s3:AbortMultipartUpload</li><li id="EN-US_TOPIC_0125560422__li1880293012217">s3:RestoreObject</li><li id="EN-US_TOPIC_0125560422__li3239185216123">s3:PutObjectRetention</li></ul>
<p id="EN-US_TOPIC_0125560422__p62936795143114"></p>
<p id="EN-US_TOPIC_0125560422__p14449517143114">OBS supports S3 resources in the ARN format:</p>
<ul id="EN-US_TOPIC_0125560422__ul65071313193114"><li id="EN-US_TOPIC_0125560422__li20507171373115">arn:aws:s3:::bucketname (operations on buckets)</li><li id="EN-US_TOPIC_0125560422__li185079139313">arn:aws:s3:::bucketname/path/objectname (operations on objects)</li></ul>

7
docs/obs/s3api/en-us_topic_0125560440.html
View File

@ -18,6 +18,13 @@
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0125560440__p63098212">403 Forbidden</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560440__row357733610367"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0125560440__p172851162446">AccessDenied</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0125560440__p1228514644419">The object you specified is immutable, can not delete.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0125560440__p125366251725">403 Forbidden</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560440__row4161693416399"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0125560440__p1552848716399">AccessForbidden</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0125560440__p4984790016399">Insufficient permission.</p>

19
docs/obs/s3api/en-us_topic_0125560444.html
View File

@ -4,6 +4,7 @@
<div id="body39379979"><p id="EN-US_TOPIC_0125560444__p13848147142614">You can use this operation to enable or suspend versioning for a bucket.</p>
<p class="msonormal" id="EN-US_TOPIC_0125560444__p24721334">Versioning can be used to restore an object that is incorrectly overwritten or deleted. You can use versioning to save, query, and restore objects of different versions. Versioning allows you to easily recover data lost due to misoperations or program faults. Versioning can also be used for retaining and archiving data.</p>
<p class="msonormal" id="EN-US_TOPIC_0125560444__p21165417">By default, versioning is disabled for a bucket.</p>
<p class="msonormal" id="EN-US_TOPIC_0125560444__p62515791">Once WORM is enabled for a bucket, OBS automatically enables versioning for the bucket and the versioning cannot be suspended for that bucket.</p>
<p class="msonormal" id="EN-US_TOPIC_0125560444__p36677197">After the versioning state is set to <strong id="EN-US_TOPIC_0125560444__b18875499">Enabled</strong>:</p>
<ul id="EN-US_TOPIC_0125560444__ul61659320"><li id="EN-US_TOPIC_0125560444__li35661763">OBS creates a unique version ID for each uploaded object. Namesake objects are not overwritten and are distinguished by their own version IDs.</li><li id="EN-US_TOPIC_0125560444__li52520413">Objects can be downloaded by version ID. By default, the latest object is downloaded if the version ID is not specified.</li><li id="EN-US_TOPIC_0125560444__li2921675">Objects can be deleted by version ID. If an object is deleted with no version ID specified, the object is only attached with a deletion mark and a unique version ID but is not physically deleted.</li><li id="EN-US_TOPIC_0125560444__li26295076">The latest objects in a bucket are returned by default after a <strong id="EN-US_TOPIC_0125560444__b35329099">GET Object</strong> request. You can also send a request to obtain a bucket's objects with all version IDs.</li><li id="EN-US_TOPIC_0125560444__li49526440">Except deletion marks and object metadata, storage space occupied by objects with all version IDs is billed.</li></ul>
<p class="msonormal" id="EN-US_TOPIC_0125560444__p18062974">After the versioning state is set to <strong id="EN-US_TOPIC_0125560444__b43084780">Suspended</strong>:</p>
@ -28,30 +29,30 @@
</div>
<div class="section" id="EN-US_TOPIC_0125560444__section15363155315813"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560444__p25561231">This request contains elements to configure the bucket versioning in the XML format. <a href="#EN-US_TOPIC_0125560444__table62924030">Table 1</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560444__table62924030"></a><a name="table62924030"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560444__table62924030" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Elements for configuring bucket versioning</caption><thead align="left"><tr id="EN-US_TOPIC_0125560444__row27526859"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.12.3.2.4.1.1"><p id="EN-US_TOPIC_0125560444__p15083110">Element</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560444__table62924030"></a><a name="table62924030"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560444__table62924030" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Elements for configuring bucket versioning</caption><thead align="left"><tr id="EN-US_TOPIC_0125560444__row27526859"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.13.3.2.4.1.1"><p id="EN-US_TOPIC_0125560444__p15083110">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.12.3.2.4.1.2"><p id="EN-US_TOPIC_0125560444__p13772373">Description</p>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.13.3.2.4.1.2"><p id="EN-US_TOPIC_0125560444__p13772373">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.12.3.2.4.1.3"><p id="EN-US_TOPIC_0125560444__p41820417">Remarks</p>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.13.3.2.4.1.3"><p id="EN-US_TOPIC_0125560444__p41820417">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560444__row32010577"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.12.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560444__p42719917">VersioningConfiguration</p>
<tbody><tr id="EN-US_TOPIC_0125560444__row32010577"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.13.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560444__p42719917">VersioningConfiguration</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.12.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560444__p37761278">Indicates the container for the versioning state configuration.</p>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.13.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560444__p37761278">Indicates the container for the versioning state configuration.</p>
<p id="EN-US_TOPIC_0125560444__p4307190">Ancestor: None</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.12.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560444__p13338129">Mandatory</p>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.13.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560444__p13338129">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560444__row52934302"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.12.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560444__p59820093">Status</p>
<tr id="EN-US_TOPIC_0125560444__row52934302"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.13.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560444__p59820093">Status</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.12.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560444__p13589360">Specifies the versioning state of the bucket.</p>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.13.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560444__p13589360">Specifies the versioning state of the bucket.</p>
<p id="EN-US_TOPIC_0125560444__ole_link9">Type: Enumeration</p>
<p id="EN-US_TOPIC_0125560444__p26996384">Ancestor: VersioningConfiguration</p>
<p id="EN-US_TOPIC_0125560444__p41640866">Valid Values: Enabled, Suspended</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.12.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560444__p17466967">Mandatory</p>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.13.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560444__p17466967">Mandatory</p>
</td>
</tr>
</tbody>

26
docs/obs/s3api/en-us_topic_0125560459.html
View File

@ -6,6 +6,8 @@
<p class="msonormal" id="EN-US_TOPIC_0125560459__p44508523">If a bucket has versioning suspended, a deletion mark with version ID <strong id="EN-US_TOPIC_0125560459__b65032387">null</strong> is generated after an object in the bucket is deleted with no version ID specified. The object whose version is <strong id="EN-US_TOPIC_0125560459__b48420578">null</strong> (if such an object exists) is physically deleted.</p>
<p class="msonormal" id="EN-US_TOPIC_0125560459__p33132024">You can specify <strong id="EN-US_TOPIC_0125560459__b29752766">versionId</strong> to delete an object of the specified version.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560459__section10345237111916"><h4 class="sectiontitle">WORM</h4><p id="EN-US_TOPIC_0125560459__p217115712263">OBS automatically enables versioning when you enable WORM for a bucket. If you delete an object without specifying a version ID, OBS does not really delete this object thanks to versioning, but inserts a delete marker with a unique version ID, which turns into the current version. If you specify a version ID when deleting an object protected by WORM, OBS prevents you from deleting this object and returns a 403 error. Delete markers are not protected by WORM.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560459__section26250571"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560459__screen54270758112853">DELETE /ObjectKey HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
@ -17,20 +19,20 @@
<div class="notice" id="EN-US_TOPIC_0125560459__note92291832638"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0125560459__p73241840182110">For deleting an object, only parameters listed in <a href="#EN-US_TOPIC_0125560459__table57902635">Table1 Request parameter</a> are supported. If the request contains parameters that cannot be identified by OBS, the server returns the 400 error code.</p>
</div></div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560459__table57902635"></a><a name="table57902635"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560459__table57902635" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameter</caption><thead align="left"><tr id="EN-US_TOPIC_0125560459__row15224096"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.4.2.4.1.1"><p id="EN-US_TOPIC_0125560459__p25192244">Parameter</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560459__table57902635"></a><a name="table57902635"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560459__table57902635" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameter</caption><thead align="left"><tr id="EN-US_TOPIC_0125560459__row15224096"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.4.2.4.1.1"><p id="EN-US_TOPIC_0125560459__p25192244">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.4.2.4.1.2"><p id="EN-US_TOPIC_0125560459__p27305877">Description</p>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.4.2.4.1.2"><p id="EN-US_TOPIC_0125560459__p27305877">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.4.2.4.1.3"><p id="EN-US_TOPIC_0125560459__p64292394">Remarks</p>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.4.2.4.1.3"><p id="EN-US_TOPIC_0125560459__p64292394">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560459__row41760635"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560459__p27168314">versionId</p>
<tbody><tr id="EN-US_TOPIC_0125560459__row41760635"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560459__p27168314">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560459__p53149858">Indicates the version ID of an object to be deleted.</p>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560459__p53149858">Indicates the version ID of an object to be deleted.</p>
<p id="EN-US_TOPIC_0125560459__p8586676">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560459__p24432171">Optional</p>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560459__p24432171">Optional</p>
</td>
</tr>
</tbody>
@ -50,23 +52,23 @@
</div>
<div class="section" id="EN-US_TOPIC_0125560459__section11230212"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560459__p40701910">This response uses common headers. For details about common response headers, see section <a href="en-us_topic_0125560484.html">Common Response Headers</a>. In addition, this response also uses optional headers, as described in <a href="#EN-US_TOPIC_0125560459__table2749429">Table 2</a>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560459__table2749429"></a><a name="table2749429"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560459__table2749429" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Optional response headers</caption><thead align="left"><tr id="EN-US_TOPIC_0125560459__row18981865"><th align="left" class="cellrowborder" valign="top" width="30.97%" id="mcps1.3.8.3.2.3.1.1"><p id="EN-US_TOPIC_0125560459__p61136126">Header</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560459__table2749429"></a><a name="table2749429"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560459__table2749429" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Optional response headers</caption><thead align="left"><tr id="EN-US_TOPIC_0125560459__row18981865"><th align="left" class="cellrowborder" valign="top" width="30.97%" id="mcps1.3.9.3.2.3.1.1"><p id="EN-US_TOPIC_0125560459__p61136126">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="69.03%" id="mcps1.3.8.3.2.3.1.2"><p id="EN-US_TOPIC_0125560459__p53079196">Description</p>
<th align="left" class="cellrowborder" valign="top" width="69.03%" id="mcps1.3.9.3.2.3.1.2"><p id="EN-US_TOPIC_0125560459__p53079196">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560459__row4447594"><td class="cellrowborder" valign="top" width="30.97%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560459__p24710800">x-amz-delete-marker</p>
<tbody><tr id="EN-US_TOPIC_0125560459__row4447594"><td class="cellrowborder" valign="top" width="30.97%" headers="mcps1.3.9.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560459__p24710800">x-amz-delete-marker</p>
</td>
<td class="cellrowborder" valign="top" width="69.03%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560459__p55417783">Indicates whether an object is marked as deleted. If an object is not marked as deleted, the header is not returned.</p>
<td class="cellrowborder" valign="top" width="69.03%" headers="mcps1.3.9.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560459__p55417783">Indicates whether an object is marked as deleted. If an object is not marked as deleted, the header is not returned.</p>
<p id="EN-US_TOPIC_0125560459__p28998002">Type: Boolean</p>
<p id="EN-US_TOPIC_0125560459__p59655430">Valid values: true|false</p>
<p id="EN-US_TOPIC_0125560459__p27965">Default: false</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560459__row251686"><td class="cellrowborder" valign="top" width="30.97%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560459__p20386623">x-amz-version-id</p>
<tr id="EN-US_TOPIC_0125560459__row251686"><td class="cellrowborder" valign="top" width="30.97%" headers="mcps1.3.9.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560459__p20386623">x-amz-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="69.03%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560459__p40703736">Indicates the version ID of an object. If an object has no version ID, this header is not returned.</p>
<td class="cellrowborder" valign="top" width="69.03%" headers="mcps1.3.9.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560459__p40703736">Indicates the version ID of an object. If an object has no version ID, this header is not returned.</p>
<p id="EN-US_TOPIC_0125560459__p30789304">Valid values: String</p>
<p id="EN-US_TOPIC_0125560459__p8668281">Default: None</p>
</td>

2
docs/obs/s3api/en-us_topic_0125560489.html
View File

@ -39,6 +39,8 @@
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0125560388.html">POST Object restore</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001806154009.html">Configuring WORM Retention for an Object</a></strong><br>
</li>
</ul>
</div>

14
docs/obs/s3api/en-us_topic_0125560493.html
View File

@ -81,6 +81,16 @@
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0125560426.html">DELETE Bucket tagging</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001684183953.html">PUT Bucket Replication</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001635744308.html">GET Bucket Replication</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001684063985.html">DELETE Bucket Replication</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0250433782.html">PUT Bucket request payment</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0250433783.html">GET Bucket request payment</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001080838596.html">PUT Bucket Encryption</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001080550512.html">GET Bucket Encryption</a></strong><br>
@ -93,6 +103,10 @@
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001121228134.html">DELETE Bucket Custom Domain</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001806313033.html">Configuring a Default WORM Policy for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001759314566.html">Obtaining the Default WORM Policy of a Bucket</a></strong><br>
</li>
</ul>
</div>

127
docs/obs/s3api/en-us_topic_0250433782.html Normal file
View File

File diff suppressed because it is too large Load Diff

116
docs/obs/s3api/en-us_topic_0250433783.html Normal file
View File

File diff suppressed because it is too large Load Diff