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-07-25 08:23:43 +00:00 committed by zuul
parent 8724fdd9fc
commit f61b26432c
47 changed files with 827 additions and 291 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

File diff suppressed because it is too large Load Diff

216
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__row188561124124213"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p785616249428">2023-05-04</p>
<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>
</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>
<ul id="obs_04_0000__ul29994616305"><li id="obs_04_0000__li201002467306">Added the APIs related to Requester Pays: <a href="obs_04_0068.html">Configuring the Requester-Pays Function for a Bucket</a> and <a href="obs_04_0069.html">Obtaining the Requester-Pays Configuration Information of a Bucket</a>.</li></ul>
</td>
</tr>
<tr id="obs_04_0000__row188561124124213"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p785616249428">2023-05-04</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p18848132264813">This is the sixth official release.</p>
<p id="obs_04_0000__p2085792414210">This issue incorporates the following change:</p>

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

@ -204,6 +204,16 @@
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p1319516275397">Deletes the default server-side encryption configuration of a bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row371106105512"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p117111762552"><a href="obs_04_0068.html">Configuring the Requester-Pays Function for a Bucket</a></p>
</td>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p167116635515">Configures the requester-pays function for a bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row1817219965519"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p1317218925518"><a href="obs_04_0069.html">Obtaining the Requester-Pays Configuration 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__p617219155513">Obtains the requester-pays configuration information of a bucket.</p>
</td>
</tr>
</tbody>
</table>
</div>

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

@ -49,7 +49,7 @@
</tr>
<tr id="obs_04_0010__row42990474"><td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.10.3.2.3.1.1 "><p id="obs_04_0010__p59676394">CanonicalizedHeaders</p>
</td>
<td class="cellrowborder" valign="top" width="73%" headers="mcps1.3.10.3.2.3.1.2 "><p id="obs_04_0010__p1949763">OBS request header field in an HTTP request header, referring to header fields started with <strong id="obs_04_0010__b319919585174">x-obs-</strong>, for example, <strong id="obs_04_0010__b2415161111183">x-obs-date</strong>, <strong id="obs_04_0010__b1872619143186">x-obs-acl</strong>, and <strong id="obs_04_0010__b184151419201818">x-obs-meta-*</strong>.</p>
<td class="cellrowborder" valign="top" width="73%" headers="mcps1.3.10.3.2.3.1.2 "><p id="obs_04_0010__p1949763">OBS request header field in an HTTP request header, referring to header fields starting with <strong id="obs_04_0010__b319919585174">x-obs-</strong>, such as, <strong id="obs_04_0010__b2415161111183">x-obs-date</strong>, <strong id="obs_04_0010__b1872619143186">x-obs-acl</strong>, and <strong id="obs_04_0010__b184151419201818">x-obs-meta-*</strong>. When calling an API, choose a header that is supported by the API as required.</p>
<ol id="obs_04_0010__ol145715617477"><li id="obs_04_0010__li1685416455352">All characters of keywords in a request header field must be converted to lowercase letters (content values must be case sensitive, for example, <strong id="obs_04_0010__b111291138163018">x-obs-storage-class:STANDARD</strong>). If a request contains multiple header fields, these fields should be organized by keyword in the alphabetical order from a to z.</li><li id="obs_04_0010__li1497111394712">If multiple header fields in a request have the same prefix, combine the header fields into one. For example, <strong id="obs_04_0010__b18992135642213">x-obs-meta-name:name1</strong> and <strong id="obs_04_0010__b615756114620">x-obs-meta-name:name2</strong> should be reorganized into <strong id="obs_04_0010__b76247410237">x-obs-meta-name:name1,name2</strong>. Use comma to separate the values.</li><li id="obs_04_0010__li18224198471">Keywords in the request header field cannot contain non-ASCII or unrecognizable characters, which are also not advisable for values in the request header field. If the two types of characters are necessary, they should be encoded and decoded on the client side. Either URL encoding or Base64 encoding is acceptable, but the server does not perform decoding.</li><li id="obs_04_0010__li8253142214474">Delete meaningless spaces and tabs in a header field. For example, <strong id="obs_04_0010__b1433317110158">x-obs-meta-name: name</strong> (with a meaningless space before <strong id="obs_04_0010__b14794533166">name</strong>) must be changed to <strong id="obs_04_0010__b54278376">x-obs-meta-name:name</strong>.</li><li id="obs_04_0010__li67877331819">Each header field occupies a separate line. See <a href="#obs_04_0010__table46456687212511">Table 4</a>.</li></ol>
</td>
</tr>
@ -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, 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, 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>
@ -522,7 +522,7 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<span class="w"> </span><span class="s">&quot;CDNNotifyConfiguration&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;acl&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;attname&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;cors&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;customdomain&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;delete&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;deletebucket&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;encryption&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;length&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;lifecycle&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;location&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;logging&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;metadata&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;mirrorBackToSource&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;modify&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;name&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;notification&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;obscompresspolicy&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;partNumber&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;policy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;position&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;quota&quot;</span><span class="p">,</span><span class="s">&quot;rename&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;replication&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-cache-control&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;partNumber&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;policy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;position&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;quota&quot;</span><span class="p">,</span><span class="s">&quot;rename&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;replication&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;requestPayment&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-cache-control&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;response-content-disposition&quot;</span><span class="p">,</span><span class="s">&quot;response-content-encoding&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-language&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-type&quot;</span><span class="p">,</span><span class="w"> </span>
<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>

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, 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, 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>
@ -470,7 +470,7 @@ Host: bucketname.obs.<em id="obs_04_0011__i41621102549">region</em>.example.com<
<span class="w"> </span><span class="s">&quot;CDNNotifyConfiguration&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;acl&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;attname&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;cors&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;customdomain&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;delete&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;deletebucket&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;encryption&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;length&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;lifecycle&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;location&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;logging&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;metadata&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;mirrorBackToSource&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;modify&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;name&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;notification&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;obscompresspolicy&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;partNumber&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;policy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;position&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;quota&quot;</span><span class="p">,</span><span class="s">&quot;rename&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;replication&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-cache-control&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;partNumber&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;policy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;position&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;quota&quot;</span><span class="p">,</span><span class="s">&quot;rename&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;replication&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;requestPayment&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-cache-control&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;response-content-disposition&quot;</span><span class="p">,</span><span class="s">&quot;response-content-encoding&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-language&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-type&quot;</span><span class="p">,</span><span class="w"> </span>
<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>

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

@ -23,7 +23,7 @@
</td>
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p43210599">Indicates whether the connection to the server is a long connection or a short connection.</p>
<p id="obs_04_0013__p53351077">Type: string</p>
<p id="obs_04_0013__p10397650">Valid values: keep-alive | close</p>
<p id="obs_04_0013__p10397650">Value options: <strong id="obs_04_0013__b11372729122511">keep-alive</strong>, <strong id="obs_04_0013__b14661328256">close</strong></p>
<p id="obs_04_0013__p26469991">Default value: none</p>
</td>
</tr>
@ -47,6 +47,13 @@
<p id="obs_04_0013__p59541652">Default value: none</p>
</td>
</tr>
<tr id="obs_04_0013__row41295227390"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p8684623103914">x-reserved-indicator</p>
</td>
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p4684123183911">A special symbol that helps troubleshoot faults.</p>
<p id="obs_04_0013__p8684182343912">Type: string</p>
<p id="obs_04_0013__p4684142383916">Default value: none</p>
</td>
</tr>
<tr id="obs_04_0013__row66112827"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p53538780">x-obs-request-id</p>
</td>
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p41673925">The value created by OBS to uniquely identify the request. OBS uses this value to troubleshoot faults.</p>

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

