OBS API 0826 Version

Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: weihongmin1 <weihongmin1@huawei.com>
Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
This commit is contained in:
2025-10-28 10:02:29 +00:00
committed by zuul
parent 4d53c82e02
commit 285f8e4a64
55 changed files with 2824 additions and 1619 deletions

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -5,7 +5,7 @@
<p id="en-us_topic_0031051947__p1089723818188">This document describes how to use application programming interfaces (APIs) to perform operations on OBS, such as creating, modifying, and deleting bucket, as well as uploading, downloading, and deleting objects. For details about all supported operations, see <a href="obs_04_0005.html">API Overview</a>.</p>
<p id="en-us_topic_0031051947__p61208411347">Before calling OBS APIs, ensure that you have fully understood relevant concepts. For details, see <a href="obs_04_0004.html">Basic Concepts</a>.</p>
<p id="en-us_topic_0031051947__p186801420155715">OBS provides Representational State Transfer (REST) APIs that you can call by making HTTP or HTTPS requests. For details, see <a href="obs_04_0006.html">Calling APIs</a>.</p>
<div class="section" id="en-us_topic_0031051947__section124911550580"><a name="en-us_topic_0031051947__section124911550580"></a><a name="section124911550580"></a><h4 class="sectiontitle">Endpoints</h4><p id="en-us_topic_0031051947__p1748961421910">An endpoint is a <strong id="en-us_topic_0031051947__b417913582412">request address</strong> for calling an API. Endpoints vary depending on services and regions. For the endpoints of all services, see <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
<div class="section" id="en-us_topic_0031051947__section124911550580"><a name="en-us_topic_0031051947__section124911550580"></a><a name="section124911550580"></a><h4 class="sectiontitle">Endpoints</h4><p id="en-us_topic_0031051947__p1748961421910">An endpoint is a <strong id="en-us_topic_0031051947__b19747132520620">request address</strong> for calling an API. Endpoints vary depending on services and regions. For the endpoints of all services, see <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
<p id="en-us_topic_0031051947__p9108202217345">OBS provides a different second-level domain name for each region. You can use the domain names provided by OBS or define your own domain names to access OBS.</p>
</div>
</div>

View File

@ -8,7 +8,21 @@
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0000__row1410225654711"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p16695125744720">2025-05-09</p>
<tbody><tr id="obs_04_0000__row987611121019"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p17352146011">2025-09-26</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p153541413019">This issue is the sixteenth official release.</p>
<p id="obs_04_0000__p2351814609">This issue incorporates the following change:</p>
<p id="obs_04_0000__p7356141906">Modified the restrictions on tag keys and values in <a href="obs_04_0049.html">Configuring Tags for a Bucket</a>, <a href="obs_04_0050.html">Obtaining Bucket Tags</a>, and <a href="obs_04_0172.html">Adding Object Tags</a>.</p>
</td>
</tr>
<tr id="obs_04_0000__row1390275615819"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p11439175813582">2025-08-20</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p1943925845818">This issue is the fifteenth official release.</p>
<p id="obs_04_0000__p243935855819">This issue incorporates the following changes:</p>
<ul id="obs_04_0000__ul15475311188"><li id="obs_04_0000__li154710316186">Updated the value of <strong id="obs_04_0000__b1926333115104">Location</strong> in <a href="obs_04_0081.html">Uploading an Object - POST</a>.</li><li id="obs_04_0000__li164218332186">Added the additional request parameter and additional response parameter <strong id="obs_04_0000__b5378192121512">x-obs-request-payer</strong> in <a href="obs_04_0022.html">Listing Objects in a Bucket</a>, <a href="obs_04_0160.html">Listing Objects in a Bucket (V2)</a>, <a href="obs_04_0023.html">Obtaining Bucket Metadata</a>, <a href="obs_04_0080.html">Uploading an Object - PUT</a>, <a href="obs_04_0081.html">Uploading an Object - POST</a>, <a href="obs_04_0082.html">Copying an Object</a>, <a href="obs_04_0083.html">Downloading an Object</a>, <a href="obs_04_0084.html">Querying Object Metadata</a>, <a href="obs_04_0085.html">Deleting an Object</a>, <a href="obs_04_0086.html">Deleting Objects</a>, <a href="obs_04_0089.html">Configuring an Object ACL</a>, <a href="obs_04_0090.html">Obtaining Object ACL Configuration</a>, <a href="obs_04_0098.html">Initiating a Multipart Upload</a>, <a href="obs_04_0099.html">Uploading Parts</a>, <a href="obs_04_0100.html">Copying Parts</a>, <a href="obs_04_0101.html">Listing Uploaded Parts that Have Not Been Assembled</a>, <a href="obs_04_0102.html">Completing a Multipart Upload</a> and <a href="obs_04_0103.html">Canceling a Multipart Upload Task</a>.</li></ul>
</td>
</tr>
<tr id="obs_04_0000__row1410225654711"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p16695125744720">2025-05-09</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p176951857124717">This issue is the fourteenth official release.</p>
<p id="obs_04_0000__p16951557184710">This issue incorporates the following changes:</p>

File diff suppressed because it is too large Load Diff

View File

@ -19,7 +19,7 @@ Authorization:<span class="w"> </span>authorization
<div class="section" id="obs_04_0020__section51585610"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0020__p40868721">This request contains no parameters.</p>
</div>
<div class="section" id="obs_04_0020__section61617313"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0020__p22032077">This request header uses common message fields. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
<p class="MsoNormal" id="obs_04_0020__p63077327">The operation message header is the same as that of a common request. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>. However, this request can contain additional headers. The following table describes the additional headers for this request.</p>
<p class="MsoNormal" id="obs_04_0020__p63077327">This request's message header is the same as that of a common request. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>. This request can contain additional headers. The following table describes the additional headers for this request.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0020__table57087753" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Additional request headers</caption><thead align="left"><tr id="obs_04_0020__row63312464"><th align="left" class="cellrowborder" valign="top" width="24.560000000000002%" id="mcps1.3.5.4.2.4.1.1"><p id="obs_04_0020__p28035972">Header</p>
</th>

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -204,7 +204,7 @@ Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEB
<span class="w"> </span>&quot;NotPrincipal&quot;:<span class="w"> </span>{
<span class="w"> </span>&quot;ID&quot;:<span class="w"> </span>[
<span class="w"> </span>&quot;domain/783fc6652cf246c096ea836694f71855:user/71f3901173514e6988115ea2c26d1999&quot;,<span class="w"> </span>
<span class="w"> </span>&quot;domain/783fc6652cf246c096ea836694f71855&quot;
<span class="w"> </span>&quot;domain/783fc6652cf246c096ea836694f71855:root&quot;
<span class="w"> </span>]
<span class="w"> </span>}
<span class="w"> </span>}

File diff suppressed because it is too large Load Diff

View File

@ -255,7 +255,7 @@ Authorization:<span class="w"> </span>signatureValue
</td>
<td class="cellrowborder" valign="top" width="34.36%" headers="mcps1.3.8.5.2.4.1.2 "><p id="obs_04_0032__p9171316238">200</p>
</td>
<td class="cellrowborder" valign="top" width="35.64%" headers="mcps1.3.8.5.2.4.1.3 "><p id="obs_04_0032__p18171171616313">Response code</p>
<td class="cellrowborder" valign="top" width="35.64%" headers="mcps1.3.8.5.2.4.1.3 "><p id="obs_04_0032__p18171171616313">Return code.</p>
</td>
</tr>
<tr id="obs_04_0032__row15399651112010"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.8.5.2.4.1.1 "><p id="obs_04_0032__p103991051162012">ErrorCode</p>
@ -328,6 +328,7 @@ Authorization:<span class="w"> </span>signatureValue
<td class="cellrowborder" valign="top" width="34.36%" headers="mcps1.3.8.5.2.4.1.2 "><p id="obs_04_0032__p1961144594519">STANDARD_IA</p>
</td>
<td class="cellrowborder" valign="top" width="35.64%" headers="mcps1.3.8.5.2.4.1.3 "><p id="obs_04_0032__p47711154124519">Current object storage class</p>
<ul id="obs_04_0032__en-us_topic_0000001828075792_ul13140114414374"><li id="obs_04_0032__en-us_topic_0000001828075792_li1214074463714">STANDARD: Standard storage</li><li id="obs_04_0032__en-us_topic_0000001828075792_li340416478376"><strong id="obs_04_0032__b17164905494585">STANDARD_IA</strong> (also <strong id="obs_04_0032__b11087962424585">WARM</strong>): Infrequent Access storage class</li><li id="obs_04_0032__en-us_topic_0000001828075792_li1010985019375"><strong id="obs_04_0032__b11987863284585">COLD</strong>: Archive storage class</li></ul>
</td>
</tr>
<tr id="obs_04_0032__row4963193824718"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.8.5.2.4.1.1 "><p id="obs_04_0032__p14330165174612">TargetStorageClass</p>

View File

