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 2023-10-16 12:27:49 +00:00 committed by zuul
parent 2cbc3d7335
commit d5b1108742
46 changed files with 1549 additions and 795 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

@ -8,7 +8,14 @@
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0000__row1932693413305"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p1932610349304">2023-06-20</p>
<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>
</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>
<ul id="obs_04_0000__ul172161913136"><li id="obs_04_0000__li1621611116138">Added WORM-related APIs: <a href="obs_04_0167.html">Configuring a Default WORM Policy for a Bucket</a>, <a href="obs_04_0168.html">Obtaining the Default WORM Policy of a Bucket</a>, and <a href="obs_04_0166.html">Configuring WORM Retention for an Object</a>.</li></ul>
</td>
</tr>
<tr id="obs_04_0000__row1932693413305"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p1932610349304">2023-06-20</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p7991846123020">This is the seventh official release.</p>
<p id="obs_04_0000__p169920467309">This issue incorporates the following changes:</p>

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

@ -169,7 +169,7 @@
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p1133840184">Obtains the bucket space quota.</p>
</td>
</tr>
<tr id="obs_04_0005__row93371813141816"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p47704802516"><a href="obs_04_0054.html">Querying Information About Used Space in a Bucket</a></p>
<tr id="obs_04_0005__row93371813141816"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p47704802516"><a href="obs_04_0054.html">Obtaining Storage Information 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__p1833144131810">Obtains the number of objects in a bucket and the space occupied by the objects.</p>
</td>
@ -367,12 +367,12 @@
<td class="cellrowborder" valign="top" width="59.35%" headers="mcps1.3.5.2.2.3.1.2 "><p id="obs_04_0005__p172967323016">Initiates a multipart upload task, and obtains the globally unique multipart upload task ID for subsequent operations, such as uploading, merging, and listing parts.</p>
</td>
</tr>
<tr id="obs_04_0005__row31464766"><td class="cellrowborder" valign="top" width="40.65%" headers="mcps1.3.5.2.2.3.1.1 "><p id="obs_04_0005__p13467047"><a href="obs_04_0099.html">Multipart Upload</a></p>
<tr id="obs_04_0005__row31464766"><td class="cellrowborder" valign="top" width="40.65%" headers="mcps1.3.5.2.2.3.1.1 "><p id="obs_04_0005__p13467047"><a href="obs_04_0099.html">Uploading Parts</a></p>
</td>
<td class="cellrowborder" valign="top" width="59.35%" headers="mcps1.3.5.2.2.3.1.2 "><p id="obs_04_0005__p142960311301">Uploads parts for a specific multipart task.</p>
</td>
</tr>
<tr id="obs_04_0005__row54094565"><td class="cellrowborder" valign="top" width="40.65%" headers="mcps1.3.5.2.2.3.1.1 "><p id="obs_04_0005__p42774091"><a href="obs_04_0100.html">Uploading a Part of an Object - Copy</a></p>
<tr id="obs_04_0005__row54094565"><td class="cellrowborder" valign="top" width="40.65%" headers="mcps1.3.5.2.2.3.1.1 "><p id="obs_04_0005__p42774091"><a href="obs_04_0100.html">Copying Parts</a></p>
</td>
<td class="cellrowborder" valign="top" width="59.35%" headers="mcps1.3.5.2.2.3.1.2 "><p id="obs_04_0005__p1056291419425">Copies an object or a part of the object as a part of a multipart task.</p>
</td>

4
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, 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, 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>
@ -526,7 +526,7 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<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>
<span class="w"> </span><span class="s">&quot;response-expires&quot;</span><span class="p">,</span><span class="s">&quot;restore&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storageClass&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storagePolicy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storageinfo&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;tagging&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;torrent&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;truncate&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;uploadId&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;uploads&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versionId&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versioning&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versions&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;website&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;x-obs-security-token&quot;</span><span class="p">));</span>
<span class="w"> </span><span class="s">&quot;x-obs-security-token&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;object-lock&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;retention&quot;</span><span class="p">));</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">ak</span><span class="p">;</span>
<span class="w"> </span>

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

@ -105,7 +105,7 @@ Host: bucketname.obs.<em id="obs_04_0011__i41621102549">region</em>.example.com<
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.17.2.3.1.2 "><p id="obs_04_0011__p29406249">Indicates the OBS resource specified by an HTTP request. This parameter is constructed as follows:</p>
<p id="obs_04_0011__p63329656">&lt;Bucket name + Object name&gt; + [Subresource 1] + [Subresource 2] + ...</p>
<ol id="obs_04_0011__ol135483613475"><li id="obs_04_0011__li1739510379234">Bucket name and object name, for example, <strong id="obs_04_0011__b126351417152615">/<em id="obs_04_0011__i863461782611">bucket</em>/<em id="obs_04_0011__i9634191720269">object</em></strong>. If no object name is specified, for example, <strong id="obs_04_0011__b176365177263">/<em id="obs_04_0011__i96351717182611">bucket</em>/</strong>, the entire bucket is listed. If no bucket name is specified either, the value of this field is <strong id="obs_04_0011__b12636171716265">/</strong>.</li><li id="obs_04_0011__li94301458125415">If a subresource (such as <strong id="obs_04_0011__b19735101091020">?acl</strong> and <strong id="obs_04_0011__b67471610161010">?logging</strong>) exists, the subresource must be added.<p id="obs_04_0011__p167755915411">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, and x-obs-security-token.</p>
<ol id="obs_04_0011__ol135483613475"><li id="obs_04_0011__li1739510379234">Bucket name and object name, for example, <strong id="obs_04_0011__b126351417152615">/<em id="obs_04_0011__i863461782611">bucket</em>/<em id="obs_04_0011__i9634191720269">object</em></strong>. If no object name is specified, for example, <strong id="obs_04_0011__b176365177263">/<em id="obs_04_0011__i96351717182611">bucket</em>/</strong>, the entire bucket is listed. If no bucket name is specified either, the value of this field is <strong id="obs_04_0011__b12636171716265">/</strong>.</li><li id="obs_04_0011__li94301458125415">If a subresource (such as <strong id="obs_04_0011__b19735101091020">?acl</strong> and <strong id="obs_04_0011__b67471610161010">?logging</strong>) exists, the subresource must be added.<p id="obs_04_0011__p167755915411">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>
</li><li id="obs_04_0011__li20542104114716">If there are multiple subresources, sort them in the alphabetical order from a to z, and use <strong id="obs_04_0011__b217162384717">&amp;</strong> to combine the subresources.</li></ol>
<div class="note" id="obs_04_0011__note196756717914"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_04_0011__ul116221356133916"><li id="obs_04_0011__li156221356133912">A subresource is unique. Do not add subresources with the same keyword (for example, <strong id="obs_04_0011__b66581225164712">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_0011__li1321451571811">Using the <strong id="obs_04_0011__b1155512711478">GetObject</strong> API as an example, assume there is a bucket named <strong id="obs_04_0011__b155564274479">bucket-test</strong> and an object named <strong id="obs_04_0011__b1755682764710">object-test</strong> in the bucket, and the object version is <strong id="obs_04_0011__b355610273472">xxx</strong>. When obtaining the object, you need to rewrite Content-Type to <strong id="obs_04_0011__b05561327154712">text/plain</strong>. Then, the <strong id="obs_04_0011__b13556627144714">CanonicalizedResource</strong> calculated by the signature is <strong id="obs_04_0011__b205561627194720">/bucket-test/object-test?response-content-type=text/plain&amp;versionId=xxx</strong>.</li></ul>
</div></div>
@ -474,7 +474,7 @@ Host: bucketname.obs.<em id="obs_04_0011__i41621102549">region</em>.example.com<
<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>
<span class="w"> </span><span class="s">&quot;response-expires&quot;</span><span class="p">,</span><span class="s">&quot;restore&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storageClass&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storagePolicy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storageinfo&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;tagging&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;torrent&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;truncate&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;uploadId&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;uploads&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versionId&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versioning&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versions&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;website&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;x-obs-security-token&quot;</span><span class="p">));</span>
<span class="w"> </span><span class="s">&quot;x-obs-security-token&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;object-lock&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;retention&quot;</span><span class="p">));</span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">ak</span><span class="p">;</span>

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

File diff suppressed because it is too large Load Diff

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