@ -6,7 +6,7 @@
</div></div>
<p class="MsoNormal" id="obs_04_0021__p179081185526">A bucket name must be unique in OBS. If a user creates a bucket with the same name as that of an existing bucket under the same account and in the same region, a 200 code (indicating success) is returned. In scenarios other than the preceding one, the request for creating a bucket with the same name as that of an existing one will receive the 409 code (indicating that a namesake bucket already exists). To set an access control policy for the bucket to be created, you can add the <strong id="obs_04_0021__b9296141924716">x-obs-acl</strong> parameter to request headers.</p>
</div>
<div class="section" id="obs_04_0021__section63129189"><h4 class="sectiontitle">Storage Class</h4><p id="obs_04_0021__p1459963215332">You can create buckets with different storage classes. The <strong id="obs_04_0021__b132269815">x-obs-storage-class</strong> header in a bucket creation request specifies the storage class for a bucket. If you do not specify a storage class when you upload an object to the bucket, the object inherits the storage class of the bucket. There are three storage classes: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class) If this header is not in the request, the storage class of the created bucket is Standard.</p>
<div class="section" id="obs_04_0021__section63129189"><h4 class="sectiontitle">Storage Class</h4><p id="obs_04_0021__p1459963215332">You can create buckets with different storage classes. The <strong id="obs_04_0021__b1448635506">x-obs-storage-class</strong> header in a bucket creation request specifies the storage class for a bucket. If you do not specify a storage class when you upload an object to the bucket, the object inherits the storage class of the bucket. There are three storage classes: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class) If this header is not in the request, the storage class of the created bucket is Standard.</p>
<p class="MsoNormal" id="obs_04_0021__p148955">If the storage class of an object is not specified when it is uploaded to a bucket (see <a href="obs_04_0080.html">Uploading Objects - PUT</a>), the object will be stored in the default storage class of the bucket.</p>
<ul id="obs_04_0021__ul12065374"><li id="obs_04_0021__li41479503">OBS Standard features low access latency and high throughput. It is most suitable for storing frequently accessed (multiple times per month) hot files. Potential application scenarios include big data, mobile applications, trending videos, and social media images.</li><li id="obs_04_0021__li13303135113346">OBS Warm storage class is suitable for storing data that is infrequently accessed (less than 12 times a year) yet has quick response requirements. Potential application scenarios include file synchronization or sharing and enterprise backup. It provides the same durability, access latency, and throughput as the Standard storage class but at a lower price. However, the Warm storage class has lower availability than the Standard one.</li><li id="obs_04_0021__li16303751123411">OBS Cold storage class is applicable to archiving rarely-accessed (averagely once a year) data. The application scenarios include data archiving and long-term data retention for backup. The Cold storage class is secure, durable, and inexpensive, which can replace tape libraries. To keep cost low, it may take hours to restore data from the Cold storage class.</li></ul>
</div>
@ -63,7 +63,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p1421505373813">This header grants the read permission to all users under an account. It allows you to list objects in a bucket, list multipart tasks in a bucket, list multi-version objects in a bucket, and obtain bucket metadata.</p>
<p id="obs_04_0021__p10856668">Type: string</p>
<p id="obs_04_0021__p30601150">Example: <strong id="obs_04_0021__b13590105115127">x-obs-grant-read:id=Tenant ID</strong>.</p>
<p id="obs_04_0021__p30601150">Example: <strong id="obs_04_0021__b985615415347">x-obs-grant-read:id=</strong><em id="obs_04_0021__i1613315510341">Tenant ID</em></p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0021__p62774090">No</p>
</td>
@ -72,7 +72,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p12844193894010">This header grants the write permission to all users under an account. Therefore, the users can create, delete, and overwrite all objects in a bucket, and can initialize parts, upload parts, copy parts, merge parts, and cancel multipart upload tasks.</p>
<p id="obs_04_0021__p36695905">Type: string</p>
<p id="obs_04_0021__p61827690">Example: <strong id="obs_04_0021__b146115441312">x-obs-grant-write:id=Tenant ID</strong>.</p>
<p id="obs_04_0021__p61827690">Example: <strong id="obs_04_0021__b167392143415">x-obs-grant-write:id=</strong><em id="obs_04_0021__i103908216345">Tenant ID</em></p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0021__p41986999">No</p>
</td>
@ -81,7 +81,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p20474891">This header grants the ACL read permission to all users under an account. Therefore, the users can read the bucket ACL information.</p>
<p id="obs_04_0021__p50056298">Type: string</p>
<p id="obs_04_0021__p47853499">Example: <strong id="obs_04_0021__b1456118821418">x-obs-grant-read-acp:id=Account ID</strong>.</p>
<p id="obs_04_0021__p47853499">Example: <strong id="obs_04_0021__b1785335673414">x-obs-grant-read-acp:id=</strong><em id="obs_04_0021__i9681658133420">Account ID</em></p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0021__p50928228">No</p>
</td>
@ -90,7 +90,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p45637041">This header grants the ACL write permission to all users under an account. Therefore, the users can modify the ACL of the bucket.</p>
<p id="obs_04_0021__p8080192">Type: string</p>
<p id="obs_04_0021__p5612866">Example: <strong id="obs_04_0021__b5172154085913">x-obs-grant-write-acp:id=Account ID</strong>.</p>
<p id="obs_04_0021__p5612866">Example: <strong id="obs_04_0021__b11210113117350">x-obs-grant-write-acp:id=</strong><em id="obs_04_0021__i1231943243514">Account ID</em></p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0021__p51989040">No</p>
</td>
@ -99,7 +99,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p5876300">This header grants the full control permission to all users under an account.</p>
<p id="obs_04_0021__p52886708">Type: string</p>
<p id="obs_04_0021__p6218329">Example: <strong id="obs_04_0021__b1787814295914">x-obs-grant-full-control:id=Account ID</strong>.</p>
<p id="obs_04_0021__p6218329">Example: <strong id="obs_04_0021__b19783144653510">x-obs-grant-full-control:id=</strong><em id="obs_04_0021__i6767947203517">Account ID</em></p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0021__p33922630">No</p>
</td>
@ -108,7 +108,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p204925228471">This header grants the read permission to all users under an account. By default, the read permission is applied to all objects in the bucket.</p>
<p id="obs_04_0021__p1843514256448">Type: string</p>
<p id="obs_04_0021__p64401625164420">Example: <strong id="obs_04_0021__b4368125865918">x-obs-grant-read-delivered:id=Account ID</strong>.</p>
<p id="obs_04_0021__p64401625164420">Example: <strong id="obs_04_0021__b265817549358">x-obs-grant-read-delivered:id=</strong><em id="obs_04_0021__i1268045593511">Account ID</em></p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0021__p1749314221476">No</p>
</td>
@ -117,7 +117,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p310642510478">This header grants the full control permission to all users under an account. By default, the FULL_CONTROL permission is applied to all objects in the bucket.</p>
<p id="obs_04_0021__p112671441124413">Type: string</p>
<p id="obs_04_0021__p227016412442">Example: <strong id="obs_04_0021__b16227179908">x-obs-grant-full-control-delivered:id=Account ID</strong>.</p>
<p id="obs_04_0021__p227016412442">Example: <strong id="obs_04_0021__b101851226367">x-obs-grant-full-control-delivered:id=</strong><em id="obs_04_0021__i101801536360">Account ID</em></p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0021__p4106182511475">No</p>
</td>

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

@ -2,7 +2,7 @@
<h1 class="topictitle1">Listing Objects in a Bucket</h1>
<div id="body49142923"><div class="section" id="obs_04_0022__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0022__p2379878">This operation lists objects in a bucket. To use this operation, you must have the permission to read the bucket.</p>
<p id="obs_04_0022__p21418904">If you specify only the bucket name in the request URI, for example <strong id="obs_04_0022__b12987115417">GET /BucketName</strong>, OBS returns descriptions for some or all objects (a maximum of 1000 objects) in the bucket. If you also specify one or more parameters among <strong id="obs_04_0022__b476019011422">prefix</strong>, <strong id="obs_04_0022__b156641433424">marker</strong>, <strong id="obs_04_0022__b763014614217">max-keys</strong>, and <strong id="obs_04_0022__b189545125426">delimiter</strong> in the request, OBS returns a list of objects as specified.</p>
<p id="obs_04_0022__p21418904">If you specify only the bucket name in the request, OBS returns descriptions for some or all of the objects (a maximum of 1,000 objects) in the bucket. If you also specify one or more parameters among <strong id="obs_04_0022__b476019011422">prefix</strong>, <strong id="obs_04_0022__b156641433424">marker</strong>, <strong id="obs_04_0022__b763014614217">max-keys</strong>, and <strong id="obs_04_0022__b189545125426">delimiter</strong> in the request, OBS returns a list of objects based on the semantics specified in <a href="#obs_04_0022__table14681180">Table 1</a>.</p>
<p id="obs_04_0022__p71702028165217">You can also add the <strong id="obs_04_0022__b1878613614433">versions</strong> parameter to the request to list multiple versions of an object in a bucket.</p>
</div>
<div class="section" id="obs_04_0022__section57209668"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen56166629"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
@ -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">Sets the maximum number of objects (in alphabetical order) returned in the response body. The value ranges from 1 to 1000. If the value has exceeded the upper limit, 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 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>
<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>
@ -67,6 +67,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0022__p54017354815">Separator used to group object names. If a prefix is specified, objects with the same string from the prefix to the first delimiter are grouped into one <strong id="obs_04_0022__b20945155175712">CommonPrefixes</strong>. If no prefix is specified, objects with the same string from the first character to the first delimiter are grouped into one <strong id="obs_04_0022__b547108125711">CommonPrefixes</strong>.</p>
<p id="obs_04_0022__p1140173114819">For example, there are three objects (<strong id="obs_04_0022__b17596122435716">abcd</strong>, <strong id="obs_04_0022__b388612298570">abcde</strong>, and <strong id="obs_04_0022__b217212335572">bbcde</strong>) in a bucket. If <strong id="obs_04_0022__b14121608584">delimiter</strong> is set to <strong id="obs_04_0022__b13729112145817">d</strong> and <strong id="obs_04_0022__b42663712583">prefix</strong> is set to <strong id="obs_04_0022__b2655191085814">a</strong>, objects <strong id="obs_04_0022__b4106382583">abcd</strong> and <strong id="obs_04_0022__b1937044595817">abcde</strong> are grouped into a <strong id="obs_04_0022__b640611210592">CommonPrefixes</strong> with <strong id="obs_04_0022__b19792231595">abcd</strong> as the prefix. If only <strong id="obs_04_0022__b8385174812013">delimiter</strong> is set to <strong id="obs_04_0022__b11870522019">d</strong>, objects <strong id="obs_04_0022__b26516816216">abcd</strong> and <strong id="obs_04_0022__b6747191116218">abcde</strong> are grouped into a <strong id="obs_04_0022__b81621124824">CommonPrefixes</strong> with <strong id="obs_04_0022__b105054403214">abcd</strong> as the prefix, and <strong id="obs_04_0022__b61471845324">bbcde</strong> is grouped separately into another <strong id="obs_04_0022__b2342149637">CommonPrefixes</strong> with <strong id="obs_04_0022__b1353828332">bbcd</strong> as the prefix.</p>
<p id="obs_04_0022__p1926293982513">For a parallel file system, if this parameter is not specified, all the content in the directory is recursively listed by default, and subdirectories are also listed. In big data scenarios, parallel file systems usually have deep directory levels and each directory has a large number of files. In such case, you are advised to configure <strong id="obs_04_0022__b1874161318585">[delimiter=/]</strong> to list the content in the current directory, but not list subdirectories, thereby improving the listing efficiency.</p>
<p id="obs_04_0022__p440113318486">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0022__p59499450">No</p>
@ -153,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 identify 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, which reflects changes only to the object content, rather than its 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">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>
<p id="obs_04_0022__p19181309">Type: string</p>
<p id="obs_04_0022__p38414053">Ancestor: ListBucketResult.Contents</p>
</td>
@ -167,7 +168,7 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0022__row10182162"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p19448771">ID</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p31846650">Tenant ID of the object owner</p>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p37562196382">Domain ID of the object owner</p>
<p id="obs_04_0022__p18184394">Type: string</p>
<p id="obs_04_0022__p29441820">Ancestor: ListBucketResult.Contents.Owner</p>
</td>
@ -228,18 +229,11 @@ Content-Length:<span class="w"> </span>length
<p id="obs_04_0022__p6613978">Ancestor: ListBucketResult.Contents</p>
</td>
</tr>
<tr id="obs_04_0022__row1212016316301"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p127331524123013">ID</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p57331424143013">Domain ID of the object owner</p>
<p id="obs_04_0022__p4733112483011">Type: string</p>
<p id="obs_04_0022__p10733324173012">Ancestor: ListVersionsResult.Contents.Owner</p>
</td>
</tr>
<tr id="obs_04_0022__row744613713302"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p1173362419303">DisplayName</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p1733724143013">Name of the object owner</p>
<p id="obs_04_0022__p1573312240308">Type: string</p>
<p id="obs_04_0022__p1473382403014">Ancestor: ListVersionsResult.Contents.Owner</p>
<p id="obs_04_0022__p1473382403014">Ancestor: ListBucketResult.Contents.Owner</p>
</td>
</tr>
<tr id="obs_04_0022__row59525802"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p56860664">Prefix</p>
@ -260,7 +254,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p21499466">Storage class of an object</p>
<p id="obs_04_0022__p59277470">Type: string</p>
<p id="obs_04_0022__p63735184">Value options: <strong id="obs_04_0022__b737918316485">STANDARD</strong> | <strong id="obs_04_0022__b235013333486">WARM</strong> | <strong id="obs_04_0022__b2780535164819">COLD</strong></p>
<p id="obs_04_0022__p63735184">Value options: <strong id="obs_04_0022__b737918316485">STANDARD</strong>, <strong id="obs_04_0022__b235013333486">WARM</strong>, <strong id="obs_04_0022__b2780535164819">COLD</strong></p>
<p id="obs_04_0022__p36745745">Ancestor: ListBucketResult.Contents</p>
</td>
</tr>
@ -379,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 identify 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 only to the object content, rather than its 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">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>
<p id="obs_04_0022__p21885083">Type: string</p>
<p id="obs_04_0022__p62748021">Ancestor: ListVersionsResult.Version</p>
</td>
@ -423,6 +417,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p34135322">Storage class of an object</p>
<p id="obs_04_0022__p38782450">Type: string</p>
<p id="obs_04_0022__p983512824220">Value options: <strong id="obs_04_0022__b12126123411481">STANDARD</strong>, <strong id="obs_04_0022__b2012617347481">WARM</strong>, <strong id="obs_04_0022__b10126034184812">COLD</strong></p>
<p id="obs_04_0022__p13497736">Ancestor: ListVersionsResult.Version</p>
</td>
</tr>

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