@ -113,7 +113,7 @@ Content-MD5:<span class="w"> </span>MD5
</th>
<th align="left" class="cellrowborder" valign="top" width="53.54%" id="mcps1.3.4.3.2.4.1.2"><p id="obs_04_0034__p42003254">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.240000000000002%" id="mcps1.3.4.3.2.4.1.3"><p id="obs_04_0034__p46820415">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="24.240000000000002%" id="mcps1.3.4.3.2.4.1.3"><p id="obs_04_0034__p46820415">Mandatory (Yes/No)</p>
</th>
</tr>
</thead>
@ -130,8 +130,8 @@ Content-MD5:<span class="w"> </span>MD5
</table>
</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 body, you need to specify the lifecycle configuration in XML format. <a href="#obs_04_0034__table49391898171726">Table 2</a> describes the specific configuration elements.</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>. If <strong id="obs_04_0034__b21857385203350">NoncurrentDays</strong> is set to <strong id="obs_04_0034__b62498741203350">1</strong> in an object deletion scenario, an object version will be deleted one day after it becomes historical. 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 <span id="obs_04_0034__text1897811392269">Warm</span> 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 <span id="obs_04_0034__text719918412454">Warm</span> 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>
<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 body, you need to specify the lifecycle configuration in XML format. <a href="#obs_04_0034__table49391898171726">Table 2</a> describes the specific XML configuration elements. </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>. If <strong id="obs_04_0034__b21857385203350">NoncurrentDays</strong> is set to <strong id="obs_04_0034__b62498741203350">1</strong> in an object deletion scenario, an object version will be deleted one day after it becomes historical. 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__b18238545306">NoncurrentDays</strong> is set to <strong id="obs_04_0034__b1123914173017">1</strong> and <strong id="obs_04_0034__b6239749305">StorageClass</strong> is set to <strong id="obs_04_0034__b1523910433017">WARM</strong>, the version transitions to the <span id="obs_04_0034__text12476111615314">Warm</span> 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 <span id="obs_04_0034__text2579193515313">Warm</span> 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>
@ -146,7 +146,7 @@ Content-MD5:<span class="w"> </span>MD5
</th>
<th align="left" class="cellrowborder" valign="top" width="52.53%" id="mcps1.3.5.4.2.4.1.2"><p id="obs_04_0034__p50822929">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.200000000000003%" id="mcps1.3.5.4.2.4.1.3"><p id="obs_04_0034__p23016597">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="20.200000000000003%" id="mcps1.3.5.4.2.4.1.3"><p id="obs_04_0034__p23016597">Mandatory (Yes/No)</p>
</th>
</tr>
</thead>
@ -233,7 +233,7 @@ Content-MD5:<span class="w"> </span>MD5
<p id="obs_04_0034__p20305823">Child: NoncurrentDays, StorageClass</p>
<p id="obs_04_0034__p48534684">Parent: 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">Yes if the <strong id="obs_04_0034__b534160349">Transition</strong>, <strong id="obs_04_0034__b1195473220">Expiration</strong>, <strong id="obs_04_0034__b187701445812">AbortIncompleteMultipartUpload</strong>, and <strong id="obs_04_0034__b556888115">NoncurrentVersionExpiration</strong> elements are 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">Yes if the <strong id="obs_04_0034__b2144196458">Transition</strong>, <strong id="obs_04_0034__b172070009">Expiration</strong>, <strong id="obs_04_0034__b187701445812">AbortIncompleteMultipartUpload</strong>, and <strong id="obs_04_0034__b1062639783">NoncurrentVersionExpiration</strong> elements are 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>
@ -308,7 +308,7 @@ Content-MD5:<span class="w"> </span>MD5
<p id="obs_04_0034__p126491341173616">Type: string</p>
<p id="obs_04_0034__p86491941183617">Parent: Tag</p>
<p id="obs_04_0034__p186491941183615">Constraints:</p>
<p id="obs_04_0034__p28051322172717">A tag key is case sensitive and must be unique. It cannot be left blank or exceed 128 characters. The following characters are not allowed: =*&lt;&gt;\,|/?!;</p>
<ul id="obs_04_0034__ul2211184554710"><li id="obs_04_0034__obs_04_0172_li1292270143417">If there are multiple tags specified for an object, each tag key must be unique.</li><li id="obs_04_0034__obs_04_0172_li18508753193311">A tag key must contain 1 to 36 characters and be case sensitive.</li><li id="obs_04_0034__obs_04_0172_li14722332342">A tag key cannot start or end with a space or contain the following characters: ,/|&lt;&gt;=*\</li></ul>
</td>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p14649741143618">Yes if Tag is present.</p>
</td>
@ -319,7 +319,7 @@ Content-MD5:<span class="w"> </span>MD5
<p id="obs_04_0034__p19649114116366">Type: string</p>
<p id="obs_04_0034__p1065013413363">Parent: Tag</p>
<p id="obs_04_0034__p156501441203617">Constraints:</p>
<p id="obs_04_0034__p1864913482271">A tag value is case sensitive and can be left blank. It cannot exceed 255 characters. The following characters are not allowed: =*&lt;&gt;\,|?!;</p>
<ul id="obs_04_0034__ul1821711516492"><li id="obs_04_0034__obs_04_0172_li12001550163712">A tag value can contain 0 to 43 characters and must be case sensitive.</li><li id="obs_04_0034__obs_04_0172_li44584673710">A tag value cannot contain the following characters: ,/|&lt;&gt;=*\</li></ul>
</td>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p965064113619">Yes if Tag is present.</p>
</td>

View File

@ -37,30 +37,42 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0037__section39049314"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0037__p66708519">This request contains elements to configure the bucket versioning in XML format. <a href="#obs_04_0037__d0e7246">Table 1</a> lists the request elements.</p>
<div class="tablenoborder"><a name="obs_04_0037__d0e7246"></a><a name="d0e7246"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0037__d0e7246" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Elements for configuring bucket versioning</caption><thead align="left"><tr id="obs_04_0037__row52104816"><th align="left" class="cellrowborder" valign="top" width="33.67%" id="mcps1.3.5.3.2.4.1.1"><p id="obs_04_0037__p59740538">Element</p>
<div class="tablenoborder"><a name="obs_04_0037__d0e7246"></a><a name="d0e7246"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0037__d0e7246" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Elements for configuring bucket versioning</caption><thead align="left"><tr id="obs_04_0037__row52104816"><th align="left" class="cellrowborder" valign="top" width="23.102310231023104%" id="mcps1.3.5.3.2.5.1.1"><p id="obs_04_0037__p59740538">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.019999999999996%" id="mcps1.3.5.3.2.4.1.2"><p id="obs_04_0037__p64308536">Description</p>
<th align="left" class="cellrowborder" valign="top" width="10.621062106210621%" id="mcps1.3.5.3.2.5.1.2"><p id="obs_04_0037__p96801955103219">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.310000000000002%" id="mcps1.3.5.3.2.4.1.3"><p id="obs_04_0037__p38936003">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="8.650865086508649%" id="mcps1.3.5.3.2.5.1.3"><p id="obs_04_0037__p167362237339">Mandatory (Yes/No)</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.625762576257635%" id="mcps1.3.5.3.2.5.1.4"><p id="obs_04_0037__p64308536">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0037__row64406127"><td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0037__p49513773">VersioningConfiguration</p>
<tbody><tr id="obs_04_0037__row64406127"><td class="cellrowborder" valign="top" width="23.102310231023104%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0037__p49513773">VersioningConfiguration</p>
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0037__p51192643">Root node for configuring versioning</p>
<p id="obs_04_0037__p58080607">Parent: none</p>
<td class="cellrowborder" valign="top" width="10.621062106210621%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0037__p1968035516327">XML</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0037__p6908717">Yes</p>
<td class="cellrowborder" valign="top" width="8.650865086508649%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0037__p14785250163316">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="57.625762576257635%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0037__p05331203414"><strong id="obs_04_0037__b7423135817349">Definition</strong>:</p>
<p id="obs_04_0037__p75711896354">Root node of versioning configuration, which is the parent node of Status.</p>
<p id="obs_04_0037__p16662162103610"><strong id="obs_04_0037__b966213211364">Constraints</strong>:</p>
<p id="obs_04_0037__p72575103347">None</p>
</td>
</tr>
<tr id="obs_04_0037__row62178457"><td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0037__p3290281">Status</p>
<tr id="obs_04_0037__row62178457"><td class="cellrowborder" valign="top" width="23.102310231023104%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0037__p3290281">Status</p>
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0037__p65186226">Versioning status of the bucket</p>
<p id="obs_04_0037__p49805123">Type: string</p>
<p id="obs_04_0037__p45592923">Parent: VersioningConfiguration</p>
<p id="obs_04_0037__p7683123">Value options: <strong id="obs_04_0037__b206919482429">Enabled</strong>, <strong id="obs_04_0037__b14585013428">Suspended</strong></p>
<td class="cellrowborder" valign="top" width="10.621062106210621%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0037__p15680165514328">String</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 class="cellrowborder" valign="top" width="8.650865086508649%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0037__p12785175023315">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="57.625762576257635%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0037__p151023153519"><strong id="obs_04_0037__b1351053103513">Definition</strong>:</p>
<p id="obs_04_0037__p35516476376">Versioning status of the bucket.</p>
<p id="obs_04_0037__p68862543371"><strong id="obs_04_0037__b15886115420374">Constraints</strong>:</p>
<p id="obs_04_0037__p1351018343520">None</p>
<p id="obs_04_0037__p751011316354"><strong id="obs_04_0037__b185102323516">Range</strong>:</p>
<ul id="obs_04_0037__ul7130115903818"><li id="obs_04_0037__li5130359153816">Enabled: Versioning is enabled.</li><li id="obs_04_0037__li181301559143813">Suspended: Versioning is suspended.</li></ul>
<p id="obs_04_0037__p35104314354"><strong id="obs_04_0037__b75109316359">Default value</strong>:</p>
<p id="obs_04_0037__p117261957123712">None</p>
</td>
</tr>
</tbody>

View File