@ -57,7 +57,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0022__row4586517"><td class="cellrowborder" valign="top" width="13.130000000000003%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0022__p35963564">max-keys</p>
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0022__p27367592">Specifies the maximum number of objects returned (in alphabetical order) in the response. The value ranges from <strong id="obs_04_0022__b1949082165712">1</strong> to <strong id="obs_04_0022__b890313115710">1000</strong>. If there are over 1,000 objects, only 1,000 objects are returned by default.</p>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0022__p27367592">Specifies the maximum number (from <strong id="obs_04_0022__b16432172375911">1</strong> to <strong id="obs_04_0022__b54321323125915">1000</strong>) of objects returned (in alphabetical order) in the response. If the value is beyond this range, only 1,000 objects are returned by default.</p>
<p id="obs_04_0022__p44981744">Type: integer</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0022__p19642622">No</p>
@ -117,7 +117,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0022__section26795963"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0022__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_0022__section39837076"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0022__p31592957">This response contains the XML list of buckets owned by the user. <a href="#obs_04_0022__table17753706155228">Table 2</a> describes the elements.</p>
<div class="section" id="obs_04_0022__section39837076"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0022__p31592957">This response lists objects in XML format. Specific elements are described in <a href="#obs_04_0022__table17753706155228">Table 2</a>.</p>
<div class="tablenoborder"><a name="obs_04_0022__table17753706155228"></a><a name="table17753706155228"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0022__table17753706155228" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="obs_04_0022__row5816417"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.9.3.2.3.1.1"><p id="obs_04_0022__p1367796"><strong id="obs_04_0022__b17732133018472">Element</strong></p>
</th>
@ -154,7 +154,7 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0022__row4028061"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p57837514">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p54327039">128-bit MD5 digest of the Base64 code of an object. ETag is the unique identifier of the object content. It can be used to determine whether the object content is changed. For example, if the ETag value is <strong id="obs_04_0022__b6681248907">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0022__b96811489012">B</strong> when the object is downloaded, it indicates that the object content has been changed. The ETag value is a hash of the object. The ETag reflects changes to the object content, rather than the object metadata. An uploaded object or copied object has a unique ETag after being encrypted using MD5. (If the object is encrypted on the server side, the ETag value is not the MD5 digest of the object, but the unique identifier calculated through server-side encryption.)</p>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p54327039">Base64-encoded 128-bit MD5 digest of an object. ETag is the unique identifier of the object content. It can be used to determine whether the object content is changed. For example, if the ETag value is <strong id="obs_04_0022__b6681248907">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0022__b96811489012">B</strong> when the object is downloaded, it indicates that the object content has been changed. The ETag value is a hash of the object. The ETag reflects changes to the object content, rather than the object metadata. An uploaded object or copied object has a unique ETag after being encrypted using MD5. (If the object is encrypted on the server side, the ETag value is not the MD5 digest of the object, but the unique identifier calculated through server-side encryption.)</p>
<p id="obs_04_0022__p19181309">Type: string</p>
<p id="obs_04_0022__p38414053">Ancestor: ListBucketResult.Contents</p>
</td>
@ -373,7 +373,7 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0022__row17685361"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p23228146">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p2431675">128-bit MD5 digest of the Base64 code of an object. ETag is the unique identifier of the object content. It can be used to determine whether the object content is changed. The actual ETag is the hash value of the object. For example, if the ETag value is <strong id="obs_04_0022__b101301544008">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0022__b51301044208">B</strong> when the object is downloaded, it indicates that the object content has been changed. The ETag reflects changes to the object content, rather than the object metadata. An uploaded object or copied object has a unique ETag after being encrypted using MD5.</p>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p2431675">Base64-encoded 128-bit MD5 digest of an object. ETag is the unique identifier of the object content. It can be used to determine whether the object content is changed. The actual ETag is the hash value of the object. For example, if the ETag value is <strong id="obs_04_0022__b101301544008">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0022__b51301044208">B</strong> when the object is downloaded, it indicates that the object content has been changed. The ETag reflects changes to the object content, rather than the object metadata. An uploaded object or copied object has a unique ETag after being encrypted using MD5.</p>
<p id="obs_04_0022__p21885083">Type: string</p>
<p id="obs_04_0022__p62748021">Ancestor: ListVersionsResult.Version</p>
</td>
@ -441,8 +441,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0022__section22989369"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0022__p7577527">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_0022__section4967514913"><h4 class="sectiontitle">Sample Request 1</h4><p id="obs_04_0022__p43971619142018"><strong id="obs_04_0022__b164528276314">List all objects.</strong></p>
<div class="codecoloring" codetype="Xml" id="obs_04_0022__screen26315321216"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0022__section4967514913"><h4 class="sectiontitle">Sample Request: Listing All Objects</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen26315321216"><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>
@ -457,7 +456,7 @@ Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEB
</div>
</div>
<div class="section" id="obs_04_0022__section61601145011"><h4 class="sectiontitle">Sample Response 1</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen1022615115320"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0022__section61601145011"><h4 class="sectiontitle">Sample Response: Listing All Objects</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen1022615115320"><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>
@ -514,8 +513,7 @@ Content-Length:<span class="w"> </span>586
</div>
</div>
<div class="section" id="obs_04_0022__section535111413214"><h4 class="sectiontitle">Sample Request 2</h4><p id="obs_04_0022__p1728013302010"><strong id="obs_04_0022__b1014495213312">Filter objects</strong>.</p>
<p id="obs_04_0022__p1693585343617">Assume that you have a bucket <strong id="obs_04_0022__b7597532384">examplebucket</strong> that contains objects <strong id="obs_04_0022__b89541836114117">newfile</strong>, <strong id="obs_04_0022__b658374724117">obj001</strong>, <strong id="obs_04_0022__b0336205244115">obj002</strong>, and <strong id="obs_04_0022__b04067234214">obs001</strong>. If you want to list only object <strong id="obs_04_0022__b136005343811">obj002</strong>, the request message is as follows:</p>
<div class="section" id="obs_04_0022__section535111413214"><h4 class="sectiontitle">Sample Request: Listing Some Objects</h4><p id="obs_04_0022__p1693585343617">Assume that you have a bucket <strong id="obs_04_0022__b7597532384">examplebucket</strong> that contains objects <strong id="obs_04_0022__b89541836114117">newfile</strong>, <strong id="obs_04_0022__b658374724117">obj001</strong>, <strong id="obs_04_0022__b0336205244115">obj002</strong>, and <strong id="obs_04_0022__b04067234214">obs001</strong>. If you want to list only object <strong id="obs_04_0022__b136005343811">obj002</strong>, the request message is as follows:</p>
<pre class="screen" id="obs_04_0022__screen11516231145">GET /?marker=obj001&amp;prefix=obj HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0022__i14163125618202">region</em>.example.com
@ -523,7 +521,7 @@ Accept: */*
Date: WED, 01 Jul 2015 02:28:25 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:KiyoYze4pmRNPYfmlXBfRTVxt8c=</pre>
</div>
<div class="section" id="obs_04_0022__section76081155815"><h4 class="sectiontitle">Sample Response 2</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen1041419535420"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0022__section76081155815"><h4 class="sectiontitle">Sample Response: Listing Some Objects</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen1041419535420"><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>
@ -580,8 +578,7 @@ Content-Length:<span class="w"> </span>707
</div>
</div>
<div class="section" id="obs_04_0022__section10211101623018"><h4 class="sectiontitle">Sample Request 3</h4><p id="obs_04_0022__p35751942102013"><strong id="obs_04_0022__b111162713712">Versioning</strong></p>
<div class="codecoloring" codetype="Xml" id="obs_04_0022__screen8484163863919"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0022__section10211101623018"><h4 class="sectiontitle">Sample Request: Listing Object Versions</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen8484163863919"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
@ -596,7 +593,7 @@ Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEB
</div>
</div>
<div class="section" id="obs_04_0022__section16842103705414"><h4 class="sectiontitle">Sample Response 3</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen649271117557"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0022__section16842103705414"><h4 class="sectiontitle">Sample Response: Listing Object Versions</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen649271117557"><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>

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

@ -131,8 +131,7 @@ Date:<span class="w"> </span>date
</div>
<div class="section" id="obs_04_0023__section45879330"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0023__p642611">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_0023__section14482163815396"><h4 class="sectiontitle">Sample Request 1</h4><p id="obs_04_0023__p17730519185215"><strong id="obs_04_0023__b93802356427">No header field for obtaining CORS configuration is carried</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0023__screen8484163863919"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0023__section14482163815396"><h4 class="sectiontitle">Sample Request: Getting CORS Configuration (with No Headers Specified)</h4><div class="codecoloring" codetype="Xml" id="obs_04_0023__screen8484163863919"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
@ -147,7 +146,7 @@ Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEB
</div>
</div>
<div class="section" id="obs_04_0023__section76081155815"><h4 class="sectiontitle">Sample Response 1</h4><div class="codecoloring" codetype="Xml" id="obs_04_0023__screen8485113814"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0023__section76081155815"><h4 class="sectiontitle">Sample Response: Getting CORS Configuration (with No Headers Specified)</h4><div class="codecoloring" codetype="Xml" id="obs_04_0023__screen8485113814"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
@ -170,8 +169,7 @@ Content-Length:<span class="w"> </span>0
</div>
</div>
<div class="section" id="obs_04_0023__section061751194812"><h4 class="sectiontitle">Sample Request 2</h4><p id="obs_04_0023__p1056113515531"><strong id="obs_04_0023__b1151664812434">Obtain bucket metadata and CORS configuration information after CORS is configured for the bucket</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0023__screen1668910265501"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0023__section061751194812"><h4 class="sectiontitle">Sample Request: Getting Bucket Metadata and CORS Configuration</h4><div class="codecoloring" codetype="Xml" id="obs_04_0023__screen1668910265501"><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>
@ -190,7 +188,7 @@ Access-Control-Request-Headers:AllowedHeader_1
</div>
</div>
<div class="section" id="obs_04_0023__section1985922615524"><h4 class="sectiontitle">Sample Response 2</h4><div class="codecoloring" codetype="Xml" id="obs_04_0023__screen1234312101531"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0023__section1985922615524"><h4 class="sectiontitle">Sample Response: Getting Bucket Metadata and CORS Configuration</h4><div class="codecoloring" codetype="Xml" id="obs_04_0023__screen1234312101531"><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>

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

@ -52,7 +52,7 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0053.html">Querying Bucket Storage Quota</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0054.html">Querying Information About Used Space in a Bucket</a></strong><br>
<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_0059.html">Configuring a Custom Domain Name for a Bucket</a></strong><br>
</li>
@ -70,6 +70,10 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0069.html">Obtaining the Requester-Pays Configuration Information of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0167.html">Configuring a Default WORM Policy for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0168.html">Obtaining the Default WORM Policy of a Bucket</a></strong><br>
</li>
</ul>
<div class="familylinks">

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

@ -220,7 +220,7 @@ Content-MD5:<span class="w"> </span>MD5
<p id="obs_04_0034__p20305823">Children node: NoncurrentDays, StorageClass</p>
<p id="obs_04_0034__p48534684">Ancestor node: Rule</p>
</td>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p38995332">Required if the <strong id="obs_04_0034__b1817212016">Transition</strong>, <strong id="obs_04_0034__b522924675">Expiration</strong>, <strong id="obs_04_0034__b187701445812">AbortIncompleteMultipartUpload</strong>, or <strong id="obs_04_0034__b653442248">NoncurrentVersionExpiration</strong> element is absent.</p>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p38995332">Required if the <strong id="obs_04_0034__b1385673702">Transition</strong>, <strong id="obs_04_0034__b539982119">Expiration</strong>, <strong id="obs_04_0034__b187701445812">AbortIncompleteMultipartUpload</strong>, or <strong id="obs_04_0034__b1830737814">NoncurrentVersionExpiration</strong> element is absent.</p>
</td>
</tr>
<tr id="obs_04_0034__row15413673"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0034__p40548035">NoncurrentVersionExpiration</p>

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

@ -305,8 +305,7 @@ Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEB
<span class="normal">37</span>
<span class="normal">38</span>
<span class="normal">39</span>
<span class="normal">40</span>
<span class="normal">41</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>200<span class="w"> </span>OK
<span class="normal">40</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>200<span class="w"> </span>OK
Server:<span class="w"> </span>OBS
x-obs-request-id:<span class="w"> </span>BF260000016436BA5684FF5A10370EDB
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSEMKZSIeboCA1eAukgYOOAd7oX3ZONn
@ -318,7 +317,6 @@ Content-Length:<span class="w"> </span>919
<span class="nt">&lt;LifecycleConfiguration&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Rule&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;ID&gt;</span>delete-2-days<span class="nt">&lt;/ID&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Prefix&gt;</span>test/<span class="nt">&lt;/Prefix&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Status&gt;</span>Enabled<span class="nt">&lt;/Status&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Expiration&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Days&gt;</span>2<span class="nt">&lt;/Days&gt;</span><span class="w"> </span>

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

@ -3,7 +3,7 @@
<h1 class="topictitle1">Configuring Versioning for a Bucket</h1>
<div id="body41213725"><div class="section" id="obs_04_0037__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0037__p14402739">This operation restores an object that is mistakenly overwritten or deleted. You can use versioning to save, query, and restore objects of different versions. Versioning allows you to easily recover lost data due to misoperations or program faults. Versioning can also be used for retaining and archiving data.</p>
<p class="msonormal" id="obs_04_0037__p19419185714345">By default, versioning is disabled for a bucket.</p>
<p class="msonormal" id="obs_04_0037__p62515791"></p>
<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>

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

@ -2,7 +2,7 @@
<h1 class="topictitle1">Configuring Bucket Storage Quota</h1>
<div id="body23313325"><div class="section" id="obs_04_0052__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0052__p9425979">The bucket storage quota must be a positive integer in the unit of byte. The maximum storage quota is 2<sup id="obs_04_0052__sup9937516203">63</sup> – 1 bytes. The default bucket storage quota is <strong id="obs_04_0052__b1044613415218">0</strong>, indicating that the bucket storage quota is not limited.</p>
<div class="note" id="obs_04_0052__note4648161119316"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ol id="obs_04_0052__ol1321716570337"><li id="obs_04_0052__li4981114348">For a bucket that has a specified storage quota, you can change the quota to <strong id="obs_04_0052__b1442801115154">0</strong> to cancel the quota limitation.</li><li id="obs_04_0052__li1721825710336">The bucket storage quota verification depends on how much space is used in the bucket. However, the used storage space is measured at the background. Therefore, bucket storage quotas may not take effect immediately, and delay is expected. The used storage space in a bucket may exceed the bucket storage quota, or the used storage space may remain unchanged after data is deleted from the bucket.</li><li id="obs_04_0052__li2645943203614">For details about the API for querying used storage space, see <a href="obs_04_0054.html">Querying Information About Used Space in a Bucket</a>.</li><li id="obs_04_0052__li2923356183715">If the used storage space in a bucket reaches the upper limit of the bucket storage quota, object upload will fail and the HTTP status code 403 Forbidden will be returned, indicating <strong id="obs_04_0052__b17583163752310">InsufficientStorageSpace</strong>. In this case, you can increase the quota, cancel the quota limitation (by changing the quota to <strong id="obs_04_0052__b15783254162411">0</strong>), or delete unwanted objects from the bucket.</li></ol>
<div class="note" id="obs_04_0052__note4648161119316"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ol id="obs_04_0052__ol1321716570337"><li id="obs_04_0052__li4981114348">For a bucket that has a specified storage quota, you can change the quota to <strong id="obs_04_0052__b1442801115154">0</strong> to cancel the quota limitation.</li><li id="obs_04_0052__li1721825710336">The bucket storage quota verification depends on how much space is used in the bucket. However, the used storage space is measured at the background. Therefore, bucket storage quotas may not take effect immediately, and delay is expected. The used storage space in a bucket may exceed the bucket storage quota, or the used storage space may remain unchanged after data is deleted from the bucket.</li><li id="obs_04_0052__li2645943203614">For details about the API for querying used storage space, see <a href="obs_04_0054.html">Obtaining Storage Information of a Bucket</a>.</li><li id="obs_04_0052__li2923356183715">If the used storage space in a bucket reaches the upper limit of the bucket storage quota, object upload will fail and the HTTP status code 403 Forbidden will be returned, indicating <strong id="obs_04_0052__b17583163752310">InsufficientStorageSpace</strong>. In this case, you can increase the quota, cancel the quota limitation (by changing the quota to <strong id="obs_04_0052__b15783254162411">0</strong>), or delete unwanted objects from the bucket.</li></ol>
</div></div>
</div>
<div class="section" id="obs_04_0052__section17724952"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0052__screen16871698"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>

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

@ -1,8 +1,8 @@
<a name="obs_04_0054"></a><a name="obs_04_0054"></a>
<h1 class="topictitle1">Querying Information About Used Space in a Bucket</h1>
<h1 class="topictitle1">Obtaining Storage Information of a Bucket</h1>
<div id="body39746667"><div class="section" id="obs_04_0054__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0054__p62746235">This operation queries the number of bucket objects and the space occupied by the objects. The size of the object space is a positive integer, measured by bytes.</p>
<div class="note" id="obs_04_0054__note18662132495916"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0054__p86624244591">The OBS bucket storage statistics is measured in the background, and the storage data is not updated in real time. Therefore, you are not advised to perform real-time verification on the storage information.</p>
<div class="note" id="obs_04_0054__note18662132495916"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0054__p86624244591">Because OBS bucket storage statistics are measured in the background, the storage information is not updated in real time. For this reason, you are advised not to perform real-time verification on the storage information.</p>
</div></div>
</div>
<div class="section" id="obs_04_0054__section27845207"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0054__screen65363495"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>

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

@ -20,8 +20,7 @@
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span></pre></div></td><td class="code"><div><pre><span></span>PUT<span class="w"> </span>/?encryption<span class="w"> </span>HTTP/1.1
<span class="normal">16</span></pre></div></td><td class="code"><div><pre><span></span>PUT<span class="w"> </span>/?encryption<span class="w"> </span>HTTP/1.1
User-Agent:<span class="w"> </span>curl/7.29.0
Host:<span class="w"> </span>bucketname.obs.region.example.com
Accept:<span class="w"> </span>*/*
@ -34,7 +33,6 @@ Content-Length:<span class="w"> </span>length
<span class="w"> </span><span class="nt">&lt;ApplyServerSideEncryptionByDefault&gt;</span>
<span class="w"> </span><span class="nt">&lt;SSEAlgorithm&gt;</span>kms<span class="nt">&lt;/SSEAlgorithm&gt;</span>
<span class="w"> </span><span class="nt">&lt;KMSMasterKeyID&gt;</span>kmskeyid-value<span class="nt">&lt;/KMSMasterKeyID&gt;</span>
<span class="w"> </span><span class="nt">&lt;ProjectID&gt;</span>projectid<span class="nt">&lt;/ProjectID&gt;</span>
<span class="w"> </span><span class="nt">&lt;/ApplyServerSideEncryptionByDefault&gt;</span>
<span class="w"> </span><span class="nt">&lt;/Rule&gt;</span>
<span class="nt">&lt;/ServerSideEncryptionConfiguration&gt;</span>
@ -103,7 +101,7 @@ Content-Length:<span class="w"> </span>length
<p id="obs_04_0062__p6679135313114">Valid value formats are as follows:</p>
<ol id="obs_04_0062__ol28871657184419"><li id="obs_04_0062__li388775774418"><em id="obs_04_0062__i513511341548">regionID:domainID (account ID)</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 resides.</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 the Domain ID and 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 inKMS.</li></ul>
<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 resides.</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 the Domain ID and 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>
</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>
@ -111,11 +109,13 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0062__row1629094482718"><td class="cellrowborder" valign="top" width="32.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0062__p22901644122713">ProjectID</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p19849131082815">ID of the project to which the KMS master key belongs in the SSE-KMS mode.</p>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p19849131082815">ID of the project where the KMS master key belongs when SSE-KMS is used. If the project is not the default one, you must use this parameter to specify the project ID.</p>
<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>
<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>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0062__p112907442274">No</p>
</td>

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