@ -114,7 +114,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p0556105494415">Indicates that methods in the rule are included in the response if <strong id="obs_04_0023__b436181492320">Access-Control-Request-Method</strong> in the request meets the CORS configuration requirements when CORS is configured for buckets.</p>
<p id="obs_04_0023__p4556155444413">Type: string</p>
<p id="obs_04_0023__p0556105420445">Valid values: <strong id="obs_04_0023__b68424310234">GET</strong>, <strong id="obs_04_0023__b37181497239">PUT</strong>, <strong id="obs_04_0023__b1835105415239">HEAD</strong>, <strong id="obs_04_0023__b124610576238">POST</strong>, and <strong id="obs_04_0023__b85642062415">DELETE</strong>.</p>
<p id="obs_04_0023__p0556105420445">Value options: <strong id="obs_04_0023__b3278848134815">GET</strong>, <strong id="obs_04_0023__b1127814811482">PUT</strong>, <strong id="obs_04_0023__b12278748124818">HEAD</strong>, <strong id="obs_04_0023__b0278348184818">POST</strong>, <strong id="obs_04_0023__b7279348104811">DELETE</strong></p>
</td>
</tr>
<tr id="obs_04_0023__row815121312444"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p2556954194412">Access-Control-Expose-Headers</p>

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

@ -66,6 +66,10 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0064.html">Deleting the Encryption Configuration of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0068.html">Configuring the Requester-Pays Function for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0069.html">Obtaining the Requester-Pays Configuration Information of a Bucket</a></strong><br>
</li>
</ul>
<div class="familylinks">

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

@ -64,7 +64,7 @@ Content-Length:<span class="w"> </span>length
<tbody><tr id="obs_04_0030__row32875587"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0030__p45676910">x-obs-acl</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0030__p8842242">Uses the canned ACL for a bucket.</p>
<p id="obs_04_0030__p45132965">Value options: <strong id="obs_04_0030__b1526321401416">private</strong> | <strong id="obs_04_0030__b13821617161417">public-read</strong> | <strong id="obs_04_0030__b1297122191412">public-read-write</strong> | <strong id="obs_04_0030__b424267141">public-read-delivered</strong> | <strong id="obs_04_0030__b5524531161411">public-read-write-delivered</strong></p>
<p id="obs_04_0030__p45132965">Value options: <strong id="obs_04_0030__b1526321401416">private</strong>, <strong id="obs_04_0030__b13821617161417">public-read</strong>, <strong id="obs_04_0030__b1297122191412">public-read-write</strong>, <strong id="obs_04_0030__b424267141">public-read-delivered</strong>, <strong id="obs_04_0030__b5524531161411">public-read-write-delivered</strong></p>
<p id="obs_04_0030__p12471314">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0030__p31891586">No</p>
@ -137,7 +137,7 @@ Content-Length:<span class="w"> </span>length
<tr id="obs_04_0030__row54046594"><td class="cellrowborder" valign="top" width="35.709999999999994%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0030__p15698002">Permission</p>
</td>
<td class="cellrowborder" valign="top" width="42.86%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0030__p63578630">Permissions to be granted. </p>
<p id="obs_04_0030__p5666973716">Value options: <strong id="obs_04_0030__b1648321412394">READ</strong> | <strong id="obs_04_0030__b16460181711399">READ_ACP</strong> | <strong id="obs_04_0030__b1951127124017">WRITE</strong> | <strong id="obs_04_0030__b18775330174011">WRITE_ACP</strong> | <strong id="obs_04_0030__b5787173211405">FULL_CONTROL</strong></p>
<p id="obs_04_0030__p5666973716">Value options: <strong id="obs_04_0030__b1648321412394">READ</strong>, <strong id="obs_04_0030__b16460181711399">READ_ACP</strong>, <strong id="obs_04_0030__b1951127124017">WRITE</strong>, <strong id="obs_04_0030__b18775330174011">WRITE_ACP</strong>, <strong id="obs_04_0030__b5787173211405">FULL_CONTROL</strong></p>
<p id="obs_04_0030__p49595399">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0030__p57804348">No</p>

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

@ -129,7 +129,7 @@ Authorization:<span class="w"> </span>signatureValue
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.2.4.1.2 "><p id="obs_04_0032__p30134562">Permissions of the grantee to the generated logs.</p>
<p id="obs_04_0032__p2775606">Type: string</p>
<p id="obs_04_0032__p24980457">Value options: <strong id="obs_04_0032__b448684351012">FULL_CONTROL</strong> | <strong id="obs_04_0032__b1370416472108">READ</strong> | <strong id="obs_04_0032__b14818194961010">WRITE</strong></p>
<p id="obs_04_0032__p24980457">Value options: <strong id="obs_04_0032__b448684351012">FULL_CONTROL</strong>, <strong id="obs_04_0032__b1370416472108">READ</strong>, <strong id="obs_04_0032__b14818194961010">WRITE</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.2.2.4.1.3 "><p id="obs_04_0032__p10151128">No</p>
</td>
@ -222,6 +222,7 @@ Authorization:<span class="w"> </span>signatureValue
<td class="cellrowborder" valign="top" width="44%" headers="mcps1.3.8.5.2.4.1.2 "><p id="obs_04_0032__p4171141618312">787f2f92b20943998a4fe2ab75eb09b8</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.8.5.2.4.1.3 "><p id="obs_04_0032__p121711816833">ID of the requester</p>
<ul id="obs_04_0032__ul566619211213"><li id="obs_04_0032__li119910462119">When an account initiates a request, this parameter value is the account ID. When an IAM user initiates a request, this parameter value is the ID of the account where the IAM user belongs.</li><li id="obs_04_0032__li866616215217">When an anonymous user initiates a request, this parameter value is <strong id="obs_04_0032__b164243033918">Anonymous</strong>.</li></ul>
</td>
</tr>
<tr id="obs_04_0032__row1012119381212"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.8.5.2.4.1.1 "><p id="obs_04_0032__p17171181616312">RequestID</p>

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

@ -116,7 +116,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="63.13999999999999%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0033__p34458318">Logging permission granted to the grantee for a bucket. The bucket owner is automatically granted the <strong id="obs_04_0033__b102417277217115">FULL_CONTROL</strong> permission when creating the bucket. Logging permissions control access to different logs.</p>
<p id="obs_04_0033__p41689409">Type: string</p>
<p id="obs_04_0033__p39660365">Value options: <strong id="obs_04_0033__b1534175914301">FULL_CONTROL</strong> | <strong id="obs_04_0033__b1735359153015">READ</strong> | <strong id="obs_04_0033__b153515595304">WRITE</strong></p>
<p id="obs_04_0033__p39660365">Value options: <strong id="obs_04_0033__b582344710491">FULL_CONTROL</strong>, <strong id="obs_04_0033__b78233473497">READ</strong>, <strong id="obs_04_0033__b11823174715490">WRITE</strong></p>
</td>
</tr>
<tr id="obs_04_0033__row55595147"><td class="cellrowborder" valign="top" width="36.86%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0033__p6913047">TargetBucket</p>

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