@ -42,23 +42,36 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0038__section15093651"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0038__p22153854">This response contains elements to specify the bucket versioning status. <a href="#obs_04_0038__table29764434204455">Table 1</a> describes the elements.</p>
<div class="tablenoborder"><a name="obs_04_0038__table29764434204455"></a><a name="table29764434204455"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0038__table29764434204455" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Response elements</caption><thead align="left"><tr id="obs_04_0038__row31333717"><th align="left" class="cellrowborder" valign="top" width="32.45%" id="mcps1.3.8.3.2.3.1.1"><p id="obs_04_0038__p55003148">Element</p>
<div class="tablenoborder"><a name="obs_04_0038__table29764434204455"></a><a name="table29764434204455"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0038__table29764434204455" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Response elements</caption><thead align="left"><tr id="obs_04_0038__row31333717"><th align="left" class="cellrowborder" valign="top" width="22.42%" id="mcps1.3.8.3.2.4.1.1"><p id="obs_04_0038__p55003148">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="67.55%" id="mcps1.3.8.3.2.3.1.2"><p id="obs_04_0038__p26069995">Description</p>
<th align="left" class="cellrowborder" valign="top" width="15.110000000000001%" id="mcps1.3.8.3.2.4.1.2"><p id="obs_04_0038__p324218102415">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="62.470000000000006%" id="mcps1.3.8.3.2.4.1.3"><p id="obs_04_0038__p26069995">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0038__row51856964"><td class="cellrowborder" valign="top" width="32.45%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0038__p39664525">VersioningConfiguration</p>
<tbody><tr id="obs_04_0038__row51856964"><td class="cellrowborder" valign="top" width="22.42%" headers="mcps1.3.8.3.2.4.1.1 "><p id="obs_04_0038__p39664525">VersioningConfiguration</p>
</td>
<td class="cellrowborder" valign="top" width="67.55%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0038__p58709918">Element of versioning status information.</p>
<p id="obs_04_0038__p58627217">Type: container</p>
<td class="cellrowborder" valign="top" width="15.110000000000001%" headers="mcps1.3.8.3.2.4.1.2 "><p id="obs_04_0038__p324315109411">XML</p>
</td>
<td class="cellrowborder" valign="top" width="62.470000000000006%" headers="mcps1.3.8.3.2.4.1.3 "><p id="obs_04_0038__p05331203414"><strong id="obs_04_0038__b7423135817349">Definition</strong>:</p>
<p id="obs_04_0038__p75711896354">Root node of versioning configuration, which is the parent node of Status.</p>
<p id="obs_04_0038__p16662162103610"><strong id="obs_04_0038__b966213211364">Constraints</strong>:</p>
<p id="obs_04_0038__p72575103347">None</p>
</td>
</tr>
<tr id="obs_04_0038__row58004282"><td class="cellrowborder" valign="top" width="32.45%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0038__p726421">Status</p>
<tr id="obs_04_0038__row58004282"><td class="cellrowborder" valign="top" width="22.42%" headers="mcps1.3.8.3.2.4.1.1 "><p id="obs_04_0038__p726421">Status</p>
</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: <strong id="obs_04_0038__b45363548424">Enabled</strong>, <strong id="obs_04_0038__b732105612426">Suspended</strong></p>
<td class="cellrowborder" valign="top" width="15.110000000000001%" headers="mcps1.3.8.3.2.4.1.2 "><p id="obs_04_0038__p02431910134115">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.470000000000006%" headers="mcps1.3.8.3.2.4.1.3 "><p id="obs_04_0038__p151023153519"><strong id="obs_04_0038__b1351053103513">Definition</strong>:</p>
<p id="obs_04_0038__p35516476376">Versioning status of the bucket.</p>
<p id="obs_04_0038__p68862543371"><strong id="obs_04_0038__b15886115420374">Constraints</strong>:</p>
<p id="obs_04_0038__p1351018343520">None</p>
<p id="obs_04_0038__p751011316354"><strong id="obs_04_0038__b185102323516">Range</strong>:</p>
<ul id="obs_04_0038__ul7130115903818"><li id="obs_04_0038__li5130359153816">Enabled: Versioning is enabled.</li><li id="obs_04_0038__li181301559143813">Suspended: Versioning is suspended.</li></ul>
<p id="obs_04_0038__p35104314354"><strong id="obs_04_0038__b75109316359">Default value</strong>:</p>
<p id="obs_04_0038__p117261957123712">None</p>
</td>
</tr>
</tbody>

View File

@ -1,10 +1,9 @@
<a name="obs_04_0044"></a><a name="obs_04_0044"></a>
<h1 class="topictitle1">Configuring Storage Class for a Bucket</h1>
<div id="body40250789"><div class="section" id="obs_04_0044__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0044__p28207758">This operation sets or updates the default storage class of a bucket.</p>
<div id="body40250789"><div class="section" id="obs_04_0044__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0044__p28207758">This operation sets or updates the default storage class for a bucket.</p>
<p class="msonormal" id="obs_04_0044__p52543238">To perform this operation, you must have the <strong id="obs_04_0044__b49121730191213">PutBucketStoragePolicy</strong> permission. By default, only the bucket owner can perform this operation. The bucket owner can grant the permission to other users by configuring the bucket policy or user policy.</p>
<p class="msonormal" id="obs_04_0044__p3127100">If you do not specify a storage class when uploading or copying an object, or initiating a multipart upload, the object inherits the bucket's storage class.</p>
<p class="msonormal" id="obs_04_0044__p28143905">The default storage class of a bucket is Standard.</p>
</div>
<div class="section" id="obs_04_0044__section51968558"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0044__screen39088442"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>

View File

@ -2,7 +2,7 @@
<h1 class="topictitle1">Configuring Cross-Region Replication for a Bucket</h1>
<div id="body41438055"><div class="section" id="obs_04_0046__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0046__p42676773">Cross-region replication refers to the automatic and asynchronous replication of objects across buckets in different regions. By activating cross-region replication, OBS can copy new objects and modified objects from a source bucket in one region to a destination bucket in a different region.</p>
<div class="note" id="obs_04_0046__note1828145423918"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0046__p1690653519522">An IAM agency is required for configuring cross-region replication. For details, see section "Creating an IAM Agency" in the <em id="obs_04_0046__i1032153781219">Object Storage Service User Guide</em>.</p>
<div class="note" id="obs_04_0046__note1828145423918"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0046__p1690653519522">An IAM agency is required for configuring cross-region replication. For details, see <strong id="obs_04_0046__b917985417317">Related Operations</strong> &gt; <strong id="obs_04_0046__b20231131813433">Creating an IAM Agency</strong> &gt; <strong id="obs_04_0046__b6187195611319">Creating an Agency for Cross-Region Replication</strong> in the <em id="obs_04_0046__i1032153781219">Object Storage Service User Guide</em>.</p>
</div></div>
<p class="msonormal" id="obs_04_0046__p48546637">To configure cross-region replication for a bucket, the following two requirements must be met:</p>
<ol id="obs_04_0046__ol34266555"><li id="obs_04_0046__li37398182">The versioning statuses of the source and destination buckets are the same. For details, see <a href="obs_04_0037.html">Configuring Versioning for a Bucket</a>.</li><li id="obs_04_0046__li9353888">The source bucket's owner and agency (OBS) have the write permission for the destination bucket (with a bucket policy configured), and the agency (OBS) also has the read permission for the source bucket. This permission delegation needs to be implemented by using a bucket policy.</li></ol>
@ -60,7 +60,7 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
</th>
<th align="left" class="cellrowborder" valign="top" width="53%" id="mcps1.3.4.3.2.4.1.2"><p id="obs_04_0046__p18096501">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24%" id="mcps1.3.4.3.2.4.1.3"><p id="obs_04_0046__p56530497">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="24%" id="mcps1.3.4.3.2.4.1.3"><p id="obs_04_0046__p56530497">Mandatory (Yes/No)</p>
</th>
</tr>
</thead>
@ -75,13 +75,13 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
</table>
</div>
</div>
<div class="section" id="obs_04_0046__section58288033"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0046__p6362">This request contains elements to specify the replication configuration for the bucket in XML format. The following table lists request elements:</p>
<div class="section" id="obs_04_0046__section58288033"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0046__p6362">The request body contains elements to specify the replication configuration for the bucket in XML format. The following table lists request elements:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0046__table57259" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Bucket replication configuration elements</caption><thead align="left"><tr id="obs_04_0046__row120353"><th align="left" class="cellrowborder" valign="top" width="24%" id="mcps1.3.5.3.2.4.1.1"><p id="obs_04_0046__p9748658">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="53%" id="mcps1.3.5.3.2.4.1.2"><p id="obs_04_0046__p51443872">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="23%" id="mcps1.3.5.3.2.4.1.3"><p id="obs_04_0046__p6204114">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="23%" id="mcps1.3.5.3.2.4.1.3"><p id="obs_04_0046__p6204114">Mandatory (Yes/No)</p>
</th>
</tr>
</thead>

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -26,18 +26,18 @@ Content-Length:<span class="w"> </span>0
</th>
<th align="left" class="cellrowborder" valign="top" width="53.260000000000005%" id="mcps1.3.3.2.2.4.1.2"><p id="obs_04_0059__p95049355327">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.310000000000002%" id="mcps1.3.3.2.2.4.1.3"><p id="obs_04_0059__p185061235143215">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="24.310000000000002%" id="mcps1.3.3.2.2.4.1.3"><p id="obs_04_0059__p185061235143215">Mandatory (Yes/No)</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0059__row175081135133212"><td class="cellrowborder" valign="top" width="22.430000000000003%" headers="mcps1.3.3.2.2.4.1.1 "><p id="obs_04_0059__p19510123510324">customdomain</p>
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.3.2.2.4.1.2 "><p id="obs_04_0059__p122588914915"><strong id="obs_04_0059__b470216154916">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.3.2.2.4.1.2 "><p id="obs_04_0059__p122588914915"><strong id="obs_04_0059__b470216154916">Definition</strong>:</p>
<p id="obs_04_0059__p16551024153319">Custom domain name of a bucket.</p>
<p id="obs_04_0059__p89852224918">Type: String, which must meet the naming conventions of domain names.</p>
<p id="obs_04_0059__p176064044514"><strong id="obs_04_0059__b8324124014510">Restrictions</strong>:</p>
<p id="obs_04_0059__p176064044514"><strong id="obs_04_0059__b8324124014510">Constraints</strong>:</p>
<p id="obs_04_0059__p15152104111451">A bucket can have a maximum of 30 domain names. One custom domain name can be used for only one bucket.</p>
<p id="obs_04_0059__p1320155144515"><strong id="obs_04_0059__b14206553450">Value range</strong>:</p>
<p id="obs_04_0059__p1320155144515"><strong id="obs_04_0059__b14206553450">Range</strong>:</p>
<p id="obs_04_0059__p17201551456">The maximum length is 256 bytes.</p>
<p id="obs_04_0059__p132018557453"><strong id="obs_04_0059__b1205557459">Default value</strong>:</p>
<p id="obs_04_0059__p163341526203219">None</p>
@ -49,7 +49,39 @@ Content-Length:<span class="w"> </span>0
</table>
</div>
</div>
<div class="section" id="obs_04_0059__section39931740163810"><h4 class="sectiontitle">Request Header</h4><p id="obs_04_0059__p1231635205817">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
<div class="section" id="obs_04_0059__section39931740163810"><h4 class="sectiontitle">Request Header</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0059__table436706591789" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="obs_04_0059__row532609251789"><th align="left" class="cellrowborder" valign="top" width="17.008299170082992%" id="mcps1.3.4.2.2.5.1.1"><p id="obs_04_0059__p90786001789">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.998400159984003%" id="mcps1.3.4.2.2.5.1.2"><p id="obs_04_0059__p1888434013510">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.82871712828717%" id="mcps1.3.4.2.2.5.1.3"><p id="obs_04_0059__p391355251789">Mandatory (Yes/No)</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="54.164583541645825%" id="mcps1.3.4.2.2.5.1.4"><p id="obs_04_0059__p642780001789">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0059__row520210419261"><td class="cellrowborder" valign="top" width="17.008299170082992%" headers="mcps1.3.4.2.2.5.1.1 "><p id="obs_04_0059__p1376912802612">Content-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="15.998400159984003%" headers="mcps1.3.4.2.2.5.1.2 "><p id="obs_04_0059__p9884440851">String</p>
</td>
<td class="cellrowborder" valign="top" width="12.82871712828717%" headers="mcps1.3.4.2.2.5.1.3 "><p id="obs_04_0059__p12769889268">No</p>
</td>
<td class="cellrowborder" valign="top" width="54.164583541645825%" headers="mcps1.3.4.2.2.5.1.4 "><p id="obs_04_0059__p793733224511"><strong id="obs_04_0059__b15368164994116">Definition:</strong></p>
<p id="obs_04_0059__p85101514134113">This header is mandatory when you configure a custom domain name certificate to verify that the content of the request body is consistent with what was sent.</p>
<p id="obs_04_0059__p57421655419">Base64-encoded 128-bit MD5 value of the request body calculated according to RFC 1864.</p>
<p id="obs_04_0059__p179925362264">Example: <strong id="obs_04_0059__b92612365426">n58IG6hfM7vqI4K0vnWpog==</strong></p>
<p id="obs_04_0059__p17609165413402"><strong id="obs_04_0059__b462617448427">Constraints</strong>:</p>
<p id="obs_04_0059__p8609155464014">None</p>
<p id="obs_04_0059__p260917546408"><strong id="obs_04_0059__b132119562426">Range:</strong></p>
<p id="obs_04_0059__p17609165484019">None</p>
<p id="obs_04_0059__p360915417401"><strong id="obs_04_0059__b11963115710429">Default value</strong>:</p>
<p id="obs_04_0059__p1420135514459">None</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="obs_04_0059__p1231635205817">For details about other common headers, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="obs_04_0059__section516565919384"><h4 class="sectiontitle">Request Elements</h4><p id="obs_04_0059__p125891247183719">This request involves no elements.</p>
</div>

