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

OBS 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-05-28 10:01:19 +00:00 committed by zuul
parent 95132e24fc
commit 8ba86cabc9
66 changed files with 3057 additions and 1037 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

295
docs/obs/api-ref/ALL_META.TXT.json
View File

File diff suppressed because it is too large Load Diff

272
docs/obs/api-ref/CLASS.TXT.json
View File

File diff suppressed because it is too large Load Diff

23
docs/obs/api-ref/obs_04_0000.html
View File

@ -8,7 +8,28 @@
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0000__row5604853162817"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p11515630141211">2023-08-15</p>
<tbody><tr id="obs_04_0000__row172721060100"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p137551511171020">2024-03-21</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p18755101171019">This is the eleventh official release.</p>
<p id="obs_04_0000__p375501111108">This issue incorporates the following change:</p>
<ul id="obs_04_0000__ul197558116102"><li id="obs_04_0000__li167550112103">Updated information about the <strong id="obs_04_0000__b1072416288303">RetainUntilDate</strong> parameter and added example 2 in <a href="obs_04_0166.html">Configuring WORM Retention for an Object</a>.</li></ul>
</td>
</tr>
<tr id="obs_04_0000__row558320706"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p17583709016">2024-02-18</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p157961918308">This is the tenth official release.</p>
<p id="obs_04_0000__p279671814017">This issue incorporates the following change:</p>
<ul id="obs_04_0000__ul379616181019"><li id="obs_04_0000__li1979613189019">In <a href="obs_04_0085.html">Deleting an Object</a>, added an example of performing the DeleteObject operation that has the <strong id="obs_04_0000__b1188142017352">versionId</strong> parameter specified.</li></ul>
</td>
</tr>
<tr id="obs_04_0000__row24124271130"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p6612203213316">2023-12-27</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p14612153215316">This is the ninth official release.</p>
<p id="obs_04_0000__p761210321939">This issue incorporates the following change:</p>
<ul id="obs_04_0000__ul18612932736"><li id="obs_04_0000__li206121932438">Added APIs related to bucket inventories: <a href="obs_04_0055.html">Configuring Bucket Inventories</a>, <a href="obs_04_0056.html">Obtaining a Specific Inventory of a Bucket</a>, <a href="obs_04_0057.html">Listing All Inventories of a Bucket</a>, and <a href="obs_04_0058.html">Deleting Bucket Inventories</a>.</li></ul>
</td>
</tr>
<tr id="obs_04_0000__row5604853162817"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p11515630141211">2023-08-15</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p11515330141217">This is the eighth official release.</p>
<p id="obs_04_0000__p715905091216">This issue incorporates the following change:</p>

34
docs/obs/api-ref/obs_04_0005.html
View File

@ -174,6 +174,26 @@
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p1833144131810">Obtains the number of objects in a bucket and the space occupied by the objects.</p>
</td>
</tr>
<tr id="obs_04_0005__row671581513918"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p171661510393"><a href="obs_04_0055.html">Configuring Bucket Inventories</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__p07169158390">Configures an inventory rule for a bucket. OBS provides bucket inventories to facilitate your management of objects in a bucket. You can configure bucket inventories to periodically list objects in a bucket. During the listing of objects, object metadata is saved in a CSV file, which is uploaded to the specified bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row198981329183914"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p38981329113912"><a href="obs_04_0056.html">Obtaining a Specific Inventory 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__p14898429193916">Obtains an inventory rule of a specified bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row828195163913"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p11281551123914"><a href="obs_04_0057.html">Listing All Inventories 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__p10281451113910">Obtains all inventory rules of a specified bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row1122449183910"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p2123154983916"><a href="obs_04_0058.html">Deleting Bucket Inventories</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__p112316495391">Deletes an inventory rule of a specified bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row17362143213398"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p10362332203918"><a href="obs_04_0059.html">Configuring a Custom Domain Name 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__p736283212397">Configures a custom domain name for a bucket. <span style="color:#3D3F43;">Once a user-defined domain name is successfully configured, the bucket can be accessed through the user-defined domain name.</span></p>
@ -286,24 +306,24 @@
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0005__row37643023"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p15255933"><a href="obs_04_0080.html">Uploading Objects - PUT</a></p>
<tbody><tr id="obs_04_0005__row37643023"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p15255933"><a href="obs_04_0080.html">Uploading an Object - PUT</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__p102951542152717">Uploads simple objects to a specified bucket.</p>
<td class="cellrowborder" valign="top" width="59.199999999999996%" headers="mcps1.3.4.2.2.3.1.2 "><p id="obs_04_0005__p102951542152717">Uploads an object to a specified bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row3085673"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p45338652"><a href="obs_04_0081.html">Uploading Objects - POST</a></p>
<tr id="obs_04_0005__row3085673"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p45338652"><a href="obs_04_0081.html">Uploading an Object - POST</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__p1429514422273">Uploads objects to a specified bucket based on tables.</p>
<td class="cellrowborder" valign="top" width="59.199999999999996%" headers="mcps1.3.4.2.2.3.1.2 "><p id="obs_04_0005__p1429514422273">Uploads an object to a specified bucket based on tables.</p>
</td>
</tr>
<tr id="obs_04_0005__row5394690"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p28194798"><a href="obs_04_0082.html">Copying Objects</a></p>
<tr id="obs_04_0005__row5394690"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p28194798"><a href="obs_04_0082.html">Copying an Object</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__p52951742162720">Creates a copy for an existing object in OBS.</p>
</td>
</tr>
<tr id="obs_04_0005__row52426590"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p37933718"><a href="obs_04_0083.html">Downloading Objects</a></p>
<tr id="obs_04_0005__row52426590"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p37933718"><a href="obs_04_0083.html">Downloading an Object</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__p429514212716">Downloads objects.</p>
<td class="cellrowborder" valign="top" width="59.199999999999996%" headers="mcps1.3.4.2.2.3.1.2 "><p id="obs_04_0005__p429514212716">Downloads an object.</p>
</td>
</tr>
<tr id="obs_04_0005__row5859146"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p55591939"><a href="obs_04_0084.html">Querying Object Metadata</a></p>

24
docs/obs/api-ref/obs_04_0010.html
View File