@ -4,7 +4,7 @@
<div id="body33721912"><div class="section" id="obs_04_0034__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0034__p44290180">This operation configures lifecycle rules that can delete or migrate objects from a bucket at a specified time. Typical application scenarios:</p>
<ul id="obs_04_0034__ul63067307"><li id="obs_04_0034__li35061754">Delete periodically uploaded files. Some files uploaded periodically need only to be retained for only one week or one month.</li><li id="obs_04_0034__li47120336">Delete files that are frequently accessed within a certain period of time but are seldom accessed afterward. You can archive these files and then schedule the time for deletion.</li><li id="obs_04_0034__li49751354242">The minimum time for the transition of the bucket storage to Warm or to Cold can be configured. The value ranges from <strong id="obs_04_0034__b842352706193456">24</strong> to <strong id="obs_04_0034__b84235270619350">8640</strong>.</li></ul>
<p class="msonormal" id="obs_04_0034__p30734851">You can perform this operation to create or update the lifecycle configuration of a bucket.</p>
<div class="note" id="obs_04_0034__note45356040"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_04_0034__ul8398111715918"><li class="text" id="obs_04_0034__li33981517096">Expired objects deleted based on a lifecycle rule cannot be recovered.</li></ul>
<div class="note" id="obs_04_0034__note8824913257"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_04_0034__ul2453192813258"><li id="obs_04_0034__li545313284253">Expired objects deleted based on a lifecycle rule cannot be recovered.</li></ul>
</div></div>
<p class="msonormal" id="obs_04_0034__p8178206">To perform this operation, you must have the <strong id="obs_04_0034__b34476226">PutLifecycleConfiguration</strong> permission. By default, only the bucket owner can perform this operation. The bucket owner can grant the permission to other users by configuring the bucket policy or user policy.</p>
<p class="msonormal" id="obs_04_0034__p6494998">The lifecycle configuration enables OBS to delete objects and transition object storage classes at a scheduled time. To prevent a user from doing so, the following permissions granted to the user must be revoked:</p>
@ -118,12 +118,12 @@ Content-MD5:<span class="w"> </span>MD5
</div>
</div>
<div class="section" id="obs_04_0034__section31237723"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0034__p40760362">In this request, you need to specify the lifecycle configuration in the request body. The lifecycle configuration can be uploaded in the form of an XML file with elements described in <a href="#obs_04_0034__table49391898171726">Table 2</a>.</p>
<ul id="obs_04_0034__ul6251638157"><li class="msonormal" id="obs_04_0034__li18251173817514">If the versioning of a bucket is enabled or suspended, you can set <strong id="obs_04_0034__b93725946316203">NoncurrentVersionTransition</strong> or <strong id="obs_04_0034__b26771811202419">NoncurrentVersionExpiration</strong> to control the lifecycle of historical object versions. The lifecycle of a historical version depends on the time when it becomes a historical one (time when the version is replaced by a new version) and the value of <strong id="obs_04_0034__b32934054202615">NoncurrentDays</strong>. For object deletion, if <strong id="obs_04_0034__b21857385203350">NoncurrentDays</strong> is set to <strong id="obs_04_0034__b62498741203350">1</strong>, an object version will be deleted only after it becomes a historical one for one day. If the version V1 of object A is created on the first date of a month and new version V2 is uploaded on the fifth date of the month, V1 becomes a historical version. At 00:00 on the seventh date of the month, V1 will expire. If an object version does not meet the deletion conditions, but <strong id="obs_04_0034__b242130506162156">NoncurrentDays</strong> is set to <strong id="obs_04_0034__b906228107162156">1</strong> and <strong id="obs_04_0034__b1713824337162156">StorageClass</strong> is set to <strong id="obs_04_0034__b1420938656162156">WARM</strong>, the version transitions to the Warm storage class one day after it has become a historical version. For example, the V1 version of object A is created on the first day of a month, and its new version V2 is uploaded on the fifth day of the month. Then V1 becomes a historical version. One day later, that is, at 0 o'clock of the seventh day, V1 transitions to the Warm storage class. The deletion or transition of the object after the expiration time may be delayed. The delay is within 48 hours.</li><li class="msonormal" id="obs_04_0034__li96774421756">Objects are processed according to the following procedures, if their latest versions meet the expiration rule and versioning is enabled or suspended for the bucket.<ul id="obs_04_0034__ul67026557"><li id="obs_04_0034__li66368102">Versioning enabled:<p id="obs_04_0034__p60442011"><a name="obs_04_0034__li66368102"></a><a name="li66368102"></a>If the latest version of the object does not have the DeleteMarker, the object generates a new DeleteMarker.</p>
<p id="obs_04_0034__p7107187">If the object of the latest version has the DeleteMarker and the object has this version only, this version will be deleted.</p>
<ul id="obs_04_0034__ul6251638157"><li class="msonormal" id="obs_04_0034__li18251173817514">If the versioning of a bucket is enabled or suspended, you can set <strong id="obs_04_0034__b93725946316203">NoncurrentVersionTransition</strong> or <strong id="obs_04_0034__b26771811202419">NoncurrentVersionExpiration</strong> to control the lifecycle of historical object versions. The lifecycle of a historical version depends on the time when it becomes a historical one (time when the version is replaced by a new version) and the value of <strong id="obs_04_0034__b32934054202615">NoncurrentDays</strong>. For object deletion, if <strong id="obs_04_0034__b21857385203350">NoncurrentDays</strong> is set to <strong id="obs_04_0034__b62498741203350">1</strong>, an object version will be deleted only after it becomes a historical one for one day. If the version V1 of object A is created on the first date of a month and new version V2 is uploaded on the fifth date of the month, V1 becomes a historical version. At 00:00 on the seventh date of the month, V1 will expire. If an object version does not meet the deletion conditions, but <strong id="obs_04_0034__b242130506162156">NoncurrentDays</strong> is set to <strong id="obs_04_0034__b906228107162156">1</strong> and <strong id="obs_04_0034__b1713824337162156">StorageClass</strong> is set to <strong id="obs_04_0034__b1420938656162156">WARM</strong>, the version transitions to the Warm storage class one day after it has become a historical version. For example, the V1 version of object A is created on the first day of a month, and its new version V2 is uploaded on the fifth day of the month. Then V1 becomes a historical version. One day later, that is, at 0 o'clock of the seventh day, V1 transitions to the Warm storage class. The deletion or transition of the object after the expiration time may be delayed. The delay is within 48 hours.</li><li class="msonormal" id="obs_04_0034__li96774421756">Objects are processed according to the following procedures, if their latest versions meet the expiration rule and versioning is enabled or suspended for the bucket.<ul id="obs_04_0034__ul67026557"><li id="obs_04_0034__li66368102">Versioning enabled:<p id="obs_04_0034__p60442011"><a name="obs_04_0034__li66368102"></a><a name="li66368102"></a>If the latest object version is not a delete marker, a new delete marker will be inserted for the object.</p>
<p id="obs_04_0034__p5971938173212">If the latest object version is a delete marker and is the only version of the object, this latest version will be deleted.</p>
<p id="obs_04_0034__p63964689">If the object of the latest version has the DeleteMarker and the object has other versions, all versions of the object remain unchanged.</p>
</li><li id="obs_04_0034__li38811293">Versioning suspended:<p id="obs_04_0034__p12126619102710"><a name="obs_04_0034__li38811293"></a><a name="li38811293"></a>If the latest version of the object does not have the DeleteMarker and is not the null version, the object generates a new DeleteMarker for the null version.</p>
<p id="obs_04_0034__p81261119152710">If the latest version of the object does not have the DeleteMarker but is the null version, this null version is overwritten by a new DeleteMarker generated for the null version.</p>
<p id="obs_04_0034__p41266197278">If the object of the latest version has the DeleteMarker and the object has this version only, this version will be deleted.</p>
<p id="obs_04_0034__p41266197278">If the latest object version is a delete marker and is the only version of the object, this latest version will be deleted.</p>
<p id="obs_04_0034__p312681912275">If the object of the latest version has the DeleteMarker and the object has other versions, all versions of the object remain unchanged.</p>
</li></ul>
</li><li class="msonormal" id="obs_04_0034__li49157541956">The following lists the processing when the versioning is enabled or suspended for a bucket and objects of the latest versions meet the transition rules:<ul id="obs_04_0034__ul1312555284313"><li class="msonormal" id="obs_04_0034__li1241419577520">If the latest version of the object has the DeleteMarker, the storage class of this version will not be transitioned.</li><li class="msonormal" id="obs_04_0034__li1240125919514">If the latest version of the object does not have the DeleteMarker and meets the transition rule, the storage class of this version will be transitioned.</li></ul>
@ -139,7 +139,7 @@ Content-MD5:<span class="w"> </span>MD5
</thead>
<tbody><tr id="obs_04_0034__row52405032"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0034__p16949237">Date</p>
</td>
<td class="cellrowborder" valign="top" width="52.53%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0034__p54741087">Specifies that OBS executes lifecycle rules for objects before the specified date. The date must be compliant with the ISO8601 format, and the time must be compliant with the UTC format of 00:00:00. For example: <strong id="obs_04_0034__b112888253374">2018-01-01T00:00:00.000Z</strong>, which indicates that objects whose last modification time is earlier than <strong id="obs_04_0034__b178232214380">2018-01-01T00:00:00.000Z</strong> are deleted or transitioned to other storage classes. Objects whose last modification time is equal to or later than the specified time are not deleted or dumped.</p>
<td class="cellrowborder" valign="top" width="52.53%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0034__p54741087">Specifies that OBS executes lifecycle rules for objects before the specified date. The date must be compliant with the ISO8601 format, and the time must be compliant with the UTC format of 00:00:00. For example, <strong id="obs_04_0034__b112888253374">2018-01-01T00:00:00.000Z</strong> indicates that objects whose last modification time is earlier than <strong id="obs_04_0034__b178232214380">2018-01-01T00:00:00.000Z</strong> are deleted or transitioned to another storage class. Objects whose last modification time is equal to or later than the specified time are not deleted or transitioned to another storage class.</p>
<p id="obs_04_0034__p4558679">Type: string</p>
<p id="obs_04_0034__p41028117">Ancestor node: Expiration, Transition</p>
</td>
@ -159,7 +159,7 @@ Content-MD5:<span class="w"> </span>MD5
</td>
<td class="cellrowborder" valign="top" width="52.53%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0034__p7413148">The storage class to which the object is transitioned.</p>
<p id="obs_04_0034__p311371114214">Type: string</p>
<p id="obs_04_0034__p66718334">Value options: <strong id="obs_04_0034__b32941757878">WARM</strong> or <strong id="obs_04_0034__b1229919570717">COLD</strong></p>
<p id="obs_04_0034__p66718334">Value options: <strong id="obs_04_0034__b32941757878">WARM</strong>, <strong id="obs_04_0034__b1229919570717">COLD</strong></p>
<p id="obs_04_0034__p63594101">Ancestor node: Transition, NoncurrentVersionTransition</p>
</td>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p50848555">Required if the <strong id="obs_04_0034__b84235270695824">Transition</strong> or <strong id="obs_04_0034__b84235270695830">NoncurrentVersionTransition</strong> element is present.</p>
@ -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__b1052720015">Transition</strong>, <strong id="obs_04_0034__b2077837494">Expiration</strong>, <strong id="obs_04_0034__b187701445812">AbortIncompleteMultipartUpload</strong>, or <strong id="obs_04_0034__b2021471685">NoncurrentVersionExpiration</strong> element is absent.</p>
<td 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>
</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>
@ -279,7 +279,7 @@ Content-MD5:<span class="w"> </span>MD5
<td class="cellrowborder" valign="top" width="52.53%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0034__p16813124">Indicates whether the rule is enabled.</p>
<p id="obs_04_0034__p17100391">Type: string</p>
<p id="obs_04_0034__p19685798">Ancestor node: Rule</p>
<p id="obs_04_0034__p42954456">Value options: Enabled, Disabled</p>
<p id="obs_04_0034__p42954456">Value options: <strong id="obs_04_0034__b42412451399">Enabled</strong>, <strong id="obs_04_0034__b1153509398">Disabled</strong></p>
</td>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p56758950">Yes</p>
</td>

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