View File

@ -23,7 +23,7 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</th>
<th align="left" class="cellrowborder" valign="top" width="53.260000000000005%" id="mcps1.3.3.2.2.4.1.2"><p id="obs_04_0061__p95049355327">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.310000000000002%" id="mcps1.3.3.2.2.4.1.3"><p id="obs_04_0061__p185061235143215">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="24.310000000000002%" id="mcps1.3.3.2.2.4.1.3"><p id="obs_04_0061__p185061235143215">Mandatory (Yes/No)</p>
</th>
</tr>
</thead>

View File

@ -101,7 +101,7 @@ Content-Length:<span class="w"> </span>length
<p id="obs_04_0062__p6679135313114">Valid value formats are as follows:</p>
<ol id="obs_04_0062__ol28871657184419"><li id="obs_04_0062__li388775774418"><em id="obs_04_0062__i1826463874220">regionID</em><strong id="obs_04_0062__b3264203884220">:</strong><em id="obs_04_0062__i026413384429">domainID</em><strong id="obs_04_0062__b426410381422">:key/</strong><em id="obs_04_0062__i1264103894218">key_id</em></li><li id="obs_04_0062__li1216183134518"><em id="obs_04_0062__i18971441107541">key_id</em></li></ol>
<p id="obs_04_0062__p5150033112717">In the preceding formats:</p>
<ul id="obs_04_0062__ul1812312350279"><li id="obs_04_0062__li48526363273"><em id="obs_04_0062__i1082183695015">regionID</em> indicates the ID of the region where the key belongs.</li><li id="obs_04_0062__li453410383271"><em id="obs_04_0062__i1054362316479">domainID</em> indicates the ID of the domain to which the key belongs. For details, see <a href="obs_04_0117.html">Obtaining a Domain ID and a User ID</a>.</li><li id="obs_04_0062__li2123235142713"><em id="obs_04_0062__i339792814549">key_id</em> indicates the ID of the key created in KMS.</li></ul>
<ul id="obs_04_0062__ul1812312350279"><li id="obs_04_0062__li48526363273"><em id="obs_04_0062__i1082183695015">regionID</em> indicates the ID of the region where the key belongs.</li><li id="obs_04_0062__li453410383271"><em id="obs_04_0062__i1054362316479">domainID</em> indicates the ID of the domain to which the key belongs. For details, see <a href="obs_04_0117.html">Obtaining a Domain ID and a User ID</a>.</li><li id="obs_04_0062__li2123235142713"><em id="obs_04_0062__i11293131062814">key_id</em> indicates the ID of the key created in KMS.</li></ul>
<p id="obs_04_0062__p2616105415423">Parent: ApplyServerSideEncryptionByDefault</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0062__p11616115484210">No</p>
@ -112,7 +112,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__p19849131082815">ID of the project where the KMS master key belongs when SSE-KMS is used. If the project is not the default one, you must use this parameter to specify the project ID.</p>
<p id="obs_04_0062__p198201472915">Type: string</p>
<p id="obs_04_0062__p1232921112811">Value options:</p>
<ol id="obs_04_0062__ol1129819314321"><li id="obs_04_0062__li429833110328">Project ID that matches <strong id="obs_04_0062__b0176124019435">KMSMasterKeyID</strong>.</li><li id="obs_04_0062__li128069579328">If <strong id="obs_04_0062__b17727124917431">KMSMasterKeyID</strong> is not specified, do not set the project ID.</li></ol>
<ol id="obs_04_0062__ol1129819314321"><li id="obs_04_0062__li429833110328">Project ID that matches <strong id="obs_04_0062__b16720173713281">KMSMasterKeyID</strong>.</li><li id="obs_04_0062__li128069579328">If <strong id="obs_04_0062__b11277184242814">KMSMasterKeyID</strong> is not specified, do not set the project ID.</li></ol>
<p id="obs_04_0062__p152901844162714">Parent: ApplyServerSideEncryptionByDefault</p>
<div class="note" id="obs_04_0062__note332131575820"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_04_0062__p4321215145814">When a custom key in a non-default IAM project is used to encrypt objects, only the key owner can upload or download the encrypted objects.</p>
</div></div>

File diff suppressed because it is too large Load Diff

View File

@ -159,7 +159,7 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0077__row60195710"><td class="cellrowborder" valign="top" width="26.53061224489796%" headers="mcps1.3.10.3.2.4.1.1 "><p id="obs_04_0077__p44014314">AccessForbidden</p>
</td>
<td class="cellrowborder" valign="top" width="48.97959183673469%" headers="mcps1.3.10.3.2.4.1.2 "><p id="obs_04_0077__p8389707">CORSResponse: This CORS request is not allowed. This is usually because the evaluation of Origin, request method / Access-Control-Request-Method or Access-Control-Request-Headers are not whitelisted by the resource's CORS specification.</p>
<td class="cellrowborder" valign="top" width="48.97959183673469%" headers="mcps1.3.10.3.2.4.1.2 "><p id="obs_04_0077__p8389707">CORSResponse: This CORS request is not allowed. This is usually because the evaluation of Origin, request method / Access-Control-Request-Method or Access-Control-Request-Headers are not whitelisted by the resource's CORS spec.</p>
<p id="obs_04_0077__p8398507">When CORS and OPTIONS are configured for a bucket, origin, method, and headers do not match any rule.</p>
</td>
<td class="cellrowborder" valign="top" width="24.489795918367346%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0077__p9190486">403 Forbidden</p>

View File