@ -57,7 +57,7 @@
</td>
<td class="cellrowborder" valign="top" width="73%" headers="mcps1.3.10.3.2.3.1.2 "><p id="obs_04_0010__p29406249">Indicates the OBS resource specified by an HTTP request. This parameter is constructed as follows:</p>
<p id="obs_04_0010__p63329656">&lt;Bucket name + Object name&gt; + [Subresource 1] + [Subresource 2] + ...</p>
<ol id="obs_04_0010__ol135483613475"><li id="obs_04_0010__li1739510379234"><span style="color:#3D3F43;">Bucket name and object name, for example, </span><strong style="color:#3D3F43;" id="obs_04_0010__b8700202932317">/<em id="obs_04_0010__i570062952317">bucket</em>/<em id="obs_04_0010__i670052922316">object</em></strong><span style="color:#3D3F43;">. If no object name is specified, for example, </span><strong style="color:#3D3F43;" id="obs_04_0010__b47021329102311">/<em id="obs_04_0010__i17703329162316">bucket</em>/</strong><span style="color:#3D3F43;">, the entire bucket is listed. If no bucket name is specified either, the value of this field is </span><strong style="color:#3D3F43;" id="obs_04_0010__b1970732915238">/</strong><span style="color:#3D3F43;">.</span></li><li id="obs_04_0010__li14147065556">If a subresource (such as <strong id="obs_04_0010__b2265729202414">?acl</strong> and <strong id="obs_04_0010__b1226662992414">?logging</strong>) exists, the subresource must be added.<p id="obs_04_0010__p1193056145515">OBS supports a variety of sub-resources, including acl, attname, cors, customdomain, delete, deletebucket, encryption, length, lifecycle, location, logging, metadata, modify, name, notification, partNumber, policy, position, quota, rename, replication, requestPayment, response-cache-control, response-content-disposition, response-content-encoding, response-content-language, response-content-type, response-expires, restore, storageClass, storagePolicy, storageinfo, tagging, torrent, truncate, uploadId, uploads, versionId, versioning, versions, website, object-lock, retention, and x-obs-security-token.</p>
<ol id="obs_04_0010__ol135483613475"><li id="obs_04_0010__li1739510379234"><span style="color:#3D3F43;">Bucket name and object name, for example, </span><strong style="color:#3D3F43;" id="obs_04_0010__b8700202932317">/<em id="obs_04_0010__i570062952317">bucket</em>/<em id="obs_04_0010__i670052922316">object</em></strong><span style="color:#3D3F43;">. If no object name is specified, for example, </span><strong style="color:#3D3F43;" id="obs_04_0010__b47021329102311">/<em id="obs_04_0010__i17703329162316">bucket</em>/</strong><span style="color:#3D3F43;">, the entire bucket is listed. If no bucket name is specified either, the value of this field is </span><strong style="color:#3D3F43;" id="obs_04_0010__b1970732915238">/</strong><span style="color:#3D3F43;">.</span></li><li id="obs_04_0010__li14147065556">If a subresource (such as <strong id="obs_04_0010__b2265729202414">?acl</strong> and <strong id="obs_04_0010__b1226662992414">?logging</strong>) exists, the subresource must be added.<p id="obs_04_0010__p1193056145515">OBS supports a variety of sub-resources, including acl, attname, cors, customdomain, delete, deletebucket, encryption, inventory, length, lifecycle, location, logging, metadata, modify, name, notification, partNumber, policy, position, quota, rename, replication, requestPayment, response-cache-control, response-content-disposition, response-content-encoding, response-content-language, response-content-type, response-expires, restore, storageClass, storagePolicy, storageinfo, tagging, torrent, truncate, uploadId, uploads, versionId, versioning, versions, website, object-lock, retention, and x-obs-security-token.</p>
</li><li id="obs_04_0010__li20542104114716">If there are multiple subresources, sort them in the alphabetical order from a to z, and use <strong id="obs_04_0010__b12446849133516">&amp;</strong> to combine the subresources.</li></ol>
<div class="note" id="obs_04_0010__note1239815267372"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_04_0010__ul116221356133916"><li id="obs_04_0010__li156221356133912">A subresource is unique. Do not add subresources with the same keyword (for example, <strong id="obs_04_0010__b377815262398">key=value1&amp;key=value2</strong>) in the same request URL. In this case, signature is computed only based on the first subresource, and only the value of the first subresource takes effect on the actual service.</li><li id="obs_04_0010__li1321451571811">Using the <strong id="obs_04_0010__b155150134218">GetObject</strong> API as an example, assume there is a bucket named <strong id="obs_04_0010__b1675333820426">bucket-test</strong> and an object named <strong id="obs_04_0010__b69171752104211">object-test</strong> in the bucket, and the object version is <strong id="obs_04_0010__b677011214435">xxx</strong>. When obtaining the object, you need to rewrite Content-Type to <strong id="obs_04_0010__b10283312104410">text/plain</strong>. Then, the <strong id="obs_04_0010__b9426921144417">CanonicalizedResource</strong> calculated by the signature is <strong id="obs_04_0010__b013203114449">/bucket-test/object-test?response-content-type=text/plain&amp;versionId=xxx</strong>.</li></ul>
</div></div>
@ -490,7 +490,9 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<span class="normal">217</span>
<span class="normal">218</span>
<span class="normal">219</span>
<span class="normal">220</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">import</span><span class="w"> </span><span class="nn">java.io.UnsupportedEncodingException</span><span class="p">;</span>
<span class="normal">220</span>
<span class="normal">221</span>
<span class="normal">222</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">import</span><span class="w"> </span><span class="nn">java.io.UnsupportedEncodingException</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.net.URLEncoder</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.security.InvalidKeyException</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.security.NoSuchAlgorithmException</span><span class="p">;</span>
@ -520,7 +522,7 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kd">final</span><span class="w"> </span><span class="n">List</span><span class="o">&lt;</span><span class="n">String</span><span class="o">&gt;</span><span class="w"> </span><span class="n">SUB_RESOURCES</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">Collections</span><span class="p">.</span><span class="na">unmodifiableList</span><span class="p">(</span><span class="n">Arrays</span><span class="p">.</span><span class="na">asList</span><span class="p">(</span>
<span class="w"> </span><span class="s">&quot;CDNNotifyConfiguration&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;acl&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;attname&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;cors&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;customdomain&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;delete&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;deletebucket&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;encryption&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;length&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;lifecycle&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;location&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;logging&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;deletebucket&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;encryption&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;inventory&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;length&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;lifecycle&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;location&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;logging&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;metadata&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;mirrorBackToSource&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;modify&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;name&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;notification&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;obscompresspolicy&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;partNumber&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;policy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;position&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;quota&quot;</span><span class="p">,</span><span class="s">&quot;rename&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;replication&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;requestPayment&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-cache-control&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;response-content-disposition&quot;</span><span class="p">,</span><span class="s">&quot;response-content-encoding&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-language&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-type&quot;</span><span class="p">,</span><span class="w"> </span>
@ -691,10 +693,12 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="nf">main</span><span class="p">(</span><span class="n">String</span><span class="o">[]</span><span class="w"> </span><span class="n">args</span><span class="p">)</span><span class="w"> </span><span class="kd">throws</span><span class="w"> </span><span class="n">Exception</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span>
<span class="w"> </span><span class="n">SignDemo</span><span class="w"> </span><span class="n">demo</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">SignDemo</span><span class="p">();</span>
<span class="w"> </span><span class="n">demo</span><span class="p">.</span><span class="na">ak</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;&lt;your-access-key-id&gt;&quot;</span><span class="p">;</span>
<span class="w"> </span><span class="n">demo</span><span class="p">.</span><span class="na">sk</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;&lt;your-secret-key-id&gt;&quot;</span><span class="p">;</span>
<span class="w"> </span><span class="cm">/* Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</span>
<span class="cm"> In this example, the AK and SK are stored in environment variables for identity authentication. Before running the code in this example, configure environment variables OTCCLOUD_SDK_AK and OTCCLOUD_SDK_SK. */</span>
<span class="w"> </span><span class="n">demo</span><span class="p">.</span><span class="na">ak</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">System</span><span class="p">.</span><span class="na">getenv</span><span class="p">(</span><span class="s">&quot;OTCCLOUD_SDK_AK&quot;</span><span class="p">);</span>
<span class="w"> </span><span class="n">demo</span><span class="p">.</span><span class="na">sk</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">System</span><span class="p">.</span><span class="na">getenv</span><span class="p">(</span><span class="s">&quot;OTCCLOUD_SDK_SK&quot;</span><span class="p">);</span>
<span class="w"> </span>
<span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">bucketName</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;bucket-test&quot;</span><span class="p">;</span>
<span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">objectName</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;hello.jpg&quot;</span><span class="p">;</span>
@ -736,14 +740,18 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">import</span> <span class="nn">sys</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">import</span> <span class="nn">sys</span>
<span class="kn">import</span> <span class="nn">hashlib</span>
<span class="kn">import</span> <span class="nn">hmac</span>
<span class="kn">import</span> <span class="nn">binascii</span>
<span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span>
<span class="n">IS_PYTHON2</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">version_info</span><span class="o">.</span><span class="n">major</span> <span class="o">==</span> <span class="mi">2</span> <span class="ow">or</span> <span class="n">sys</span><span class="o">.</span><span class="n">version</span> <span class="o">&lt;</span> <span class="s1">'3'</span>
<span class="n">yourSecretAccessKeyID</span> <span class="o">=</span> <span class="s1">'275hSvB6EEOorBNsMDEfOaICQnilYaPZhXUaSK64'</span>
<span class="c1"># Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</span>
<span class="c1"># In this example, the AK and SK are stored in environment variables for identity authentication. Before running the code in this example, configure environment variables OTCCLOUD_SDK_AK and OTCCLOUD_SDK_SK.</span>
<span class="n">yourSecretAccessKeyID</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getenv</span><span class="p">(</span><span class="s1">'OTCCLOUD_SDK_SK'</span><span class="p">)</span>
<span class="n">httpMethod</span> <span class="o">=</span> <span class="s2">&quot;PUT&quot;</span>
<span class="n">contentType</span> <span class="o">=</span> <span class="s2">&quot;application/xml&quot;</span>
<span class="c1"># &quot;date&quot; is the time when the request was actually generated</span>

201
docs/obs/api-ref/obs_04_0011.html
View File

File diff suppressed because it is too large Load Diff

127
docs/obs/api-ref/obs_04_0012.html
View File

File diff suppressed because it is too large Load Diff

10
docs/obs/api-ref/obs_04_0015.html
View File

@ -102,7 +102,8 @@
<span class="normal">93</span>
<span class="normal">94</span>
<span class="normal">95</span>
<span class="normal">96</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">package</span><span class="w"> </span><span class="nn">com.obsclient</span><span class="p">;</span>
<span class="normal">96</span>
<span class="normal">97</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">package</span><span class="w"> </span><span class="nn">com.obsclient</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.io.*</span><span class="p">;</span>
@ -114,9 +115,10 @@
<span class="kn">import</span><span class="w"> </span><span class="nn">org.apache.http.impl.client.HttpClients</span><span class="p">;</span>
<span class="kd">public</span><span class="w"> </span><span class="kd">class</span> <span class="nc">TestMain</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">accessKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;UDSIAMSTUBTEST000012&quot;</span><span class="p">;</span><span class="w"> </span><span class="c1">//The value of this parameter is the AK obtained.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">securityKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;Udsiamstubtest000000UDSIAMSTUBTEST000012&quot;</span><span class="p">;</span><span class="w"> </span><span class="c1">//The value of this parameter is the SK obtained.</span>
<span class="w"> </span><span class="cm">/* Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</span>
<span class="cm"> In this example, the AK and SK are stored in environment variables for identity authentication. Before running the code in this example, configure environment variables OTCCLOUD_SDK_AK and OTCCLOUD_SDK_SK. */</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">accessKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">System</span><span class="p">.</span><span class="na">getenv</span><span class="p">(</span><span class="s">&quot;OTCCLOUD_SDK_AK&quot;</span><span class="p">);</span><span class="w"> </span><span class="c1">//The value is the AK obtained.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">securityKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">System</span><span class="p">.</span><span class="na">getenv</span><span class="p">(</span><span class="s">&quot;OTCCLOUD_SDK_SK&quot;</span><span class="p">);</span><span class="w"> </span><span class="c1">//The value is the SK obtained.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">region</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;a1&quot;</span><span class="p">;</span><span class="w"> </span><span class="c1">// The value is the region where the planned bucket resides.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">createBucketTemplate</span><span class="w"> </span><span class="o">=</span>
<span class="w"> </span><span class="s">&quot;&lt;CreateBucketConfiguration &quot;</span><span class="w"> </span><span class="o">+</span>

10
docs/obs/api-ref/obs_04_0016.html
View File

@ -101,7 +101,9 @@
<span class="normal">92</span>
<span class="normal">93</span>
<span class="normal">94</span>
<span class="normal">95</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">package</span><span class="w"> </span><span class="nn">com.obsclient</span><span class="p">;</span>
<span class="normal">95</span>
<span class="normal">96</span>
<span class="normal">97</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">package</span><span class="w"> </span><span class="nn">com.obsclient</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.io.*</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.util.ArrayList</span><span class="p">;</span>
@ -124,8 +126,10 @@
<span class="kd">public</span><span class="w"> </span><span class="kd">class</span> <span class="nc">TestMain</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">accessKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;UDSIAMSTUBTEST000012&quot;</span><span class="p">;</span><span class="w"> </span><span class="c1">//The value of this parameter is the AK obtained.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">securityKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;Udsiamstubtest000000UDSIAMSTUBTEST000012&quot;</span><span class="p">;</span><span class="w"> </span><span class="c1">//The value of this parameter is the SK obtained.</span>
<span class="w"> </span><span class="cm">/* Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</span>
<span class="cm"> In this example, the AK and SK are stored in environment variables for identity authentication. Before running the code in this example, configure environment variables OTCCLOUD_SDK_AK and OTCCLOUD_SDK_SK. */</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">accessKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">System</span><span class="p">.</span><span class="na">getenv</span><span class="p">(</span><span class="s">&quot;OTCCLOUD_SDK_AK&quot;</span><span class="p">);</span><span class="w"> </span><span class="c1">//The value is the AK obtained.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">securityKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">System</span><span class="p">.</span><span class="na">getenv</span><span class="p">(</span><span class="s">&quot;OTCCLOUD_SDK_SK&quot;</span><span class="p">);</span><span class="w"> </span><span class="c1">//The value is the SK obtained.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="nf">main</span><span class="p">(</span><span class="n">String</span><span class="o">[]</span><span class="w"> </span><span class="n">str</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>

10
docs/obs/api-ref/obs_04_0017.html
View File

@ -110,7 +110,9 @@
<span class="normal">101</span>
<span class="normal">102</span>
<span class="normal">103</span>
<span class="normal">104</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">package</span><span class="w"> </span><span class="nn">com.obsclient</span><span class="p">;</span>
<span class="normal">104</span>
<span class="normal">105</span>
<span class="normal">106</span></pre></div></td><td class="code"><div><pre><span></span><span class="kn">package</span><span class="w"> </span><span class="nn">com.obsclient</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.io.*</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.util.ArrayList</span><span class="p">;</span>
@ -133,8 +135,10 @@
<span class="kd">public</span><span class="w"> </span><span class="kd">class</span> <span class="nc">TestMain</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">accessKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;UDSIAMSTUBTEST000012&quot;</span><span class="p">;</span><span class="w"> </span><span class="c1">//The value of this parameter is the AK obtained.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">securityKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;Udsiamstubtest000000UDSIAMSTUBTEST000012&quot;</span><span class="p">;</span><span class="w"> </span><span class="c1">//The value of this parameter is the SK obtained.</span>
<span class="w"> </span><span class="cm">/* Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</span>
<span class="cm"> In this example, the AK and SK are stored in environment variables for identity authentication. Before running the code in this example, configure environment variables OTCCLOUD_SDK_AK and OTCCLOUD_SDK_SK. */</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">accessKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">System</span><span class="p">.</span><span class="na">getenv</span><span class="p">(</span><span class="s">&quot;OTCCLOUD_SDK_AK&quot;</span><span class="p">);</span><span class="w"> </span><span class="c1">//The value is the AK obtained.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">securityKey</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">System</span><span class="p">.</span><span class="na">getenv</span><span class="p">(</span><span class="s">&quot;OTCCLOUD_SDK_SK&quot;</span><span class="p">);</span><span class="w"> </span><span class="c1">//The value is the SK obtained.</span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="nf">main</span><span class="p">(</span><span class="n">String</span><span class="o">[]</span><span class="w"> </span><span class="n">str</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span>

4
docs/obs/api-ref/obs_04_0021.html
View File

@ -2,12 +2,12 @@
<h1 class="topictitle1">Creating a Bucket</h1>
<div id="body39144302"><div class="section" id="obs_04_0021__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="MsoNormal" id="obs_04_0021__p35349457">This operation is used to create a bucket with a specified name.</p>
<div class="note" id="obs_04_0021__note49709663"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_04_0021__ul84544338518"><li class="NotesText" id="obs_04_0021__li84548333513">By default, a user can have a maximum of 100 buckets.</li><li id="obs_04_0021__li1522184015116">The name of a deleted bucket can be reused for a bucket or a parallel file system at least 30 minutes after the deletion.</li><li id="obs_04_0021__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 the WORM sections. 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 class="note" id="obs_04_0021__note49709663"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_04_0021__ul84544338518"><li class="NotesText" id="obs_04_0021__li84548333513">By default, a user can have a maximum of 100 buckets.</li><li id="obs_04_0021__li1522184015116">The name of a deleted bucket can be reused for a bucket or a parallel file system at least 30 minutes after the deletion.</li><li id="obs_04_0021__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="obs_04_0167.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 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__b184051333135110">x-obs-storage-class</strong> header in a bucket creation request specifies the bucket's storage class. 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. The storage class options are as follows: <strong id="obs_04_0021__b1844480112017">STANDARD</strong> (Standard), <strong id="obs_04_0021__b544416082018">WARM</strong> (Warm), <strong id="obs_04_0021__b444480192010">COLD</strong> (Cold). If the <strong id="obs_04_0021__b1819518563534">x-obs-storage-class</strong> header is not in the request, a Standard bucket will be created.</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>
<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 an Object - 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>
<div class="section" id="obs_04_0021__section31291796"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0021__screen20577521"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>

86
docs/obs/api-ref/obs_04_0022.html
View File

File diff suppressed because it is too large Load Diff

42
docs/obs/api-ref/obs_04_0023.html
View File

@ -59,67 +59,67 @@ Date:<span class="w"> </span>date
</div>
</div>
<div class="section" id="obs_04_0023__section34535095"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0023__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_0023__p34922606">In addition to the common response headers, the message headers listed in <a href="#obs_04_0023__table13151171313444">Table 2</a> may be used.</p>
<p id="obs_04_0023__p34922606">In addition to the common response headers, the headers listed in <a href="#obs_04_0023__table13151171313444">Table 2</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0023__table13151171313444"></a><a name="table13151171313444"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0023__table13151171313444" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0023__row815181319449"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.7.4.2.3.1.1"><p id="obs_04_0023__p357332011449">Header</p>
<div class="tablenoborder"><a name="obs_04_0023__table13151171313444"></a><a name="table13151171313444"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0023__table13151171313444" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0023__row815181319449"><th align="left" class="cellrowborder" valign="top" width="44.72%" id="mcps1.3.7.4.2.3.1.1"><p id="obs_04_0023__p357332011449">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.7.4.2.3.1.2"><p id="obs_04_0023__p155736206445">Description</p>
<th align="left" class="cellrowborder" valign="top" width="55.279999999999994%" id="mcps1.3.7.4.2.3.1.2"><p id="obs_04_0023__p155736206445">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0023__row515115131447"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p1268114419442">x-obs-bucket-location</p>
<tbody><tr id="obs_04_0023__row515115131447"><td class="cellrowborder" valign="top" width="44.72%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p1268114419442">x-obs-bucket-location</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p13681154484410">The region where the bucket resides.</p>
<td class="cellrowborder" valign="top" width="55.279999999999994%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p13681154484410">The region where the bucket resides.</p>
<p id="obs_04_0023__p36817443443">Type: string</p>
</td>
</tr>
<tr id="obs_04_0023__row9151181314410"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p6681144134416">x-obs-storage-class</p>
<tr id="obs_04_0023__row9151181314410"><td class="cellrowborder" valign="top" width="44.72%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p6681144134416">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p222815391378">Default storage class of the bucket. The options are as follows: <strong id="obs_04_0023__b07232019123917">STANDARD</strong> (Standard), <strong id="obs_04_0023__b6655731153911">WARM</strong> (Warm), <strong id="obs_04_0023__b3267153763919">COLD</strong> (Cold).</p>
<td class="cellrowborder" valign="top" width="55.279999999999994%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p222815391378">Default storage class of the bucket. The options are as follows: <strong id="obs_04_0023__b07232019123917">STANDARD</strong> (Standard), <strong id="obs_04_0023__b6655731153911">WARM</strong> (Warm), <strong id="obs_04_0023__b3267153763919">COLD</strong> (Cold).</p>
<p id="obs_04_0023__p86811444134410">Type: string</p>
</td>
</tr>
<tr id="obs_04_0023__row71511513164413"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p1368134414416">x-obs-version</p>
<tr id="obs_04_0023__row71511513164413"><td class="cellrowborder" valign="top" width="44.72%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p1368134414416">x-obs-version</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p969674414418">OBS version of the bucket.</p>
<td class="cellrowborder" valign="top" width="55.279999999999994%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p969674414418">OBS version of the bucket.</p>
<p id="obs_04_0023__p8696184412443">Type: string</p>
</td>
</tr>
<tr id="obs_04_0023__row16151113194412"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p5696164415447">x-obs-fs-file-interface</p>
<tr id="obs_04_0023__row16151113194412"><td class="cellrowborder" valign="top" width="44.72%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p5696164415447">x-obs-fs-file-interface</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p94382063714">Indicates whether the bucket is a parallel file system. The value can be <strong id="obs_04_0023__b799019011311">Enabled</strong> (parallel file system).</p>
<td class="cellrowborder" valign="top" width="55.279999999999994%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p94382063714">Indicates whether the bucket is a parallel file system. The value can be <strong id="obs_04_0023__b799019011311">Enabled</strong> (parallel file system).</p>
<p id="obs_04_0023__p1069654494411">If this header field is not carried, the bucket is not a parallel file system.</p>
<p id="obs_04_0023__p26968442444">Type: string</p>
</td>
</tr>
<tr id="obs_04_0023__row1615191316449"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p655618544449">Access-Control-Allow-Origin</p>
<tr id="obs_04_0023__row1615191316449"><td class="cellrowborder" valign="top" width="44.72%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p655618544449">Access-Control-Allow-Origin</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p175569544442">Indicates that the origin is included in the response if the origin in the request meets the CORS configuration requirements when CORS is configured for buckets.</p>
<td class="cellrowborder" valign="top" width="55.279999999999994%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p175569544442">Indicates that the origin is included in the response if the origin in the request meets the CORS configuration requirements when CORS is configured for buckets.</p>
<p id="obs_04_0023__p10556195454412">Type: string</p>
</td>
</tr>
<tr id="obs_04_0023__row9151171316448"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p255615414444">Access-Control-Allow-Headers</p>
<tr id="obs_04_0023__row9151171316448"><td class="cellrowborder" valign="top" width="44.72%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p255615414444">Access-Control-Allow-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p15556145420440">Indicates that the headers are included in the response if headers in the request meet the CORS configuration requirements when CORS is configured for buckets.</p>
<td class="cellrowborder" valign="top" width="55.279999999999994%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p15556145420440">Indicates that the headers are included in the response if headers in the request meet the CORS configuration requirements when CORS is configured for buckets.</p>
<p id="obs_04_0023__p1655615413446">Type: string</p>
</td>
</tr>
<tr id="obs_04_0023__row16151171314417"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p7556165494410">Access-Control-Max-Age</p>
<tr id="obs_04_0023__row16151171314417"><td class="cellrowborder" valign="top" width="44.72%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p7556165494410">Access-Control-Max-Age</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p1755625416449">Value of <strong id="obs_04_0023__b3651102347">MaxAgeSeconds</strong> in the CORS configuration of the server when CORS is configured for buckets.</p>
<td class="cellrowborder" valign="top" width="55.279999999999994%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p1755625416449">Value of <strong id="obs_04_0023__b3651102347">MaxAgeSeconds</strong> in the CORS configuration of the server when CORS is configured for buckets.</p>
<p id="obs_04_0023__p45561954104411">Type: integer</p>
</td>
</tr>
<tr id="obs_04_0023__row815118139443"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p1055625411443">Access-Control-Allow-Methods</p>
<tr id="obs_04_0023__row815118139443"><td class="cellrowborder" valign="top" width="44.72%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p1055625411443">Access-Control-Allow-Methods</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p0556105494415">Indicates that methods in the rule are included in the response if <strong id="obs_04_0023__b436181492320">Access-Control-Request-Method</strong> in the request meets the CORS configuration requirements when CORS is configured for buckets.</p>
<td class="cellrowborder" valign="top" width="55.279999999999994%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p0556105494415">Indicates that methods in the rule are included in the response if <strong id="obs_04_0023__b436181492320">Access-Control-Request-Method</strong> in the request meets the CORS configuration requirements when CORS is configured for buckets.</p>
<p id="obs_04_0023__p4556155444413">Type: string</p>
<p id="obs_04_0023__p0556105420445">Value options: <strong id="obs_04_0023__b3278848134815">GET</strong>, <strong id="obs_04_0023__b1127814811482">PUT</strong>, <strong id="obs_04_0023__b12278748124818">HEAD</strong>, <strong id="obs_04_0023__b0278348184818">POST</strong>, <strong id="obs_04_0023__b7279348104811">DELETE</strong></p>
</td>
</tr>
<tr id="obs_04_0023__row815121312444"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p2556954194412">Access-Control-Expose-Headers</p>
<tr id="obs_04_0023__row815121312444"><td class="cellrowborder" valign="top" width="44.72%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p2556954194412">Access-Control-Expose-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p455605484418">Value of <strong id="obs_04_0023__b7102534">ExposeHeader</strong> in the CORS configuration of a server when CORS is configured for buckets.</p>
<td class="cellrowborder" valign="top" width="55.279999999999994%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p455605484418">Value of <strong id="obs_04_0023__b7102534">ExposeHeader</strong> in the CORS configuration of a server when CORS is configured for buckets.</p>
<p id="obs_04_0023__p7556145419441">Type: string</p>
</td>
</tr>

2
docs/obs/api-ref/obs_04_0025.html
View File

@ -16,7 +16,7 @@ Authorization:<span class="w"> </span>authorization
</div>
</div>
<div class="section" id="obs_04_0025__section29684841"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0025__p20958252">This request contains no message parameters.</p>
<div class="section" id="obs_04_0025__section29684841"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0025__p20958252">This request contains no parameters.</p>
</div>
<div class="section" id="obs_04_0025__section65836981"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0025__p19896826">This request uses common request headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>

8
docs/obs/api-ref/obs_04_0026.html
View File

@ -54,6 +54,14 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0054.html">Obtaining Storage Information of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0055.html">Configuring Bucket Inventories</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0056.html">Obtaining a Specific Inventory of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0057.html">Listing All Inventories of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0058.html">Deleting Bucket Inventories</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0059.html">Configuring a Custom Domain Name for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0060.html">Obtaining the Custom Domain Name of a Bucket</a></strong><br>

2
docs/obs/api-ref/obs_04_0030.html
View File

@ -168,7 +168,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0030__section18442703"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0030__p45135991">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0030__section31766605"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0030__p32136637">No special error responses are returned. For details, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
<div class="section" id="obs_04_0030__section31766605"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0030__p32136637">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0030__section14482163815396"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0030__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>

96
docs/obs/api-ref/obs_04_0032.html
View File

File diff suppressed because it is too large Load Diff

50
docs/obs/api-ref/obs_04_0034.html
View File

File diff suppressed because it is too large Load Diff

42
docs/obs/api-ref/obs_04_0035.html
View File

File diff suppressed because it is too large Load Diff

10
docs/obs/api-ref/obs_04_0037.html
View File

@ -6,9 +6,9 @@
<p class="msonormal" id="obs_04_0037__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="obs_04_0037__p25771207">You can perform this operation to enable or suspend versioning for a bucket.</p>
<p class="msonormal" id="obs_04_0037__p30614278">After versioning is enabled for a bucket:</p>
<ul id="obs_04_0037__ul7093052"><li id="obs_04_0037__li35379206">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="obs_04_0037__li49977398">You can download objects by specifying version IDs. By default, the latest object is downloaded if the version ID is not specified.</li><li id="obs_04_0037__li47143398">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 marker and a unique version ID but is not physically deleted.</li><li id="obs_04_0037__li21637399">The latest objects in a bucket are returned by default after a GET Object request. You can also send a request to obtain a bucket's objects with all version IDs.</li><li id="obs_04_0037__li60518866">Except deletion markers and object metadata, storage space occupied by objects with all version IDs is charged.</li></ul>
<ul id="obs_04_0037__ul7093052"><li id="obs_04_0037__li35379206">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="obs_04_0037__li49977398">You can download objects by specifying version IDs. By default, the latest object is downloaded if the version ID is not specified.</li><li id="obs_04_0037__li47143398">You can specify a version ID to permanently delete a specific object. If an object is deleted with no version ID specified, only a delete marker with a unique version ID is generated, but the object is not physically deleted.</li><li id="obs_04_0037__li21637399">The latest objects in a bucket are returned by default after a GET Object request. You can also send a request to obtain a bucket's objects with all version IDs.</li><li id="obs_04_0037__li60518866">Except delete markers, storage space occupied by objects with all version IDs, excluding object metadata, is billed.</li></ul>
<p class="msonormal" id="obs_04_0037__p63837474">After versioning is suspended for a bucket:</p>
<ul id="obs_04_0037__ul37666362"><li id="obs_04_0037__li7798889">Existing objects with version IDs are not affected.</li><li id="obs_04_0037__li3081139">The system creates version ID <strong id="obs_04_0037__b1374318164718">null</strong> to an uploaded object and the object will be overwritten after a namesake one is uploaded.</li><li id="obs_04_0037__li27730259">You can download objects by specifying version IDs. By default, the latest object is downloaded if the version ID is not specified.</li><li id="obs_04_0037__li48245745">Objects can be deleted by version ID. If an object is deleted with no version ID specified, the object is attached with a deletion marker whose version ID is <strong id="obs_04_0037__b1669506">null</strong>. The object with version ID <strong id="obs_04_0037__b864760555163621">null</strong> is physically deleted.</li><li id="obs_04_0037__li31558526">Except deletion markers and object metadata, storage space occupied by objects with all version IDs is charged.</li></ul>
<ul id="obs_04_0037__ul37666362"><li id="obs_04_0037__li7798889">Existing objects with version IDs are not affected.</li><li id="obs_04_0037__li3081139">The system creates version ID <strong id="obs_04_0037__b1374318164718">null</strong> to an uploaded object and the object will be overwritten after a namesake one is uploaded.</li><li id="obs_04_0037__li27730259">You can download objects by specifying version IDs. By default, the latest object is downloaded if the version ID is not specified.</li><li id="obs_04_0037__li48245745">You can specify a version ID to delete a specific object. If an object is deleted with no version ID specified, OBS creates a delete marker with a version ID of <strong id="obs_04_0037__b864760555163621">null</strong> and deletes the object whose version ID is <strong id="obs_04_0037__b1669506">null</strong>.</li><li id="obs_04_0037__li31558526">Except delete markers, storage space occupied by objects with all version IDs, excluding object metadata, is billed.</li></ul>
<p class="msonormal" id="obs_04_0037__p3452939">Only the bucket owner can set versioning for the bucket.</p>
</div>
<div class="section" id="obs_04_0037__section31076456"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0037__screen6103826"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
@ -32,7 +32,7 @@ Content-Length:<span class="w"> </span>length
</div>
</div>
<div class="section" id="obs_04_0037__section11252648"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0037__p142055">This request contains no message parameters.</p>
<div class="section" id="obs_04_0037__section11252648"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0037__p142055">This request contains no parameters.</p>
</div>
<div class="section" id="obs_04_0037__section34164974"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0037__p11506457">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
@ -49,7 +49,7 @@ Content-Length:<span class="w"> </span>length
<tbody><tr id="obs_04_0037__row64406127"><td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0037__p49513773">VersioningConfiguration</p>
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0037__p51192643">Root node for configuring versioning</p>
<p id="obs_04_0037__p58080607">Ancestor node: none</p>
<p id="obs_04_0037__p58080607">Parent: none</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0037__p6908717">Yes</p>
</td>
@ -58,7 +58,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0037__p65186226">Versioning status of the bucket</p>
<p id="obs_04_0037__p49805123">Type: string</p>
<p id="obs_04_0037__p45592923">Ancestor node: VersioningConfiguration</p>
<p id="obs_04_0037__p45592923">Parent: VersioningConfiguration</p>
<p id="obs_04_0037__p7683123">Value options: <strong id="obs_04_0037__b206919482429">Enabled</strong>, <strong id="obs_04_0037__b14585013428">Suspended</strong></p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0037__p18353199">Yes</p>

32
docs/obs/api-ref/obs_04_0039.html
View File

@ -87,8 +87,8 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p34726893">Root element for configuring the event notification function of a bucket. If the sub element is <strong id="obs_04_0039__b1089151064616">null</strong>, the function is disabled.</p>
<p id="obs_04_0039__p44106583">Type: container</p>
<p id="obs_04_0039__p61414928">Ancestor: none</p>
<p id="obs_04_0039__p15863441">Children: zero or multiple TopicConfiguration elements</p>
<p id="obs_04_0039__p61414928">Parent: none</p>
<p id="obs_04_0039__p15863441">Child: zero or multiple TopicConfiguration elements</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p9870327">Yes</p>
</td>
@ -97,8 +97,8 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p59619520">Element for configuring the event notification topic.</p>
<p id="obs_04_0039__p66813638">Type: container</p>
<p id="obs_04_0039__p64451838">Ancestor: NotificationConfiguration</p>
<p id="obs_04_0039__p43195631">Children: Id, Filter, Topic, Event, or Events</p>
<p id="obs_04_0039__p64451838">Parent: NotificationConfiguration</p>
<p id="obs_04_0039__p43195631">Child: Id, Filter, Topic, and one or more Event elements</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p9185228">No</p>
</td>
@ -107,7 +107,7 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p7347313181111">URN of the event notification topic. When OBS detects a specific event in the bucket, it publishes a notification message to the topic. The topic value can be found in SMN topics.</p>
<p id="obs_04_0039__p47738024">Type: string</p>
<p id="obs_04_0039__p26989038">Ancestor: TopicConfiguration</p>
<p id="obs_04_0039__p26989038">Parent: TopicConfiguration</p>
<p id="obs_04_0039__p1551024015538">Template:</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0039__screen5173185384111"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="nt">&lt;Topic&gt;</span>urn:smn:region:project_id:smn_topic<span class="nt">&lt;/Topic&gt;</span>
</pre></div></td></tr></table></div>
@ -124,9 +124,9 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</tr>
<tr id="obs_04_0039__row33267138"><td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0039__p10283637">Id</p>
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p27668240">Unique ID of each event notification. If the user does not specify an ID, the system assigns an ID automatically.</p>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p27668240">Unique ID of each event notification. If the ID is not specified, OBS automatically assigns an ID.</p>
<p id="obs_04_0039__p47687572">Type: string</p>
<p id="obs_04_0039__p26534972">Ancestor: TopicConfiguration</p>
<p id="obs_04_0039__p26534972">Parent: TopicConfiguration</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p1849120">No</p>
</td>
@ -135,8 +135,8 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p2616012">Element used to store rules of filtering object names.</p>
<p id="obs_04_0039__p23544113">Type: container</p>
<p id="obs_04_0039__p10570425">Ancestor: TopicConfiguration</p>
<p id="obs_04_0039__p28024967">Children: Object</p>
<p id="obs_04_0039__p10570425">Parent: TopicConfiguration</p>
<p id="obs_04_0039__p28024967">Child: Object</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p55429854">No</p>
</td>
@ -145,8 +145,8 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p43957019">Element that defines the filtering rule. The rule filters objects based on the prefixes and suffixes of object names.</p>
<p id="obs_04_0039__p60068854">Type: container</p>
<p id="obs_04_0039__p3748775">Ancestor: Filter</p>
<p id="obs_04_0039__p33738975">Children: one or more FilterRules</p>
<p id="obs_04_0039__p3748775">Parent: Filter</p>
<p id="obs_04_0039__p33738975">Child: one or more FilterRule elements</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p48502416">No</p>
</td>
@ -155,8 +155,8 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p14198482">Element that defines key-value pairs of the filtering rule</p>
<p id="obs_04_0039__p60677479">Type: container</p>
<p id="obs_04_0039__p9226404">Ancestor: Object</p>
<p id="obs_04_0039__p15928779">Children: Name, Value</p>
<p id="obs_04_0039__p9226404">Parent: Object</p>
<p id="obs_04_0039__p15928779">Child: Name and Value</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p15162686">No</p>
</td>
@ -165,7 +165,7 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p42147386">Prefix or suffix of object names for filtering</p>
<p id="obs_04_0039__p43782157">Type: string</p>
<p id="obs_04_0039__p58495099">Ancestor: FilterRule</p>
<p id="obs_04_0039__p58495099">Parent: FilterRule</p>
<p id="obs_04_0039__p56693843">Value options: <strong id="obs_04_0039__b143401605433">prefix</strong>, <strong id="obs_04_0039__b167221015432">suffix</strong></p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p28798577">No</p>
@ -175,7 +175,7 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p55726618">Key word of object names. Based on the prefix or suffix defined by <strong id="obs_04_0039__b842352706153140">Name</strong>, enter the key word for filtering objects. A longer string of characters delivers a more accurate filtering result. A maximum of 1024 characters are supported.</p>
<p id="obs_04_0039__p31777520">Type: string</p>
<p id="obs_04_0039__p17562225">Ancestor: FilterRule</p>
<p id="obs_04_0039__p17562225">Parent: FilterRule</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p13254149">No</p>
</td>
@ -196,7 +196,7 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
<p id="obs_04_0039__p11153933104112">Or use wildcard characters to support all delete operations:</p>
<ul id="obs_04_0039__ul1853491410432"><li id="obs_04_0039__li10534111494311">ObjectRemoved:*</li></ul>
<p id="obs_04_0039__p840815203431"></p>
<p id="obs_04_0039__p42835883">Ancestor: TopicConfiguration</p>
<p id="obs_04_0039__p42835883">Parent: TopicConfiguration</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p47154481">Required if TopicConfiguration is added</p>
</td>

30
docs/obs/api-ref/obs_04_0040.html
View File

@ -92,60 +92,60 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p10449581">Element for configuring the event notification function of a bucket. If this element is <strong id="obs_04_0040__b75553017460">null</strong>, the function is disabled.</p>
<p id="obs_04_0040__p26937369">Type: container</p>
<p id="obs_04_0040__p41109733">Ancestor: none</p>
<p id="obs_04_0040__p34443282">Children: one or more TopicConfiguration elements</p>
<p id="obs_04_0040__p41109733">Parent: none</p>
<p id="obs_04_0040__p34443282">Child: one or more TopicConfiguration elements</p>
</td>
</tr>
<tr id="obs_04_0040__row41554090"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0040__p10438115">TopicConfiguration</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p40180985">Element for configuring the event notification topic.</p>
<p id="obs_04_0040__p26084546">Type: container</p>
<p id="obs_04_0040__p33434323">Ancestor: NotificationConfiguration</p>
<p id="obs_04_0040__p32473453">Children: Id, Filter, Topic, Event, or Events</p>
<p id="obs_04_0040__p33434323">Parent: NotificationConfiguration</p>
<p id="obs_04_0040__p32473453">Child: Id, Filter, Topic, and one or more Event elements</p>
</td>
</tr>
<tr id="obs_04_0040__row23825625"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0040__p50827509">Topic</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p23387532">URN of the event notification topic. After detecting a specific event in the bucket, OBS sends a message to the topic.</p>
<p id="obs_04_0040__p9161202">Type: string</p>
<p id="obs_04_0040__p15341960">Ancestor: TopicConfiguration</p>
<p id="obs_04_0040__p15341960">Parent: TopicConfiguration</p>
</td>
</tr>
<tr id="obs_04_0040__row50412549"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0040__p56884650">Id</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p44253952">Unique ID of each event notification. If the user does not specify an ID, the system assigns an ID automatically.</p>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p44253952">Unique ID of each event notification. If the ID is not specified, OBS automatically assigns an ID.</p>
<p id="obs_04_0040__p62741253">Type: string</p>
<p id="obs_04_0040__p27800366">Ancestor: TopicConfiguration</p>
<p id="obs_04_0040__p27800366">Parent: TopicConfiguration</p>
</td>
</tr>
<tr id="obs_04_0040__row48876710"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0040__p66699469">Filter</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p33947871">Element used to store rules of filtering object names.</p>
<p id="obs_04_0040__p37095389">Type: container</p>
<p id="obs_04_0040__p65423046">Ancestor: TopicConfiguration</p>
<p id="obs_04_0040__p51936509">Children: Object</p>
<p id="obs_04_0040__p65423046">Parent: TopicConfiguration</p>
<p id="obs_04_0040__p51936509">Child: Object</p>
</td>
</tr>
<tr id="obs_04_0040__row64775402"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0040__p12316210">Object</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p58088967">Element used to store rules of filtering object names.</p>
<p id="obs_04_0040__p53038657">Type: container</p>
<p id="obs_04_0040__p7585872">Ancestor: TopicConfiguration</p>
<p id="obs_04_0040__p7585872">Parent: TopicConfiguration</p>
</td>
</tr>
<tr id="obs_04_0040__row1163988"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0040__p27174183">FilterRule</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p53625186">Element that defines key-value pairs of the filtering rule.</p>
<p id="obs_04_0040__p12864630">Type: container</p>
<p id="obs_04_0040__p48672814">Ancestor: Object</p>
<p id="obs_04_0040__p35402146">Children: Name, Value</p>
<p id="obs_04_0040__p48672814">Parent: Object</p>
<p id="obs_04_0040__p35402146">Child: Name and Value</p>
</td>
</tr>
<tr id="obs_04_0040__row50183858"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0040__p38360727">Name</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p20211205">Prefix or suffix of object names for filtering</p>
<p id="obs_04_0040__p47683118">Type: string</p>
<p id="obs_04_0040__p26494883">Ancestor: FilterRule</p>
<p id="obs_04_0040__p26494883">Parent: FilterRule</p>
<p id="obs_04_0040__p37127355">Value options: <strong id="obs_04_0040__b11186158104320">prefix</strong>, <strong id="obs_04_0040__b1484210917432">suffix</strong></p>
</td>
</tr>
@ -153,7 +153,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p20858799">Keywords of object names so that objects can be filtered based on the prefixes or suffixes</p>
<p id="obs_04_0040__p53511470">Type: string</p>
<p id="obs_04_0040__p11841183">Ancestor: FilterRule</p>
<p id="obs_04_0040__p11841183">Parent: FilterRule</p>
</td>
</tr>
<tr id="obs_04_0040__row39461789"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0040__p42288329">Event</p>
@ -172,7 +172,7 @@ Content-Length:<span class="w"> </span>length
<p id="obs_04_0040__p11153933104112">Or use wildcard characters to support all delete operations:</p>
<ul id="obs_04_0040__ul1853491410432"><li id="obs_04_0040__li10534111494311">ObjectRemoved:*</li></ul>
<p id="obs_04_0040__p840815203431"></p>
<p id="obs_04_0040__p66501246">Ancestor: TopicConfiguration</p>
<p id="obs_04_0040__p66501246">Parent: TopicConfiguration</p>
</td>
</tr>
</tbody>

14
docs/obs/api-ref/obs_04_0044.html
View File

@ -3,7 +3,7 @@
<h1 class="topictitle1">Configuring Storage Class for a Bucket</h1>
<div id="body40250789"><div class="section" id="obs_04_0044__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0044__p28207758">This operation sets or updates the default storage class of a bucket.</p>
<p class="msonormal" id="obs_04_0044__p52543238">To perform this operation, you must have the <strong id="obs_04_0044__b49121730191213">PutBucketStoragePolicy</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_0044__p3127100">After the default storage class has been set for a bucket, if the storage class of an object is not specified during uploading, copying, or initialization of multi-part upload, the object storage class is the same as the default storage class of the bucket.</p>
<p class="msonormal" id="obs_04_0044__p3127100">If you do not specify a storage class when uploading or copying an object, or initiating a multipart upload, the object inherits the bucket's storage class.</p>
<p class="msonormal" id="obs_04_0044__p28143905">The default storage class of a bucket is Standard.</p>
</div>
<div class="section" id="obs_04_0044__section51968558"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0044__screen39088442"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
@ -41,14 +41,14 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0044__row64903084"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0044__p22658476">StorageClass</p>
<tbody><tr id="obs_04_0044__row1648312612482"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0044__p1118941017483">StorageClass</p>
</td>
<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: <strong id="obs_04_0044__b11157171664314">STANDARD</strong>, <strong id="obs_04_0044__b7160122504318">WARM</strong>, <strong id="obs_04_0044__b1099115294433">COLD</strong></p>
<p id="obs_04_0044__p15884183444011">The available storage classes are as follows: Standard (<strong id="obs_04_0044__b1157914452516">STANDARD</strong>), Warm (<strong id="obs_04_0044__b205795452520">WARM</strong>), Cold (<strong id="obs_04_0044__b8579345259">COLD</strong>). </p>
<td class="cellrowborder" valign="top" width="51%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0044__p19189151010480">Specifies the default storage class for a bucket.</p>
<p id="obs_04_0044__p31891610194811">Type: string</p>
<p id="obs_04_0044__p1818961017483">Value options: <strong id="obs_04_0044__b78011126105117">STANDARD</strong>, <strong id="obs_04_0044__b48011826185110">WARM</strong>, <strong id="obs_04_0044__b3802152605119">COLD</strong></p>
<p id="obs_04_0044__p318941016482">The available storage classes are as follows: Standard (<strong id="obs_04_0044__b15527112919279">STANDARD</strong>), Warm (<strong id="obs_04_0044__b19527122920273">WARM</strong>), Cold (<strong id="obs_04_0044__b1527172962714">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 class="cellrowborder" valign="top" width="23%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0044__p1318971017489">Yes</p>
</td>
</tr>
</tbody>

30
docs/obs/api-ref/obs_04_0046.html
View File

File diff suppressed because it is too large Load Diff

28
docs/obs/api-ref/obs_04_0047.html
View File

@ -77,15 +77,15 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
</td>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p41737906">Container for the replication rules. A maximum of 100 rules can be configured. The size of the XML file can reach 50 KB.</p>
<p id="obs_04_0047__p40096838">Type: container</p>
<p id="obs_04_0047__p25327227">Children: Rule</p>
<p id="obs_04_0047__p26618459">Ancestor: none</p>
<p id="obs_04_0047__p25327227">Child: Rule</p>
<p id="obs_04_0047__p26618459">Parent: none</p>
</td>
</tr>
<tr id="obs_04_0047__row104037508209"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p11111579205">Agency</p>
</td>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p14111577201">Name of the agency, which can have a maximum of 64 characters.</p>
<p id="obs_04_0047__p1911157162011">Type: string</p>
<p id="obs_04_0047__p9115578208">Ancestor: ReplicationConfiguration</p>
<p id="obs_04_0047__p9115578208">Parent: ReplicationConfiguration</p>
</td>
</tr>
<tr id="obs_04_0047__row10395144"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p36700315">Rule</p>
@ -93,21 +93,21 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p19935510">Container of a specified replication rule.</p>
<p id="obs_04_0047__p45201866">The replication configuration must contain at least one rule. The maximum number of rules is 100.</p>
<p id="obs_04_0047__p4163618">Type: container</p>
<p id="obs_04_0047__p37472566">Ancestor: ReplicationConfiguration</p>
<p id="obs_04_0047__p37472566">Parent: ReplicationConfiguration</p>
</td>
</tr>
<tr id="obs_04_0047__row37737321"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p36824194">ID</p>
</td>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p29969743">Unique identifier of a rule, with a maximum length of 255 characters.</p>
<p id="obs_04_0047__p1292237">Type: string</p>
<p id="obs_04_0047__p11630137">Ancestor: Rule</p>
<p id="obs_04_0047__p11630137">Parent: Rule</p>
</td>
</tr>
<tr id="obs_04_0047__row22653283"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p22976659">Status</p>
</td>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p49170108">If the value of this element is <strong id="obs_04_0047__b842352706112931">Disabled</strong>, this rule will be ignored.</p>
<p id="obs_04_0047__p39877789">Type: string</p>
<p id="obs_04_0047__p23355781">Ancestor: Rule</p>
<p id="obs_04_0047__p23355781">Parent: Rule</p>
<p id="obs_04_0047__p8875437">Value options: <strong id="obs_04_0047__b032315311200">Enabled</strong>, <strong id="obs_04_0047__b103247532209">Disabled</strong></p>
</td>
</tr>
@ -116,14 +116,14 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p20906381">Prefix of an object key name, applicable to one or more objects. If the <strong id="obs_04_0047__b499142872620">Prefix</strong> is left blank, the cross-region replication rule is applied to the whole bucket.</p>
<p id="obs_04_0047__p53939706">The maximum length of a prefix is 1,024 characters. Duplicated prefixes are not supported.</p>
<p id="obs_04_0047__p15695313">Type: string</p>
<p id="obs_04_0047__p7040089">Ancestor: Rule</p>
<p id="obs_04_0047__p7040089">Parent: Rule</p>
</td>
</tr>
<tr id="obs_04_0047__row31951537"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p37937694">Destination</p>
</td>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p53054355">Container for the destination bucket information.</p>
<p id="obs_04_0047__p7727153">Type: container</p>
<p id="obs_04_0047__p2435513">Ancestor: Rule</p>
<p id="obs_04_0047__p2435513">Parent: Rule</p>
</td>
</tr>
<tr id="obs_04_0047__row30658935"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p345838">Bucket</p>
@ -131,14 +131,14 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p28012880">Bucket used to store object copies that are marked by rules.</p>
<p id="obs_04_0047__p50789334">If the replication configuration contains multiple rules, the rules must specify the same bucket as the destination bucket.</p>
<p id="obs_04_0047__p54450823">Type: string</p>
<p id="obs_04_0047__p20295366">Ancestor: Destination</p>
<p id="obs_04_0047__p20295366">Parent: Destination</p>
</td>
</tr>
<tr id="obs_04_0047__row31372179"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p58118584">StorageClass</p>
</td>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p9984849">Storage class of an object.</p>
<p id="obs_04_0047__p22754781">Type: string</p>
<p id="obs_04_0047__p3466439">Ancestor: Destination</p>
<p id="obs_04_0047__p3466439">Parent: Destination</p>
<p id="obs_04_0047__p31197952">Value options: <strong id="obs_04_0047__b416355913393">STANDARD</strong>, <strong id="obs_04_0047__b89857124012">WARM</strong>, <strong id="obs_04_0047__b108221848401">COLD</strong></p>
</td>
</tr>
@ -146,16 +146,16 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
</td>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p741071644716">Keyword for synchronizing object deletion operations. If the value is <strong id="obs_04_0047__b1877417551657">Enabled</strong>, the object deletion for the source bucket will be replicated to the destination bucket.</p>
<p id="obs_04_0047__p144101167471">Type: string</p>
<p id="obs_04_0047__p19410816164719">Ancestor: Destination</p>
<p id="obs_04_0047__p54101316144719">Value options: <strong id="obs_04_0047__b17805121412238">Enabled</strong> and <strong id="obs_04_0047__b148051314102319">Disabled</strong> (If this element is absent from the request, <strong id="obs_04_0047__b980520148237">Disabled</strong> is applied by default.)</p>
<p id="obs_04_0047__p19410816164719">Parent: Destination</p>
<p id="obs_04_0047__p54101316144719">Value options: <strong id="obs_04_0047__b19521843173218">Enabled</strong> and <strong id="obs_04_0047__b1995234313212">Disabled</strong> (If this element is absent from the request, <strong id="obs_04_0047__b3952134333212">Disabled</strong> is applied by default.)</p>
</td>
</tr>
<tr id="obs_04_0047__row21591347836"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p1916024716315">HistoricalObjectReplication</p>
</td>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p419115115473">Keyword for copying a historical object. If the value is <strong id="obs_04_0047__b8853171412366">Enabled</strong>, historical objects meeting this rule are copied.</p>
<p id="obs_04_0047__p16191145194714">Type: string</p>
<p id="obs_04_0047__p18191135112470">Ancestor: Rule</p>
<p id="obs_04_0047__p1319165118472">Value options: <strong id="obs_04_0047__b76283115466">Enabled</strong> and <strong id="obs_04_0047__b1763163116469">Disabled</strong> (If this element is absent from the request, <strong id="obs_04_0047__b36317313468">Disabled</strong> is applied by default.)</p>
<p id="obs_04_0047__p18191135112470">Parent: Rule</p>
<p id="obs_04_0047__p1319165118472">Value options: <strong id="obs_04_0047__b18760104517322">Enabled</strong> and <strong id="obs_04_0047__b167601445153211">Disabled</strong> (If this element is absent from the request, <strong id="obs_04_0047__b14760164513327">Disabled</strong> is applied by default.)</p>
</td>
</tr>
</tbody>

10
docs/obs/api-ref/obs_04_0049.html
View File

@ -75,7 +75,7 @@ Content-MD5:<span class="w"> </span>md5
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0049__p6536111718422">Root element for TagSet and Tag</p>
<p id="obs_04_0049__p85368172423">Type: container</p>
<p id="obs_04_0049__p125365178429">Ancestor: none</p>
<p id="obs_04_0049__p125365178429">Parent: none</p>
</td>
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0049__p553681720423">Yes</p>
</td>
@ -84,7 +84,7 @@ Content-MD5:<span class="w"> </span>md5
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0049__p591252604217">Element of the tag set</p>
<p id="obs_04_0049__p391202634216">Type: container</p>
<p id="obs_04_0049__p4912142604210">Ancestor: Tagging</p>
<p id="obs_04_0049__p4912142604210">Parent: Tagging</p>
</td>
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0049__p3912326144211">Yes</p>
</td>
@ -93,7 +93,7 @@ Content-MD5:<span class="w"> </span>md5
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0049__p8333639114218">Information element of Tag</p>
<p id="obs_04_0049__p1233323919429">Type: container</p>
<p id="obs_04_0049__p0333163974214">Ancestor: TagSet</p>
<p id="obs_04_0049__p0333163974214">Parent: TagSet</p>
</td>
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0049__p333319390424">Yes</p>
</td>
@ -102,7 +102,7 @@ Content-MD5:<span class="w"> </span>md5
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0049__p74952488427">Tag name</p>
<p id="obs_04_0049__p1349514814423">Type: string</p>
<p id="obs_04_0049__p149512481428">Ancestor: Tag</p>
<p id="obs_04_0049__p149512481428">Parent: Tag</p>
</td>
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0049__p18495154864216">Yes</p>
</td>
@ -111,7 +111,7 @@ Content-MD5:<span class="w"> </span>md5
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0049__p19616854174215">Tag value</p>
<p id="obs_04_0049__p7616135414424">Type: string</p>
<p id="obs_04_0049__p2616105415423">Ancestor: Tag</p>
<p id="obs_04_0049__p2616105415423">Parent: Tag</p>
</td>
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0049__p11616115484210">Yes</p>
</td>

10
docs/obs/api-ref/obs_04_0050.html
View File

@ -68,35 +68,35 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="71.72%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0050__p13105932231">Element of the tag set and tag.</p>
<p id="obs_04_0050__p6105203213312">Type: container</p>
<p id="obs_04_0050__p16105732833">Ancestor: none</p>
<p id="obs_04_0050__p16105732833">Parent: none</p>
</td>
</tr>
<tr id="obs_04_0050__row14105163211311"><td class="cellrowborder" valign="top" width="28.28%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0050__p1810514321035">TagSet</p>
</td>
<td class="cellrowborder" valign="top" width="71.72%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0050__p161051832232">Element of the tag set.</p>
<p id="obs_04_0050__p101067329315">Type: container</p>
<p id="obs_04_0050__p17106032232">Ancestor: Tagging</p>
<p id="obs_04_0050__p17106032232">Parent: Tagging</p>
</td>
</tr>
<tr id="obs_04_0050__row31061327320"><td class="cellrowborder" valign="top" width="28.28%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0050__p15106632132">Tag</p>
</td>
<td class="cellrowborder" valign="top" width="71.72%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0050__p121066328312">Element of the tag information.</p>
<p id="obs_04_0050__p21061232330">Type: container</p>
<p id="obs_04_0050__p18107432939">Ancestor: TagSet</p>
<p id="obs_04_0050__p18107432939">Parent: TagSet</p>
</td>
</tr>
<tr id="obs_04_0050__row18107832932"><td class="cellrowborder" valign="top" width="28.28%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0050__p0107232634">Key</p>
</td>
<td class="cellrowborder" valign="top" width="71.72%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0050__p9107163212319">Tag name.</p>
<p id="obs_04_0050__p141077321433">Type: string</p>
<p id="obs_04_0050__p101088323316">Ancestor: Tag</p>
<p id="obs_04_0050__p101088323316">Parent: Tag</p>
</td>
</tr>
<tr id="obs_04_0050__row10108032336"><td class="cellrowborder" valign="top" width="28.28%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0050__p810823216311">Value</p>
</td>
<td class="cellrowborder" valign="top" width="71.72%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0050__p1010873217315">Tag value.</p>
<p id="obs_04_0050__p11108113215315">Type: string</p>
<p id="obs_04_0050__p310820325310">Ancestor: Tag</p>
<p id="obs_04_0050__p310820325310">Parent: Tag</p>
</td>
</tr>
</tbody>

347
docs/obs/api-ref/obs_04_0055.html Normal file
View File

File diff suppressed because it is too large Load Diff

337
docs/obs/api-ref/obs_04_0056.html Normal file
View File

File diff suppressed because it is too large Load Diff

216
docs/obs/api-ref/obs_04_0057.html Normal file
View File

File diff suppressed because it is too large Load Diff

87
docs/obs/api-ref/obs_04_0058.html Normal file
View File

@ -0,0 +1,87 @@
<a name="obs_04_0058"></a><a name="obs_04_0058"></a>
<h1 class="topictitle1">Deleting Bucket Inventories</h1>
<div id="body1546933383180"><div class="section" id="obs_04_0058__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0058__p268315184218">OBS uses the DELETE method to delete inventories (identified by inventory IDs) of a specified bucket.</p>
<p id="obs_04_0058__p1971117286491">To perform this operation, you must have the <strong id="obs_04_0058__b283158606669">DeleteBucketInventoryConfiguration</strong> permission. By default, the bucket owner has this permission and can grant it to others.</p>
</div>
<div class="section" id="obs_04_0058__section760823317564"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="obs_04_0058__screen19232727152544">DELETE /?inventory&amp;id=<em style="color:#FF0000;" id="obs_04_0058__i12638727256">configuration-id</em> HTTP/1.1
User-Agent: curl/7.29.0
Host: <em id="obs_04_0058__i123441746202313">bucketname</em>.obs.<em id="obs_04_0058__i034434682311">region</em>.example.com
Accept: */*
Date: <em id="obs_04_0058__i154860334480"><span style="color:#FF0000;">date</span></em>
Authorization: <em id="obs_04_0058__i15842537144810"><span style="color:#FF0000;">authorization string</span></em></pre>
</div>
<div class="section" id="obs_04_0058__section1371325895711"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0058__table34931235193212" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0058__row195001352328"><th align="left" class="cellrowborder" valign="top" width="22.430000000000003%" id="mcps1.3.3.2.2.4.1.1"><p id="obs_04_0058__p750214358321">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="53.260000000000005%" id="mcps1.3.3.2.2.4.1.2"><p id="obs_04_0058__p95049355327">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.310000000000002%" id="mcps1.3.3.2.2.4.1.3"><p id="obs_04_0058__p185061235143215">Mandatory</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0058__row175081135133212"><td class="cellrowborder" valign="top" width="22.430000000000003%" headers="mcps1.3.3.2.2.4.1.1 "><p id="obs_04_0058__p19510123510324">id</p>
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.3.2.2.4.1.2 "><p id="obs_04_0058__p16551024153319">ID of the inventory to be deleted.</p>
<p id="obs_04_0058__p1486620174115">Type: string</p>
<p id="obs_04_0058__p154809270334">Specifications: A maximum of 64 characters</p>
<p id="obs_04_0058__p1518414513396">There is no default value.</p>
<p id="obs_04_0058__p11655141563317">Valid characters: letters, digits, hyphens (-), periods (.) and underscores (_)</p>
</td>
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.3.2.2.4.1.3 "><p id="obs_04_0058__p853293516321">Yes</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0058__section1082510151584"><h4 class="sectiontitle">Request Headers</h4><p id="obs_04_0058__p1231635205817">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_0058__section4216153718588"><h4 class="sectiontitle">Request Elements</h4><p id="obs_04_0058__p512465625811">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0058__section7375637599"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0058__screen1351602445911"><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>status_code
Server:<span class="w"> </span>OBS
x-obs-request-id:<span class="w"> </span>request<span class="w"> </span>id
x-obs-id-2:<span class="w"> </span>id
Date:<span class="w"> </span>date
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0058__section4327836215"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0058__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_0058__section2085012491723"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0058__p63829146313">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0058__section75624441842"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0058__p184128334439">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0058__section51791023968"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="obs_04_0058__screen5561411267">DELETE /test?inventory&amp;id=id1 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0058__i12367117502">region</em>.example.com
Accept: */*
Date: Tue, 08 Jan 2019 13:18:35 +0000
Authorization: OBS UDSIAMSTUBTEST000001:UT9F2YUgaFu9uFGMmxFj2CBgQHs=</pre>
</div>
<div class="section" id="obs_04_0058__section18234571088"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0058__screen1219123011919"><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>000001682D993B666808E265A3F6361D
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSyB46jGSQsu06m1nyIeKxTuJ+H27ooC
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:14:03<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>

16
docs/obs/api-ref/obs_04_0060.html
View File

@ -71,32 +71,32 @@ Content-Length:<span class="w"> </span>272
</td>
<td class="cellrowborder" valign="top" width="60.61%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0060__p41737906">Container of the returned result</p>
<p id="obs_04_0060__p40096838">Type: container</p>
<p id="obs_04_0060__p25327227">Children: Domains</p>
<p id="obs_04_0060__p26618459">Ancestor: none</p>
<p id="obs_04_0060__p25327227">Child: Domains</p>
<p id="obs_04_0060__p26618459">Parent: none</p>
</td>
</tr>
<tr id="obs_04_0060__row32220038"><td class="cellrowborder" valign="top" width="39.39%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0060__p59686313">Domains</p>
</td>
<td class="cellrowborder" valign="top" width="60.61%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0060__p2753164">Element indicating the custom domain name</p>
<p id="obs_04_0060__p24778477">Type: container</p>
<p id="obs_04_0060__p471612013534">Children: DomainName, CreateTime</p>
<p id="obs_04_0060__p1471632014532">Ancestor: ListBucketCustomDomainsResult</p>
<p id="obs_04_0060__p471612013534">Child: DomainName and CreateTime</p>
<p id="obs_04_0060__p1471632014532">Parent: ListBucketCustomDomainsResult</p>
</td>
</tr>
<tr id="obs_04_0060__row20591764545"><td class="cellrowborder" valign="top" width="39.39%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0060__p65986115418">DomainName</p>
</td>
<td class="cellrowborder" valign="top" width="60.61%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0060__p1135662819546">Custom domain name</p>
<p id="obs_04_0060__p835692865410">Type: string</p>
<p id="obs_04_0060__p9356182895417">Children: none</p>
<p id="obs_04_0060__p10356928175418">Ancestor: Domains</p>
<p id="obs_04_0060__p9356182895417">Child: none</p>
<p id="obs_04_0060__p10356928175418">Parent: Domains</p>
</td>
</tr>
<tr id="obs_04_0060__row05952215547"><td class="cellrowborder" valign="top" width="39.39%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0060__p35952215545">CreateTime</p>
</td>
<td class="cellrowborder" valign="top" width="60.61%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0060__p18296214205517">Time when a custom domain name is created</p>
<p id="obs_04_0060__p629610146551">Type: string, which must be a UTC time.</p>
<p id="obs_04_0060__p1029613146550">Children: none</p>
<p id="obs_04_0060__p1929631455517">Ancestor: Domains</p>
<p id="obs_04_0060__p1029613146550">Child: none</p>
<p id="obs_04_0060__p1929631455517">Parent: Domains</p>
</td>
</tr>
</tbody>

18
docs/obs/api-ref/obs_04_0062.html
View File

@ -58,8 +58,8 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p6536111718422">Root element of the default encryption configuration of a bucket.</p>
<p id="obs_04_0062__p85368172423">Type: container</p>
<p id="obs_04_0062__p125365178429">Ancestor: none</p>
<p id="obs_04_0062__p1555484273118">Children: Rule</p>
<p id="obs_04_0062__p125365178429">Parent: none</p>
<p id="obs_04_0062__p1555484273118">Child: Rule</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0062__p553681720423">Yes</p>
</td>
@ -68,8 +68,8 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p591252604217">Sub-element of the default encryption configuration of a bucket.</p>
<p id="obs_04_0062__p391202634216">Type: container</p>
<p id="obs_04_0062__p4912142604210">Ancestor: ServerSideEncryptionConfiguration</p>
<p id="obs_04_0062__p83382043312">Children: ApplyServerSideEncryptionByDefault</p>
<p id="obs_04_0062__p4912142604210">Parent: ServerSideEncryptionConfiguration</p>
<p id="obs_04_0062__p83382043312">Child: ApplyServerSideEncryptionByDefault</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0062__p3912326144211">Yes</p>
</td>
@ -78,8 +78,8 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p8333639114218">Sub-element of the default encryption configuration of a bucket.</p>
<p id="obs_04_0062__p1233323919429">Type: container</p>
<p id="obs_04_0062__p0333163974214">Ancestor: Rule</p>
<p id="obs_04_0062__p2559123813510">Children: SSEAlgorithm, KMSMasterKeyID</p>
<p id="obs_04_0062__p0333163974214">Parent: Rule</p>
<p id="obs_04_0062__p2559123813510">Child: SSEAlgorithm and KMSMasterKeyID</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0062__p333319390424">Yes</p>
</td>
@ -89,7 +89,7 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p74952488427">Server-side encryption algorithm used for the default encryption configuration of a bucket.</p>
<p id="obs_04_0062__p1349514814423">Type: string</p>
<p id="obs_04_0062__p149512481428">Value options: <strong id="obs_04_0062__b394583095618">kms</strong></p>
<p id="obs_04_0062__p1089135793715">Ancestor: ApplyServerSideEncryptionByDefault</p>
<p id="obs_04_0062__p1089135793715">Parent: ApplyServerSideEncryptionByDefault</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0062__p18495154864216">Yes</p>
</td>
@ -102,7 +102,7 @@ Content-Length:<span class="w"> </span>length
<ol id="obs_04_0062__ol28871657184419"><li id="obs_04_0062__li388775774418"><em id="obs_04_0062__i19524203191914">regionID</em><strong id="obs_04_0062__b111901227191919">:</strong><em id="obs_04_0062__i10933173413191">domainID</em><strong id="obs_04_0062__b10135133425411">:key/</strong><em id="obs_04_0062__i41351334115418">key_id</em></li><li id="obs_04_0062__li1216183134518"><em id="obs_04_0062__i18971441107541">key_id</em></li></ol>
<p id="obs_04_0062__p5150033112717">In the preceding formats:</p>
<ul id="obs_04_0062__ul1812312350279"><li id="obs_04_0062__li48526363273"><em id="obs_04_0062__i1082183695015">regionID</em> indicates the ID of the region where the key belongs.</li><li id="obs_04_0062__li453410383271"><em id="obs_04_0062__i8343117105118">domainID</em> indicates the ID of the domain to which the key belongs. For details, see <a href="obs_04_0117.html">Obtaining a Domain ID and a User ID</a>.</li><li id="obs_04_0062__li2123235142713"><em id="obs_04_0062__i339792814549">key_id</em> indicates the ID of the key created in KMS.</li></ul>
<p id="obs_04_0062__p2616105415423">Ancestor: ApplyServerSideEncryptionByDefault</p>
<p id="obs_04_0062__p2616105415423">Parent: ApplyServerSideEncryptionByDefault</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0062__p11616115484210">No</p>
</td>
@ -113,7 +113,7 @@ Content-Length:<span class="w"> </span>length
<p id="obs_04_0062__p198201472915">Type: string</p>
<p id="obs_04_0062__p1232921112811">Value options:</p>
<ol id="obs_04_0062__ol1129819314321"><li id="obs_04_0062__li429833110328">Project ID that matches <strong id="obs_04_0062__b0176124019435">KMSMasterKeyID</strong>.</li><li id="obs_04_0062__li128069579328">If <strong id="obs_04_0062__b17727124917431">KMSMasterKeyID</strong> is not specified, do not set the project ID.</li></ol>
<p id="obs_04_0062__p152901844162714">Ancestor: <strong id="obs_04_0062__b51428275448">ApplyServerSideEncryptionByDefault</strong></p>
<p id="obs_04_0062__p152901844162714">Parent: ApplyServerSideEncryptionByDefault</p>
<div class="note" id="obs_04_0062__note332131575820"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_04_0062__p4321215145814">When a custom key in a non-default IAM project is used to encrypt objects, only the key owner can upload or download the encrypted objects.</p>
</div></div>
</td>

18
docs/obs/api-ref/obs_04_0063.html
View File

@ -76,24 +76,24 @@ Date:<span class="w"> </span>date<span class="w"> </span>
</td>
<td class="cellrowborder" valign="top" width="60.650000000000006%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0063__p6536111718422">Root element of the default encryption configuration of a bucket.</p>
<p id="obs_04_0063__p85368172423">Type: container</p>
<p id="obs_04_0063__p125365178429">Ancestor: none</p>
<p id="obs_04_0063__p1555484273118">Children: Rule</p>
<p id="obs_04_0063__p125365178429">Parent: none</p>
<p id="obs_04_0063__p1555484273118">Child: Rule</p>
</td>
</tr>
<tr id="obs_04_0063__row12641636422"><td class="cellrowborder" valign="top" width="39.35%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0063__p3911152616425">Rule</p>
</td>
<td class="cellrowborder" valign="top" width="60.650000000000006%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0063__p591252604217">Sub-element of the default encryption configuration of a bucket.</p>
<p id="obs_04_0063__p391202634216">Type: container</p>
<p id="obs_04_0063__p4912142604210">Ancestor: ServerSideEncryptionConfiguration</p>
<p id="obs_04_0063__p83382043312">Children: ApplyServerSideEncryptionByDefault</p>
<p id="obs_04_0063__p4912142604210">Parent: ServerSideEncryptionConfiguration</p>
<p id="obs_04_0063__p83382043312">Child: ApplyServerSideEncryptionByDefault</p>
</td>
</tr>
<tr id="obs_04_0063__row944320444211"><td class="cellrowborder" valign="top" width="39.35%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0063__p163325395428">ApplyServerSideEncryptionByDefault</p>
</td>
<td class="cellrowborder" valign="top" width="60.650000000000006%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0063__p8333639114218">Sub-element of the default encryption configuration of a bucket.</p>
<p id="obs_04_0063__p1233323919429">Type: container</p>
<p id="obs_04_0063__p0333163974214">Ancestor: Rule</p>
<p id="obs_04_0063__p2559123813510">Children: SSEAlgorithm, KMSMasterKeyID</p>
<p id="obs_04_0063__p0333163974214">Parent: Rule</p>
<p id="obs_04_0063__p2559123813510">Child: SSEAlgorithm and KMSMasterKeyID</p>
</td>
</tr>
<tr id="obs_04_0063__row1314615104218"><td class="cellrowborder" valign="top" width="39.35%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0063__p11495174818425">SSEAlgorithm</p>
@ -101,21 +101,21 @@ Date:<span class="w"> </span>date<span class="w"> </span>
<td class="cellrowborder" valign="top" width="60.650000000000006%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0063__p74952488427">The server-side encryption algorithm used for encryption configuration of a bucket.</p>
<p id="obs_04_0063__p1543373514489">Type: string</p>
<p id="obs_04_0063__p1349514814423">Value options: <strong id="obs_04_0063__b7731144973819">kms</strong></p>
<p id="obs_04_0063__p1089135793715">Ancestor: ApplyServerSideEncryptionByDefault</p>
<p id="obs_04_0063__p1089135793715">Parent: ApplyServerSideEncryptionByDefault</p>
</td>
</tr>
<tr id="obs_04_0063__row13866105154213"><td class="cellrowborder" valign="top" width="39.35%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0063__p196161654134219"><span style="color:#444444;">KMSMasterKeyID</span></p>
</td>
<td class="cellrowborder" valign="top" width="60.650000000000006%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0063__p19616854174215">ID of the customer master key (CMK) used for SSE-KMS.</p>
<p id="obs_04_0063__p7616135414424">Type: string</p>
<p id="obs_04_0063__p2616105415423">Ancestor: ApplyServerSideEncryptionByDefault</p>
<p id="obs_04_0063__p2616105415423">Parent: ApplyServerSideEncryptionByDefault</p>
</td>
</tr>
<tr id="obs_04_0063__row1588165219426"><td class="cellrowborder" valign="top" width="39.35%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0063__p11881252154211">ProjectID</p>
</td>
<td class="cellrowborder" valign="top" width="60.650000000000006%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0063__p1088752184212">ID of the project where the KMS master key belongs when SSE-KMS is used.</p>
<p id="obs_04_0063__p1251114204310">Type: string</p>
<p id="obs_04_0063__p9167154814430">Ancestor: ApplyServerSideEncryptionByDefault</p>
<p id="obs_04_0063__p9167154814430">Parent: ApplyServerSideEncryptionByDefault</p>
<div class="note" id="obs_04_0063__note1937111215592"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_04_0063__p4321215145814">When a custom key in a non-default IAM project is used to encrypt objects, only the key owner can upload or download the encrypted objects.</p>
</div></div>
</td>

4
docs/obs/api-ref/obs_04_0068.html
View File

@ -43,7 +43,7 @@ Content-Length:<span class="w"> </span>length
<tbody><tr id="obs_04_0068__row64406127"><td class="cellrowborder" valign="top" width="26.540000000000003%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0068__p49513773">RequestPaymentConfiguration</p>
</td>
<td class="cellrowborder" valign="top" width="58.15%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0068__p51192643">Root node of the requester-pays configuration.</p>
<p id="obs_04_0068__p58080607">Ancestor: none</p>
<p id="obs_04_0068__p58080607">Parent: none</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0068__p6908717">Yes</p>
</td>
@ -52,7 +52,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="58.15%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0068__p65186226">Specifies who pays for accessing resources in the bucket.</p>
<p id="obs_04_0068__p49805123">Type: string</p>
<p id="obs_04_0068__p45592923">Ancestor: <strong id="obs_04_0068__b879392483017">RequestPaymentConfiguration</strong></p>
<p id="obs_04_0068__p45592923">Parent: RequestPaymentConfiguration</p>
<p id="obs_04_0068__p8695201710314">Value options:</p>
<ul id="obs_04_0068__ul176341522143118"><li id="obs_04_0068__li13634152219310"><strong id="obs_04_0068__b0990925913">BucketOwner</strong>: The bucket owner pays all fees associated with the bucket.</li><li id="obs_04_0068__li6814824203113"><strong id="obs_04_0068__b1978517211694">Requester</strong>: The requester pays for data transfer and API calls associated with accessing resources in the bucket, while the bucket owner pays for data storage in the bucket.</li></ul>
</td>

2
docs/obs/api-ref/obs_04_0069.html
View File

@ -63,7 +63,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="68.78999999999999%" headers="mcps1.3.8.3.1.3.1.2 "><p id="obs_04_0069__p65186226">Identifier of who pays for the bucket.</p>
<p id="obs_04_0069__p49805123">Type: string</p>
<p id="obs_04_0069__p8287634152514">Ancestor: <strong id="obs_04_0069__b1129313201612">RequestPaymentConfiguration</strong></p>
<p id="obs_04_0069__p8287634152514">Parent: RequestPaymentConfiguration</p>
<p id="obs_04_0069__p8695201710314">Value options:</p>
<ul id="obs_04_0069__ul176341522143118"><li id="obs_04_0069__li13634152219310"><strong id="obs_04_0069__b152101216101619">BucketOwner</strong>: The bucket owner pays all fees associated with the bucket.</li><li id="obs_04_0069__li6814824203113"><strong id="obs_04_0069__b13898817181617">Requester</strong>: The requester pays for data transfer and API calls associated with accessing resources in the bucket, while the bucket owner pays for data storage in the bucket.</li></ul>
</td>

56
docs/obs/api-ref/obs_04_0071.html
View File

File diff suppressed because it is too large Load Diff

26
docs/obs/api-ref/obs_04_0074.html
View File

@ -44,7 +44,7 @@ Content-MD5:<span class="w"> </span>MD5
</div>
</div>
<div class="section" id="obs_04_0074__section60322637"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0074__p17010680">This request contains no message parameters.</p>
<div class="section" id="obs_04_0074__section60322637"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0074__p17010680">This request contains no parameters.</p>
</div>
<div class="section" id="obs_04_0074__section6032824"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0074__p35687858">This request uses common headers and CORS request headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a> and <a href="#obs_04_0074__table15021581161521">Table 1</a>.</p>
@ -69,7 +69,7 @@ Content-MD5:<span class="w"> </span>MD5
</table>
</div>
</div>
<div class="section" id="obs_04_0074__section54295418"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0074__p33690852">In this request, you must configure the CORS of buckets in the request body. The lifecycle configuration is specified as XML with elements described in <a href="#obs_04_0074__table35453405161544">Table 2</a>.</p>
<div class="section" id="obs_04_0074__section54295418"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0074__p33690852">In this request body, you must configure the CORS rules for a bucket in XML format. <a href="#obs_04_0074__table35453405161544">Table 2</a> describes the specific configuration elements.</p>
<div class="tablenoborder"><a name="obs_04_0074__table35453405161544"></a><a name="table35453405161544"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0074__table35453405161544" frame="border" border="1" rules="all"><caption><b>Table 2 </b>CORS configuration elements</caption><thead align="left"><tr id="obs_04_0074__row7895657"><th align="left" class="cellrowborder" valign="top" width="19.387755102040817%" id="mcps1.3.5.3.2.4.1.1"><p id="obs_04_0074__p35568496">Element</p>
</th>
@ -83,7 +83,7 @@ Content-MD5:<span class="w"> </span>MD5
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p28302272">Root node of <strong id="obs_04_0074__b842352706145424">CORSRule</strong> and its capacity cannot exceed 64 KB.</p>
<p id="obs_04_0074__p53393857">Type: container</p>
<p id="obs_04_0074__p10782666">Ancestor: none</p>
<p id="obs_04_0074__p10782666">Parent: none</p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0074__p980736">Yes</p>
</td>
@ -92,7 +92,7 @@ Content-MD5:<span class="w"> </span>MD5
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p63694769">CORS rules. <strong id="obs_04_0074__b952926112115">CORSConfiguration</strong> can contain a maximum of 100 rules.</p>
<p id="obs_04_0074__p36382015">Type: container</p>
<p id="obs_04_0074__p59002687">Ancestor: CORSConfiguration</p>
<p id="obs_04_0074__p59002687">Parent: CORSConfiguration</p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0074__p14488317">Yes</p>
</td>
@ -101,7 +101,7 @@ Content-MD5:<span class="w"> </span>MD5
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p16836989">Unique identifier of a rule. The value can contain a maximum of 255 characters.</p>
<p id="obs_04_0074__p17315177">Type: string</p>
<p id="obs_04_0074__p21618872">Ancestor: CORSRule</p>
<p id="obs_04_0074__p21618872">Parent: CORSRule</p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0074__p6298183">No</p>
</td>
@ -111,35 +111,35 @@ Content-MD5:<span class="w"> </span>MD5
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p51212956">Method allowed by a CORS rule</p>
<p id="obs_04_0074__p58263423">Type: string</p>
<p id="obs_04_0074__p54608766">Value options: <strong id="obs_04_0074__b106990448468">GET</strong>, <strong id="obs_04_0074__b18699444164619">PUT</strong>, <strong id="obs_04_0074__b5699244124617">HEAD</strong>, <strong id="obs_04_0074__b11700134454613">POST</strong>, <strong id="obs_04_0074__b37007441466">DELETE</strong></p>
<p id="obs_04_0074__p21716848">Ancestor: CORSRule</p>
<p id="obs_04_0074__p21716848">Parent: CORSRule</p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0074__p14234302">Yes</p>
</td>
</tr>
<tr id="obs_04_0074__row60999859"><td class="cellrowborder" valign="top" width="19.387755102040817%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0074__p42041559">AllowedOrigin</p>
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p49923082">An origin that is allowed by a CORS rule. It is a character string and can contain a wildcard (*), and allows one wildcard character (*) at most.</p>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p49923082">Origins that are allowed in the CORS rule. Only English domain names are supported for configuring origins, and regular expressions can be used for matching origins. Each <strong id="obs_04_0074__b1269613955418">AllowedOrigin</strong> allows one wildcard character (*) at most.</p>
<p id="obs_04_0074__p46654562">Type: string</p>
<p id="obs_04_0074__p17237879">Ancestor: CORSRule</p>
<p id="obs_04_0074__p17237879">Parent: CORSRule</p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0074__p54090948">Yes</p>
</td>
</tr>
<tr id="obs_04_0074__row17056486"><td class="cellrowborder" valign="top" width="19.387755102040817%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0074__p39398119">AllowedHeader</p>
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p37131036">Headers that are allowed in a PutBucketCORS request via the <strong id="obs_04_0074__b65266721105921">Access-Control-Request-Headers</strong> header. If a request contains <strong id="obs_04_0074__b1735789192716">Access-Control-Request- Headers</strong>, only a CORS request that matches the configuration of AllowedHeader is considered as a valid request. Each AllowedHeader can contain at most one wildcard (*) and cannot contain spaces.</p>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p37131036">Headers that are allowed in a PutBucketCORS request via the <strong id="obs_04_0074__b65266721105921">Access-Control-Request-Headers</strong> header. If a CORS request contains <strong id="obs_04_0074__b1735789192716">Access-Control-Request-Headers</strong>, this request is considered valid only when it matches the configuration of <strong id="obs_04_0074__b13858192035613">AllowedHeader</strong>. The match is based on regular expressions. Each <strong id="obs_04_0074__b2084119205720">AllowedHeader</strong> can contain at most one wildcard (*) and cannot contain spaces.</p>
<p id="obs_04_0074__p65743869">Type: string</p>
<p id="obs_04_0074__p54823917">Ancestor: CORSRule</p>
<p id="obs_04_0074__p54823917">Parent: CORSRule</p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0074__p11552324">No</p>
</td>
</tr>
<tr id="obs_04_0074__row36862052"><td class="cellrowborder" valign="top" width="19.387755102040817%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0074__p33036220">MaxAgeSeconds</p>
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p58688140">Indicates the response time of CORS that can be cached by a client. It is expressed in seconds.</p>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p58688140">The time in seconds that the client can cache CORS responses.</p>
<p id="obs_04_0074__p58431217">Each CORSRule can contain only one MaxAgeSeconds. It can be set to a negative value.</p>
<p id="obs_04_0074__p56118909">Type: integer</p>
<p id="obs_04_0074__p35308137">Ancestor: CORSRule</p>
<p id="obs_04_0074__p35308137">Parent: CORSRule</p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0074__p41386862">No</p>
</td>
@ -148,7 +148,7 @@ Content-MD5:<span class="w"> </span>MD5
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p16441382">An additional header in CORS responses. The header provides additional information for clients. It cannot contain spaces.</p>
<p id="obs_04_0074__p13754711">Type: string</p>
<p id="obs_04_0074__p56683537">Ancestor: CORSRule</p>
<p id="obs_04_0074__p56683537">Parent: CORSRule</p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0074__p27963789">No</p>
</td>

16
docs/obs/api-ref/obs_04_0075.html
View File

@ -60,21 +60,21 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0075__p12963734">Root node of <strong id="obs_04_0075__b195838300469">CORSRules</strong> and its capacity cannot exceed 64 KB.</p>
<p id="obs_04_0075__p49564750">Type: container</p>
<p id="obs_04_0075__p43429572">Ancestor: none</p>
<p id="obs_04_0075__p43429572">Parent: none</p>
</td>
</tr>
<tr id="obs_04_0075__row55321833"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0075__p51883501">CORSRule</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0075__p41814016">CORS rule. CORSConfiguration can contain a maximum of 100 rules.</p>
<p id="obs_04_0075__p40781832">Type: container</p>
<p id="obs_04_0075__p31492173">Ancestor: CORSConfiguration</p>
<p id="obs_04_0075__p31492173">Parent: CORSConfiguration</p>
</td>
</tr>
<tr id="obs_04_0075__row14994104"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0075__p6562892">ID</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0075__p61832237">Unique identifier of a rule. The value can contain a maximum of 255 characters.</p>
<p id="obs_04_0075__p19619221">Type: string</p>
<p id="obs_04_0075__p42355266">Ancestor: CORSRule</p>
<p id="obs_04_0075__p42355266">Parent: CORSRule</p>
</td>
</tr>
<tr id="obs_04_0075__row45653075"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0075__p6911634">AllowedMethod</p>
@ -82,21 +82,21 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0075__p22971514">Method allowed by a CORS rule.</p>
<p id="obs_04_0075__p5417036">Type: string</p>
<p id="obs_04_0075__p48753330">Value options: <strong id="obs_04_0075__b891450164614">GET</strong>, <strong id="obs_04_0075__b179145074616">PUT</strong>, <strong id="obs_04_0075__b1791195016469">HEAD</strong>, <strong id="obs_04_0075__b1291185010460">POST</strong>, <strong id="obs_04_0075__b991135004614">DELETE</strong></p>
<p id="obs_04_0075__p36126787">Ancestor: CORSRule</p>
<p id="obs_04_0075__p36126787">Parent: CORSRule</p>
</td>
</tr>
<tr id="obs_04_0075__row56705634"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0075__p29753651">AllowedOrigin</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0075__p61235532">Indicates an origin that is allowed by a CORS rule. It is a character string and can contain a wildcard (*), and allows one wildcard character (*) at most.</p>
<p id="obs_04_0075__p14248884">Type: string</p>
<p id="obs_04_0075__p61131094">Ancestor: CORSRule</p>
<p id="obs_04_0075__p61131094">Parent: CORSRule</p>
</td>
</tr>
<tr id="obs_04_0075__row13308941"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0075__p4282435">AllowedHeader</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0075__p11332925">Indicates which headers are allowed in a PUT Bucket CORS request via the <strong id="obs_04_0075__b65266721105921">Access-Control-Request-Headers</strong> header. If a request contains <strong id="obs_04_0075__b1695414116425">Access-Control-Request- Headers</strong>, only a CORS request that matches the configuration of AllowedHeader is considered as a valid request. Each AllowedHeader can contain at most one wildcard (*) and cannot contain spaces.</p>
<p id="obs_04_0075__p34887463">Type: string</p>
<p id="obs_04_0075__p45551715">Ancestor: CORSRule</p>
<p id="obs_04_0075__p45551715">Parent: CORSRule</p>
</td>
</tr>
<tr id="obs_04_0075__row7312259"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0075__p55422103">MaxAgeSeconds</p>
@ -104,14 +104,14 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0075__p60005388">Response time of CORS that can be cached by a client. It is expressed in seconds.</p>
<p id="obs_04_0075__p3177586">Each CORSRule can contain only one MaxAgeSeconds. It can be set to a negative value.</p>
<p id="obs_04_0075__p28598282">Type: integer</p>
<p id="obs_04_0075__p56057947">Ancestor: CORSRule</p>
<p id="obs_04_0075__p56057947">Parent: CORSRule</p>
</td>
</tr>
<tr id="obs_04_0075__row34759480"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0075__p64054462">ExposeHeader</p>
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0075__p21028933">Indicates a supplemented header in CORS responses. The header provides additional information for clients. It cannot contain spaces.</p>
<p id="obs_04_0075__p55042672">Type: string</p>
<p id="obs_04_0075__p25622004">Ancestor: CORSRule</p>
<p id="obs_04_0075__p25622004">Parent: CORSRule</p>
</td>
</tr>
</tbody>

8
docs/obs/api-ref/obs_04_0079.html
View File

@ -4,13 +4,13 @@
<div id="body40793968"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_04_0080.html">Uploading Objects - PUT</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0080.html">Uploading an Object - PUT</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0081.html">Uploading Objects - POST</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0081.html">Uploading an Object - POST</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0082.html">Copying Objects</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0082.html">Copying an Object</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0083.html">Downloading Objects</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0083.html">Downloading an Object</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0084.html">Querying Object Metadata</a></strong><br>
</li>

28
docs/obs/api-ref/obs_04_0080.html
View File

@ -1,6 +1,6 @@
<a name="obs_04_0080"></a><a name="obs_04_0080"></a>
<h1 class="topictitle1">Uploading Objects - PUT</h1>
<h1 class="topictitle1">Uploading an Object - PUT</h1>
<div id="body25727187"><div class="section" id="obs_04_0080__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0080__p57130901">After creating a bucket in OBS, you can use this operation to upload an object to the bucket. This operation uploads an object to a bucket. To use this operation, you must have the write permission for the bucket.</p>
<div class="note" id="obs_04_0080__note44416069"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="obs_04_0080__p30218092">The name of each object in a bucket must be unique.</p>
</div></div>
@ -11,17 +11,16 @@
<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>
<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. Request lines of these two methods are given as follows:</p>
<pre class="screen" id="obs_04_0080__screen53331759111919">PUT /ObjectName HTTP/1.1</pre>
<pre class="screen" id="obs_04_0080__screen666703202019">POST / HTTP/1.1</pre>
<p id="obs_04_0080__p62431152115613">For details about POST upload, see <a href="obs_04_0081.html">Uploading Objects - POST</a>.</p>
<p id="obs_04_0080__p62431152115613">For details about POST upload, see <a href="obs_04_0081.html">Uploading an Object - POST</a>.</p>
</div>
<div class="section" id="obs_04_0080__section27143284"><h4 class="sectiontitle">Versioning</h4><p class="msonormal" id="obs_04_0080__p31746393">If versioning is enabled for a bucket, the system automatically generates a unique version ID for the requested object in this bucket and returns the version ID in response header <strong id="obs_04_0080__b38890115">x-obs-version-id</strong>. If versioning is suspended for the bucket, the object version ID is <strong id="obs_04_0080__b4762183545911">null</strong>. For details about the versioning statuses of a bucket, see <a href="obs_04_0037.html">Configuring Versioning for a Bucket</a>.</p>
</div>
<div class="section" id="obs_04_0080__section1475721115541"><h4 class="sectiontitle">WORM</h4><p id="obs_04_0080__p759131755418">If a bucket has WORM enabled, you can configure retention policies for objects in the bucket. You can specify the <strong id="obs_04_0080__b1821612513390">x-obs-object-lock-mode</strong> and <strong id="obs_04_0080__b378111773910">x-obs-object-lock-retain-until-date</strong> headers to configure a retention policy when you upload an object. If you do not specify these two headers but have configured a default bucket-level WORM policy, this default policy automatically applies to the object newly uploaded. You can also configure or update a WORM retention policy for an existing object.</p>
<div class="note" id="obs_04_0080__note143221114511"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0080__p1277512964714">When you enable WORM for a bucket, OBS automatically enables versioning for the bucket. WORM protects objects based on the object version IDs. Only object versions with any WORM retention policy configured will be protected. Assume that object <strong id="obs_04_0080__b86122918189">test.txt 001</strong> is protected by WORM. If another file with the same name is uploaded, a new object version <strong id="obs_04_0080__b1110331181915">test.txt 002</strong> with no WORM policy configured will be generated. In such case, <strong id="obs_04_0080__b5285134217204">test.txt 002</strong> is not protected and can be deleted. When you download an object without specifying a version ID, the current object version (<strong id="obs_04_0080__b863463619217">test.txt 002</strong>) will be downloaded.</p>
</div></div>
<p id="obs_04_0080__p477113453505"></p>
</div>
<div class="section" id="obs_04_0080__section42962965"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0080__screen49284209"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
@ -156,15 +155,14 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row58960965"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0080__p11108823">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p27399486">Indicates the master key when SSE-KMS is used. If this header is not provided, the default master key will be used. If there is no such a default master key, OBS will create one and use it by default.</p>
<p id="obs_04_0080__p45268789">Type: string</p>
<p id="obs_04_0080__p6679135313114">The following two formats are supported:</p>
<p id="obs_04_0080__p486340133414">- <em id="obs_04_0080__i184740245012">regionID</em><strong id="obs_04_0080__b11474202418012">:</strong><em id="obs_04_0080__i114743247014">domainID</em><strong id="obs_04_0080__b1347422413010">:key/</strong><em id="obs_04_0080__i24741241001">key_id</em></p>
<p id="obs_04_0080__p090816596123">- <em id="obs_04_0080__i67511527901">key_id</em></p>
<p id="obs_04_0080__p558627121315"><em id="obs_04_0080__i164971941212">regionID</em> indicates the ID of the region where the key belongs. <em id="obs_04_0080__i449874913">domainID</em> indicates the ID of the tenant where the key belongs. <em id="obs_04_0080__i44981749114">key_id</em> indicates the ID of the key created in KMS.</p>
<p id="obs_04_0080__p17830152818144">Example:</p>
<p id="obs_04_0080__p887642112425">- <strong id="obs_04_0080__b8804144511214">x-obs-server-side-encryption-kms-key-id: </strong><em id="obs_04_0080__i1826125311361">region</em>:<strong id="obs_04_0080__b151008511225">domainiddomainiddomainiddoma0001: key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</strong></p>
<p id="obs_04_0080__p9879721204216">- <strong id="obs_04_0080__b121003718213">x-obs-server-side-encryption-kms-key-id: 4f1cd4de-ab64-4807-920a-47fc42e7f0d0</strong></p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p16779515135616"><strong id="obs_04_0080__b1637810181284">Explanation</strong>:</p>
<p id="obs_04_0080__p127799156563">The key used to encrypt objects. This header can be specified using either of the following formats:</p>
<p id="obs_04_0080__p147792155569">1. <em id="obs_04_0080__i1748822832815">regionID</em><strong id="obs_04_0080__b12649193519283">:</strong><em id="obs_04_0080__i2090653032810">domainID</em><strong id="obs_04_0080__b990342132817">:</strong><strong id="obs_04_0080__b0359181182918">key/</strong><em id="obs_04_0080__i138321036296">key_id</em>: <em id="obs_04_0080__i12471313142811">regionID</em> indicates the ID of the region where the key belongs. <em id="obs_04_0080__i9247413152820">domainID</em> indicates the ID of the tenant where the key belongs. <em id="obs_04_0080__i1924712133289">key_id</em> indicates the ID of the key created in KMS on the DEW console. An example is given as follows: <strong id="obs_04_0080__b759430194720">x-obs-server-side-encryption-kms-key-id: </strong><em id="obs_04_0080__i0937163785812">region</em><strong id="obs_04_0080__b5879431203618">:exampledomainid: key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</strong>.</p>
<p id="obs_04_0080__p6779415115615">2. <em id="obs_04_0080__i1367948133617">key_id</em>: It indicates the ID of the key created in KMS on the DEW console. An example is given as follows: <strong id="obs_04_0080__b5587387393">x-obs-server-side-encryption-kms-key-id: 4f1cd4de-ab64-4807-920a-47fc42e7f0d0</strong>.</p>
<p id="obs_04_0080__p97793154567"><strong id="obs_04_0080__b1392517101611">Restrictions</strong>:</p>
<p id="obs_04_0080__p8779121513566">This header can be used only when you set the <strong id="obs_04_0080__b8427938104010">x-obs-server-side-encryption</strong> header to <strong id="obs_04_0080__b10482017414">kms</strong>.</p>
<p id="obs_04_0080__p16779015195615"><strong id="obs_04_0080__b122221815179">Default value</strong>:</p>
<p id="obs_04_0080__p577951515617">If you choose the KMS encryption but do not specify this header, the default master key will be used. If there is no such a default master key, OBS will create one and use it by default.</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0080__p50495402">No</p>
</td>
@ -252,7 +250,7 @@ Content-Type:<span class="w"> </span>type
</div>
</div>
<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 message headers listed in <a href="#obs_04_0080__table24122936102344">Table 2</a> may be used.</p>
<p class="msonormal" id="obs_04_0080__p30613480">In addition to the common response headers, the headers listed in <a href="#obs_04_0080__table24122936102344">Table 2</a> may be used.</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.10.4.2.3.1.1"><p id="obs_04_0080__p1414299">Header</p>
</th>
@ -298,7 +296,7 @@ Content-Type:<span class="w"> </span>type
</tr>
<tr id="obs_04_0080__row33117788"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0080__p65295189">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0080__p54418926">This header is returned when the storage class of an object is not Standard. The value can be <strong id="obs_04_0080__b142242621220610">WARM</strong> or <strong id="obs_04_0080__b39795655420610">COLD</strong>.</p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0080__p54418926">This header is returned when the storage class of an object is not Standard. The value can be <strong id="obs_04_0080__b371322482811">WARM</strong> or <strong id="obs_04_0080__b137131424112816">COLD</strong>.</p>
<p id="obs_04_0080__p20008286">Type: string</p>
</td>
</tr>

16
docs/obs/api-ref/obs_04_0081.html
View File

@ -1,6 +1,6 @@
<a name="obs_04_0081"></a><a name="obs_04_0081"></a>
<h1 class="topictitle1">Uploading Objects - POST</h1>
<h1 class="topictitle1">Uploading an Object - POST</h1>
<div id="body14481882"><div class="section" id="obs_04_0081__section1534875573"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0081__p59601668">This operation uploads an object to a bucket. To use this operation, you must have the write permission for the bucket.</p>
<div class="note" id="obs_04_0081__note66652971"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="obs_04_0081__p63228075">The name of each object in a bucket must be unique.</p>
</div></div>
@ -13,7 +13,7 @@
<p id="obs_04_0081__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. Request lines of these two methods are given as follows:</p>
<pre class="screen" id="obs_04_0081__screen53331759111919">PUT /ObjectName HTTP/1.1</pre>
<pre class="screen" id="obs_04_0081__screen666703202019">POST / HTTP/1.1</pre>
<p id="obs_04_0081__p19165518576">For details about PUT upload, see <a href="obs_04_0080.html">Uploading Objects - PUT</a>.</p>
<p id="obs_04_0081__p19165518576">For details about PUT upload, see <a href="obs_04_0080.html">Uploading an Object - PUT</a>.</p>
</div>
<div class="section" id="obs_04_0081__section28789840"><h4 class="sectiontitle">Versioning</h4><p class="msonormal" id="obs_04_0081__p21200411">If versioning is enabled for a bucket, the system automatically generates a unique version ID for the requested object in this bucket and returns the version ID in response header <strong id="obs_04_0081__b66290058">x-obs-version-id</strong>. If versioning is suspended for a bucket, the version ID of the requested object in this bucket is <strong id="obs_04_0081__b59739617">null</strong>. For details about the versioning statuses of a bucket, see <a href="obs_04_0037.html">Configuring Versioning for a Bucket</a>.</p>
</div>
@ -456,7 +456,7 @@ ETag:<span class="w"> </span>etag
</div>
</div>
<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 message headers listed in <a href="#obs_04_0081__table35215532173747">Table 3</a> may be used.</p>
<p class="msonormal" id="obs_04_0081__p15525038">In addition to the common response headers, the headers listed in <a href="#obs_04_0081__table35215532173747">Table 3</a> may be used.</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.10.4.2.3.1.1"><p id="obs_04_0081__p21709532">Header</p>
</th>
@ -926,7 +926,7 @@ Content-Disposition: form-data; name="key"
object01
--148828969260233905620870
Content-Disposition: form-data; name="AwsAccessKeyId"
Content-Disposition: form-data; name="ObsAccessKeyId"
55445349414d5354554254455354303030303033
--148828969260233905620870
@ -981,7 +981,7 @@ Content-Disposition: form-data; name="key"
obj
----------------------------285613759795901770404350
Content-Disposition: form-data; name="AwsAccessKeyId"
Content-Disposition: form-data; name="ObsAccessKeyId"
XXXXXXXXXXXXXXX000003
----------------------------285613759795901770404350
@ -1020,7 +1020,7 @@ x-obs-id-2: 32AAAUJAIAABAAAQAAEAABAAAQAAEAABCScDjcXgZ7oMYSVnZnk4+HrClVwLVPTi
x-forward-status: 0x40020000000001
x-dae-api-type: REST.POST.OBJECT</pre>
</div>
<div class="section" id="obs_04_0081__section1299154075311"><h4 class="sectiontitle">Sample Request: Configuring a WORM Retention Policy When Uploading an Object</h4><pre class="screen" id="obs_04_0081__screen16138124035319">POST /srcbucket HTTP/1.1
<div class="section" id="obs_04_0081__section1299154075311"><h4 class="sectiontitle">Sample Request: Uploading an Object (with a WORM Retention Policy Configured)</h4><pre class="screen" id="obs_04_0081__screen16138124035319">POST /srcbucket HTTP/1.1
User-Agent: PostmanRuntime/7.26.8
Accept: */*
Postman-Token: 4c2f4c7e-2e0b-46c0-b1a7-4a5da560b6a1
@ -1035,7 +1035,7 @@ Content-Disposition: form-data; name="key"
obj
----------------------------940435396775653808840608
Content-Disposition: form-data; name="AwsAccessKeyId"
Content-Disposition: form-data; name="ObsAccessKeyId"
XXXXXXXXXXXXXXX000003
----------------------------940435396775653808840608
@ -1065,7 +1065,7 @@ Content-Disposition: form-data; name="submit"
Upload to OBS
----------------------------940435396775653808840608--</pre>
</div>
<div class="section" id="obs_04_0081__section1102140135316"><h4 class="sectiontitle">Sample Response: Configuring a WORM Retention Policy When Uploading an Object</h4><pre class="screen" id="obs_04_0081__screen61382040125315">HTTP/1.1 204 No Content
<div class="section" id="obs_04_0081__section1102140135316"><h4 class="sectiontitle">Sample Response: Uploading an Object (with a WORM Retention Policy Configured)</h4><pre class="screen" id="obs_04_0081__screen61382040125315">HTTP/1.1 204 No Content
Server: OBS
Date: Thu, 15 Jun 2023 13:24:03 GMT
Connection: keep-alive

29
docs/obs/api-ref/obs_04_0082.html
View File

@ -1,17 +1,18 @@
<a name="obs_04_0082"></a><a name="obs_04_0082"></a>
<h1 class="topictitle1">Copying Objects</h1>
<h1 class="topictitle1">Copying an Object</h1>
<div id="body61435126"><div class="section" id="obs_04_0082__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0082__p39464956">You can perform this operation to create a copy of an existing object in OBS.</p>
<p class="msonormal" id="obs_04_0082__p19640290">Users can determine whether to copy the metadata of the source object to the target object (by default) or replace the metadata of the target object with the metadata contained in the request. The ACL of the source object is not copied to the target object. By default, the ACL of the target object is private. You can set an ACL for the target object by sending an API request.</p>
<p class="msonormal" id="obs_04_0082__p42544890">The request for copying an object needs to carry the information about the bucket and object to be copied in the header field. The message body cannot be carried.</p>
<p class="msonormal" id="obs_04_0082__p47359691">This operation supports server-side encryption.</p>
<p id="obs_04_0082__p9615112319534">An object copy can be up to 5 GB in size. If the source object size exceeds 5 GB, you can only <a href="obs_04_0100.html">copy part of the object</a>.</p>
<div class="note" id="obs_04_0082__note1586114511116"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="cautiontext" id="obs_04_0082__p49467454">You cannot determine whether a request is executed successfully only using <strong id="obs_04_0082__b733137133204115">status_code</strong> in the header returned by HTTP. If 200 in <strong id="obs_04_0082__b1634619502204120">status_code</strong> is returned, the server has received the request and starts to process the request. The body in the response shows whether the copy succeeds. If the body contains ETag, the copy succeeds. Otherwise, the copy failed.</p>
</div></div>
</div>
<div class="section" id="obs_04_0082__section23584040"><h4 class="sectiontitle">Versioning</h4><p class="msonormal" id="obs_04_0082__p10189271">By default, <strong id="obs_04_0082__b48514746">x-obs-copy-source</strong> specifies the latest version of the source object. If the latest version of the source object has a deletion marker, the object is considered to have been deleted. You can add <strong id="obs_04_0082__b33979533">versionId</strong> to request header <strong id="obs_04_0082__b37380344">x-obs-copy-source</strong> to copy an object with the specified version ID.</p>
<div class="section" id="obs_04_0082__section23584040"><h4 class="sectiontitle">Versioning</h4><p class="msonormal" id="obs_04_0082__p10189271">By default, <strong id="obs_04_0082__b48514746">x-obs-copy-source</strong> specifies the latest version of the source object. If the latest version of the source object is a delete marker, the object is considered deleted. You can add <strong id="obs_04_0082__b33979533">versionId</strong> to request header <strong id="obs_04_0082__b37380344">x-obs-copy-source</strong> to copy an object with the specified version ID.</p>
<p class="msonormal" id="obs_04_0082__p24594578">If a bucket has versioning enabled, the system automatically generates a unique version ID for the requested object in this bucket and returns the version ID in response header <strong id="obs_04_0082__b7909027">x-obs-version-id</strong>. If versioning is suspended for the bucket, the object version ID is <strong id="obs_04_0082__b6348185161214">null</strong>.</p>
<div class="notice" id="obs_04_0082__note11381267"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p class="cautiontext" id="obs_04_0082__p35322545">When the bucket versioning status is disabled, if you make a copy of object_A and save it as object_B, and an object named as object_B already exists, the new object_B will overwrite the existing one. After the copying is executed successfully, only new object_B can be downloaded because old object_B has been deleted. Therefore, before copying an object, ensure that there is no object with the same name as the object copy to prevent data from being deleted mistakenly. During the copying, object_A has no changes. </p>
</div></div>
<p class="cautiontext" id="obs_04_0082__p49467454">You cannot determine whether a request is executed successfully only using <strong id="obs_04_0082__b733137133204115">status_code</strong> in the header returned by HTTP. If 200 in <strong id="obs_04_0082__b1634619502204120">status_code</strong> is returned, the server has received the request and starts to process the request. The body in the response shows whether the copy succeeds. If the body contains ETag, the copy succeeds. Otherwise, the copy failed.</p>
</div>
<div class="section" id="obs_04_0082__section1475721115541"><h4 class="sectiontitle">WORM</h4><p id="obs_04_0082__p134973436414">If a bucket has WORM enabled, you can configure retention policies for objects in the bucket. You can specify the <strong id="obs_04_0082__b16286138101016">x-obs-object-lock-mode</strong> and <strong id="obs_04_0082__b142863861017">x-obs-object-lock-retain-until-date</strong> headers to configure a retention policy when you copy an object. If you do not specify these two headers but have configured a default bucket-level WORM policy, this default policy automatically applies to the object newly copied. You can also configure or update a WORM retention policy after an object is copied to the bucket.</p>
<div class="note" id="obs_04_0082__note7241205112419"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0082__p724113511418">In a copy operation, the object protection status is not copied, so the protection status of an object copy is independent of that of the source object. After the copy is complete, WORM retention changes made on the source object does not affect the object copy.</p>
@ -44,7 +45,7 @@ Date:<span class="w"> </span>date
</div>
</div>
<div class="section" id="obs_04_0082__section12896034"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0082__p48230284">This request contains no message parameters.</p>
<div class="section" id="obs_04_0082__section12896034"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0082__p48230284">This request contains no parameters.</p>
</div>
<div class="section" id="obs_04_0082__section48955445"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0082__p14338945">You can add optional headers to specify the object to be copied. <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a> describes the optional headers.</p>
@ -58,7 +59,7 @@ Date:<span class="w"> </span>date
</thead>
<tbody><tr id="obs_04_0082__row3058719"><td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0082__p46429677">x-obs-acl</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0082__p227785144918">This header can be added to set access control policies for objects when copying the objects. The access control policies are the predefined common policies, including <strong id="obs_04_0082__b842352706163347">private</strong>, <strong id="obs_04_0082__b842352706163352">public-read</strong>, <strong id="obs_04_0082__b842352706163357">public-read-write</strong>.</p>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0082__p227785144918">When copying an object, you can add this header to configure the object ACL using the predefined common policies, including <strong id="obs_04_0082__b4139161132118">private</strong>, <strong id="obs_04_0082__b20139101112113">public-read</strong>, and <strong id="obs_04_0082__b10139101192119">public-read-write</strong>.</p>
<p id="obs_04_0082__p24367465">Type: string</p>
<p id="obs_04_0082__p17980599">Example: <strong id="obs_04_0082__b183885920497">x-obs-acl: acl</strong></p>
</td>
@ -121,17 +122,17 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0082__row43768204"><td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0082__p55563613">x-obs-copy-source-if-match</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0082__p4358836">Copies the source object only if its ETag matches the one specified by this header. Otherwise, a 412 HTTP status code error (failed precondition) is returned.</p>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0082__p4358836">Indicates that the source object is copied only if its ETag matches the one specified in this header. Otherwise, a 412 status code (failed precondition) is returned.</p>
<p id="obs_04_0082__p39229524">Type: string</p>
<p id="obs_04_0082__p17521398">Example: <strong id="obs_04_0082__b8380152210495">x-obs-copy-source-if-match: etag</strong></p>
<p id="obs_04_0082__p23474860">Constraint: This parameter can be used with <strong id="obs_04_0082__b1789215718286">x-obs-copy-source-if-unmodified-since</strong> but not other conditional copy parameters.</p>
<p id="obs_04_0082__p23474860">Constraint: This header can be used with <strong id="obs_04_0082__b8676118589">x-obs-copy-source-if-unmodified-since</strong> but not other conditional copy headers.</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0082__p22415484">No</p>
</td>
</tr>
<tr id="obs_04_0082__row412769"><td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0082__p33434329">x-obs-copy-source-if-none-match</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0082__p23826142">Copies the object only if its ETag does not match the one specified in this header. Otherwise, a 412 HTTP status code error (failed precondition) is returned.</p>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0082__p23826142">Indicates that the source object is copied only if its ETag does not match the one specified in this header. Otherwise, a 412 status code (failed precondition) is returned.</p>
<p id="obs_04_0082__p13108688">Type: string</p>
<p id="obs_04_0082__p50869335">Example: <strong id="obs_04_0082__b5753172610494">x-obs-copy-source-if-none-match: etag</strong></p>
<p id="obs_04_0082__p55170835">Constraint: This parameter can be used with <strong id="obs_04_0082__b8567153014296">x-obs-copy-source-if-modified-since</strong> but not other conditional copy parameters.</p>
@ -144,9 +145,9 @@ Date:<span class="w"> </span>date
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0082__p19892329">Indicates that the source object is copied only if it has not been modified since the time specified by this header. Otherwise, error code 412 (failed precondition) is returned. This header can be used with <strong id="obs_04_0082__b195702434325">x-obs-copy-source-if-match</strong>, but cannot be used with other conditional copy headers.</p>
<p id="obs_04_0082__p44813233">Type: string</p>
<p id="obs_04_0082__p7842432181619">Format: HTTP time string complying with the format specified at <strong id="obs_04_0082__b17164103414179">http://www.ietf.org/rfc/rfc2616.txt</strong>, which can be any of the following:</p>
<ol id="obs_04_0082__ol02590473167"><li id="obs_04_0082__li14259134712162">EEE, dd MMM yyyy HH:mm:ss z</li><li id="obs_04_0082__li1326017473168">EEEE, dd-MMM-yy HH:mm:ss z</li><li id="obs_04_0082__li18260347181610">EEE MMM dd HH:mm:ss yyyy</li></ol>
<ol id="obs_04_0082__ol02590473167"><li id="obs_04_0082__li14259134712162"><strong id="obs_04_0082__b836032219182">EEE, dd MMM yyyy HH:mm:ss z</strong></li><li id="obs_04_0082__li1326017473168"><strong id="obs_04_0082__b18238142421819">EEEE, dd-MMM-yy HH:mm:ss z</strong></li><li id="obs_04_0082__li18260347181610"><strong id="obs_04_0082__b863019257189">EEE MMM dd HH:mm:ss yyyy</strong></li></ol>
<p id="obs_04_0082__p614810111413">Examples:</p>
<ol id="obs_04_0082__ol15822094117"><li id="obs_04_0082__li17815209415">x-obs-copy-source-if-unmodified-since: Sun, 06 Nov 1994 08:49:37 GMT</li><li id="obs_04_0082__li1081620184112">x-obs-copy-source-if-unmodified-since: Sunday, 06-Nov-94 08:49:37 GMT</li><li id="obs_04_0082__li9892014414">x-obs-copy-source-if-unmodified-since: Sun Nov 6 08:49:37 1994</li></ol>
<ol id="obs_04_0082__ol15822094117"><li id="obs_04_0082__li17815209415"><strong id="obs_04_0082__b12998112631815">x-obs-copy-source-if-unmodified-since: Sun, 06 Nov 1994 08:49:37 GMT</strong></li><li id="obs_04_0082__li1081620184112"><strong id="obs_04_0082__b1734962971817">x-obs-copy-source-if-unmodified-since: Sunday, 06-Nov-94 08:49:37 GMT</strong></li><li id="obs_04_0082__li9892014414"><strong id="obs_04_0082__b125273114189">x-obs-copy-source-if-unmodified-since: Sun Nov 6 08:49:37 1994</strong></li></ol>
<p id="obs_04_0082__p144291819194015">Constraint: The time specified by this header cannot be later than the current server time (GMT time), or this header does not take effect.</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0082__p53939580">No</p>
@ -157,9 +158,9 @@ Date:<span class="w"> </span>date
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0082__p24518744">Indicates that the source object is copied only if it has been modified since the time specified by this header. Otherwise, error code 412 (failed precondition) is returned. This header can be used with <strong id="obs_04_0082__b109601229431">x-obs-copy-source-if-none-match</strong>, but cannot be used with other conditional copy headers.</p>
<p id="obs_04_0082__p19342108">Type: string</p>
<p id="obs_04_0082__p68321613174320">Format: HTTP time string complying with the format specified at <strong id="obs_04_0082__b28261324184215">http://www.ietf.org/rfc/rfc2616.txt</strong>, which can be any of the following:</p>
<ol id="obs_04_0082__ol13832813144310"><li id="obs_04_0082__li383271334313">EEE, dd MMM yyyy HH:mm:ss z</li><li id="obs_04_0082__li15832141314319">EEEE, dd-MMM-yy HH:mm:ss z</li><li id="obs_04_0082__li19832101318434">EEE MMM dd HH:mm:ss yyyy</li></ol>
<ol id="obs_04_0082__ol13832813144310"><li id="obs_04_0082__li383271334313"><strong id="obs_04_0082__b11910163281819">EEE, dd MMM yyyy HH:mm:ss z</strong></li><li id="obs_04_0082__li15832141314319"><strong id="obs_04_0082__b75714343186">EEEE, dd-MMM-yy HH:mm:ss z</strong></li><li id="obs_04_0082__li19832101318434"><strong id="obs_04_0082__b320619400185">EEE MMM dd HH:mm:ss yyyy</strong></li></ol>
<p id="obs_04_0082__p883281314316">Examples:</p>
<ol id="obs_04_0082__ol1832713114315"><li id="obs_04_0082__li583218135434">x-obs-copy-source-if-unmodified-since: Sun, 06 Nov 1994 08:49:37 GMT</li><li id="obs_04_0082__li983221374317">x-obs-copy-source-if-unmodified-since: Sunday, 06-Nov-94 08:49:37 GMT</li><li id="obs_04_0082__li188321913144312">x-obs-copy-source-if-unmodified-since: Sun Nov 6 08:49:37 1994</li></ol>
<ol id="obs_04_0082__ol1832713114315"><li id="obs_04_0082__li583218135434"><strong id="obs_04_0082__b1696614114181">x-obs-copy-source-if-unmodified-since: Sun, 06 Nov 1994 08:49:37 GMT</strong></li><li id="obs_04_0082__li983221374317"><strong id="obs_04_0082__b8832114317185">x-obs-copy-source-if-unmodified-since: Sunday, 06-Nov-94 08:49:37 GMT</strong></li><li id="obs_04_0082__li188321913144312"><strong id="obs_04_0082__b332134551819">x-obs-copy-source-if-unmodified-since: Sun Nov 6 08:49:37 1994</strong></li></ol>
<p id="obs_04_0082__p033575519130">Constraint: The time specified by this header cannot be later than the current server time (GMT time), or this header does not take effect.</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0082__p7535566">No</p>
@ -327,7 +328,7 @@ Content-Length:<span class="w"> </span>length
</div>
</div>
<div class="section" id="obs_04_0082__section53712907"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0082__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<p class="msonormal" id="obs_04_0082__p50494524">In addition to the common response headers, the message headers listed in <a href="#obs_04_0082__table45458228101549">Table 2</a> may be used.</p>
<p class="msonormal" id="obs_04_0082__p50494524">In addition to the common response headers, the headers listed in <a href="#obs_04_0082__table45458228101549">Table 2</a> may be used.</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.10.4.2.3.1.1"><p id="obs_04_0082__p9478074">Header</p>
</th>
@ -379,7 +380,7 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0082__row2048480"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0082__p31709196">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0082__p18308080">This header is returned when the storage class of an object is not Standard. The value can be <strong id="obs_04_0082__b16862175124619">WARM</strong> or <strong id="obs_04_0082__b1386325144617">COLD</strong>.</p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0082__p18308080">This header is returned when the storage class of an object is not Standard. The value can be <strong id="obs_04_0082__b1221168154514">WARM</strong> or <strong id="obs_04_0082__b16228814451">COLD</strong>.</p>
<p id="obs_04_0082__p30554999">Type: string</p>
</td>
</tr>

16
docs/obs/api-ref/obs_04_0083.html
View File

@ -1,11 +1,11 @@
<a name="obs_04_0083"></a><a name="obs_04_0083"></a>
<h1 class="topictitle1">Downloading Objects</h1>
<div id="body7507202"><div class="section" id="obs_04_0083__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="MsoNormal" id="obs_04_0083__p51920639">This operation downloads objects from OBS. Before using this GET operation, check that you have the read permission for the target object. If the object owner has granted anonymous users the read permission for the object, anonymous users can access this object without using the authentication header field.</p>
<h1 class="topictitle1">Downloading an Object</h1>
<div id="body7507202"><div class="section" id="obs_04_0083__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="MsoNormal" id="obs_04_0083__p51920639">This operation downloads an object from OBS. Before using this GET operation, check that you have the read permission for the target object. If the object owner has granted anonymous users the read permission for the object, anonymous users can access this object without using the authentication header field.</p>
</div>
<div class="section" id="obs_04_0083__section44822219"><h4 class="sectiontitle">Server-Side Encryption</h4><p class="MsoNormal" id="obs_04_0083__p4103663">If the object uploaded to the server is encrypted on the server using the encryption key provided by the client, downloading the object requires including the encryption key in the message.</p>
</div>
<div class="section" id="obs_04_0083__section746787"><h4 class="sectiontitle">Versioning</h4><p class="MsoNormal" id="obs_04_0083__p63961276">By default, the GET operation returns the current version of an object. If the current version of the object is a deletion marker, OBS returns a code meaning non-existence of the object. To obtain an object of a specified version, the <strong id="obs_04_0083__b158935119499">versionId</strong> parameter can be used to specify the desired version.</p>
<div class="section" id="obs_04_0083__section746787"><h4 class="sectiontitle">Versioning</h4><p class="MsoNormal" id="obs_04_0083__p63961276">By default, the GET operation returns the current version of an object. If the current version of the object is a delete marker, OBS returns a code meaning that the object does not exist. To obtain an object of a specified version, the <strong id="obs_04_0083__b158935119499">versionId</strong> parameter can be used to specify the desired version.</p>
</div>
<div class="section" id="obs_04_0083__section6721083"><h4 class="sectiontitle">Cold Objects</h4><p class="MsoNormal" id="obs_04_0083__p13480849">If the object you want to download is in the Cold storage class, ensure that this object has been restored before you download it. The response varies depending on the object's restore state. If an object has been restored, the <strong id="obs_04_0083__b1207465602144715">x-obs-restore</strong> header (indicating the expiry date of the object) is returned when the object is successfully downloaded. If you send a request to download Cold objects that are not restored or are being restored, a <strong id="obs_04_0083__b1231441133144728">403 Forbidden</strong> error will be returned.</p>
</div>
@ -100,7 +100,7 @@ Range:bytes=byte_range<span class="w"> </span>
</tr>
<tr id="obs_04_0083__row3210135204916"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p021018529498">attname</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p1612114765018">Rewrites the <strong id="obs_04_0083__b1537970484">Content-Disposition</strong> header in the response.</p>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p1612114765018">Rewrites the <strong id="obs_04_0083__b2081417106">Content-Disposition</strong> header in the response.</p>
<p id="obs_04_0083__p1612197195017">Type: string</p>
<p id="obs_04_0083__p20472268503">Example:</p>
<p id="obs_04_0083__p11253017500">attname=name1</p>
@ -227,7 +227,7 @@ Last-Modified:<span class="w"> </span>time<span class="w"> </span>
</div>
</div>
<div class="section" id="obs_04_0083__section56977142"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0083__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_0083__p40541517">In addition to the common response headers, the message headers listed in <a href="#obs_04_0083__table40465940">Table 3</a> may be used.</p>
<p class="MsoNormal" id="obs_04_0083__p40541517">In addition to the common response headers, the headers listed in <a href="#obs_04_0083__table40465940">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0083__table40465940"></a><a name="table40465940"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0083__table40465940" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0083__row62215211"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.10.4.2.3.1.1"><p id="obs_04_0083__p6267364">Header</p>
</th>
@ -249,7 +249,7 @@ Last-Modified:<span class="w"> </span>time<span class="w"> </span>
</tr>
<tr id="obs_04_0083__row20962859"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p20270044">x-obs-delete-marker</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p31260906">Indicates whether an object is a deletion marker. If the object is not marked as deleted, the response does not contain this header.</p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p31260906">Indicates whether an object is a delete marker. If the object is not marked as deleted, the response does not contain this header.</p>
<p id="obs_04_0083__p12912703">Type: boolean</p>
<p id="obs_04_0083__p49105468">Value options: <strong id="obs_04_0083__b20420112232417">true</strong>, <strong id="obs_04_0083__b842012202416">false</strong></p>
<p id="obs_04_0083__p39296035">The default value is <strong id="obs_04_0083__b84235270618335">false</strong>.</p>
@ -258,7 +258,7 @@ Last-Modified:<span class="w"> </span>time<span class="w"> </span>
<tr id="obs_04_0083__row18119995"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p58433486">x-obs-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p35491934">Object version ID. If the object has no version number specified, the response does not contain this header.</p>
<p id="obs_04_0083__p50991952">Valid value: character string</p>
<p id="obs_04_0083__p50991952">Valid value: string</p>
<p id="obs_04_0083__p56274386">Default value: none</p>
</td>
</tr>
@ -271,7 +271,7 @@ Last-Modified:<span class="w"> </span>time<span class="w"> </span>
</tr>
<tr id="obs_04_0083__row19767344"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p57650994">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p39218953">Indicates the master key ID. This header is included in a response if SSE-KMS is used. </p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p39218953">Indicates the master key ID. This header is included in a response when SSE-KMS is used.</p>
<p id="obs_04_0083__p135275133514">Type: string</p>
<p id="obs_04_0083__p672833104612">Format: <em id="obs_04_0083__i107663221269">regionID</em><strong id="obs_04_0083__b3766192214619">:</strong><em id="obs_04_0083__i1376614221864">domainID</em><strong id="obs_04_0083__b19767322269">:key/</strong><em id="obs_04_0083__i1767202220619">key_id</em></p>
<p id="obs_04_0083__p1435213517358"><em id="obs_04_0083__i13695247526">regionID</em> indicates the ID of the region where the key belongs. <em id="obs_04_0083__i196961471522">domainID</em> indicates the ID of the tenant where the key belongs. <em id="obs_04_0083__i16961347226">key_id</em> indicates the key ID used in this encryption.</p>

4
docs/obs/api-ref/obs_04_0084.html
View File

@ -118,7 +118,7 @@ Last-Modified:<span class="w"> </span>time
</div>
</div>
<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 message headers listed in <a href="#obs_04_0084__table53333691145218">Table 3</a> may be used.</p>
<p class="msonormal" id="obs_04_0084__p56384785">In addition to the common response headers, the headers listed in <a href="#obs_04_0084__table53333691145218">Table 3</a> may be used.</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>
@ -185,7 +185,7 @@ Last-Modified:<span class="w"> </span>time
</tr>
<tr id="obs_04_0084__row23428385"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.8.4.2.3.1.1 "><p id="obs_04_0084__p18651037">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0084__p34339025">Indicates the master key ID. This header is included in a response if SSE-KMS is used. </p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0084__p34339025">Indicates the master key ID. This header is included in a response when SSE-KMS is used.</p>
<p id="obs_04_0084__p1162761803510">Type: string</p>
<p id="obs_04_0084__p5627111814351">Format: <em id="obs_04_0084__i14782182611616">regionID</em><strong id="obs_04_0084__b20788112616611">:</strong><em id="obs_04_0084__i8789142616611">domainID</em><strong id="obs_04_0084__b27891826968">:key/</strong><em id="obs_04_0084__i778952618619">key_id</em> <em id="obs_04_0084__i863125510219">regionID</em> indicates the ID of the region where the key belongs. <em id="obs_04_0084__i36318551022">domainID</em> indicates the ID of the tenant where the key belongs. <em id="obs_04_0084__i163155520215">key_id</em> indicates the key ID used in this encryption.</p>
<p id="obs_04_0084__p4699111445312">Example: <strong id="obs_04_0084__b4908449125914">x-obs-server-side-encryption-kms-key-id:</strong><strong id="obs_04_0084__b8910144918597"><em id="obs_04_0084__i39092490599">region</em></strong><strong id="obs_04_0084__b6910204955919">:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</strong></p>

31
docs/obs/api-ref/obs_04_0085.html
View File

@ -3,8 +3,9 @@
<h1 class="topictitle1">Deleting an Object</h1>
<div id="body54050549"><div class="section" id="obs_04_0085__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0085__p32607795">You can perform this operation to delete an object. If you try to delete an object that does not exist, OBS will return a success message.</p>
</div>
<div class="section" id="obs_04_0085__section25034704"><h4 class="sectiontitle">Versioning</h4><p class="msonormal" id="obs_04_0085__p16018311">When versioning is enabled for a bucket, a deletion marker with a unique version number is generated when an object is deleted without specifying the version. However, the object is not actually deleted. If versioning is suspended for a bucket and no version is specified when you delete an object, the object whose version number is <strong id="obs_04_0085__b789805613311">null</strong> is deleted, and a deletion marker with version number <strong id="obs_04_0085__b10366999342">null</strong> is generated.</p>
<div class="section" id="obs_04_0085__section25034704"><h4 class="sectiontitle">Versioning</h4><p class="msonormal" id="obs_04_0085__p16018311">When versioning is enabled for a bucket, a delete request that does not specify a version ID cannot permanently delete the object. Instead, OBS creates a delete marker with a unique version ID. When versioning is suspended for a bucket, a delete request that does not specify a version ID deletes the object whose version ID is <strong id="obs_04_0085__b789805613311">null</strong> and creates a delete marker with a version ID of <strong id="obs_04_0085__b10366999342">null</strong>.</p>
<p class="msonormal" id="obs_04_0085__p9947077">To delete an object of a specified version, the <strong id="obs_04_0085__b1866401892947">versionId</strong> parameter can be used to specify the desired version.</p>
<p id="obs_04_0085__p16753145114810">To restore a deleted object, you need to specify the delete marker version in the <strong id="obs_04_0085__b1310275220388">versionId</strong> parameter when deleting it.</p>
</div>
<div class="section" id="obs_04_0085__section10345237111916"><h4 class="sectiontitle">WORM</h4><p id="obs_04_0085__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>
@ -74,7 +75,7 @@ Date:<span class="w"> </span>date
<tr id="obs_04_0085__row8408337"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0085__p9986676">x-obs-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.9.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__p32529595">Valid value: string</p>
<p id="obs_04_0085__p24330907">Default value: none</p>
</td>
</tr>
@ -114,6 +115,32 @@ Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </sp
</div>
</div>
<div class="section" id="obs_04_0085__section143102517493"><h4 class="sectiontitle">Sample Request: Specifying <strong id="obs_04_0085__b2376631182913">versionId</strong> to Delete a Specific Object Version</h4><pre class="screen" id="obs_04_0085__screen1613013615505">DELETE /object2?versionId=G001118A49821905FFFFD28739D419DA HTTP/1.1
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:iqSPeUBl66PwXDApxjRKk6hlcN4=
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0085__i6119145455715">region</em>.example.com
Date: WED, 01 Jul 2015 02:37:22 GMT
Content-Type: application/xml</pre>
</div>
<div class="section" id="obs_04_0085__section1989514810501"><h4 class="sectiontitle">Sample Response: Specifying <strong id="obs_04_0085__b761115118297">versionId</strong> to Delete a Specific Object Version</h4><pre class="screen" id="obs_04_0085__screen935555815017">x-obs-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCS3WJqDiMsxgGHKQrlqST9veFKpDgE50
x-obs-request-id: 0000018A4997390DD306CCDA0DEC814F
Server: OBS
Date: WED, 01 Jul 2015 02:37:22 GMT
x-obs-version-id: G001118A49821905FFFFD28739D419DA</pre>
</div>
<div class="section" id="obs_04_0085__section527043710512"><h4 class="sectiontitle">Sample Request: Specifying <strong id="obs_04_0085__b44641416113018">versionId</strong> to Delete a Delete Marker</h4><pre class="screen" id="obs_04_0085__screen11249164819517">DELETE /object2?versionId=G001118A6456208AFFFFD24829FCF614
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:iqSPeUBl66PwXDApxjRKk6hlcN4=
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0085__i132850401903">region</em>.example.com
Date: WED, 01 Jul 2015 02:37:22 GMT
Content-Type: application/xml</pre>
</div>
<div class="section" id="obs_04_0085__section12555180115210"><h4 class="sectiontitle">Sample Response: Specifying <strong id="obs_04_0085__b6790182643012">versionId</strong> to Delete a Delete Marker</h4><pre class="screen" id="obs_04_0085__screen697512855312">x-obs-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCS3WJqDiMsxgGHKQrlqST9veFKpDgE50
x-obs-request-id: 0000018A4997390DD306CCDA0DEC814F
Server: OBS
Date: WED, 01 Jul 2015 02:37:22 GMT
x-obs-version-id: G001118A6456208AFFFFD24829FCF614</pre>
</div>
</div>
<div>
<div class="familylinks">

10
docs/obs/api-ref/obs_04_0086.html
View File

@ -84,7 +84,7 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0086__row65901021"><td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0086__p36382490">Key</p>
</td>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0086__p61300596">Key of the object to be deleted </p>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0086__p61300596">Key of the object to be deleted. </p>
<p id="obs_04_0086__p14834455">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0086__p60740198">Yes</p>
@ -193,15 +193,15 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0086__row35919634"><td class="cellrowborder" valign="top" width="28.4%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0086__p23809262">DeleteMarker</p>
</td>
<td class="cellrowborder" valign="top" width="71.6%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0086__p49502103">If this element is specified, <strong id="obs_04_0086__b40617610">true</strong> will be returned when you create or delete a deletion marker in the requested bucket with versioning enabled.</p>
<td class="cellrowborder" valign="top" width="71.6%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0086__p49502103">If this element is specified, <strong id="obs_04_0086__b40617610">true</strong> will be returned when you create or delete a delete marker in a bucket with versioning enabled.</p>
<p id="obs_04_0086__p42865748">Type: boolean</p>
</td>
</tr>
<tr id="obs_04_0086__row43508590"><td class="cellrowborder" valign="top" width="28.4%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0086__p34534892">DeleteMarkerVersionId</p>
</td>
<td class="cellrowborder" valign="top" width="71.6%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0086__p45862871">Indicates the version ID of the deletion marker deleted or created by the request.</p>
<p id="obs_04_0086__p10112656">If the request either creates or deletes a deletion marker, OBS returns this element in response with the version ID of the deletion marker. This element will be returned in either of the following cases:</p>
<ul id="obs_04_0086__ul23905046"><li id="obs_04_0086__li13818825">You send a versionless request, that is, you specify only the object name but not the version ID. In this case, the UDS creates a deletion marker and returns its version ID in the response.</li><li id="obs_04_0086__li57260562">You send a request with versions, that is, you specify object keys and version IDs that identify deletion markers. In this case, OBS deletes the deletion marker and returns its version ID in the response.</li></ul>
<td class="cellrowborder" valign="top" width="71.6%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0086__p45862871">Indicates the version ID of the delete marker deleted or created by the request.</p>
<p id="obs_04_0086__p10112656">If you create or delete a delete marker in a bucket with versioning enabled, OBS returns this element in the response. This element will be returned in either of the following cases:</p>
<ul id="obs_04_0086__ul23905046"><li id="obs_04_0086__li13818825">You send a request that has only the object name but not the version ID specified. In this case, OBS creates a delete marker and returns its version ID in the response.</li><li id="obs_04_0086__li57260562">You send a request that has both the object key and version ID (that identifies a delete marker) specified. In this case, OBS deletes the delete marker and returns its version ID in the response.</li></ul>
<p id="obs_04_0086__p45583010">Type: boolean</p>
</td>
</tr>

2
docs/obs/api-ref/obs_04_0089.html
View File

@ -163,7 +163,7 @@ Content-Type:<span class="w"> </span>application/xml
</div>
</div>
<div class="section" id="obs_04_0089__section47403265"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0089__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_0089__p44587388">In addition to the common response headers, the message headers listed in <a href="#obs_04_0089__table21765641102739">Table 3</a> may be used.</p>
<p id="obs_04_0089__p44587388">In addition to the common response headers, the headers listed in <a href="#obs_04_0089__table21765641102739">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0089__table21765641102739"></a><a name="table21765641102739"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0089__table21765641102739" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0089__row52223563"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0089__p2250249">Header</p>
</th>

2
docs/obs/api-ref/obs_04_0090.html
View File

@ -86,7 +86,7 @@ Content-Type:<span class="w"> </span>application/xml<span class="w"> </span>
</div>
</div>
<div class="section" id="obs_04_0090__section53655969"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0090__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_0090__p47423499">In addition to the common response headers, the message headers listed in <a href="#obs_04_0090__table995015721520">Table 2</a> may be used.</p>
<p id="obs_04_0090__p47423499">In addition to the common response headers, the headers listed in <a href="#obs_04_0090__table995015721520">Table 2</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0090__table995015721520"></a><a name="table995015721520"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0090__table995015721520" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response header</caption><thead align="left"><tr id="obs_04_0090__row43542352"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0090__p37269637">Header</p>
</th>

2
docs/obs/api-ref/obs_04_0091.html
View File

@ -165,7 +165,7 @@ Last-Modified:<span class="w"> </span>time
</div>
</div>
<div class="section" id="obs_04_0091__section66401511596"><h4 class="sectiontitle">Response Headers</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0091__table165543915196" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0091__row35547917199"><th align="left" class="cellrowborder" valign="top" width="23.46%" id="mcps1.3.7.2.2.3.1.1"><p id="obs_04_0091__p105541892192">Header</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0091__table165543915196" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0091__row35547917199"><th align="left" class="cellrowborder" valign="top" width="23.46%" id="mcps1.3.7.2.2.3.1.1"><p id="obs_04_0091__p105541892192">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="76.53999999999999%" id="mcps1.3.7.2.2.3.1.2"><p id="obs_04_0091__p175548951915">Description</p>
</th>

Some files were not shown because too many files have changed in this diff Show More