@ -114,7 +114,7 @@ Content-Length:<span class="w"> </span>length
</thead>
<tbody><tr id="obs_04_0035__row43172404"><td class="cellrowborder" valign="top" width="37.37373737373738%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0035__p7303851">Date</p>
</td>
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p54741087">Specifies that OBS executes lifecycle rules for objects before the specified date. The date must be compliant with the ISO8601 format, and the time must be compliant with the UTC format of 00:00:00. For example: <strong id="obs_04_0035__b626951513428">2018-01-01T00:00:00.000Z</strong>, which indicates that objects whose last modification time is earlier than <strong id="obs_04_0035__b11270111594219">2018-01-01T00:00:00.000Z</strong> are deleted or transitioned to other storage classes. Objects whose last modification time is equal to or later than the specified time are not deleted or dumped.</p>
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p54741087">Specifies that OBS executes lifecycle rules for objects before the specified date. The date must be compliant with the ISO8601 format, and the time must be compliant with the UTC format of 00:00:00. For example, <strong id="obs_04_0035__b1054220371462">2018-01-01T00:00:00.000Z</strong> indicates that objects whose last modification time is earlier than <strong id="obs_04_0035__b14542637134618">2018-01-01T00:00:00.000Z</strong> are deleted or transitioned to another storage class. Objects whose last modification time is equal to or later than the specified time are not deleted or transitioned to another storage class.</p>
<p id="obs_04_0035__p4843063">Type: string</p>
<p id="obs_04_0035__p43587572">Ancestor node: Expiration, Transition</p>
</td>
@ -130,7 +130,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p4781631">The storage class to which the object is transitioned.</p>
<p id="obs_04_0035__p25018184358">Type: string</p>
<p id="obs_04_0035__p43034686">Value options: <strong id="obs_04_0035__b1854883933612">WARM</strong> or <strong id="obs_04_0035__b15549439143616">COLD</strong></p>
<p id="obs_04_0035__p43034686">Value options: <strong id="obs_04_0035__b1854883933612">WARM</strong>, <strong id="obs_04_0035__b15549439143616">COLD</strong></p>
<p id="obs_04_0035__p51767860">Ancestor node: Transition, NoncurrentVersionTransition</p>
</td>
</tr>
@ -222,7 +222,7 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p28211173">Indicates whether the rule is enabled.</p>
<p id="obs_04_0035__p52573969">Type: string</p>
<p id="obs_04_0035__p3403680">Ancestor node: Rule</p>
<p id="obs_04_0035__p30633121">Value options: Enabled, Disabled</p>
<p id="obs_04_0035__p30633121">Value options: <strong id="obs_04_0035__b8941043174215">Enabled</strong>, <strong id="obs_04_0035__b18941543134210">Disabled</strong></p>
</td>
</tr>
</tbody>

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

@ -59,7 +59,7 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0037__p65186226">Versioning status of the bucket</p>
<p id="obs_04_0037__p49805123">Type: string</p>
<p id="obs_04_0037__p45592923">Ancestor node: VersioningConfiguration</p>
<p id="obs_04_0037__p7683123">Value options: Enabled, Suspended</p>
<p id="obs_04_0037__p7683123">Value options: <strong id="obs_04_0037__b206919482429">Enabled</strong>, <strong id="obs_04_0037__b14585013428">Suspended</strong></p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0037__p18353199">Yes</p>
</td>

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

@ -60,7 +60,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="67.55%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0038__p58840153">Versioning status of the bucket.</p>
<p id="obs_04_0038__p59799329">Type: string</p>
<p id="obs_04_0038__p1323052">Value options: Enabled, Suspended</p>
<p id="obs_04_0038__p1323052">Value options: <strong id="obs_04_0038__b45363548424">Enabled</strong>, <strong id="obs_04_0038__b732105612426">Suspended</strong></p>
</td>
</tr>
</tbody>

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

@ -166,7 +166,7 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0039__p42147386">Prefix or suffix of object names for filtering</p>
<p id="obs_04_0039__p43782157">Type: string</p>
<p id="obs_04_0039__p58495099">Ancestor: FilterRule</p>
<p id="obs_04_0039__p56693843">Value options: prefix, suffix</p>
<p id="obs_04_0039__p56693843">Value options: <strong id="obs_04_0039__b143401605433">prefix</strong>, <strong id="obs_04_0039__b167221015432">suffix</strong></p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0039__p28798577">No</p>
</td>

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

@ -146,7 +146,7 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0040__p20211205">Prefix or suffix of object names for filtering</p>
<p id="obs_04_0040__p47683118">Type: string</p>
<p id="obs_04_0040__p26494883">Ancestor: FilterRule</p>
<p id="obs_04_0040__p37127355">Value options: prefix, suffix</p>
<p id="obs_04_0040__p37127355">Value options: <strong id="obs_04_0040__b11186158104320">prefix</strong>, <strong id="obs_04_0040__b1484210917432">suffix</strong></p>
</td>
</tr>
<tr id="obs_04_0040__row65710745"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0040__p20970128">Value</p>

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

@ -45,7 +45,7 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>
</td>
<td class="cellrowborder" valign="top" width="51%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0044__p23397285">Specifies the default storage class for a bucket.</p>
<p id="obs_04_0044__p4701910132510">Type: string</p>
<p id="obs_04_0044__p78072113256">Value options: STANDARD | WARM | COLD</p>
<p id="obs_04_0044__p78072113256">Value options: <strong id="obs_04_0044__b11157171664314">STANDARD</strong>, <strong id="obs_04_0044__b7160122504318">WARM</strong>, <strong id="obs_04_0044__b1099115294433">COLD</strong></p>
<p id="obs_04_0044__p15884183444011">The available storage classes include Standard (<strong id="obs_04_0044__b116747265409">STANDARD</strong>), Warm (<strong id="obs_04_0044__b13777134919406">WARM</strong>), and Cold (<strong id="obs_04_0044__b0223652194012">COLD</strong>).</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0044__p10969390">Yes</p>

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

@ -167,7 +167,7 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0046__p1922710">Storage class of an object</p>
<p id="obs_04_0046__p17304395">Type: string</p>
<p id="obs_04_0046__p21521828">Ancestor: Destination</p>
<p id="obs_04_0046__p59478732">Value options: STANDARD | WARM | COLD</p>
<p id="obs_04_0046__p59478732">Value options: <strong id="obs_04_0046__b7444154194311">STANDARD</strong>, <strong id="obs_04_0046__b188291448194315">WARM</strong>, <strong id="obs_04_0046__b16593852144314">COLD</strong></p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0046__p53048019">No</p>
</td>

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

@ -108,7 +108,7 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p49170108">If the value of this element is <strong id="obs_04_0047__b842352706112931">Disabled</strong>, this rule will be ignored.</p>
<p id="obs_04_0047__p39877789">Type: string</p>
<p id="obs_04_0047__p23355781">Ancestor: Rule</p>
<p id="obs_04_0047__p8875437">Value options: <strong id="obs_04_0047__b032315311200">Enabled</strong> and <strong id="obs_04_0047__b103247532209">Disabled</strong></p>
<p id="obs_04_0047__p8875437">Value options: <strong id="obs_04_0047__b032315311200">Enabled</strong>, <strong id="obs_04_0047__b103247532209">Disabled</strong></p>
</td>
</tr>
<tr id="obs_04_0047__row27742744"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p32569778">Prefix</p>
@ -139,7 +139,7 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
<td class="cellrowborder" valign="top" width="68.05%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0047__p9984849">Storage class of an object.</p>
<p id="obs_04_0047__p22754781">Type: string</p>
<p id="obs_04_0047__p3466439">Ancestor: Destination</p>
<p id="obs_04_0047__p31197952">Value options: <strong id="obs_04_0047__b416355913393">STANDARD</strong> | <strong id="obs_04_0047__b89857124012">WARM</strong> | <strong id="obs_04_0047__b108221848401">COLD</strong></p>
<p id="obs_04_0047__p31197952">Value options: <strong id="obs_04_0047__b416355913393">STANDARD</strong>, <strong id="obs_04_0047__b89857124012">WARM</strong>, <strong id="obs_04_0047__b108221848401">COLD</strong></p>
</td>
</tr>
<tr id="obs_04_0047__row259515810296"><td class="cellrowborder" valign="top" width="31.95%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0047__p1011725114611">DeleteData</p>

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

@ -2,7 +2,7 @@
<h1 class="topictitle1">Deleting Tags</h1>
<div id="body1522727142744"><div class="section" id="obs_04_0051__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0051__p38705345481">This operation deletes the tags of a bucket.</p>
<p id="obs_04_0051__p8870123474818">To perform this operation, you must have the <strong id="obs_04_0051__b1369575492116">PutBucketTagging</strong> permission. By default, only the bucket owner can delete the tags of a bucket. The bucket owner can allow other users to perform this operation by setting a bucket policy or granting them the permission.</p>
<p id="obs_04_0051__p8870123474818">To perform this operation, you must have the <strong id="obs_04_0051__b1369575492116">DeleteBucketTagging</strong> permission. By default, only the bucket owner can delete the tags of a bucket. The bucket owner can allow other users to perform this operation by setting a bucket policy or granting them the permission.</p>
</div>
<div class="section" id="obs_04_0051__section45065450485"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0051__screen3610323119435"><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_0053.html
View File

@ -1,7 +1,7 @@
<a name="obs_04_0053"></a><a name="obs_04_0053"></a>
<h1 class="topictitle1">Querying Bucket Storage Quota</h1>
<div id="body7940910"><div class="section" id="obs_04_0053__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0053__p12427570">Only the bucket owner can query information about the bucket storage quota. However, an inactive owner is not allowed to get the bucket quota. The bucket storage quota is measured by byte. <strong id="obs_04_0053__b193051652122919">0</strong> indicates that no upper limit is set.</p>
<div id="body7940910"><div class="section" id="obs_04_0053__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0053__p12427570">A bucket owner can query the bucket storage quota, but a bucket owner who is frozen due to arrears cannot. The bucket storage quota is measured by byte. <strong id="obs_04_0053__b193051652122919">0</strong> indicates that no upper limit is set.</p>
</div>
<div class="section" id="obs_04_0053__section44739271"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0053__screen39233970"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>

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

@ -90,7 +90,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p74952488427">Server-side encryption algorithm used for the default encryption configuration of a bucket.</p>
<p id="obs_04_0062__p1349514814423">Type: string</p>
<p id="obs_04_0062__p149512481428">Valid values: <strong id="obs_04_0062__b394583095618">kms</strong></p>
<p id="obs_04_0062__p149512481428">Value options: <strong id="obs_04_0062__b394583095618">kms</strong></p>
<p id="obs_04_0062__p1089135793715">Ancestor: ApplyServerSideEncryptionByDefault</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0062__p18495154864216">Yes</p>
@ -101,7 +101,7 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p19616854174215">Customer master key (CMK) used in SSE-KMS encryption mode. If you do not specify this header, the default master key will be used.</p>
<p id="obs_04_0062__p7616135414424">Type: string</p>
<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__i1860613405">regionID:domainID (account ID)</em>:key/<em id="obs_04_0062__i143414910018">key_id</em></li><li id="obs_04_0062__li1216183134518">key_id</li></ol>
<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>
<p id="obs_04_0062__p2616105415423">Ancestor: ApplyServerSideEncryptionByDefault</p>
@ -113,7 +113,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p19849131082815">ID of the project to which the KMS master key belongs in the SSE-KMS mode.</p>
<p id="obs_04_0062__p198201472915">Type: string</p>
<p id="obs_04_0062__p1232921112811">Valid values:</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>
</td>

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