@ -157,7 +157,7 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0078__row36387235"><td class="cellrowborder" valign="top" width="26.53061224489796%" headers="mcps1.3.10.3.2.4.1.1 "><p id="obs_04_0078__p61684923">AccessForbidden</p>
</td>
<td class="cellrowborder" valign="top" width="48.97959183673469%" headers="mcps1.3.10.3.2.4.1.2 "><p id="obs_04_0078__p30422880">CORSResponse: This CORS request is not allowed. This is usually because the evaluation of Origin, request method/Access-Control-Request-Method or Access-Control-Request-Headers are not whitelisted by the resource's CORS spec.</p>
<td class="cellrowborder" valign="top" width="48.97959183673469%" headers="mcps1.3.10.3.2.4.1.2 "><p id="obs_04_0078__p30422880">CORSResponse: This CORS request is not allowed. This is usually because the evaluation of Origin, request method / Access-Control-Request-Method or Access-Control-Request-Headers are not whitelisted by the resource's CORS spec.</p>
<p id="obs_04_0078__p5370466">When CORS and OPTIONS are configured for a bucket, origin, method, and headers do not match any rule.</p>
</td>
<td class="cellrowborder" valign="top" width="24.489795918367346%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0078__p32354629">403 Forbidden</p>

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -46,14 +46,45 @@ Content-Length:<span class="w"> </span>length
<div class="section" id="obs_04_0086__section7470264"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0086__p61252388">This request involves no parameters.</p>
</div>
<div class="section" id="obs_04_0086__section123519"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0086__p62496390">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="obs_04_0086__section1111676"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0086__p60058758">This request uses elements to specify the list of objects to be deleted in a batch. <a href="#obs_04_0086__table42836777">Table 1</a> describes the elements.</p>
<p id="obs_04_0086__p1153442642015">In addition to the common request headers, the header listed in <a href="#obs_04_0086__table101171333196">Table 1</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0086__table42836777"></a><a name="table42836777"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0086__table42836777" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request elements</caption><thead align="left"><tr id="obs_04_0086__row55516876"><th align="left" class="cellrowborder" valign="top" width="18.36816318368163%" id="mcps1.3.5.3.2.4.1.1"><p id="obs_04_0086__p573089">Element</p>
<div class="tablenoborder"><a name="obs_04_0086__table101171333196"></a><a name="table101171333196"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0086__table101171333196" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Additional request header</caption><thead align="left"><tr id="obs_04_0086__obs_04_0082_row6117193312912"><th align="left" class="cellrowborder" valign="top" width="19.93%" id="mcps1.3.4.4.2.5.1.1"><p id="obs_04_0086__obs_04_0082_p1117153318914"><strong id="obs_04_0086__b194266744895230">Header</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.629999999999999%" id="mcps1.3.4.4.2.5.1.2"><p id="obs_04_0086__obs_04_0082_p18410532121819"><strong id="obs_04_0086__b1195784311532">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.66%" id="mcps1.3.4.4.2.5.1.3"><p id="obs_04_0086__obs_04_0082_p121171433497"><strong id="obs_04_0086__b48490506495331">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.779999999999994%" id="mcps1.3.4.4.2.5.1.4"><p id="obs_04_0086__obs_04_0082_p16117183315914"><strong id="obs_04_0086__b28075722795244">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0086__obs_04_0082_row10117163317911"><td class="cellrowborder" valign="top" width="19.93%" headers="mcps1.3.4.4.2.5.1.1 "><p id="obs_04_0086__obs_04_0082_p81172334910">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="12.629999999999999%" headers="mcps1.3.4.4.2.5.1.2 "><p id="obs_04_0086__obs_04_0082_p74101432101810">String</p>
</td>
<td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.3.4.4.2.5.1.3 "><p id="obs_04_0086__obs_04_0082_p1811710339915">No</p>
</td>
<td class="cellrowborder" valign="top" width="55.779999999999994%" headers="mcps1.3.4.4.2.5.1.4 "><p id="obs_04_0086__obs_04_0082_p4915529112011"><strong id="obs_04_0086__b178786784095253">Definition</strong>:</p>
<p id="obs_04_0086__obs_04_0082_p155114443566">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0086__obs_04_0082_p159151529172013"><strong id="obs_04_0086__b175658421462">Constraints</strong>:</p>
<p id="obs_04_0086__obs_04_0082_p143311938205210">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0086__obs_04_0082_p1091519295206"><strong id="obs_04_0086__b165651842184611">Range</strong>:</p>
<p id="obs_04_0086__obs_04_0082_p10891636161916">requester</p>
<p id="obs_04_0086__obs_04_0082_p5915112992010"><strong id="obs_04_0086__b1256534244611">Default value</strong>:</p>
<p id="obs_04_0086__obs_04_0082_p854916466518">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0086__section1111676"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0086__p60058758">This request uses elements to specify the list of objects to be deleted in a batch. <a href="#obs_04_0086__table42836777">Table 2</a> describes the elements.</p>
<div class="tablenoborder"><a name="obs_04_0086__table42836777"></a><a name="table42836777"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0086__table42836777" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request elements</caption><thead align="left"><tr id="obs_04_0086__row55516876"><th align="left" class="cellrowborder" valign="top" width="18.36816318368163%" id="mcps1.3.5.3.2.4.1.1"><p id="obs_04_0086__p573089">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="63.26367363263674%" id="mcps1.3.5.3.2.4.1.2"><p id="obs_04_0086__p15129188">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.36816318368163%" id="mcps1.3.5.3.2.4.1.3"><p id="obs_04_0086__p23324516">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="18.36816318368163%" id="mcps1.3.5.3.2.4.1.3"><p id="obs_04_0086__p23324516">Mandatory (Yes/No)</p>
</th>
</tr>
</thead>
@ -138,10 +169,37 @@ Content-Length:<span class="w"> </span>length
</div>
</div>
<div class="section" id="obs_04_0086__section22936932"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0086__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
</div>
<div class="section" id="obs_04_0086__section5105801"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0086__p49210771">This response uses elements to return results of deleted objects in a batch. <a href="#obs_04_0086__table56991560">Table 2</a> describes the elements.</p>
<p id="obs_04_0086__p12477201618412">In addition to the common response headers, the header listed in <a href="#obs_04_0086__table172904210301">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0086__table56991560"></a><a name="table56991560"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0086__table56991560" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="obs_04_0086__row44016410"><th align="left" class="cellrowborder" valign="top" width="28.4%" id="mcps1.3.8.3.2.3.1.1"><p id="obs_04_0086__p8559454">Element</p>
<div class="tablenoborder"><a name="obs_04_0086__table172904210301"></a><a name="table172904210301"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0086__table172904210301" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header</caption><thead align="left"><tr id="obs_04_0086__row029110203010"><th align="left" class="cellrowborder" valign="top" width="23.14%" id="mcps1.3.7.4.2.4.1.1"><p id="obs_04_0086__p182917217303">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.99%" id="mcps1.3.7.4.2.4.1.2"><p id="obs_04_0086__p1078810532411"><strong id="obs_04_0086__b158581015152415">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.87%" id="mcps1.3.7.4.2.4.1.3"><p id="obs_04_0086__p142912215302">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0086__row229182183011"><td class="cellrowborder" valign="top" width="23.14%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0086__p4291112123010">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="11.99%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0086__p17789115172410">string</p>
</td>
<td class="cellrowborder" valign="top" width="64.87%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0086__p451692516220"><strong id="obs_04_0086__b121091690">Definition</strong>:</p>
<p id="obs_04_0086__p7516202518210">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0086__p1551619258218"><strong id="obs_04_0086__b230890217">Constraints</strong>:</p>
<p id="obs_04_0086__p145161125625">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0086__p165161259212"><strong id="obs_04_0086__b1805871711">Range</strong>:</p>
<p id="obs_04_0086__p051615259213">requester</p>
<p id="obs_04_0086__p20516162510216"><strong id="obs_04_0086__b238655978">Default value</strong>:</p>
<p id="obs_04_0086__p1851614251728">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0086__section5105801"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0086__p49210771">This response uses elements to return results of deleted objects in a batch. <a href="#obs_04_0086__table56991560">Table 4</a> describes the elements.</p>
<div class="tablenoborder"><a name="obs_04_0086__table56991560"></a><a name="table56991560"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0086__table56991560" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response elements</caption><thead align="left"><tr id="obs_04_0086__row44016410"><th align="left" class="cellrowborder" valign="top" width="28.4%" id="mcps1.3.8.3.2.3.1.1"><p id="obs_04_0086__p8559454">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="71.6%" id="mcps1.3.8.3.2.3.1.2"><p id="obs_04_0086__p65827105">Description</p>
</th>

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -49,7 +49,7 @@ Content-Length: <em id="obs_04_0100__i63865863">length</em></pre>
</table>
</div>
</div>
<div class="section" id="obs_04_0100__section7658674"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0100__p36793344">In addition to the common message headers, the request uses two extended headers. <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a> describes the common message header.</p>
<div class="section" id="obs_04_0100__section7658674"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0100__p36793344">In addition to the common message headers, the request uses two extended headers. <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a> describes the common message headers.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0100__table27470926" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="obs_04_0100__row11414663"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.3.2.4.1.1"><p id="obs_04_0100__p52172500">Header</p>
</th>
@ -181,6 +181,20 @@ Content-Length: <em id="obs_04_0100__i63865863">length</em></pre>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0100__p7535566">No</p>
</td>
</tr>
<tr id="obs_04_0100__row12347121017489"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0100__p916111224816">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0100__p1616121224813"><strong id="obs_04_0100__b47783379723118">Definition</strong>:</p>
<p id="obs_04_0100__p6161212144815">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0100__p1916161214810"><strong id="obs_04_0100__b65000756623140">Constraints</strong>:</p>
<p id="obs_04_0100__p16161512194812">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0100__p016012124818"><strong id="obs_04_0100__b11387395623158">Range</strong>:</p>
<p id="obs_04_0100__p5161123484">requester</p>
<p id="obs_04_0100__p31691218481"><strong id="obs_04_0100__b95980026395535">Default value</strong>:</p>
<p id="obs_04_0100__p768112298486">None</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0100__p716141215482">No</p>
</td>
</tr>
</tbody>
</table>
</div>
@ -213,9 +227,9 @@ Date: <em id="obs_04_0100__i64317386">date</em>
</tr>
<tr id="obs_04_0100__row61553617"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0100__p19787044">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0100__p1753512571813"><strong id="obs_04_0100__b169662810418">Explanation</strong>:</p>
<p id="obs_04_0100__p205358571889">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0100__p135361957886"><strong id="obs_04_0100__b158189541025">Restrictions</strong>:</p>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0100__p1753512571813"><strong id="obs_04_0100__b169662810418">Definition</strong>:</p>
<p id="obs_04_0100__p205358571889">If the SSE-KMS encryption is used with a specified key, the key ID is required. </p>
<p id="obs_04_0100__p135361957886"><strong id="obs_04_0100__b158189541025">Constraints</strong>:</p>
<p id="obs_04_0100__p153618578818">This header can only be used when you specify <strong id="obs_04_0100__b21015331045">kms</strong> for the <strong id="obs_04_0100__b2010115334417">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0100__p11536557683"><strong id="obs_04_0100__b20745734045">Default value</strong>:</p>
<p id="obs_04_0100__p17536857783">If you specify <strong id="obs_04_0100__b273515635111">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
@ -235,6 +249,18 @@ Date: <em id="obs_04_0100__i64317386">date</em>
<p id="obs_04_0100__p55175303">Example: <strong id="obs_04_0100__b42135114110">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
</td>
</tr>
<tr id="obs_04_0100__row471234211513"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0100__p9761645135110">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0100__p1876845135112"><strong id="obs_04_0100__b31852876923118">Definition</strong>:</p>
<p id="obs_04_0100__p197612453518">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0100__p576645195118"><strong id="obs_04_0100__b22679932723140">Constraints</strong>:</p>
<p id="obs_04_0100__p167614514519">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0100__p1276154520517"><strong id="obs_04_0100__b72461626723159">Range</strong>:</p>
<p id="obs_04_0100__p1176945135118">requester</p>
<p id="obs_04_0100__p1276245105110"><strong id="obs_04_0100__b503166069">Default value</strong>:</p>
<p id="obs_04_0100__p107684512513">None</p>
</td>
</tr>
</tbody>
</table>
</div>

View File