@ -113,9 +113,11 @@ Date:<span class="w"> </span>date<span class="w"> </span>
</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 to which the KMS master key belongs in the SSE-KMS mode.</p>
<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>
<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>
</tr>
</tbody>

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

@ -1,10 +1,9 @@
<a name="obs_04_0068"></a><a name="obs_04_0068"></a>
<h1 class="topictitle1">Configuring the Requester-Pays Function for a Bucket</h1>
<div id="body1583235745573"><div class="section" id="obs_04_0068__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0068__p42175431">The requester-pays configuration allows the requester to pay for data transfer and API calls associated with accessing the requested OBS resources, while the bucket owner only pays for data storage.</p>
<ul id="obs_04_0068__ul311492261017"><div class="note" id="obs_04_0068__note114929164720"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0068__p14488174014136">To access a requester-pays bucket, users (except the bucket owner and IAM users under the same account as the bucket owner) must add the <strong id="obs_04_0068__b32941482502">x-obs-request-payer: requester</strong> header in the request, indicating that the requester agrees to pay for the request and traffic. If this header is not included in the request, the authentication fails and error "403 Forbidden" is returned. If the response returned by the server includes the <strong id="obs_04_0068__b12397221285">x-obs-request-charged: requester</strong> header, the requester is billed for the request. This rule is applicable to all API requests against requester-pays buckets.</p>
<div id="body1583235745573"><div class="section" id="obs_04_0068__section5584184924715"><h4 class="sectiontitle">Functions</h4><div class="msonormal" id="obs_04_0068__p42175431">The requester-pays configuration allows the requester to pay for data transfer and API calls associated with accessing the requested OBS resources, while the bucket owner only pays for data storage.<div class="note" id="obs_04_0068__note114929164720"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0068__p14488174014136">To access a requester-pays bucket, users (except the bucket owner and IAM users under the same account as the bucket owner) must add the <strong id="obs_04_0068__b32941482502">x-obs-request-payer: requester</strong> header in the request, indicating that the requester agrees to pay for the request and traffic. If this header is not included in the request, the authentication fails and error "403 Forbidden" is returned. If the response returned by the server includes the <strong id="obs_04_0068__b12397221285">x-obs-request-charged: requester</strong> header, the requester is billed for the request. This rule is applicable to all API requests against requester-pays buckets.</p>
</div></div>
</li></ul>
</div>
</div>
<div class="section" id="obs_04_0068__section31076456"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0068__screen6103826"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>

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