@ -100,7 +100,7 @@ Date:<span class="w"> </span>date<span class="w"> </span>
</td>
<td class="cellrowborder" valign="top" width="60.650000000000006%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0063__p74952488427">The server-side encryption algorithm used for encryption configuration of a bucket.</p>
<p id="obs_04_0063__p1543373514489">Type: string</p>
<p id="obs_04_0063__p1349514814423">Valid value: <strong id="obs_04_0063__b7731144973819">kms</strong></p>
<p id="obs_04_0063__p1349514814423">Value options: <strong id="obs_04_0063__b7731144973819">kms</strong></p>
<p id="obs_04_0063__p1089135793715">Ancestor: ApplyServerSideEncryptionByDefault</p>
</td>
</tr>

128
docs/obs/api-ref/obs_04_0068.html Normal file
View File

File diff suppressed because it is too large Load Diff

125
docs/obs/api-ref/obs_04_0069.html Normal file
View File

File diff suppressed because it is too large Load Diff

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

@ -207,7 +207,7 @@ Authorization:<span class="w"> </span>authorization
<td class="cellrowborder" valign="top" width="55.1%" headers="mcps1.3.5.4.1.2.2.4.1.2 "><p id="obs_04_0071__p43564450">Protocol used in the redirection request</p>
<p id="obs_04_0071__p56535736">Type: string</p>
<p id="obs_04_0071__p39059577">Ancestor: Redirect</p>
<p id="obs_04_0071__p15991880">Value options: http, https</p>
<p id="obs_04_0071__p15991880">Value options: <strong id="obs_04_0071__b4635163804611">http</strong>, <strong id="obs_04_0071__b20355640104613">https</strong></p>
<p id="obs_04_0071__p9709197">Condition: Not required if one of the siblings is present.</p>
</td>
<td class="cellrowborder" valign="top" width="7.140000000000001%" headers="mcps1.3.5.4.1.2.2.4.1.3 "><p id="obs_04_0071__p48247493">No</p>

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

@ -110,7 +110,7 @@ Content-MD5:<span class="w"> </span>MD5
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0074__p51212956">Method allowed by a CORS rule</p>
<p id="obs_04_0074__p58263423">Type: string</p>
<p id="obs_04_0074__p54608766">Possible values are GET, PUT, HEAD, POST, and DELETE. </p>
<p id="obs_04_0074__p54608766">Value options: <strong id="obs_04_0074__b106990448468">GET</strong>, <strong id="obs_04_0074__b18699444164619">PUT</strong>, <strong id="obs_04_0074__b5699244124617">HEAD</strong>, <strong id="obs_04_0074__b11700134454613">POST</strong>, <strong id="obs_04_0074__b37007441466">DELETE</strong></p>
<p id="obs_04_0074__p21716848">Ancestor: CORSRule</p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0074__p14234302">Yes</p>

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

@ -81,7 +81,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0075__p22971514">Method allowed by a CORS rule.</p>
<p id="obs_04_0075__p5417036">Type: string</p>
<p id="obs_04_0075__p48753330">Possible values are GET, PUT, HEAD, POST, and DELETE. </p>
<p id="obs_04_0075__p48753330">Value options: <strong id="obs_04_0075__b891450164614">GET</strong>, <strong id="obs_04_0075__b179145074616">PUT</strong>, <strong id="obs_04_0075__b1791195016469">HEAD</strong>, <strong id="obs_04_0075__b1291185010460">POST</strong>, <strong id="obs_04_0075__b991135004614">DELETE</strong></p>
<p id="obs_04_0075__p36126787">Ancestor: CORSRule</p>
</td>
</tr>

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

@ -48,7 +48,7 @@ Access-Control-Request-Method:<span class="w"> </span>method
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0077__p16180416">An HTTP method that can be used by a request. The request can use multiple method headers.</p>
<p id="obs_04_0077__p11406019">Type: string</p>
<p id="obs_04_0077__p35545309">Possible values are GET, PUT, HEAD, POST, and DELETE. </p>
<p id="obs_04_0077__p35545309">Value options: <strong id="obs_04_0077__b6532175719460">GET</strong>, <strong id="obs_04_0077__b1753255794620">PUT</strong>, <strong id="obs_04_0077__b1053335754613">HEAD</strong>, <strong id="obs_04_0077__b155331157194620">POST</strong>, <strong id="obs_04_0077__b4533105714612">DELETE</strong></p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0077__p60597762">Yes</p>
</td>
@ -118,7 +118,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0077__p46037149">If the Access-Control-Request-Method of a request meets server CORS configuration requirements, the response contains the methods in the rule.</p>
<p id="obs_04_0077__p11681162">Type: string</p>
<p id="obs_04_0077__p38021595">Possible values are GET, PUT, HEAD, POST, and DELETE. </p>
<p id="obs_04_0077__p38021595">Value options: <strong id="obs_04_0077__b33331911474">GET</strong>, <strong id="obs_04_0077__b173344134717">PUT</strong>, <strong id="obs_04_0077__b83344112477">HEAD</strong>, <strong id="obs_04_0077__b1033419114476">POST</strong>, <strong id="obs_04_0077__b133348114719">DELETE</strong></p>
</td>
</tr>
<tr id="obs_04_0077__row6650043"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0077__p1782642">Access-Control-Expose-Headers</p>

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

@ -46,7 +46,7 @@ Access-Control-Request-Method:<span class="w"> </span>method
</td>
<td class="cellrowborder" valign="top" width="63.26530612244898%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0078__p14531029">Indicates an HTTP method that can be used by a request. The request can use multiple method headers.</p>
<p id="obs_04_0078__p63670405">Type: string</p>
<p id="obs_04_0078__p36162737">Valid values: <strong id="obs_04_0078__b2404182382918">GET</strong>, <strong id="obs_04_0078__b114901525132914">PUT</strong>, <strong id="obs_04_0078__b6599172820290">HEAD</strong>, <strong id="obs_04_0078__b1515430112913">POST</strong>, and <strong id="obs_04_0078__b1743620344297">DELETE</strong>. </p>
<p id="obs_04_0078__p36162737">Value options: <strong id="obs_04_0078__b19485194711">GET</strong>, <strong id="obs_04_0078__b8465104712">PUT</strong>, <strong id="obs_04_0078__b174115144713">HEAD</strong>, <strong id="obs_04_0078__b44151475">POST</strong>, <strong id="obs_04_0078__b185145104714">DELETE</strong></p>
</td>
<td class="cellrowborder" valign="top" width="17.346938775510203%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0078__p43500552">Yes</p>
</td>
@ -116,7 +116,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="71.71717171717171%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0078__p22156577">If the Access-Control-Request-Method of a request meets server CORS configuration requirements, the response contains the methods in the rule.</p>
<p id="obs_04_0078__p65191466">Type: string</p>
<p id="obs_04_0078__p49852287">Possible values are GET, PUT, HEAD, POST, and DELETE. </p>
<p id="obs_04_0078__p49852287">Value options: <strong id="obs_04_0078__b1094813794714">GET</strong>, <strong id="obs_04_0078__b99492717477">PUT</strong>, <strong id="obs_04_0078__b199498724715">HEAD</strong>, <strong id="obs_04_0078__b294911719471">POST</strong>, <strong id="obs_04_0078__b194915720473">DELETE</strong></p>
</td>
</tr>
<tr id="obs_04_0078__row46017399"><td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0078__p36421857">Access-Control-Expose-Headers</p>

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

@ -1,7 +1,7 @@
<a name="obs_04_0080"></a><a name="obs_04_0080"></a>
<h1 class="topictitle1">Uploading Objects - PUT</h1>
<div id="body25727187"><div class="section" id="obs_04_0080__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0080__p57130901">After bucket creation in OBS, you can use this operation to upload an object to the bucket. Uploading an object adds it to a bucket. This requires users to have the write operation.</p>
<div id="body25727187"><div class="section" id="obs_04_0080__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0080__p57130901">After bucket creation in OBS, you can use this operation to upload an object to the bucket. This operation uploads an object to a bucket. To use this operation, you must have the write permission on the bucket.</p>
<div class="note" id="obs_04_0080__note44416069"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="obs_04_0080__p30218092">The name of each object in a bucket must be unique.</p>
</div></div>
<p class="msonormal" id="obs_04_0080__p148472556134">With versioning not enabled, if an object to be uploaded has the same name as an existing object in the bucket, the newly uploaded object will overwrite the existing one. To protect data from being corrupted during transmission, you can add the <strong id="obs_04_0080__b736611115814">Content-MD5</strong> parameter in the request header. After receiving the request, OBS will perform an MD5 consistency check. If the two MD5 values are inconsistent, the system returns an error message.</p>
@ -72,7 +72,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row176201754161817"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0080__p54102201376">x-obs-grant-read</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p1041152010375">When creating an object, you can use this header to authorize all users in an account the permission to read objects and obtain object metadata.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p1041152010375">When creating an object, you can use this header to grant all users in an account the permissions to read objects and obtain object metadata.</p>
<p id="obs_04_0080__p036992924111">Type: string</p>
<p id="obs_04_0080__p1245415214403">Example: <strong id="obs_04_0080__b12371913312">x-obs-grant-read: id=domainID</strong>. If multiple accounts are authorized, separate them with commas (,).</p>
</td>
@ -81,7 +81,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row1852810319198"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0080__p2784192993712">x-obs-grant-read-acp</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p6913194219811">When creating an object, you can use this header to authorize all users in an account the permission to obtain the object ACL.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p6913194219811">When creating an object, you can use this header to grant all users in an account the permissions to obtain the object ACL.</p>
<p id="obs_04_0080__p49151332194119">Type: string</p>
<p id="obs_04_0080__p19223133034117">Example: <strong id="obs_04_0080__b3858353414">x-obs-grant-read-acp: id=domainID</strong>. If multiple accounts are authorized, separate them with commas (,).</p>
</td>
@ -90,7 +90,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row1337219031911"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0080__p4151526163710">x-obs-grant-write-acp</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p94031856283">When creating an object, you can use this header to authorize all users in an account the permission to write the object ACL.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p94031856283">When creating an object, you can use this header to grant all users in an account the permission to write the object ACL.</p>
<p id="obs_04_0080__p79212366417">Type: string</p>
<p id="obs_04_0080__p95921443104120">Example: <strong id="obs_04_0080__b1094520314417">x-obs-grant-write-acp: id=domainID</strong>. If multiple accounts are authorized, separate them with commas (,).</p>
</td>
@ -99,7 +99,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row10662185731812"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0080__p3389132314376">x-obs-grant-full-control</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p1914315101898">When creating an object, you can use this header to authorize all users in an account the permission to read the object, obtain the object metadata, obtain the object ACL, and write the object ACL.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p1914315101898">When creating an object, you can use this header to grant all users in an account the permissions to read the object, obtain the object metadata, obtain the object ACL, and write the object ACL.</p>
<p id="obs_04_0080__p1284513399419">Type: string</p>
<p id="obs_04_0080__p428421618431">Example: <strong id="obs_04_0080__b139941255948">x-obs-grant-full-control: id=domainID</strong>. If multiple accounts are authorized, separate them with commas (,).</p>
</td>
@ -118,9 +118,10 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row9474686"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0080__p29252105">x-obs-meta-*</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p20610280">When creating an object, you can use a header starting with <strong id="obs_04_0080__b14342076819330">x-obs-meta-</strong> to define object metadata in an HTTP request. Custom metadata will be returned in the response header when you retrieve or query the metadata of the object. </p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p20610280">When creating an object, you can use a header starting with <strong id="obs_04_0080__b14342076819330">x-obs-meta-</strong> to define object metadata in an HTTP request. The user-defined metadata will be returned in the response when you retrieve the object or query the object metadata. </p>
<p id="obs_04_0080__p51274795">Type: string</p>
<p id="obs_04_0080__p58819972">Example: <strong id="obs_04_0080__b540181244618">x-obs-meta-test: test metadata</strong></p>
<p id="obs_04_0080__p172151945102012">Constraint: Both user-defined metadata keys and their values must conform to US-ASCII standards.</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0080__p66797252">No</p>
</td>
@ -150,7 +151,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row58960965"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0080__p11108823">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p27399486">Master key ID. This header is used in SSE-KMS mode. If the customer does not provide the master key ID, the default master key ID will be used.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p27399486">Master key ID. This header is used in SSE-KMS mode. If the customer does not provide the master key ID, the default master key ID will be used. If there is no such a default master key, the system will create one and use it by default.</p>
<p id="obs_04_0080__p45268789">Type: string</p>
<p id="obs_04_0080__p6679135313114">The following two formats are supported:</p>
<p id="obs_04_0080__p486340133414">1. <em id="obs_04_0080__i121978588519">regionID</em><strong id="obs_04_0080__b101976586515">:</strong><em id="obs_04_0080__i41971458459">domainID</em><strong id="obs_04_0080__b21981958858">:key/</strong><em id="obs_04_0080__i219811583520">key_id</em></p>
@ -204,8 +205,8 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row121411077571"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0080__p1514215711573">x-obs-expires</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p038312375711">Indicates the expiration time of an object, in days. An object will be automatically deleted once it expires (calculated from the last modification time of the object).</p>
<p id="obs_04_0080__p72445358436">This field can be configured only when an object is uploaded and cannot be modified through the metadata modification API.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0080__p038312375711">Specifies when an object expires. It is measured in days. An object will be automatically deleted once it expires. (The validity calculates from the object's creation time.)</p>
<p id="obs_04_0080__p72445358436">You can configure this field when uploading an object or modify this field by using the metadata modification API after the object is uploaded.</p>
<p id="obs_04_0080__p133831235577">Type: integer</p>
<p id="obs_04_0080__p638302312574">Example: <strong id="obs_04_0080__b168957229472">x-obs-expires:3</strong></p>
</td>

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