@ -51,6 +51,37 @@ Authorization: auth</pre>
</div>
</div>
<div class="section" id="obs_04_0101__section28569971"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0101__p21356864">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
<p id="obs_04_0101__p1153442642015">In addition to the common request headers, the header listed in <a href="#obs_04_0101__table101171333196">Table 2</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0101__table101171333196"></a><a name="table101171333196"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0101__table101171333196" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional request header</caption><thead align="left"><tr id="obs_04_0101__obs_04_0082_row6117193312912"><th align="left" class="cellrowborder" valign="top" width="19.93%" id="mcps1.3.4.4.2.5.1.1"><p id="obs_04_0101__obs_04_0082_p1117153318914"><strong id="obs_04_0101__b95860756895331">Header</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.629999999999999%" id="mcps1.3.4.4.2.5.1.2"><p id="obs_04_0101__obs_04_0082_p18410532121819"><strong id="obs_04_0101__b196875447495339">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.66%" id="mcps1.3.4.4.2.5.1.3"><p id="obs_04_0101__obs_04_0082_p121171433497"><strong id="obs_04_0101__b195649176495353">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.779999999999994%" id="mcps1.3.4.4.2.5.1.4"><p id="obs_04_0101__obs_04_0082_p16117183315914"><strong id="obs_04_0101__b41305208095440">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0101__obs_04_0082_row10117163317911"><td class="cellrowborder" valign="top" width="19.93%" headers="mcps1.3.4.4.2.5.1.1 "><p id="obs_04_0101__obs_04_0082_p81172334910">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="12.629999999999999%" headers="mcps1.3.4.4.2.5.1.2 "><p id="obs_04_0101__obs_04_0082_p74101432101810">String</p>
</td>
<td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.3.4.4.2.5.1.3 "><p id="obs_04_0101__obs_04_0082_p1811710339915">No</p>
</td>
<td class="cellrowborder" valign="top" width="55.779999999999994%" headers="mcps1.3.4.4.2.5.1.4 "><p id="obs_04_0101__obs_04_0082_p4915529112011"><strong id="obs_04_0101__b126473619195311">Definition</strong>:</p>
<p id="obs_04_0101__obs_04_0082_p155114443566">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0101__obs_04_0082_p159151529172013"><strong id="obs_04_0101__b193845184795526">Constraints</strong>:</p>
<p id="obs_04_0101__obs_04_0082_p143311938205210">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0101__obs_04_0082_p1091519295206"><strong id="obs_04_0101__b45470746395743">Range</strong>:</p>
<p id="obs_04_0101__obs_04_0082_p10891636161916">requester</p>
<p id="obs_04_0101__obs_04_0082_p5915112992010"><strong id="obs_04_0101__b133626432195538">Default value</strong>:</p>
<p id="obs_04_0101__obs_04_0082_p854916466518">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0101__section55803155"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0101__p67006934">This request involves no elements.</p>
</div>
@ -96,7 +127,7 @@ Content-Length:<span class="w"> </span>length
<span class="w"> </span><span class="nt">&lt;ID&gt;</span>ownerid<span class="nt">&lt;/ID&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;/Owner&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;StorageClass&gt;</span>storageclass<span class="nt">&lt;/StorageClass&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;PartNumberMarker&gt;</span>partNmebermarker<span class="nt">&lt;/PartNumberMarker&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;PartNumberMarker&gt;</span>partNumbermarker<span class="nt">&lt;/PartNumberMarker&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;NextPartNumberMarker&gt;</span>nextPartnumberMarker<span class="nt">&lt;/NextPartNumberMarker&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;MaxParts&gt;</span>maxParts<span class="nt">&lt;/MaxParts&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;IsTruncated&gt;</span>true<span class="nt">&lt;/IsTruncated&gt;</span><span class="w"> </span>
@ -111,10 +142,37 @@ Content-Length:<span class="w"> </span>length
</div>
</div>
<div class="section" id="obs_04_0101__section23761681"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0101__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
</div>
<div class="section" id="obs_04_0101__section12528537"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0101__p66441434">This response uses elements to return information about uploaded parts. <a href="#obs_04_0101__table33229135">Table 2</a> describes the elements.</p>
<p id="obs_04_0101__p143785356613">In addition to the common response headers, the header listed in <a href="#obs_04_0101__table172904210301">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0101__table33229135"></a><a name="table33229135"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0101__table33229135" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="obs_04_0101__row64592765"><th align="left" class="cellrowborder" valign="top" width="26.26%" id="mcps1.3.8.3.2.3.1.1"><p id="obs_04_0101__p64631451">Element</p>
<div class="tablenoborder"><a name="obs_04_0101__table172904210301"></a><a name="table172904210301"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0101__table172904210301" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header</caption><thead align="left"><tr id="obs_04_0101__obs_04_0086_row029110203010"><th align="left" class="cellrowborder" valign="top" width="23.14%" id="mcps1.3.7.4.2.4.1.1"><p id="obs_04_0101__obs_04_0086_p182917217303"><strong id="obs_04_0101__b193701429495331">Header</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.99%" id="mcps1.3.7.4.2.4.1.2"><p id="obs_04_0101__obs_04_0086_p1078810532411"><strong id="obs_04_0101__b18323314195339">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.87%" id="mcps1.3.7.4.2.4.1.3"><p id="obs_04_0101__obs_04_0086_p142912215302"><strong id="obs_04_0101__b77828756895440">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0101__obs_04_0086_row229182183011"><td class="cellrowborder" valign="top" width="23.14%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0101__obs_04_0086_p4291112123010">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="11.99%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0101__obs_04_0086_p17789115172410">string</p>
</td>
<td class="cellrowborder" valign="top" width="64.87%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0101__obs_04_0086_p451692516220"><strong id="obs_04_0101__b193170612695311">Definition</strong>:</p>
<p id="obs_04_0101__obs_04_0086_p7516202518210">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0101__obs_04_0086_p1551619258218"><strong id="obs_04_0101__b138432058395526">Constraints</strong>:</p>
<p id="obs_04_0101__obs_04_0086_p145161125625">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0101__obs_04_0086_p165161259212"><strong id="obs_04_0101__b189541623795743">Range</strong>:</p>
<p id="obs_04_0101__obs_04_0086_p051615259213">requester</p>
<p id="obs_04_0101__obs_04_0086_p20516162510216"><strong id="obs_04_0101__b41680862995538">Default value</strong>:</p>
<p id="obs_04_0101__obs_04_0086_p1851614251728">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0101__section12528537"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0101__p66441434">This response uses elements to return information about uploaded parts. <a href="#obs_04_0101__table33229135">Table 4</a> describes the elements.</p>
<div class="tablenoborder"><a name="obs_04_0101__table33229135"></a><a name="table33229135"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0101__table33229135" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response elements</caption><thead align="left"><tr id="obs_04_0101__row64592765"><th align="left" class="cellrowborder" valign="top" width="26.26%" id="mcps1.3.8.3.2.3.1.1"><p id="obs_04_0101__p64631451">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="73.74000000000001%" id="mcps1.3.8.3.2.3.1.2"><p id="obs_04_0101__p5905309">Description</p>
</th>

File diff suppressed because it is too large Load Diff

View File

@ -13,7 +13,7 @@ Authorization:<span class="w"> </span>auth
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0103__section35169792"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0103__p4605046">This request uses message parameters to specify the multipart upload task number of the segment task. <a href="#obs_04_0103__table46411854">Table 1</a> describes the parameters.</p>
<div class="section" id="obs_04_0103__section35169792"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0103__p4605046">This request uses message parameters to specify the multipart upload task number. <a href="#obs_04_0103__table46411854">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="obs_04_0103__table46411854"></a><a name="table46411854"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0103__table46411854" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0103__row5822871"><th align="left" class="cellrowborder" valign="top" width="24.240000000000002%" id="mcps1.3.3.3.2.4.1.1"><p id="obs_04_0103__p1890565">Parameter</p>
</th>
@ -36,6 +36,37 @@ Authorization:<span class="w"> </span>auth
</div>
</div>
<div class="section" id="obs_04_0103__section48092677"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0103__p25092644">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
<p id="obs_04_0103__p1153442642015">In addition to the common request headers, the header listed in <a href="#obs_04_0103__table101171333196">Table 2</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0103__table101171333196"></a><a name="table101171333196"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0103__table101171333196" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional request header</caption><thead align="left"><tr id="obs_04_0103__obs_04_0082_row6117193312912"><th align="left" class="cellrowborder" valign="top" width="19.93%" id="mcps1.3.4.4.2.5.1.1"><p id="obs_04_0103__obs_04_0082_p1117153318914"><strong id="obs_04_0103__b179437277495246">Header</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.629999999999999%" id="mcps1.3.4.4.2.5.1.2"><p id="obs_04_0103__obs_04_0082_p18410532121819"><strong id="obs_04_0103__b156315545195356">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.66%" id="mcps1.3.4.4.2.5.1.3"><p id="obs_04_0103__obs_04_0082_p121171433497"><strong id="obs_04_0103__b76617675395345">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.779999999999994%" id="mcps1.3.4.4.2.5.1.4"><p id="obs_04_0103__obs_04_0082_p16117183315914"><strong id="obs_04_0103__b5091634029539">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0103__obs_04_0082_row10117163317911"><td class="cellrowborder" valign="top" width="19.93%" headers="mcps1.3.4.4.2.5.1.1 "><p id="obs_04_0103__obs_04_0082_p81172334910">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="12.629999999999999%" headers="mcps1.3.4.4.2.5.1.2 "><p id="obs_04_0103__obs_04_0082_p74101432101810">String</p>
</td>
<td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.3.4.4.2.5.1.3 "><p id="obs_04_0103__obs_04_0082_p1811710339915">No</p>
</td>
<td class="cellrowborder" valign="top" width="55.779999999999994%" headers="mcps1.3.4.4.2.5.1.4 "><p id="obs_04_0103__obs_04_0082_p4915529112011"><strong id="obs_04_0103__b78508727795413">Definition</strong>:</p>
<p id="obs_04_0103__obs_04_0082_p155114443566">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0103__obs_04_0082_p159151529172013"><strong id="obs_04_0103__b58720013595529">Constraints</strong>:</p>
<p id="obs_04_0103__obs_04_0082_p143311938205210">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0103__obs_04_0082_p1091519295206"><strong id="obs_04_0103__b134516823795745">Range</strong>:</p>
<p id="obs_04_0103__obs_04_0082_p10891636161916">requester</p>
<p id="obs_04_0103__obs_04_0082_p5915112992010"><strong id="obs_04_0103__b100007018895541">Default value</strong>:</p>
<p id="obs_04_0103__obs_04_0082_p854916466518">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0103__section30180910"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0103__p38926708">This request involves no elements.</p>
</div>
@ -43,6 +74,33 @@ Authorization:<span class="w"> </span>auth
Date: <em id="obs_04_0103__i37516848">date</em></pre>
</div>
<div class="section" id="obs_04_0103__section28734685"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0103__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<p id="obs_04_0103__p143785356613">In addition to the common response headers, the header listed in <a href="#obs_04_0103__table172904210301">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0103__table172904210301"></a><a name="table172904210301"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0103__table172904210301" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header</caption><thead align="left"><tr id="obs_04_0103__obs_04_0086_row029110203010"><th align="left" class="cellrowborder" valign="top" width="23.14%" id="mcps1.3.7.4.2.4.1.1"><p id="obs_04_0103__obs_04_0086_p182917217303"><strong id="obs_04_0103__b168411972295246">Header</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.99%" id="mcps1.3.7.4.2.4.1.2"><p id="obs_04_0103__obs_04_0086_p1078810532411"><strong id="obs_04_0103__b4676210095356">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.87%" id="mcps1.3.7.4.2.4.1.3"><p id="obs_04_0103__obs_04_0086_p142912215302"><strong id="obs_04_0103__b466033169539">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0103__obs_04_0086_row229182183011"><td class="cellrowborder" valign="top" width="23.14%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0103__obs_04_0086_p4291112123010">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="11.99%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0103__obs_04_0086_p17789115172410">string</p>
</td>
<td class="cellrowborder" valign="top" width="64.87%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0103__obs_04_0086_p451692516220"><strong id="obs_04_0103__b209285967795413">Definition</strong>:</p>
<p id="obs_04_0103__obs_04_0086_p7516202518210">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0103__obs_04_0086_p1551619258218"><strong id="obs_04_0103__b157039810695529">Constraints</strong>:</p>
<p id="obs_04_0103__obs_04_0086_p145161125625">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0103__obs_04_0086_p165161259212"><strong id="obs_04_0103__b189617504595745">Range</strong>:</p>
<p id="obs_04_0103__obs_04_0086_p051615259213">requester</p>
<p id="obs_04_0103__obs_04_0086_p20516162510216"><strong id="obs_04_0103__b168294724995541">Default value</strong>:</p>
<p id="obs_04_0103__obs_04_0086_p1851614251728">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0103__section57285581"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0103__p1704444">This response contains no elements.</p>
</div>