@ -32,6 +32,8 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0094.html">Renaming an Object</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0166.html">Configuring WORM Retention for an Object</a></strong><br>
</li>
</ul>
<div class="familylinks">

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

@ -187,7 +187,7 @@ Last-Modified:<span class="w"> </span>time
</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>
<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__i14332542111316">regionID</em> is the ID of the region to which the key belongs. <em id="obs_04_0084__i5338184291320">domainID</em> is the account ID of the tenant to which the key belongs. <em id="obs_04_0084__i83397429133">key_id</em> is the key ID used in this encryption.</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>
</td>
</tr>
@ -235,6 +235,20 @@ Last-Modified:<span class="w"> </span>time
<p id="obs_04_0084__p1297832514820">Type: string</p>
</td>
</tr>
<tr id="obs_04_0084__row176651040597"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.8.4.2.3.1.1 "><p id="obs_04_0084__p5180191819182"><span style="color:#494949;">x-obs-object-lock-mode</span></p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0084__p6180918151813">WORM mode that will be applied to the object. Currently, only <strong id="obs_04_0084__b2443165812187">COMPLIANCE</strong> is supported. This header is returned only when the object has any object-level retention policy configured or has the default bucket-level WORM policy applied. To configure this header, the <strong id="obs_04_0084__b335715924120">GetObjectRetention</strong> permission is required.</p>
<p id="obs_04_0084__p14496145181918">Type: string</p>
<p id="obs_04_0084__p154228537191">Example: <strong id="obs_04_0084__b773731920020">x-obs-object-lock-mode:COMPLIANCE</strong></p>
</td>
</tr>
<tr id="obs_04_0084__row5212243599"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.8.4.2.3.1.1 "><p id="obs_04_0084__p14809920131812"><span style="color:#494949;">x-obs-object-lock-retain-until-date</span></p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0084__p97201718162111">Indicates the expiration time of the WORM retention. The value must be a UTC time that complies with ISO 8601, for example, <strong id="obs_04_0084__b937161762618">2015-07-01T04:11:15Z</strong>. This header is returned only when the object has any object-level retention policy configured or has the default bucket-level WORM policy applied. To configure this header, the <strong id="obs_04_0084__b10371151782610">GetObjectRetention</strong> permission is required.</p>
<p id="obs_04_0084__p1972081822113">Type: string</p>
<p id="obs_04_0084__p372031872119">Example: <strong id="obs_04_0084__b131940433014">x-obs-object-lock-retain-until-date:2015-07-01T04:11:15Z</strong></p>
</td>
</tr>
</tbody>
</table>
</div>

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

@ -6,6 +6,8 @@
<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>
<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>
</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>
<div class="section" id="obs_04_0085__section23985747"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0085__screen1215151"><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>
@ -21,20 +23,20 @@ Authorization:<span class="w"> </span>authorization
<div class="notice" id="obs_04_0085__note156845164416"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="obs_04_0085__p73241840182110">For deleting an object, only parameters listed in <a href="#obs_04_0085__d0e15727">Table 1</a> are supported. If the request contains parameters that cannot be identified by OBS, the server returns the 400 error code.</p>
</div></div>
<div class="tablenoborder"><a name="obs_04_0085__d0e15727"></a><a name="d0e15727"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0085__d0e15727" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0085__row44545009"><th align="left" class="cellrowborder" valign="top" width="22.220000000000002%" id="mcps1.3.4.4.2.4.1.1"><p id="obs_04_0085__p51375997">Parameter</p>
<div class="tablenoborder"><a name="obs_04_0085__d0e15727"></a><a name="d0e15727"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0085__d0e15727" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0085__row44545009"><th align="left" class="cellrowborder" valign="top" width="22.220000000000002%" id="mcps1.3.5.4.2.4.1.1"><p id="obs_04_0085__p51375997">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="62.629999999999995%" id="mcps1.3.4.4.2.4.1.2"><p id="obs_04_0085__p6356363">Description</p>
<th align="left" class="cellrowborder" valign="top" width="62.629999999999995%" id="mcps1.3.5.4.2.4.1.2"><p id="obs_04_0085__p6356363">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.15%" id="mcps1.3.4.4.2.4.1.3"><p id="obs_04_0085__p3277069">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="15.15%" id="mcps1.3.5.4.2.4.1.3"><p id="obs_04_0085__p3277069">Mandatory</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0085__row40173335"><td class="cellrowborder" valign="top" width="22.220000000000002%" headers="mcps1.3.4.4.2.4.1.1 "><p id="obs_04_0085__p32814727">versionId</p>
<tbody><tr id="obs_04_0085__row40173335"><td class="cellrowborder" valign="top" width="22.220000000000002%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0085__p32814727">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.4.2.4.1.2 "><p id="obs_04_0085__p40747248">Object version ID</p>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0085__p40747248">Object version ID</p>
<p id="obs_04_0085__p31180913">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.4.4.2.4.1.3 "><p id="obs_04_0085__p42625985">No</p>
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0085__p42625985">No</p>
</td>
</tr>
</tbody>
@ -55,23 +57,23 @@ Date:<span class="w"> </span>date
<div class="section" id="obs_04_0085__section1814760"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0085__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<p class="msonormal" id="obs_04_0085__p24800784">If versioning is enabled for the bucket, the headers listed in <a href="#obs_04_0085__table862048515455">Table 2</a> may also be used.</p>
<div class="tablenoborder"><a name="obs_04_0085__table862048515455"></a><a name="table862048515455"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0085__table862048515455" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0085__row25289386"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0085__p35174418">Header</p>
<div class="tablenoborder"><a name="obs_04_0085__table862048515455"></a><a name="table862048515455"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0085__table862048515455" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0085__row25289386"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.9.4.2.3.1.1"><p id="obs_04_0085__p35174418">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.8.4.2.3.1.2"><p id="obs_04_0085__p30555594">Description</p>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.9.4.2.3.1.2"><p id="obs_04_0085__p30555594">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0085__row59084026"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.8.4.2.3.1.1 "><p id="obs_04_0085__p21076811">x-obs-delete-marker</p>
<tbody><tr id="obs_04_0085__row59084026"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0085__p21076811">x-obs-delete-marker</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0085__p29500132">Indicates whether an object is deleted. 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.9.4.2.3.1.2 "><p id="obs_04_0085__p29500132">Indicates whether an object is deleted. If the object is not marked as deleted, the response does not contain this header.</p>
<p id="obs_04_0085__p64174604">Type: boolean</p>
<p id="obs_04_0085__p40700526">Value options: <strong id="obs_04_0085__b5972123874714">true</strong>, <strong id="obs_04_0085__b5972163815473">false</strong></p>
<p id="obs_04_0085__p30760421">The default value is <strong id="obs_04_0085__b84235270618335">false</strong>.</p>
</td>
</tr>
<tr id="obs_04_0085__row8408337"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.8.4.2.3.1.1 "><p id="obs_04_0085__p9986676">x-obs-version-id</p>
<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.8.4.2.3.1.2 "><p id="obs_04_0085__p3614399">Object version ID. If the object has no version number specified, the response does not contain this header.</p>
<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__p24330907">Default value: none</p>
</td>

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