File diff suppressed because it is too large Load Diff

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

@ -97,7 +97,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0082__p36076142">Indicates names of the source bucket and the source object. If the source object has multiple versions, the versionId parameter can be used to specify the desired version.</p>
<p id="obs_04_0082__p56249824">Type: string</p>
<p id="obs_04_0082__p1619935102619">Constraint: URL encoding is required for handling Chinese characters.</p>
<p id="obs_04_0082__p1619935102619">Constraint: URL encoding is required for handling Chinese characters and %.</p>
<p id="obs_04_0082__p36486376">Example: <strong id="obs_04_0082__b1381171354917">x-obs-copy-source: /source_bucket/sourceObject</strong></p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.6.3.2.4.1.3 "><p id="obs_04_0082__p2606499">Yes</p>
@ -184,7 +184,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0082__row48218161"><td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.6.3.2.4.1.1 "><p id="obs_04_0082__p13357001">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0082__p8175281">Indicates the master key ID of an encrypted object. This header is used in SSE-KMS mode. If the customer does not provide the master key ID, the default master key ID will be used.</p>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0082__p8175281">Indicates the master key ID of an encrypted object. This header is used in SSE-KMS mode. If the customer does not provide the master key ID, the default master key ID will be used. If there is no such a default master key, the system will create one and use it by default.</p>
<p id="obs_04_0082__p6468666">Type: string</p>
<p id="obs_04_0082__p6679135313114">The following two formats are supported:</p>
<p id="obs_04_0082__p48363114420">1. <em id="obs_04_0082__i86713151612">regionID</em><strong id="obs_04_0082__b973415868">:</strong><em id="obs_04_0082__i37314151611">domainID</em><strong id="obs_04_0082__b77416159616">:key/</strong><em id="obs_04_0082__i274101515616">key_id</em></p>

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

@ -100,7 +100,7 @@ Range:bytes=byte_range<span class="w"> </span>
</tr>
<tr id="obs_04_0083__row3210135204916"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p021018529498">attname</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p1612114765018">Rewrites the <strong id="obs_04_0083__b1910342571">Content-Disposition</strong> header in the response.</p>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p1612114765018">Rewrites the <strong id="obs_04_0083__b28938014">Content-Disposition</strong> header in the response.</p>
<p id="obs_04_0083__p1612197195017">Type: string</p>
<p id="obs_04_0083__p20472268503">Example:</p>
<p id="obs_04_0083__p11253017500">attname=name1</p>
@ -251,7 +251,7 @@ Last-Modified:<span class="w"> </span>time<span class="w"> </span>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p31260906">Indicates whether an object is a deletion marker. If the object is not marked as deleted, the response does not contain this header.</p>
<p id="obs_04_0083__p12912703">Type: boolean</p>
<p id="obs_04_0083__p49105468">Valid values: <strong id="obs_04_0083__b59967403164459">true</strong> or <strong id="obs_04_0083__b263109916453">false</strong></p>
<p id="obs_04_0083__p49105468">Value options: <strong id="obs_04_0083__b20420112232417">true</strong>, <strong id="obs_04_0083__b842012202416">false</strong></p>
<p id="obs_04_0083__p39296035">The default value is <strong id="obs_04_0083__b84235270618335">false</strong>.</p>
</td>
</tr>

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

@ -167,7 +167,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__p55615860">Indicates that methods in the rule are included in the response if Access-Control-Request-Method in the request meets the CORS configuration requirements when CORS is configured for buckets.</p>
<p id="obs_04_0084__p30780694">Type: string</p>
<p id="obs_04_0084__p8590796">Possible values are GET, PUT, HEAD, POST, and DELETE. </p>
<p id="obs_04_0084__p8590796">Value options: <strong id="obs_04_0084__b339612352471">GET</strong>, <strong id="obs_04_0084__b3396193514478">PUT</strong>, <strong id="obs_04_0084__b8396183544716">HEAD</strong>, <strong id="obs_04_0084__b239733514475">POST</strong>, <strong id="obs_04_0084__b173972356475">DELETE</strong></p>
</td>
</tr>
<tr id="obs_04_0084__row10208301"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.8.4.2.3.1.1 "><p id="obs_04_0084__p21566081">Access-Control-Expose-Headers</p>

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

@ -65,7 +65,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.8.4.2.3.1.2 "><p id="obs_04_0085__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">Valid values: <strong id="obs_04_0085__b59967403164459">true</strong> or <strong id="obs_04_0085__b263109916453">false</strong></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>

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

@ -135,7 +135,7 @@ Authorization:<span class="w"> </span>authorization
<tr id="obs_04_0089__row34127147"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.6.3.2.4.1.1 "><p id="obs_04_0089__p12835559">Permission</p>
</td>
<td class="cellrowborder" valign="top" width="41.839999999999996%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0089__p33047326">Authorized permission.</p>
<p id="obs_04_0089__p189461810103910">Value options: <strong id="obs_04_0089__b53722408526">READ</strong> | <strong id="obs_04_0089__b337354012524">READ_ACP</strong> | <strong id="obs_04_0089__b23751740145215">WRITE_ACP</strong> | <strong id="obs_04_0089__b13375124005210">FULL_CONTROL</strong></p>
<p id="obs_04_0089__p189461810103910">Value options: <strong id="obs_04_0089__b53722408526">READ</strong>, <strong id="obs_04_0089__b337354012524">READ_ACP</strong>, <strong id="obs_04_0089__b23751740145215">WRITE_ACP</strong>, <strong id="obs_04_0089__b13375124005210">FULL_CONTROL</strong></p>
<p id="obs_04_0089__p28990484">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="32.65%" headers="mcps1.3.6.3.2.4.1.3 "><p id="obs_04_0089__p66527890">No</p>

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