View File

@ -8,6 +8,8 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0106.html">SSE-KMS</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0173.html">SSE-OBS</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0107.html">SSE-C</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0108.html">API Operations Related to Server-Side Encryption</a></strong><br>

View File

@ -22,26 +22,26 @@
</td>
<td class="cellrowborder" valign="top" width="18.4%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0106__p42669278493">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0106__p7134184955020"><strong id="obs_04_0106__b112951647783845">Explanation</strong>:</p>
<p id="obs_04_0106__p43151819496">Indicates that SSE-KMS is used for server-side encryption.</p>
<p id="obs_04_0106__p11315187494">Example: <strong id="obs_04_0106__b521080386">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0106__p143311189369"><strong id="obs_04_0106__b1333101810365">Restrictions</strong>:</p>
<p id="obs_04_0106__p13332018103617">None</p>
<p id="obs_04_0106__p633111883619"><strong id="obs_04_0106__b1233718173611">Value range</strong>:</p>
<ul id="obs_04_0106__ul1477842216363"><li id="obs_04_0106__li1778132273614">kms</li><li id="obs_04_0106__li10778142214364">AES256</li></ul>
<p id="obs_04_0106__p17331118163611"><strong id="obs_04_0106__b133101817366">Default value</strong>:</p>
<p id="obs_04_0106__p933418153615">kms</p>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0106__p136788095614"><strong id="obs_04_0106__b1067840125610">Definition</strong>:</p>
<p id="obs_04_0106__p117967166149">Encryption mode.</p>
<p id="obs_04_0106__p3815923144910">Example: <strong id="obs_04_0106__b4174901149322">x-obs-server-side-encryption:AES256</strong></p>
<p id="obs_04_0106__p167880205611"><strong id="obs_04_0106__b867819095617">Constraints</strong>:</p>
<p id="obs_04_0106__p46785016563">None</p>
<p id="obs_04_0106__p781716772117"><strong id="obs_04_0106__b1681727152119">Range</strong>:</p>
<ul id="obs_04_0106__ul0596105416132"><li id="obs_04_0106__li1853893595612">kms: SSE-KMS is used.</li><li id="obs_04_0106__li35969543139">AES256: SSE-OBS is used and the AES256 algorithm is used.</li></ul>
<p id="obs_04_0106__p19679140135611"><strong id="obs_04_0106__b1967940165616">Default value</strong>:</p>
<p id="obs_04_0106__p11651184994812">None</p>
</td>
</tr>
<tr id="obs_04_0106__row7381804910"><td class="cellrowborder" valign="top" width="35.36%" headers="mcps1.3.5.2.4.1.1 "><p id="obs_04_0106__p03161816496">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="18.4%" headers="mcps1.3.5.2.4.1.2 "><p id="obs_04_0106__p1426616279495">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0106__p15342554192512"><strong id="obs_04_0106__b112743984713">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0106__p15342554192512"><strong id="obs_04_0106__b112743984713">Definition</strong>:</p>
<p id="obs_04_0106__p103422054142518">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0106__p4342185415257"><strong id="obs_04_0106__b968878625">Restrictions</strong>:</p>
<p id="obs_04_0106__p4342185415257"><strong id="obs_04_0106__b1333101810365">Constraints</strong>:</p>
<p id="obs_04_0106__p6342125462513">This header can only be used when you specify <strong id="obs_04_0106__b14059036583657">kms</strong> for the <strong id="obs_04_0106__b13081973103657">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0106__p23421754102514"><strong id="obs_04_0106__b2065742916">Default value</strong>:</p>
<p id="obs_04_0106__p23421754102514"><strong id="obs_04_0106__b133101817366">Default value</strong>:</p>
<p id="obs_04_0106__p93428548259">If you specify <strong id="obs_04_0106__b12396748403657">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
</td>
</tr>

View File

@ -16,7 +16,7 @@
<tbody><tr id="obs_04_0107__row1412573764215"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0107__p18431172634319">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0107__p1843282614431">Indicates the encryption algorithm for the object when SSE-C is used.</p>
<p id="obs_04_0107__p1143292694311">Example: <strong id="obs_04_0107__b42741427172913">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
<p id="obs_04_0107__p1143292694311">Example: <strong id="obs_04_0107__b162341310363">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
</td>
</tr>
<tr id="obs_04_0107__row1112515375428"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0107__p143416261434">x-obs-server-side-encryption-customer-key</p>
@ -27,7 +27,7 @@
</tr>
<tr id="obs_04_0107__row151254372427"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.1 "><p id="obs_04_0107__p1944018267432">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0107__p144252654312">Indicates the MD5 value of the key for encrypting objects when SSE-C is used. Its value is a Base64-encoded MD5 hash. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.3.1.2 "><p id="obs_04_0107__p144252654312">Indicates the MD5 value of the key for encrypting objects when SSE-C is used. Its value is a Base64-encoded MD5 hash. The MD5 value is used to ensure data integrity during key transmission.</p>
<p id="obs_04_0107__p10442192613436">Example: <strong id="obs_04_0107__b18505193334317">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
</td>
</tr>
@ -59,7 +59,7 @@
</tr>
<tr id="obs_04_0107__row16107185794515"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.2.3.1.1 "><p id="obs_04_0107__p36290124">x-obs-copy-source-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.2.3.1.2 "><p id="obs_04_0107__p53818954">Indicates the MD5 value of the key for decrypting the source object when SSE-C is used. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.2.3.1.2 "><p id="obs_04_0107__p53818954">Indicates the MD5 value of the key for decrypting the source object when SSE-C is used. The MD5 value is used to ensure data integrity during key transmission.</p>
<p id="obs_04_0107__p14608539">Example: <strong id="obs_04_0107__b15976353124315">x-obs-copy-source-server-side-encryption-customer-key:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
</td>
</tr>

View File

@ -12,13 +12,16 @@
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0112__row154451029174017"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p1478220188253">Uploading objects with PUT or POST, appending content to objects, initiating a multipart upload, and uploading, copying, and assembling parts</p>
<tbody><tr id="obs_04_0112__row154451029174017"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p1478220188253">Uploading objects using PUT or POST, appending objects, initiating multipart uploads, uploading parts, copying parts, assembling parts, modifying objects, truncating objects, renaming objects</p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p724153945816"><a href="obs_04_0080.html">Uploading an Object - PUT</a></p>
<p id="obs_04_0112__p102411039145819"><a href="obs_04_0081.html">Uploading an Object - POST</a></p>
<p id="obs_04_0112__p1824123917589"><a href="obs_04_0098.html">Initiating a Multipart Upload</a></p>
<p id="obs_04_0112__p624143916580"><a href="obs_04_0099.html">Uploading Parts</a></p>
<p id="obs_04_0112__p1524113918581"><a href="obs_04_0102.html">Completing a Multipart Upload</a></p>
<p id="obs_04_0112__p19372617402"><a href="obs_04_0092.html">Modifying an Object</a></p>
<p id="obs_04_0112__p68276592406"><a href="obs_04_0093.html">Truncating an Object</a></p>
<p id="obs_04_0112__p95677196415"><a href="obs_04_0094.html">Renaming an Object</a></p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.3 "><p id="obs_04_0112__p14141515444">obs:object:PutObject</p>
</td>
@ -156,13 +159,14 @@
<td class="cellrowborder" valign="top" width="14.285714285714285%" headers="mcps1.3.1.2.5.1.4 "><p id="obs_04_0112__p18695152819719">Supported</p>
</td>
</tr>
<tr id="obs_04_0112__row1343013429256"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p104303428250">Obtaining the object-level WORM retention configuration</p>
<tr id="obs_04_0112__row4752173910143"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p78271856191420">Obtaining the object-level WORM retention configuration</p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p20430134242510"><a href="obs_04_0084.html">Querying Object Metadata</a></p>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p982755617140"><a href="obs_04_0084.html">Querying Object Metadata</a></p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.3 "><p id="obs_04_0112__p444113125542">obs:object:GetObject</p>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.3 "><p id="obs_04_0112__p6408144110235">obs:object:GetObject</p>
<p id="obs_04_0112__p18827165671412">obs:object:GetObjectRetention</p>
</td>
<td class="cellrowborder" valign="top" width="14.285714285714285%" headers="mcps1.3.1.2.5.1.4 "><p id="obs_04_0112__p1143019424256">Supported</p>
<td class="cellrowborder" valign="top" width="14.285714285714285%" headers="mcps1.3.1.2.5.1.4 "><p id="obs_04_0112__p38272056111416">Supported</p>
</td>
</tr>
<tr id="obs_04_0112__row1928942810553"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p029082835519">Adding object tags</p>