@ -101,7 +101,7 @@ Content-Length:<span class="w"> </span>length
</tbody>
</table>
</div>
<p class="cautiontext" id="obs_04_0086__p45730853">A maximum of 1000 objects can be deleted at a time. If you send a request for deleting more than 1000 objects, OBS returns an error message.</p>
<p class="cautiontext" id="obs_04_0086__p45730853">A maximum of 1,000 objects can be deleted at a time. If you send a request for deleting more than 1,000 objects, OBS returns an error message.</p>
<p class="cautiontext" id="obs_04_0086__p8924501">After concurrent tasks are assigned, OBS may encounter an internal error during cyclic deletion of multiple objects. In that case, the metadata still exists when the object index data is deleted, which means data inconsistency.</p>
</div>
<div class="section" id="obs_04_0086__section10005088"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0086__screen9984937"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
@ -132,7 +132,7 @@ Content-Length:<span class="w"> </span>length
<span class="nt">&lt;Error&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>Key<span class="nt">&lt;/Key&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Code&gt;</span>ErrorCode<span class="nt">&lt;/Code&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Message&gt;</span>message<span class="nt">&lt;/Message&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Message&gt;</span>Message<span class="nt">&lt;/Message&gt;</span><span class="w"> </span>
<span class="nt">&lt;/Error&gt;</span><span class="w"> </span>
<span class="nt">&lt;/DeleteResult&gt;</span>
</pre></div></td></tr></table></div>

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

@ -26,15 +26,7 @@ Authorization:<span class="w"> </span>authorization
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0090__row32974368"><td class="cellrowborder" valign="top" width="24.240000000000002%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0090__p53678186">acl</p>
</td>
<td class="cellrowborder" valign="top" width="57.58%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0090__p52965837">Indicates that the request is to obtain the object ACL.</p>
<p id="obs_04_0090__p6930487">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0090__p24498545">Yes</p>
</td>
</tr>
<tr id="obs_04_0090__row19160315"><td class="cellrowborder" valign="top" width="24.240000000000002%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0090__p8481687">versionId</p>
<tbody><tr id="obs_04_0090__row19160315"><td class="cellrowborder" valign="top" width="24.240000000000002%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0090__p8481687">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="57.58%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0090__p15928043">Version number of an object.</p>
<p id="obs_04_0090__p9134666">Type: string</p>
@ -106,7 +98,7 @@ Content-Type:<span class="w"> </span>application/xml<span class="w"> </span>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0090__p37949556">Version number of an object.</p>
<p id="obs_04_0090__p6001692">Valid value: string</p>
<p id="obs_04_0090__p54015232">There is no default value.</p>
<p id="obs_04_0090__p54015232">Default value: none</p>
</td>
</tr>
</tbody>

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

@ -234,8 +234,7 @@ Last-Modified:<span class="w"> </span>time
</div>
<div class="section" id="obs_04_0091__section7010441604"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0091__p1170348119">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_0091__section1797652710587"><h4 class="sectiontitle">Sample Request 1</h4><p id="obs_04_0091__p41728101716"><strong id="obs_04_0091__b159053020512">Adding Object Metadata</strong></p>
<p id="obs_04_0091__p792612321102">Add the following metadata to the object: <strong id="obs_04_0091__b7701614061">Content-Type:application/zip</strong> and <strong id="obs_04_0091__b67941217662">x-obs-meta-test:meta</strong>.</p>
<div class="section" id="obs_04_0091__section1797652710587"><h4 class="sectiontitle">Sample Request: Adding Metadata for an Object</h4><p id="obs_04_0091__p792612321102">Add the following metadata to the object: <strong id="obs_04_0091__b7701614061">Content-Type:application/zip</strong> and <strong id="obs_04_0091__b67941217662">x-obs-meta-test:meta</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0091__screen41281918122116"><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>
@ -257,7 +256,7 @@ x-obs-meta-test:meta
</div>
</div>
<div class="section" id="obs_04_0091__section1634411453444"><h4 class="sectiontitle">Sample Response 1</h4><div class="codecoloring" codetype="Xml" id="obs_04_0091__screen91063375488"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0091__section1634411453444"><h4 class="sectiontitle">Sample Response: Adding Metadata for an Object</h4><div class="codecoloring" codetype="Xml" id="obs_04_0091__screen91063375488"><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>
@ -278,8 +277,7 @@ x-obs-meta-test:meta
</div>
</div>
<div class="section" id="obs_04_0091__section5110811174511"><h4 class="sectiontitle">Sample Request 2</h4><p id="obs_04_0091__p4969141111450"><strong id="obs_04_0091__b1431515498617">Modifying Object Metadata</strong></p>
<p id="obs_04_0091__p12953131514618">If metadata <strong id="obs_04_0091__b206081835154617">x-obs-meta-test:testmeta</strong> exists in the object and the value of <strong id="obs_04_0091__b66131735184615">x-obs-storage-class</strong> is <strong id="obs_04_0091__b0613133524613">WARM</strong>, change the metadata <strong id="obs_04_0091__b186141035114613">x-obs-meta-test</strong> of the object to <strong id="obs_04_0091__b14614203514466">newmeta</strong> and change <strong id="obs_04_0091__b1461443510462">x-obs-storage-class</strong> to <strong id="obs_04_0091__b361463514467">COLD</strong>.</p>
<div class="section" id="obs_04_0091__section5110811174511"><h4 class="sectiontitle">Sample Request: Editing Metadata of an Object</h4><p id="obs_04_0091__p12953131514618">If metadata <strong id="obs_04_0091__b206081835154617">x-obs-meta-test:testmeta</strong> exists in the object and the value of <strong id="obs_04_0091__b66131735184615">x-obs-storage-class</strong> is <strong id="obs_04_0091__b0613133524613">WARM</strong>, change the metadata <strong id="obs_04_0091__b186141035114613">x-obs-meta-test</strong> of the object to <strong id="obs_04_0091__b14614203514466">newmeta</strong> and change <strong id="obs_04_0091__b1461443510462">x-obs-storage-class</strong> to <strong id="obs_04_0091__b361463514467">COLD</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0091__screen1533681895619"><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>
@ -301,7 +299,7 @@ x-obs-storage-class:COLD
</div>
</div>
<div class="section" id="obs_04_0091__section181718381456"><h4 class="sectiontitle">Sample Response 2</h4><div class="codecoloring" codetype="Xml" id="obs_04_0091__screen5311811121216"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0091__section181718381456"><h4 class="sectiontitle">Sample Response: Editing Metadata of an Object</h4><div class="codecoloring" codetype="Xml" id="obs_04_0091__screen5311811121216"><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>
@ -324,8 +322,7 @@ x-obs-storage-class:COLD
</div>
</div>
<div class="section" id="obs_04_0091__section588454394519"><h4 class="sectiontitle">Sample Request 3</h4><p id="obs_04_0091__p66032044144518"><strong id="obs_04_0091__b89031128983">Deleting Object Metadata</strong></p>
<p id="obs_04_0091__p19671119141312">Metadata <strong id="obs_04_0091__b128084214612">x-obs-meta-test:newmeta</strong> and <strong id="obs_04_0091__b9851142194616">Content-Type:application/zip</strong> exist in the object, and delete <strong id="obs_04_0091__b4856429467">x-obs-meta-test</strong>.</p>
<div class="section" id="obs_04_0091__section588454394519"><h4 class="sectiontitle">Sample Request: Deleting Metadata of an Object</h4><p id="obs_04_0091__p19671119141312">Metadata <strong id="obs_04_0091__b128084214612">x-obs-meta-test:newmeta</strong> and <strong id="obs_04_0091__b9851142194616">Content-Type:application/zip</strong> exist in the object, and delete <strong id="obs_04_0091__b4856429467">x-obs-meta-test</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0091__screen1592817231416"><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>
@ -345,7 +342,7 @@ Content-Type:application/zip
</div>
</div>
<div class="section" id="obs_04_0091__section99685499019"><h4 class="sectiontitle">Sample Response 3</h4><div class="codecoloring" codetype="Xml" id="obs_04_0091__screen115112819173"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0091__section99685499019"><h4 class="sectiontitle">Sample Response: Deleting Metadata of an Object</h4><div class="codecoloring" codetype="Xml" id="obs_04_0091__screen115112819173"><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>

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

@ -2,7 +2,7 @@
<h1 class="topictitle1">Modifying an Object</h1>
<div id="body1541665569463"><div class="section" id="obs_04_0092__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0092__p2025912321245">This operation can modify an object from a specified position.</p>
<div class="note" id="obs_04_0092__note157119479517"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0092__p290817918540">This API is supported only by parallel file systems. For details about how to create a parallel file system, see <a href="obs_04_0021.html#obs_04_0021__section4293341135610">Sample Request 4</a>.</p>
<div class="note" id="obs_04_0092__note157119479517"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0092__p290817918540">This API is supported only by parallel file systems. For details about how to create a parallel file system, see <a href="obs_04_0021.html#obs_04_0021__section4293341135610">Sample Request: Creating a Parallel File System</a>.</p>
</div></div>
</div>
<div class="section" id="obs_04_0092__section117547365453"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="obs_04_0092__screen1082453613457">PUT /ObjectName?modify&amp;position=<em id="obs_04_0092__i20662171325010">Position</em> HTTP/1.1

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

@ -2,7 +2,7 @@
<h1 class="topictitle1">Truncating an Object</h1>
<div id="body1541665569463"><div class="section" id="obs_04_0093__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0093__p2025912321245">This operation can truncate an object to a specified size.</p>
<div class="note" id="obs_04_0093__note157119479517"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0093__obs_04_0092_p290817918540">This API is supported only by parallel file systems. For details about how to create a parallel file system, see <a href="obs_04_0021.html#obs_04_0021__section4293341135610">Sample Request 4</a>.</p>
<div class="note" id="obs_04_0093__note157119479517"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0093__obs_04_0092_p290817918540">This API is supported only by parallel file systems. For details about how to create a parallel file system, see <a href="obs_04_0021.html#obs_04_0021__section4293341135610">Sample Request: Creating a Parallel File System</a>.</p>
</div></div>
</div>
<div class="section" id="obs_04_0093__section114577124330"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="obs_04_0093__screen19507212133311">PUT /ObjectName?truncate&amp;length=<em id="obs_04_0093__i162921446175020">Length</em> HTTP/1.1

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