@ -49,7 +49,7 @@ Authorization:<span class="w"> </span>authorization
</thead>
<tbody><tr id="obs_04_0098__row14322183543119"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0098__p26969841">x-obs-acl</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p10531275155">When initializing a multipart upload task, you can add this message header to set the permission control policy for the object. The predefined common policies are as follows: <strong id="obs_04_0098__b10316226175712">private</strong>, <strong id="obs_04_0098__b136446312572">public-read</strong>, and <strong id="obs_04_0098__b10892443115710">public-read-write</strong>.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p10531275155">When initiating a multipart upload, you can add this message header to set the permission control policy for the object. The predefined common policies are as follows: <strong id="obs_04_0098__b10316226175712">private</strong>, <strong id="obs_04_0098__b136446312572">public-read</strong>, and <strong id="obs_04_0098__b10892443115710">public-read-write</strong>.</p>
<p id="obs_04_0098__p50162129">Type: string</p>
<p id="obs_04_0098__p48805985">Note: This header is a predefined policy expressed in a character string.</p>
<p id="obs_04_0098__p587119293244">Example: <strong id="obs_04_0098__b723111593712">x-obs-acl: public-read-write</strong></p>
@ -59,7 +59,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row876819301311"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0098__p54102201376">x-obs-grant-read</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p1041152010375">When initializing a multipart upload task, you can use this header to authorize all users in an account to read the object and obtain the object metadata.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p1041152010375">When initiating a multipart upload, you can use this header to authorize all users in an account to read the object and obtain the object metadata.</p>
<p id="obs_04_0098__p036992924111">Type: string</p>
<p id="obs_04_0098__p253019115249">Example: <strong id="obs_04_0098__b7372195219362">x-obs-grant-read: ID=domainID</strong> If multiple accounts are authorized, separate them with commas (,).</p>
</td>
@ -68,7 +68,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row53481428173115"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0098__p2784192993712">x-obs-grant-read-acp</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p6913194219811">When initializing a multipart upload task, you can use this header to authorize all users in an account the permission to obtain the object ACL.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p6913194219811">When initiating a multipart upload, you can use this header to authorize all users in an account the permission to obtain the object ACL.</p>
<p id="obs_04_0098__p49151332194119">Type: string</p>
<p id="obs_04_0098__p843643814237">Example: <strong id="obs_04_0098__b165941618103711">x-obs-grant-read-acp: ID=domainID</strong> If multiple accounts are authorized, separate them with commas (,).</p>
</td>
@ -77,7 +77,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row1812104512308"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0098__p4151526163710">x-obs-grant-write-acp</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p94031856283">When initializing a multipart upload task, you can use this header to authorize all users in an account the permission to write the object ACL.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p94031856283">When initiating a multipart upload, you can use this header to authorize all users in an account the permission to write the object ACL.</p>
<p id="obs_04_0098__p79212366417">Type: string</p>
<p id="obs_04_0098__p17584184211233">Example: <strong id="obs_04_0098__b541922123710">x-obs-grant-write-acp: ID=domainID</strong> If multiple accounts are authorized, separate them with commas (,).</p>
</td>
@ -86,7 +86,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row331924114302"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0098__p3389132314376">x-obs-grant-full-control</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p1914315101898">When initializing a multipart upload task, you can use this header to authorize all users in an account the permission to read the object, obtain the object metadata, obtain the object ACL, and write the object ACL.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p1914315101898">When initiating a multipart upload, you can use this header to authorize all users in an account to read the object, obtain the object metadata, obtain the object ACL, and write the object ACL.</p>
<p id="obs_04_0098__p1284513399419">Type: string</p>
<p id="obs_04_0098__p673114440234">Example: <strong id="obs_04_0098__b12460102915377">x-obs-grant-full-control: ID=domainID</strong> If multiple accounts are authorized, separate them with commas (,).</p>
</td>
@ -95,7 +95,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row46729206"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0098__p26969336">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p37032594">When initiating a multi-part upload task, you can add this header to specify the storage class for the object. If you do not use this header, the object storage class is the default storage class of the bucket.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p37032594">When initiating a multipart upload, you can add this header to specify the storage class for the object. If you do not use this header, the object storage class is the default storage class of the bucket.</p>
<p id="obs_04_0098__p64857896">Type: string</p>
<p id="obs_04_0098__p14339210104117">Storage class value options: <strong id="obs_04_0098__b1677713810441">STANDARD</strong> (Standard), <strong id="obs_04_0098__b777763814443">WARM</strong> (Warm), <strong id="obs_04_0098__b1477819384446">COLD</strong> (Cold). These values are case sensitive.</p>
<p id="obs_04_0098__p18998234">Example: <strong id="obs_04_0098__b116516302814">x-obs-storage-class: STANDARD</strong></p>
@ -124,7 +124,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row63524059"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0098__p45175155">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p35308952">Master key ID. This header is used in SSE-KMS mode. If the customer does not provide the master key ID, the default master key ID will be used.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p35308952">Master key ID. This header is used in SSE-KMS mode. If the customer does not provide the master key ID, the default master key ID will be used. If there is no such a default master key, the system will create one and use it by default.</p>
<p id="obs_04_0098__p49345114">Type: string</p>
<p id="obs_04_0098__p6679135313114">The following two formats are supported:</p>
<p id="obs_04_0098__p14701134894919">1. <em id="obs_04_0098__i64591304515">regionID</em><strong id="obs_04_0098__b1946617308515">:</strong><em id="obs_04_0098__i44668309515">domainID</em><strong id="obs_04_0098__b74661730352">:key/</strong><em id="obs_04_0098__i5466530351">key_id</em></p>
@ -176,6 +176,15 @@ Authorization:<span class="w"> </span>authorization
<td class="cellrowborder" valign="top" width="9.180000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0098__p1014357105719">No</p>
</td>
</tr>
<tr id="obs_04_0098__row110622973915"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0098__p29252105">x-obs-meta-*</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0098__p20610280">When initiating a multipart upload, you can use a header starting with <strong id="obs_04_0098__b14342076819330">x-obs-meta-</strong> in the HTTP request to define object metadata for easy management. The user-defined metadata will be returned in the response when you retrieve the object or query the object metadata. </p>
<p id="obs_04_0098__p51274795">Type: string</p>
<p id="obs_04_0098__p58819972">Example: <strong id="obs_04_0098__b2919173913572">x-obs-meta-test: test metadata</strong></p>
</td>
<td class="cellrowborder" valign="top" width="9.180000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0098__p66797252">No</p>
</td>
</tr>
</tbody>
</table>
</div>

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

File diff suppressed because it is too large Load Diff

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

@ -6,8 +6,6 @@
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_04_0114.html">Status Codes</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0115.html">Error Codes</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0116.html">Obtaining Access Keys (AK/SK)</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0117.html">Obtaining the Domain ID and User ID</a></strong><br>

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

@ -635,6 +635,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__p19133820653">Authenticate the user's real name and try again.</p>
</td>
</tr>
<tr id="obs_04_0115__row1964148101013"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p196564810107">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p8651648121010">RequestPayerDenied</p>
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p1765648181011">This is a requester-pays bucket.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p17652048181017">Carry the header <strong id="obs_04_0115__b1744722802311">x-obs-request-payer: requester</strong> in the access request.</p>
</td>
</tr>
<tr id="obs_04_0115__row15763190102539"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p1913342016520">404 Not Found</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p1513314208520">NoSuchBucket</p>
@ -726,6 +735,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__p7894115911412">The method is not allowed.</p>
</td>
</tr>
<tr id="obs_04_0115__row18540172461211"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p05401635101219">405 Method Not Allowed</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p16540123517121">FsNotSupport</p>
</td>
<td class="cellrowborder" valign="top" width="29.959999999999997%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p454053571211">POSIX buckets do not support this API.</p>
</td>
<td class="cellrowborder" valign="top" width="30.04%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p4540123571215">The method is not allowed.</p>
</td>
</tr>
<tr id="obs_04_0115__row49261331102747"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p189455911416">408 Request Timeout</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p3894359151413">RequestTimeout</p>
@ -865,9 +883,4 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0113.html">Appendixes</a></div>
</div>
</div>

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>Hover the cursor over the username in the upper right corner and choose <strong id="obs_04_0116__b912954115389">My Credentials</strong> from the drop-down list.</span></li><li id="obs_04_0116__li147341111103312"><span>On the <strong id="obs_04_0116__b933072916448">My Credentials</strong> page, click <strong id="obs_04_0116__b13332102984417">Manage Access Keys</strong>.</span></li><li id="obs_04_0116__li16734121112338"><span>Click <strong id="obs_04_0116__b199592312114">Add Access Key</strong>.</span></li><li id="obs_04_0116__li473414116337"><span>Enter the password for login.</span></li><li id="obs_04_0116__li18734151123311"><span>Enter the authentication code your email received.</span></li><li id="obs_04_0116__li7735111143318"><span>Click <strong id="obs_04_0116__b17863546137">OK</strong> to download the access key file.</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 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>

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

@ -61,6 +61,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__p14521714114815">Separator used to group object names. If a prefix is specified, objects with the same string from the prefix to the first delimiter are grouped into one <strong id="obs_04_0160__b11550113317149">CommonPrefixes</strong>. If no prefix is specified, objects with the same string from the first character to the first delimiter are grouped into one <strong id="obs_04_0160__b7550933151418">CommonPrefixes</strong>.</p>
<p id="obs_04_0160__p16521714194818">For example, there are three objects (<strong id="obs_04_0160__b928113510144">abcd</strong>, <strong id="obs_04_0160__b82814357147">abcde</strong>, and <strong id="obs_04_0160__b6281035151418">bbcde</strong>) in a bucket. If <strong id="obs_04_0160__b17980113561414">delimiter</strong> is set to <strong id="obs_04_0160__b109800355147">d</strong> and <strong id="obs_04_0160__b49801358144">prefix</strong> is set to <strong id="obs_04_0160__b1980235121414">a</strong>, objects <strong id="obs_04_0160__b18980203541419">abcd</strong> and <strong id="obs_04_0160__b1298133510142">abcde</strong> are grouped into a <strong id="obs_04_0160__b998110351141">CommonPrefixes</strong> with <strong id="obs_04_0160__b159811835121413">abcd</strong> as the prefix. If only <strong id="obs_04_0160__b198153515148">delimiter</strong> is set to <strong id="obs_04_0160__b159811535101411">d</strong>, objects <strong id="obs_04_0160__b1598243561413">abcd</strong> and <strong id="obs_04_0160__b2982133519146">abcde</strong> are grouped into a <strong id="obs_04_0160__b13982163511414">CommonPrefixes</strong> with <strong id="obs_04_0160__b998213591416">abcd</strong> as the prefix, and <strong id="obs_04_0160__b129823352146">bbcde</strong> is grouped separately into another <strong id="obs_04_0160__b29828353141">CommonPrefixes</strong> with <strong id="obs_04_0160__b12982143515143">bbcd</strong> as the prefix.</p>
<p id="obs_04_0160__p4120145715251">For a parallel file system, if this parameter is not specified, all the content in the directory is recursively listed by default, and subdirectories are also listed. In big data scenarios, parallel file systems usually have deep directory levels and each directory has a large number of files. In such case, you are advised to configure <strong id="obs_04_0160__b634812451857">[delimiter=/]</strong> to list the content in the current directory, but not list subdirectories, thereby improving the listing efficiency.</p>
<p id="obs_04_0160__p552014144819">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0160__p59499450">No</p>
@ -172,7 +173,7 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0160__row4028061"><td class="cellrowborder" valign="top" width="35.27%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0160__p57837514">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="64.73%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0160__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_0160__b77818616535">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0160__b13847613537">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 only to the object content, rather than its 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="64.73%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0160__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_0160__b77818616535">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0160__b13847613537">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_0160__p19181309">Type: string</p>
<p id="obs_04_0160__p38414053">Ancestor: ListBucketResult.Contents</p>
</td>
@ -251,7 +252,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="64.73%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0160__p21499466">Storage class of an object</p>
<p id="obs_04_0160__p59277470">Type: string</p>
<p id="obs_04_0160__p63735184">Value options: <strong id="obs_04_0160__b206114465488">STANDARD</strong> | <strong id="obs_04_0160__b361746144812">WARM</strong> | <strong id="obs_04_0160__b1262134612480">COLD</strong></p>
<p id="obs_04_0160__p63735184">Value options: <strong id="obs_04_0160__b206114465488">STANDARD</strong>, <strong id="obs_04_0160__b361746144812">WARM</strong>, <strong id="obs_04_0160__b1262134612480">COLD</strong></p>
<p id="obs_04_0160__p36745745">Ancestor: ListBucketResult.Contents</p>
</td>
</tr>