View File

@ -525,6 +525,15 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p10933905119">Use an object bucket.</p>
</td>
</tr>
<tr id="obs_04_0115__row1379599144814"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p187951299484">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p879513910480">ForbidAnonReqOverwriteRespHead</p>
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p167951994818">Anonymous users cannot overwrite response headers when calling the object download API.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p1479569124811">Delete the parameters for overwriting response headers, or include a signature to call the object download API.</p>
</td>
</tr>
<tr id="obs_04_0115__row7769934"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p81336202510">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p1913362014515">AccessDenied</p>
@ -756,7 +765,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p16540123517121">FsNotSupport</p>
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p454053571211">POSIX buckets do not support this API.</p>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p454053571211">The parallel file system does not support this API.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p4540123571215">The method is not allowed.</p>
</td>

View File

@ -2,7 +2,7 @@
<h1 class="topictitle1">Obtaining Access Keys (AK/SK)</h1>
<div id="body1559727156453"><p id="obs_04_0116__p183445011362">When you call APIs, you need to use the AK and SK for authentication. To obtain the AK and SK, perform the following steps:</p>
<ol id="obs_04_0116__ol2073512113338"><li id="obs_04_0116__li97331911183311"><span>Log in to the console.</span></li><li id="obs_04_0116__li57335110335"><span>Click the login username in the upper right corner and choose <strong id="obs_04_0116__b84601521104219">My Credentials</strong> from the drop-down list.</span></li><li id="obs_04_0116__li2031416205528"><span>Choose <strong id="obs_04_0116__b1526024014710">Access Keys</strong>.</span></li><li id="obs_04_0116__li16734121112338"><span>Click <strong id="obs_04_0116__b199592312114">Create Access Key</strong>.</span></li><li id="obs_04_0116__li1292210461389"><span>Enter an access key description (optional) and click <strong id="obs_04_0116__b2415540534">OK</strong>.</span></li><li id="obs_04_0116__li18734151123311"><span>Enter the verification code sent to your mobile phone, virtual MFA device, or email, and click <strong id="obs_04_0116__b99301444114710">OK</strong>.</span><p><div class="note" id="obs_04_0116__note177801301011"><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__p197807309116">This step is required only when you have enabled operation protection.</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__li1292210461389"><span>Enter an access key description (optional) and click <strong id="obs_04_0116__b2415540534">OK</strong>.</span></li><li id="obs_04_0116__li18734151123311"><span>Enter the verification code sent to your mobile phone, virtual MFA device, or email, and click <strong id="obs_04_0116__b932420196403">OK</strong>.</span><p><div class="note" id="obs_04_0116__note177801301011"><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__p197807309116">This step is required only when you have enabled operation protection.</p>
</div></div>
</p></li><li id="obs_04_0116__li7735111143318"><span>Click <strong id="obs_04_0116__b393114320405">Download</strong> to obtain 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>
</div></div>

View File

@ -89,6 +89,37 @@ Authorization:<span class="w"> </span>authorization
</div>
</div>
<div class="section" id="obs_04_0160__section18519163972210"><h4 class="sectiontitle">Request Headers</h4><p id="obs_04_0160__p55973588">This request uses common request headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
<p id="obs_04_0160__p1153442642015">In addition to the common request headers, the header listed in <a href="#obs_04_0160__table101171333196">Table 2</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0160__table101171333196"></a><a name="table101171333196"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0160__table101171333196" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional request header</caption><thead align="left"><tr id="obs_04_0160__obs_04_0082_row6117193312912"><th align="left" class="cellrowborder" valign="top" width="19.93%" id="mcps1.3.4.4.2.5.1.1"><p id="obs_04_0160__obs_04_0082_p1117153318914"><strong id="obs_04_0160__b12857152419301">Header</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.629999999999999%" id="mcps1.3.4.4.2.5.1.2"><p id="obs_04_0160__obs_04_0082_p18410532121819"><strong id="obs_04_0160__b553819113311">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.66%" id="mcps1.3.4.4.2.5.1.3"><p id="obs_04_0160__obs_04_0082_p121171433497"><strong id="obs_04_0160__b772742163116">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.779999999999994%" id="mcps1.3.4.4.2.5.1.4"><p id="obs_04_0160__obs_04_0082_p16117183315914"><strong id="obs_04_0160__b139371845318">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0160__obs_04_0082_row10117163317911"><td class="cellrowborder" valign="top" width="19.93%" headers="mcps1.3.4.4.2.5.1.1 "><p id="obs_04_0160__obs_04_0082_p81172334910">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="12.629999999999999%" headers="mcps1.3.4.4.2.5.1.2 "><p id="obs_04_0160__obs_04_0082_p74101432101810">String</p>
</td>
<td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.3.4.4.2.5.1.3 "><p id="obs_04_0160__obs_04_0082_p1811710339915">No</p>
</td>
<td class="cellrowborder" valign="top" width="55.779999999999994%" headers="mcps1.3.4.4.2.5.1.4 "><p id="obs_04_0160__obs_04_0082_p4915529112011"><strong id="obs_04_0160__b166701953111">Definition</strong>:</p>
<p id="obs_04_0160__obs_04_0082_p155114443566">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0160__obs_04_0082_p159151529172013"><strong id="obs_04_0160__b866331963116">Constraints</strong>:</p>
<p id="obs_04_0160__obs_04_0082_p143311938205210">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0160__obs_04_0082_p1091519295206"><strong id="obs_04_0160__b1672218343312">Range</strong>:</p>
<p id="obs_04_0160__obs_04_0082_p10891636161916">requester</p>
<p id="obs_04_0160__obs_04_0082_p5915112992010"><strong id="obs_04_0160__b929320267329">Default value</strong>:</p>
<p id="obs_04_0160__obs_04_0082_p854916466518">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0160__section13747132915619"><h4 class="sectiontitle">Request Elements</h4><p id="obs_04_0160__p162536425568">This request contains no elements.</p>
</div>
@ -109,10 +140,37 @@ Authorization:<span class="w"> </span>authorization
&lt;/ListBucketResult&gt;</pre>
</div>
<div class="section" id="obs_04_0160__section1443783810235"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0160__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
</div>
<div class="section" id="obs_04_0160__section9457950112515"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0160__p31592957">This response lists objects in XML format. Specific elements are described in <a href="#obs_04_0160__table17753706155228">Table 2</a>.</p>
<p id="obs_04_0160__p143785356613">In addition to the common response headers, the header listed in <a href="#obs_04_0160__table172904210301">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0160__table17753706155228"></a><a name="table17753706155228"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0160__table17753706155228" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="obs_04_0160__row5816417"><th align="left" class="cellrowborder" valign="top" width="35.27%" id="mcps1.3.8.3.2.3.1.1"><p id="obs_04_0160__p1367796">Element</p>
<div class="tablenoborder"><a name="obs_04_0160__table172904210301"></a><a name="table172904210301"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0160__table172904210301" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header</caption><thead align="left"><tr id="obs_04_0160__obs_04_0086_row029110203010"><th align="left" class="cellrowborder" valign="top" width="23.14%" id="mcps1.3.7.4.2.4.1.1"><p id="obs_04_0160__obs_04_0086_p182917217303"><strong id="obs_04_0160__b158042003313">Header</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.99%" id="mcps1.3.7.4.2.4.1.2"><p id="obs_04_0160__obs_04_0086_p1078810532411"><strong id="obs_04_0160__b1339216317316">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.87%" id="mcps1.3.7.4.2.4.1.3"><p id="obs_04_0160__obs_04_0086_p142912215302"><strong id="obs_04_0160__b1619715693111">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0160__obs_04_0086_row229182183011"><td class="cellrowborder" valign="top" width="23.14%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0160__obs_04_0086_p4291112123010">x-obs-request-payer</p>
</td>
<td class="cellrowborder" valign="top" width="11.99%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0160__obs_04_0086_p17789115172410">string</p>
</td>
<td class="cellrowborder" valign="top" width="64.87%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0160__obs_04_0086_p451692516220"><strong id="obs_04_0160__b154371611103110">Definition</strong>:</p>
<p id="obs_04_0160__obs_04_0086_p7516202518210">Indicates that the requester agrees to pay for the request and traffic.</p>
<p id="obs_04_0160__obs_04_0086_p1551619258218"><strong id="obs_04_0160__b61832153116">Constraints</strong>:</p>
<p id="obs_04_0160__obs_04_0086_p145161125625">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
<p id="obs_04_0160__obs_04_0086_p165161259212"><strong id="obs_04_0160__b923718397314">Range</strong>:</p>
<p id="obs_04_0160__obs_04_0086_p051615259213">requester</p>
<p id="obs_04_0160__obs_04_0086_p20516162510216"><strong id="obs_04_0160__b17467143010325">Default value</strong>:</p>
<p id="obs_04_0160__obs_04_0086_p1851614251728">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0160__section9457950112515"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0160__p31592957">This response lists objects in XML format. Specific elements are described in <a href="#obs_04_0160__table17753706155228">Table 4</a>.</p>
<div class="tablenoborder"><a name="obs_04_0160__table17753706155228"></a><a name="table17753706155228"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0160__table17753706155228" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response elements</caption><thead align="left"><tr id="obs_04_0160__row5816417"><th align="left" class="cellrowborder" valign="top" width="35.27%" id="mcps1.3.8.3.2.3.1.1"><p id="obs_04_0160__p1367796">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.73%" id="mcps1.3.8.3.2.3.1.2"><p id="obs_04_0160__p57599360">Description</p>
</th>

View File

@ -153,7 +153,7 @@ Content-Length:<span class="w"> </span>441<span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;TagSet&gt;</span>
<span class="w"> </span><span class="nt">&lt;Tag&gt;</span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>TagName1<span class="nt">&lt;/Key&gt;</span>
<span class="w"> </span><span class="nt">&lt;Value&gt;</span>TageSetVaule1<span class="nt">&lt;/Value&gt;</span>
<span class="w"> </span><span class="nt">&lt;Value&gt;</span>TagSetValue1<span class="nt">&lt;/Value&gt;</span>
<span class="w"> </span><span class="nt">&lt;/Tag&gt;</span>
<span class="w"> </span><span class="nt">&lt;/TagSet&gt;</span>
<span class="nt">&lt;/Tagging&gt;</span>

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