@ -2,7 +2,7 @@
<h1 class="topictitle1">Renaming an Object</h1>
<div id="body1541665569463"><div class="section" id="obs_04_0094__section83041644183813"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0094__p572355211381">This operation can rename an object.</p>
<div class="note" id="obs_04_0094__note162121231711"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0094__p290817918540">This API is supported only by parallel file systems. For details about how to create a parallel file system, see <a href="obs_04_0021.html#obs_04_0021__section4293341135610">Sample Request 4</a>. Renaming an object is a non-idempotent operation.</p>
<div class="note" id="obs_04_0094__note162121231711"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0094__p290817918540">This API is supported only by parallel file systems. For details about how to create a parallel file system, see <a href="obs_04_0021.html#obs_04_0021__section4293341135610">Sample Request: Creating a Parallel File System</a>. Renaming an object is a non-idempotent operation.</p>
</div></div>
</div>
<div class="section" id="obs_04_0094__section760614963314"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="obs_04_0094__screen1061584913333">POST /ObjectName?name=<em id="obs_04_0094__i11871159510">Name&amp;</em>rename HTTP/1.1

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

@ -8,9 +8,9 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0098.html">Initiating a Multipart Upload</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0099.html">Multipart Upload</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0099.html">Uploading Parts</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0100.html">Uploading a Part of an Object - Copy</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0100.html">Copying Parts</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0101.html">Listing Uploaded Parts of an Object</a></strong><br>
</li>

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

@ -282,8 +282,7 @@ Content-Length:<span class="w"> </span>length
<div class="section" id="obs_04_0097__section29382687"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0097__p40624238">If the value of <strong id="obs_04_0097__b84235270674044">maxUploads</strong> is a non-integer or smaller than 0, OBS returns <strong id="obs_04_0097__b84235270674138">400 Bad Request</strong>.</p>
<p class="msonormal" id="obs_04_0097__p30073825">Other errors are included in <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0097__section8651130153911"><h4 class="sectiontitle">Sample Request 1</h4><p id="obs_04_0097__p4978114417264"><strong id="obs_04_0097__b115482562305">List the initialized multipart tasks without any parameter</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0097__screen250717511394"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0097__section8651130153911"><h4 class="sectiontitle">Sample Request: Listing Initiated Multipart Uploads</h4><div class="codecoloring" codetype="Xml" id="obs_04_0097__screen250717511394"><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>
@ -298,7 +297,7 @@ Authorization:<span class="w"> </span>OBS<span class="w"> </span>UDSIAMSTUBTEST0
</div>
</div>
<div class="section" id="obs_04_0097__section6321192184111"><h4 class="sectiontitle">Sample Response 1</h4><div class="codecoloring" codetype="Xml" id="obs_04_0097__screen19381122174118"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0097__section6321192184111"><h4 class="sectiontitle">Sample Response: Listing Initiated Multipart Uploads</h4><div class="codecoloring" codetype="Xml" id="obs_04_0097__screen19381122174118"><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>
@ -361,8 +360,7 @@ Content-Length:<span class="w"> </span>681
</div>
</div>
<div class="section" id="obs_04_0097__section32871958184516"><h4 class="sectiontitle">Sample Request 2</h4><p id="obs_04_0097__p149319344297"><strong id="obs_04_0097__b181041628183112">List the initialized multipart tasks with the prefix and delimiter</strong>.</p>
<p id="obs_04_0097__p1259795115464">The following example describes how to list two initiated multipart uploads (with objects <strong id="obs_04_0097__b17891201620301">multipart-object001</strong> and <strong id="obs_04_0097__b4515101963013">part2-key02</strong> in bucket <strong id="obs_04_0097__b974332983019">examplebucket</strong>. In this listing operation, <strong id="obs_04_0097__b198393173015">prefix</strong> is set to <strong id="obs_04_0097__b1496733811304">multipart</strong> and <strong id="obs_04_0097__b10903124319307">object001</strong> is set to <strong id="obs_04_0097__b66534481307">delimiter</strong>.</p>
<div class="section" id="obs_04_0097__section32871958184516"><h4 class="sectiontitle">Sample Request: Listing Initiated Multipart Uploads (with a Prefix and Delimiter Specified)</h4><p id="obs_04_0097__p1259795115464">The following example describes how to list two initiated multipart uploads (with objects <strong id="obs_04_0097__b17891201620301">multipart-object001</strong> and <strong id="obs_04_0097__b4515101963013">part2-key02</strong> in bucket <strong id="obs_04_0097__b974332983019">examplebucket</strong>. In this listing operation, <strong id="obs_04_0097__b198393173015">prefix</strong> is set to <strong id="obs_04_0097__b1496733811304">multipart</strong> and <strong id="obs_04_0097__b10903124319307">object001</strong> is set to <strong id="obs_04_0097__b66534481307">delimiter</strong>.</p>
<pre class="screen" id="obs_04_0097__screen65372308460">GET /?uploads&amp;delimiter=object001&amp;prefix=multipart HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0097__i16622171212817">region</em>.example.com
@ -370,7 +368,7 @@ Accept: */*
Date: WED, 01 Jul 2015 04:51:21 GMT
Authorization: OBS UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=</pre>
</div>
<div class="section" id="obs_04_0097__section3921182910539"><h4 class="sectiontitle">Sample Response 2</h4><div class="codecoloring" codetype="Xml" id="obs_04_0097__screen39681829165318"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0097__section3921182910539"><h4 class="sectiontitle">Sample Response: Listing Initiated Multipart Uploads (with a Prefix and Delimiter Specified)</h4><div class="codecoloring" codetype="Xml" id="obs_04_0097__screen39681829165318"><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>

189
docs/obs/api-ref/obs_04_0098.html
View File

File diff suppressed because it is too large Load Diff

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

@ -1,6 +1,6 @@
<a name="obs_04_0099"></a><a name="obs_04_0099"></a>
<h1 class="topictitle1">Multipart Upload</h1>
<h1 class="topictitle1">Uploading Parts</h1>
<div id="body47090749"><div class="section" id="obs_04_0099__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0099__p35066376">After initiating a multipart upload, you can use this operation to upload parts for the multipart upload using its task ID. When parts are uploaded in a multipart upload of an object, the upload sequence does not affect part merging, namely, multiple parts can be uploaded concurrently.</p>
<p class="msonormal" id="obs_04_0099__p47161933">Part sizes range from 100 KB to 5 GB. However, when parts are being merged, the size of the last uploaded part ranges from 0 to 5 GB. The upload part ID ranges from 1 to 10,000.</p>
<p class="msonormal" id="obs_04_0099__p21804221">This operation supports server-side encryption.</p>
@ -122,7 +122,7 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.3.1.2 "><p id="obs_04_0099__p41759616">Indicates the master key ID. This header is included in a response if SSE-KMS is used. </p>
<p id="obs_04_0099__p36311057123619">Type: string</p>
<p id="obs_04_0099__p12143184595018">Format: <em id="obs_04_0099__i1885113918520">regionID</em><strong id="obs_04_0099__b20857939450">:</strong><em id="obs_04_0099__i88575391155">domainID</em><strong id="obs_04_0099__b19858203910516">:key/</strong><em id="obs_04_0099__i158589390510">key_id</em></p>
<p id="obs_04_0099__p116312573364"><em id="obs_04_0099__i13571818201412">regionID</em> is the ID of the region to which the key belongs. <em id="obs_04_0099__i85871815148">domainID</em> is the account ID of the tenant to which the key belongs. <em id="obs_04_0099__i25891891419">key_id</em> is the key ID used in this encryption.</p>
<p id="obs_04_0099__p116312573364"><em id="obs_04_0099__i159641435185817">regionID</em> indicates the ID of the region where the key belongs. <em id="obs_04_0099__i1696514350583">domainID</em> indicates the ID of the tenant where the key belongs. <em id="obs_04_0099__i296511359581">key_id</em> indicates the key ID used in this encryption.</p>
<p id="obs_04_0099__p113127905815">Example: <strong id="obs_04_0099__b26110381804">x-obs-server-side-encryption-kms-key-id:</strong><strong id="obs_04_0099__b11635387011"><em id="obs_04_0099__i206314388010">region</em></strong><strong id="obs_04_0099__b11648380013">:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</strong></p>
</td>
</tr>

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

@ -1,6 +1,6 @@
<a name="obs_04_0100"></a><a name="obs_04_0100"></a>
<h1 class="topictitle1">Uploading a Part of an Object - Copy</h1>
<h1 class="topictitle1">Copying Parts</h1>
<div id="body20741762"><div class="section" id="obs_04_0100__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0100__p28787755">After creating a multipart upload job, you can specify its upload ID and upload a part to the job in OBS. Alternatively, you can make an API call to add a part (part of an object or the whole object).</p>
<p class="msonormal" id="obs_04_0100__p57763204">This operation supports server-side encryption.</p>
<div class="notice" id="obs_04_0100__note48307965"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p class="cautiontext" id="obs_04_0100__p52458133">You cannot determine whether a request is executed successfully only using <strong id="obs_04_0100__b733137133204115">status_code</strong> in the returned HTTP header. If 200 in <strong id="obs_04_0100__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 request is executed successfully. The request is executed successfully only when the body contains Etag; otherwise, the request fails to be executed.</p>
@ -170,7 +170,7 @@ Date: <em id="obs_04_0100__i64317386">date</em>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0100__p59246769">Indicates the master key ID. This header is included in a response if SSE-KMS is used. </p>
<p id="obs_04_0100__p3184191118373">Type: string</p>
<p id="obs_04_0100__p816033935117">Format: <em id="obs_04_0100__i2412844957">regionID</em><strong id="obs_04_0100__b941815441856">:</strong><em id="obs_04_0100__i1141844410511">domainID</em><strong id="obs_04_0100__b174181044759">:key/</strong><em id="obs_04_0100__i541916441754">key_id</em></p>
<p id="obs_04_0100__p91841311103713"><em id="obs_04_0100__i285415301519">regionID</em> is the ID of the region to which the key belongs. <em id="obs_04_0100__i2085483131511">domainID</em> is the account ID of the tenant to which the key belongs. <em id="obs_04_0100__i12855153191511">key_id</em> is the key ID used in this encryption.</p>
<p id="obs_04_0100__p91841311103713"><em id="obs_04_0100__i1023610453586">regionID</em> indicates the ID of the region where the key belongs. <em id="obs_04_0100__i152368456583">domainID</em> indicates the ID of the tenant where the key belongs. <em id="obs_04_0100__i1237134515812">key_id</em> indicates the key ID used in this encryption.</p>
<p id="obs_04_0100__p53578586588">Example: <strong id="obs_04_0100__b15620125112010">x-obs-server-side-encryption-kms-key-id:</strong><strong id="obs_04_0100__b1162135117014"><em id="obs_04_0100__i46201651104">region</em></strong><strong id="obs_04_0100__b1762218514016">:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</strong></p>
</td>
</tr>

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

@ -31,7 +31,7 @@ Authorization: auth</pre>
</td>
<td class="cellrowborder" valign="top" width="56.120000000000005%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0101__p56272029">Maximum number of parts that can be listed</p>
<p id="obs_04_0101__p36686218">Type: integer</p>
<p id="obs_04_0101__p61740514">Default value: 1000</p>
<p id="obs_04_0101__p61740514">Default value: <strong id="obs_04_0101__b14283163125317">1,000</strong></p>
</td>
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0101__p34925723">No</p>
</td>

80
docs/obs/api-ref/obs_04_0102.html
View File

File diff suppressed because it is too large Load Diff

89
docs/obs/api-ref/obs_04_0106.html
View File

File diff suppressed because it is too large Load Diff

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

@ -1,8 +1,10 @@
<a name="obs_04_0107"></a><a name="obs_04_0107"></a>
<h1 class="topictitle1">Server-Side Encryption (SSE-C)</h1>
<div id="body5487110"><p class="msonormal" id="obs_04_0107__p8972557">In the SSE-C mode, OBS uses the keys and MD5 values provided by customers for server-side encryption.</p>
<p class="msonormal" id="obs_04_0107__p13644154">OBS does not store your encryption keys. If you lost your encryption keys, you lost the objects. Six headers are added to support SSE-C.</p>
<div id="body5487110"><div class="section" id="obs_04_0107__section104215161210"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0107__p11402161614125">With SSE-C used, OBS uses the keys and MD5 values provided by customers for server-side encryption.</p>
</div>
<div class="section" id="obs_04_0107__section794711344129"><h4 class="sectiontitle">Newly Added Headers</h4><p id="obs_04_0107__p2032793616129">OBS does not store your encryption keys. If you lost them, you lost the objects. Six headers are added to support SSE-C.</p>
</div>
<p class="msonormal" id="obs_04_0107__p55688526">The following table lists headers that are required when you use SSE-C to encrypt objects.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0107__table101231237144214" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Header fields used for encrypting objects in SSE-C mode</caption><thead align="left"><tr id="obs_04_0107__row0125153764211"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.2.3.1.1"><p id="obs_04_0107__p171250379427">Element</p>
@ -11,10 +13,10 @@
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0107__row1412573764215"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0107__p18431172634319">x-obs-server-side-encryption-customer-algorithm</p>
<tbody><tr id="obs_04_0107__row1412573764215"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0107__p18431172634319"><span style="color:#252B3A;">x-obs-server-side-encryption-customer-algorithm</span></p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0107__p1843282614431">Indicates an encryption algorithm. The header is used in SSE-C mode.</p>
<p id="obs_04_0107__p1143292694311">Example: <strong id="obs_04_0107__b15626111984318">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
<p id="obs_04_0107__p1143292694311">Example: <strong id="obs_04_0107__b42741427172913">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
</td>
</tr>
<tr id="obs_04_0107__row1112515375428"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0107__p143416261434">x-obs-server-side-encryption-customer-key</p>
@ -32,8 +34,8 @@
</tbody>
</table>
</div>
<p id="obs_04_0107__p6362428134419">API operations to which the newly added headers apply:</p>
<ul id="obs_04_0107__ul1563754118444"><li id="obs_04_0107__li46378412449">PutObject</li><li id="obs_04_0107__li1646715124417">PostObject</li><li id="obs_04_0107__li15218125816445">CopyObject (the newly added headers apply to target objects)</li><li id="obs_04_0107__li7792152194516">HeadObject</li><li id="obs_04_0107__li837386144510">GetObject</li><li id="obs_04_0107__li12306141014454">InitiateMultipartUpload</li><li id="obs_04_0107__li16197613164519">UploadPart</li><li id="obs_04_0107__li89832195451">UploadPart-Copy (the newly added headers apply to target parts)</li></ul>
<p id="obs_04_0107__p6362428134419">APIs where the newly added headers apply:</p>
<ul id="obs_04_0107__ul1563754118444"><li id="obs_04_0107__li46378412449"><a href="obs_04_0080.html">Uploading Objects - PUT</a></li><li id="obs_04_0107__li1646715124417"><a href="obs_04_0081.html">Uploading Objects - POST</a></li><li id="obs_04_0107__li15218125816445"><a href="obs_04_0082.html">Copying Objects</a>: The newly added headers apply to object copies.</li><li id="obs_04_0107__li7792152194516"><a href="obs_04_0084.html">Querying Object Metadata</a></li><li id="obs_04_0107__li837386144510"><a href="obs_04_0083.html">Downloading Objects</a></li><li id="obs_04_0107__li12306141014454"><a href="obs_04_0098.html">Initiating a Multipart Upload</a></li><li id="obs_04_0107__li16197613164519"><a href="obs_04_0099.html">Uploading Parts</a></li><li id="obs_04_0107__li89832195451"><a href="obs_04_0100.html">Copying Parts</a>: The newly added headers apply to target parts.</li></ul>
<p id="obs_04_0107__p8384173917455"></p>
<p class="msonormal" id="obs_04_0107__p63181975">The following table lists three headers that are added for CopyObject and UploadPart-Copy operations to support source objects encrypted using SSE-C.</p>
@ -64,8 +66,7 @@
</tbody>
</table>
</div>
<div class="section" id="obs_04_0107__section151461344181918"><h4 class="sectiontitle">Sample Request 1</h4><p id="obs_04_0107__p183870405126"><strong id="obs_04_0107__b6345327153312">Upload an object with the SSE-C encryption mode.</strong></p>
<div class="codecoloring" codetype="Xml" id="obs_04_0107__screen645110482196"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0107__section151461344181918"><h4 class="sectiontitle">Sample Request: Uploading an Object Encrypted with SSE-C</h4><div class="codecoloring" codetype="Xml" id="obs_04_0107__screen645110482196"><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>
@ -92,7 +93,7 @@ Content-Length:<span class="w"> </span>5242
</div>
</div>
<div class="section" id="obs_04_0107__section039121783514"><h4 class="sectiontitle">Sample Response 1</h4><div class="codecoloring" codetype="Xml" id="obs_04_0107__screen152782032153511"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0107__section039121783514"><h4 class="sectiontitle">Sample Response: Uploading an Object Encrypted with SSE-C</h4><div class="codecoloring" codetype="Xml" id="obs_04_0107__screen152782032153511"><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>
@ -113,8 +114,7 @@ Content-Length:<span class="w"> </span>0
</div>
</div>
<div class="section" id="obs_04_0107__section3959940113518"><h4 class="sectiontitle">Sample Request 2</h4><p id="obs_04_0107__p1854634516357"><strong id="obs_04_0107__b9574193210332">Copy the SSE-C encrypted object and save it as the KMS encrypted object.</strong></p>
<div class="codecoloring" codetype="Xml" id="obs_04_0107__screen1272175813510"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0107__section3959940113518"><h4 class="sectiontitle">Sample Request: Copying an SSE-C Encrypted Object and Saving It as a KMS Encrypted Object</h4><div class="codecoloring" codetype="Xml" id="obs_04_0107__screen1272175813510"><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>
@ -145,7 +145,7 @@ Content-Length:<span class="w"> </span>5242
</div>
</div>
<div class="section" id="obs_04_0107__section1589193223912"><h4 class="sectiontitle">Sample Response 2</h4><div class="codecoloring" codetype="Xml" id="obs_04_0107__screen155121223417"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0107__section1589193223912"><h4 class="sectiontitle">Sample Response: Copying an SSE-C Encrypted Object and Saving It as a KMS Encrypted Object</h4><div class="codecoloring" codetype="Xml" id="obs_04_0107__screen155121223417"><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>
@ -166,8 +166,7 @@ Content-Length:<span class="w"> </span>0
</div>
</div>
<div class="section" id="obs_04_0107__section13241145493917"><h4 class="sectiontitle">Sample Request 3</h4><p id="obs_04_0107__p1519105818399"><strong id="obs_04_0107__b8999183714334">The URL contains the signature and the SSE-C encrypted object is uploaded.</strong></p>
<pre class="screen" id="obs_04_0107__screen28009915407">PUT /encrypobject?AccessKeyId=H4IPJX0TQTHTHEBQQCEC&amp;Expires=1532688887&amp;Signature=EQmDuOhaLUrzrzRNZxwS72CXeXM%3D HTTP/1.1
<div class="section" id="obs_04_0107__section13241145493917"><h4 class="sectiontitle">Sample Request: Uploading an SSE-C Encrypted Object Using a Signed URL</h4><pre class="screen" id="obs_04_0107__screen28009915407">PUT /encrypobject?AccessKeyId=H4IPJX0TQTHTHEBQQCEC&amp;Expires=1532688887&amp;Signature=EQmDuOhaLUrzrzRNZxwS72CXeXM%3D HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0107__i883312340299">region</em>.example.com
Accept: */*
@ -179,7 +178,7 @@ Expect: 100-continue
<em id="obs_04_0107__i3949109132311">[5242 Byte object contents]</em></pre>
</div>
<div class="section" id="obs_04_0107__section1990581416405"><h4 class="sectiontitle">Sample Response 3</h4><div class="codecoloring" codetype="Xml" id="obs_04_0107__screen13874591790"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<div class="section" id="obs_04_0107__section1990581416405"><h4 class="sectiontitle">Sample Response: Uploading an SSE-C Encrypted Object Using a Signed URL</h4><div class="codecoloring" codetype="Xml" id="obs_04_0107__screen13874591790"><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>

36
docs/obs/api-ref/obs_04_0115.html
View File

@ -235,7 +235,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p1606204582210">Invalid Content-Length value.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p18606204592212">Check the encapsulation header or contact technical support.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p18606204592212">Check the encapsulation header or for technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row14913292594"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p156809312597">400 Bad Request</p>
@ -343,7 +343,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p941816597311">The customer master key (CMK) is disabled in SSE-KMS mode.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p20418185910315">Replace the key and try again, or contact with the technical support.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p20418185910315">Change a key and try again, or for technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row17292568"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p1141865913313">400 Bad Request</p>
@ -469,7 +469,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p0343454102318">There are multiple Content-Length headers.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p634319547230">Check the encapsulation header or contact technical support.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p634319547230">Check the encapsulation header or for technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row56710568"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p442115591313">400 Bad Request</p>
@ -514,7 +514,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p0133520554">This operation is available only to specific users.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p14133182016518">Contact technical support.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p14133182016518"> for technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row7769934"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p81336202510">403 Forbidden</p>
@ -526,6 +526,15 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p111338201853">Provide a correct date header in the request.</p>
</td>
</tr>
<tr id="obs_04_0115__row72851266442"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p1928514674413">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p172851162446">AccessDenied</p>
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p1228514644419">The object you specified is immutable, can not delete.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p1728526144415">Wait until the WORM retention expires and then modify or delete the object.</p>
</td>
</tr>
<tr id="obs_04_0115__row10027140"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p1313316201252">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p111330209516">AccessForbidden</p>
@ -750,7 +759,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p108943593149">The socket connection to the server has no read or write operations within the timeout period.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p12894759141416">Check the network and try again, or contact technical support.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p12894759141416">Check the network and try again, or for technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row7219776102835"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p4894175951411">409 Conflict</p>
@ -804,7 +813,16 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p10508201316167">The request method is not supported by the server.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p35081913191613">Not supported by the server. Contact technical support.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p35081913191613"> for technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row11186540311"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p618716433113">409 ObjectNotAppendable</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p1218724173117">ObjectNotAppendable</p>
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p91871047312">The object is not appendable.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p11877493111">Check the bucket type. Parallel file systems do not support append upload. Check the object type. Cold objects are not appendable.</p>
</td>
</tr>
<tr id="obs_04_0115__row64459840102853"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p050891315168">411 Length Required</p>
@ -849,7 +867,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p18509101381618">An internal error occurs. Retry later.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p15509101361612">Contact technical support.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p15509101361612"> for technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row13312352103058"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p1850913134166">501 Not Implemented</p>
@ -858,7 +876,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p3509181381617">The request method is not implemented by the server.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p14509213181620">Not supported currently. Contact technical support.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p14509213181620"> for technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row2931731629"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p150912131162">503 Service Unavailable</p>
@ -867,7 +885,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p1550915131164">The server is overloaded or has internal errors.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p14509113181620">Try later or contact technical support.</p>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p14509113181620">Try again later or for technical support.</p>
</td>
</tr>
<tr id="obs_04_0115__row37055610166"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p750961391612">503 Service Unavailable</p>

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

@ -2,7 +2,7 @@
<h1 class="topictitle1">Obtaining Access Keys (AK/SK)</h1>
<div id="body1559727156453"><p id="obs_04_0116__p183445011362">When you call APIs, you need to use the AK and SK for authentication. To obtain the AK and SK, perform the following steps:</p>
<ol id="obs_04_0116__ol2073512113338"><li id="obs_04_0116__li97331911183311"><span>Log in to the console.</span></li><li id="obs_04_0116__li57335110335"><span>Click the login username in the upper right corner and choose <strong id="obs_04_0116__b84601521104219">My Credentials</strong> from the drop-down list.</span></li><li id="obs_04_0116__li2031416205528"><span>Choose <strong id="obs_04_0116__b1526024014710">Access Keys</strong>.</span></li><li id="obs_04_0116__li16734121112338"><span>Click <strong id="obs_04_0116__b199592312114">Create Access Key</strong>.</span></li><li id="obs_04_0116__li473414116337"><span>Enter the login password.</span></li><li id="obs_04_0116__li18734151123311"><span>Enter the verification code your mobile phone, or email received, and click <strong id="obs_04_0116__b99301444114710">OK</strong>.</span></li><li id="obs_04_0116__li7735111143318"><span>View the access key file that was automatically downloaded.</span><p><div class="note" id="obs_04_0116__note117355116337"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="obs_04_0116__p873571111335">Keep AKs and SKs properly to prevent information leakage.</p>
<ol id="obs_04_0116__ol2073512113338"><li id="obs_04_0116__li97331911183311"><span>Log in to the console.</span></li><li id="obs_04_0116__li57335110335"><span>Click on the login username in the upper right corner and choose <strong id="obs_04_0116__b84601521104219">My Credentials</strong> from the drop-down list.</span></li><li id="obs_04_0116__li2031416205528"><span>Choose <strong id="obs_04_0116__b1526024014710">Access Keys</strong>.</span></li><li id="obs_04_0116__li16734121112338"><span>Click <strong id="obs_04_0116__b199592312114">Create Access Key</strong>.</span></li><li id="obs_04_0116__li473414116337"><span>Enter the login password.</span></li><li id="obs_04_0116__li18734151123311"><span>Enter the verification code your mobile phone, or email received, and click <strong id="obs_04_0116__b99301444114710">OK</strong>.</span></li><li id="obs_04_0116__li7735111143318"><span>View the access key file that was automatically downloaded.</span><p><div class="note" id="obs_04_0116__note117355116337"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="obs_04_0116__p873571111335">Keep AKs and SKs properly to prevent information leakage.</p>
</div></div>
</p></li></ol>
<p id="obs_04_0116__p101221620153614"></p>

6
docs/obs/api-ref/obs_04_0160.html
View File

@ -51,7 +51,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0160__row4586517"><td class="cellrowborder" valign="top" width="13.130000000000003%" headers="mcps1.3.3.3.2.4.1.1 "><p id="obs_04_0160__p35963564">max-keys</p>
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0160__p27367592">Sets the maximum number of objects returned (in alphabetical order) in the response. The value ranges from 1 to 1000. If there are over 1,000 objects, only 1,000 objects are returned by default.</p>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0160__p27367592">Specifies the maximum number (from <strong id="obs_04_0160__b207561213175419">1</strong> to <strong id="obs_04_0160__b575611136546">1000</strong>) of objects returned (in alphabetical order) in the response. If the value is beyond this range, only 1,000 objects are returned by default.</p>
<p id="obs_04_0160__p44981744">Type: integer</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0160__p19642622">No</p>
@ -80,7 +80,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0160__p1078563971713">Specifies whether to return the object owner information.</p>
<p id="obs_04_0160__p1077616018206">Type: boolean</p>
<p id="obs_04_0160__p890719019203">Optional value: <strong id="obs_04_0160__b191512312339">true</strong> or <strong id="obs_04_0160__b39151231193313">false</strong></p>
<p id="obs_04_0160__p890719019203">Value options: <strong id="obs_04_0160__b191512312339">true</strong>, <strong id="obs_04_0160__b39151231193313">false</strong></p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0160__p878553961717">No</p>
</td>
@ -110,7 +110,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0160__section1443783810235"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0160__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_0160__section9457950112515"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0160__p31592957">This response lists objects in the XML format. Specific elements are described in <a href="#obs_04_0160__table17753706155228">Table 2</a>.</p>
<div class="section" id="obs_04_0160__section9457950112515"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0160__p31592957">This response lists objects in XML format. Specific elements are described in <a href="#obs_04_0160__table17753706155228">Table 2</a>.</p>
<div class="tablenoborder"><a name="obs_04_0160__table17753706155228"></a><a name="table17753706155228"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0160__table17753706155228" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="obs_04_0160__row5816417"><th align="left" class="cellrowborder" valign="top" width="35.27%" id="mcps1.3.8.3.2.3.1.1"><p id="obs_04_0160__p1367796">Element</p>
</th>

165
docs/obs/api-ref/obs_04_0166.html Normal file
View File

File diff suppressed because it is too large Load Diff

191
docs/obs/api-ref/obs_04_0167.html Normal file
View File

File diff suppressed because it is too large Load Diff

176
docs/obs/api-ref/obs_04_0168.html Normal file
View File

File diff suppressed because it is too large Load Diff