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

OBS API DOC

Browse Source 
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
This commit is contained in:
zhangyue 2023-10-27 13:05:29 +00:00 committed by zuul
parent 49c41314df
commit a51a411ad8
66 changed files with 1364 additions and 263 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

File diff suppressed because it is too large Load Diff

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

@ -396,7 +396,7 @@
"code":"44"
},
{
"desc":"Cross-region replication refers to the automatic and asynchronous replication of objects across buckets in different regions. By activating the cross-region replication f",
"desc":"Cross-region replication refers to the automatic and asynchronous replication of objects across buckets in different regions. By activating cross-region replication, OBS ",
"product_code":"obs",
"title":"Configuring Cross-Region Replication for a Bucket",
"uri":"obs_04_0046.html",
@ -423,7 +423,7 @@
"code":"47"
},
{
"desc":"This operation adds tags to a bucket.After tags are added to a bucket, all charging data records (CDRs) generated by the requests for this bucket will take the same tags.",
"desc":"This operation adds tags to a bucket.After tags are added to a bucket, all service detail records (SDRs) generated by the requests for this bucket will have the same tags",
"product_code":"obs",
"title":"Configuring Tags for a Bucket",
"uri":"obs_04_0049.html",
@ -504,7 +504,7 @@
"code":"56"
},
{
"desc":"OBS uses the PUT method to create or update the default server-side encryption for a bucket.After encryption is enabled for a bucket, objects uploaded to the bucket are e",
"desc":"OBS uses the PUT method to create or update the default server-side encryption for a bucket.After you configure encryption for a bucket, objects uploaded to this bucket w",
"product_code":"obs",
"title":"Configuring Bucket Encryption",
"uri":"obs_04_0062.html",
@ -666,7 +666,7 @@
"code":"74"
},
{
"desc":"This operation uploads an object to a bucket. To use this operation, you must have the write permission on the bucket.The name of each object in a bucket must be unique.W",
"desc":"This operation uploads an object to a bucket. To use this operation, you must have the write permission for the bucket.The name of each object in a bucket must be unique.",
"product_code":"obs",
"title":"Uploading Objects - POST",
"uri":"obs_04_0081.html",
@ -839,7 +839,7 @@
{
"desc":"You can perform this operation to query all parts associated to a multipart upload. The size of each part listed by this API is the same as the size of the part uploaded.",
"product_code":"obs",
"title":"Listing Uploaded Parts of an Object",
"title":"Listing Uploaded Parts",
"uri":"obs_04_0101.html",
"doc_type":"api",
"p_code":"89",
@ -873,7 +873,7 @@
"code":"97"
},
{
"desc":"Users can upload and download objects in common mode or using server-side encryption.OBS supports server-side encryption.Users can implement this function based on the ke",
"desc":"You can configure server-side encryption for objects, so that they will be encrypted or decrypted when you upload them to or download them from a bucket.The encryption an",
"product_code":"obs",
"title":"Server-Side Encryption Overview",
"uri":"obs_04_0105.html",
@ -884,7 +884,7 @@
{
"desc":"With SSE-KMS, OBS uses the keys provided by Key Management Service (KMS) for server-side encryption. You can create custom keys on KMS to encrypt your objects. If you do ",
"product_code":"obs",
"title":"Server-Side Encryption (SSE-KMS)",
"title":"SSE-KMS",
"uri":"obs_04_0106.html",
"doc_type":"api",
"p_code":"97",
@ -893,7 +893,7 @@
{
"desc":"With SSE-C used, OBS uses the keys and MD5 values provided by customers for server-side encryption.OBS does not store your encryption keys. If you lost them, you lost the",
"product_code":"obs",
"title":"Server-Side Encryption (SSE-C)",
"title":"SSE-C",
"uri":"obs_04_0107.html",
"doc_type":"api",
"p_code":"97",
@ -945,9 +945,9 @@
"code":"105"
},
{
"desc":"During API calls, the domain ID (DomainID) and user ID (UserID) need to be specified in some requests. Therefore, you need to obtain them from the console. The procedure ",
"desc":"When making API calls, you may need to specify the domain ID (DomainID) and user ID (UserID) in some requests. To obtain them from the console, do as follows:On the My Cr",
"product_code":"obs",
"title":"Obtaining the Domain ID and User ID",
"title":"Obtaining a Domain ID and a User ID",
"uri":"obs_04_0117.html",
"doc_type":"api",
"p_code":"103",

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

@ -131,7 +131,7 @@
</tr>
<tr id="obs_04_0005__row38862996"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p33548891"><a href="obs_04_0046.html">Configuring Cross-Region Replication for a Bucket</a></p>
</td>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p733154121819">Configures the cross-region replication function for a bucket. By activating the cross-region replication function, OBS can copy new objects and modified objects from a source bucket to destination buckets in different regions.</p>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p733154121819">Configures the cross-region replication function for a bucket. 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>
</td>
</tr>
<tr id="obs_04_0005__row33504565"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p41925888"><a href="obs_04_0047.html">Obtaining the Cross-Region Replication Configuration of a Bucket</a></p>
@ -214,6 +214,16 @@
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p617219155513">Obtains the requester-pays configuration information of a bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row74799439161"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p9479114321619"><a href="obs_04_0167.html">Configuring a Default WORM Policy for a Bucket</a></p>
</td>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p11479164301618">Configures the default WORM policy and a retention period for a bucket.</p>
</td>
</tr>
<tr id="obs_04_0005__row1795746121614"><td class="cellrowborder" valign="top" width="39.910000000000004%" headers="mcps1.3.2.2.2.3.1.1 "><p id="obs_04_0005__p495164691617"><a href="obs_04_0168.html">Obtaining the Default WORM Policy of a Bucket</a></p>
</td>
<td class="cellrowborder" valign="top" width="60.089999999999996%" headers="mcps1.3.2.2.2.3.1.2 "><p id="obs_04_0005__p3951946131619">Returns the default WORM policy of a bucket.</p>
</td>
</tr>
</tbody>
</table>
</div>
@ -346,6 +356,11 @@
<td class="cellrowborder" valign="top" width="59.199999999999996%" headers="mcps1.3.4.2.2.3.1.2 "><p id="obs_04_0005__p14735135813486">Renames an object in a specified parallel file system.</p>
</td>
</tr>
<tr id="obs_04_0005__row227915791819"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p428055718180"><a href="obs_04_0166.html">Configuring WORM Retention for an Object</a></p>
</td>
<td class="cellrowborder" valign="top" width="59.199999999999996%" headers="mcps1.3.4.2.2.3.1.2 "><p id="obs_04_0005__p1828055717189">Configures or updates the retention period for objects uploaded to a bucket with WORM enabled.</p>
</td>
</tr>
</tbody>
</table>
</div>
@ -377,7 +392,7 @@
<td class="cellrowborder" valign="top" width="59.35%" headers="mcps1.3.5.2.2.3.1.2 "><p id="obs_04_0005__p1056291419425">Copies an object or a part of the object as a part of a multipart task.</p>
</td>
</tr>
<tr id="obs_04_0005__row49422505"><td class="cellrowborder" valign="top" width="40.65%" headers="mcps1.3.5.2.2.3.1.1 "><p id="obs_04_0005__p58136511"><a href="obs_04_0101.html">Listing Uploaded Parts of an Object</a></p>
<tr id="obs_04_0005__row49422505"><td class="cellrowborder" valign="top" width="40.65%" headers="mcps1.3.5.2.2.3.1.1 "><p id="obs_04_0005__p58136511"><a href="obs_04_0101.html">Listing Uploaded Parts</a></p>
</td>
<td class="cellrowborder" valign="top" width="59.35%" headers="mcps1.3.5.2.2.3.1.2 "><p id="obs_04_0005__p1429613313017">Queries information about all parts of a multipart task.</p>
</td>

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

@ -168,7 +168,7 @@
</table>
</div>
</div>
<div class="section" id="obs_04_0007__section14612192315587"><h4 class="sectiontitle">(Optional) Request Body</h4><p id="obs_04_0007__p23132011213">A request body is generally sent in a structured format (for example, JSON or XML). It corresponds to <strong id="obs_04_0007__b367972613329">Content-Type</strong> in the request header and is used to transfer content other than the request header. If the request body contains Chinese characters, these characters must be coded in UTF-8.</p>
<div class="section" id="obs_04_0007__section14612192315587"><h4 class="sectiontitle">(Optional) Request Body</h4><p id="obs_04_0007__p23132011213">A request body is generally sent in a structured format (for example, JSON or XML). It corresponds to <strong id="obs_04_0007__b367972613329">Content-Type</strong> in the request header and is used to transfer content other than the request header. If the request body contains full-width characters, these characters must be coded using UTF-8.</p>
<p id="obs_04_0007__p43235913117">The request body varies according to the APIs. Certain APIs do not require the request body, such as the GET and DELETE APIs.</p>
</div>
<div class="section" id="obs_04_0007__section140743661613"><h4 class="sectiontitle">Sending a Request</h4><p id="obs_04_0007__abe87411d02f441d8acf5a5f63d52edbe">There are two methods to initiate requests based on the constructed request messages:</p>

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

@ -515,37 +515,37 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kd">final</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">SIGN_SEP</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;\n&quot;</span><span class="p">;</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kd">final</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">OBS_PREFIX</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;x-obs-&quot;</span><span class="p">;</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kd">final</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">DEFAULT_ENCODING</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;UTF-8&quot;</span><span class="p">;</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kd">final</span><span class="w"> </span><span class="n">List</span><span class="o">&lt;</span><span class="n">String</span><span class="o">&gt;</span><span class="w"> </span><span class="n">SUB_RESOURCES</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">Collections</span><span class="p">.</span><span class="na">unmodifiableList</span><span class="p">(</span><span class="n">Arrays</span><span class="p">.</span><span class="na">asList</span><span class="p">(</span>
<span class="w"> </span><span class="s">&quot;CDNNotifyConfiguration&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;acl&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;attname&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;cors&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;customdomain&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;delete&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;deletebucket&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;encryption&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;length&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;lifecycle&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;location&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;logging&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;metadata&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;mirrorBackToSource&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;modify&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;name&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;notification&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;obscompresspolicy&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;partNumber&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;policy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;position&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;quota&quot;</span><span class="p">,</span><span class="s">&quot;rename&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;replication&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;requestPayment&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-cache-control&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;response-content-disposition&quot;</span><span class="p">,</span><span class="s">&quot;response-content-encoding&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-language&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-type&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;response-expires&quot;</span><span class="p">,</span><span class="s">&quot;restore&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storageClass&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storagePolicy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storageinfo&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;tagging&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;torrent&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;truncate&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;uploadId&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;uploads&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versionId&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versioning&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versions&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;website&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;x-obs-security-token&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;object-lock&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;retention&quot;</span><span class="p">));</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">ak</span><span class="p">;</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">sk</span><span class="p">;</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="nf">urlEncode</span><span class="p">(</span><span class="n">String</span><span class="w"> </span><span class="n">input</span><span class="p">)</span><span class="w"> </span><span class="kd">throws</span><span class="w"> </span><span class="n">UnsupportedEncodingException</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kd">final</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">DEFAULT_ENCODING</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;UTF-8&quot;</span><span class="p">;</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="kd">static</span><span class="w"> </span><span class="kd">final</span><span class="w"> </span><span class="n">List</span><span class="o">&lt;</span><span class="n">String</span><span class="o">&gt;</span><span class="w"> </span><span class="n">SUB_RESOURCES</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">Collections</span><span class="p">.</span><span class="na">unmodifiableList</span><span class="p">(</span><span class="n">Arrays</span><span class="p">.</span><span class="na">asList</span><span class="p">(</span>
<span class="w"> </span><span class="s">&quot;CDNNotifyConfiguration&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;acl&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;attname&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;cors&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;customdomain&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;delete&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;deletebucket&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;encryption&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;length&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;lifecycle&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;location&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;logging&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;metadata&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;mirrorBackToSource&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;modify&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;name&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;notification&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;obscompresspolicy&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;partNumber&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;policy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;position&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;quota&quot;</span><span class="p">,</span><span class="s">&quot;rename&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;replication&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;requestPayment&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-cache-control&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;response-content-disposition&quot;</span><span class="p">,</span><span class="s">&quot;response-content-encoding&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-language&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;response-content-type&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;response-expires&quot;</span><span class="p">,</span><span class="s">&quot;restore&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storageClass&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storagePolicy&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;storageinfo&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;tagging&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;torrent&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;truncate&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;uploadId&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;uploads&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versionId&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versioning&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;versions&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;website&quot;</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="s">&quot;x-obs-security-token&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;object-lock&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;retention&quot;</span><span class="p">));</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">ak</span><span class="p">;</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">sk</span><span class="p">;</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">public</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="nf">urlEncode</span><span class="p">(</span><span class="n">String</span><span class="w"> </span><span class="n">input</span><span class="p">)</span><span class="w"> </span><span class="kd">throws</span><span class="w"> </span><span class="n">UnsupportedEncodingException</span>
<span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="n">URLEncoder</span><span class="p">.</span><span class="na">encode</span><span class="p">(</span><span class="n">input</span><span class="p">,</span><span class="w"> </span><span class="n">DEFAULT_ENCODING</span><span class="p">)</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="n">URLEncoder</span><span class="p">.</span><span class="na">encode</span><span class="p">(</span><span class="n">input</span><span class="p">,</span><span class="w"> </span><span class="n">DEFAULT_ENCODING</span><span class="p">)</span>
<span class="w"> </span><span class="p">.</span><span class="na">replaceAll</span><span class="p">(</span><span class="s">&quot;%7E&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;~&quot;</span><span class="p">)</span><span class="w"> </span><span class="c1">//for browser</span>
<span class="w"> </span><span class="p">.</span><span class="na">replaceAll</span><span class="p">(</span><span class="s">&quot;%2F&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;/&quot;</span><span class="p">)</span>
<span class="w"> </span><span class="p">.</span><span class="na">replaceAll</span><span class="p">(</span><span class="s">&quot;%20&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;+&quot;</span><span class="p">);</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="nf">join</span><span class="p">(</span><span class="n">List</span><span class="o">&lt;?&gt;</span><span class="w"> </span><span class="n">items</span><span class="p">,</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">delimiter</span><span class="p">)</span>
<span class="w"> </span>
<span class="w"> </span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="nf">join</span><span class="p">(</span><span class="n">List</span><span class="o">&lt;?&gt;</span><span class="w"> </span><span class="n">items</span><span class="p">,</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">delimiter</span><span class="p">)</span>
<span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="n">StringBuilder</span><span class="w"> </span><span class="n">sb</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">StringBuilder</span><span class="p">();</span>
<span class="w"> </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">items</span><span class="p">.</span><span class="na">size</span><span class="p">();</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span>
<span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">item</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">items</span><span class="p">.</span><span class="na">get</span><span class="p">(</span><span class="n">i</span><span class="p">).</span><span class="na">toString</span><span class="p">();</span>
<span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">item</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">items</span><span class="p">.</span><span class="na">get</span><span class="p">(</span><span class="n">i</span><span class="p">).</span><span class="na">toString</span><span class="p">();</span>
<span class="w"> </span><span class="n">sb</span><span class="p">.</span><span class="na">append</span><span class="p">(</span><span class="n">item</span><span class="p">);</span>
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">items</span><span class="p">.</span><span class="na">size</span><span class="p">()</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span>
<span class="w"> </span><span class="p">{</span>

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

@ -6,7 +6,7 @@
</div></div>
<p class="MsoNormal" id="obs_04_0021__p179081185526">A bucket name must be unique in OBS. If a user creates a bucket with the same name as that of an existing bucket under the same account and in the same region, a 200 code (indicating success) is returned. In scenarios other than the preceding one, the request for creating a bucket with the same name as that of an existing one will receive the 409 code (indicating that a namesake bucket already exists). To set an access control policy for the bucket to be created, you can add the <strong id="obs_04_0021__b9296141924716">x-obs-acl</strong> parameter to request headers.</p>
</div>
<div class="section" id="obs_04_0021__section63129189"><h4 class="sectiontitle">Storage Class</h4><p id="obs_04_0021__p1459963215332">You can create buckets with different storage classes. The <strong id="obs_04_0021__b1677739888">x-obs-storage-class</strong> header in a bucket creation request specifies the storage class for a bucket. If you do not specify a storage class when you upload an object to the bucket, the object inherits the storage class of the bucket. There are three storage classes: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class) If this header is not in the request, the storage class of the created bucket is Standard.</p>
<div class="section" id="obs_04_0021__section63129189"><h4 class="sectiontitle">Storage Class</h4><p id="obs_04_0021__p1459963215332">You can create buckets with different storage classes. The <strong id="obs_04_0021__b184051333135110">x-obs-storage-class</strong> header in a bucket creation request specifies the bucket's storage class. If you do not specify a storage class when you upload an object to the bucket, the object inherits the storage class of the bucket. The storage class options are as follows: <strong id="obs_04_0021__b1844480112017">STANDARD</strong> (Standard), <strong id="obs_04_0021__b544416082018">WARM</strong> (Warm), <strong id="obs_04_0021__b444480192010">COLD</strong> (Cold). If the <strong id="obs_04_0021__b1819518563534">x-obs-storage-class</strong> header is not in the request, a Standard bucket will be created.</p>
<p class="MsoNormal" id="obs_04_0021__p148955">If the storage class of an object is not specified when it is uploaded to a bucket (see <a href="obs_04_0080.html">Uploading Objects - PUT</a>), the object will be stored in the default storage class of the bucket.</p>
<ul id="obs_04_0021__ul12065374"><li id="obs_04_0021__li41479503">OBS Standard features low access latency and high throughput. It is most suitable for storing frequently accessed (multiple times per month) hot files. Potential application scenarios include big data, mobile applications, trending videos, and social media images.</li><li id="obs_04_0021__li13303135113346">OBS Warm storage class is suitable for storing data that is infrequently accessed (less than 12 times a year) yet has quick response requirements. Potential application scenarios include file synchronization or sharing and enterprise backup. It provides the same durability, access latency, and throughput as the Standard storage class but at a lower price. However, the Warm storage class has lower availability than the Standard one.</li><li id="obs_04_0021__li16303751123411">OBS Cold storage class is applicable to archiving rarely-accessed (averagely once a year) data. The application scenarios include data archiving and long-term data retention for backup. The Cold storage class is secure, durable, and inexpensive, which can replace tape libraries. To keep cost low, it may take hours to restore data from the Cold storage class.</li></ul>
</div>
@ -53,7 +53,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0021__row4054265"><td class="cellrowborder" valign="top" width="24.490000000000002%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0021__p59960025">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p1638234817364">When creating a bucket, you can add this header to specify the default storage class of the bucket. The default storage classes are as follows: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class). If this header is not in the request, the storage class of the bucket created is Standard.</p>
<td class="cellrowborder" valign="top" width="59.18%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0021__p1638234817364">When creating a bucket, you can add this header to specify the default storage class for the bucket. The storage class options are as follows: <strong id="obs_04_0021__b1623715299173">STANDARD</strong> (Standard), <strong id="obs_04_0021__b7872123211712">WARM</strong> (Warm), and <strong id="obs_04_0021__b1975633691711">COLD</strong> (Cold). If this header is not in the request, a Standard bucket will be created.</p>
<p id="obs_04_0021__p22988206">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0021__p50105411">No</p>
@ -183,7 +183,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0021__section40962197"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0021__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_0021__section33115460"><h4 class="sectiontitle">Response Elements</h4><p class="MsoNormal" id="obs_04_0021__p31505145">This response involves no elements.</p>
<div class="section" id="obs_04_0021__section33115460"><h4 class="sectiontitle">Response Elements</h4><p class="MsoNormal" id="obs_04_0021__p31505145">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0021__section29603689"><h4 class="sectiontitle">Error Responses</h4><p class="MsoNormal" id="obs_04_0021__p1779922">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -100,20 +100,24 @@ Authorization:<span class="w"> </span>authorization
</div>
<div class="section" id="obs_04_0022__section12758381"><h4 class="sectiontitle">Request Elements</h4><p id="obs_04_0022__p2556808">This request contains no elements.</p>
</div>
<div class="section" id="obs_04_0022__section47716571"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen5774891"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>status_code
Date:<span class="w"> </span>date
x-obs-bucket-location:<span class="w"> </span>region
Content-Type:<span class="w"> </span>application/xml<span class="w"> </span>
Content-Length:<span class="w"> </span>length
<span class="nt">&lt;Response</span><span class="w"> </span><span class="err">Body</span><span class="nt">&gt;</span>
</pre></div></td></tr></table></div>
</div>
<div class="section" id="obs_04_0022__section47716571"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="obs_04_0022__screen19177179144413">&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ListBucketResult xmlns="http://obs.otc.t-systems.com/doc/2016-01-01/"&gt;
&lt;Name&gt;bucket_name&lt;/Name&gt;
&lt;Prefix&gt;&lt;/Prefix&gt;
&lt;Marker&gt;&lt;/Marker&gt;
&lt;MaxKeys&gt;1000&lt;/MaxKeys&gt;
&lt;IsTruncated&gt;false&lt;/IsTruncated&gt;
&lt;Contents&gt;
&lt;Key&gt;object_name&lt;/Key&gt;
&lt;LastModified&gt;2022-11-11T11:11:11.111Z&lt;/LastModified&gt;
&lt;ETag&gt;"37f80ab36f7c19abe8250e5e00123456"&lt;/ETag&gt;
&lt;Size&gt;55555&lt;/Size&gt;
&lt;Owner&gt;
&lt;ID&gt;e8df38eb4e4f4f148e06d8db50123456&lt;/ID&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;/Contents&gt;
&lt;/ListBucketResult&gt;</pre>
</div>
<div class="section" id="obs_04_0022__section26795963"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0022__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
</div>
@ -417,7 +421,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p34135322">Storage class of an object</p>
<p id="obs_04_0022__p38782450">Type: string</p>
<p id="obs_04_0022__p983512824220">Value options: <strong id="obs_04_0022__b12126123411481">STANDARD</strong>, <strong id="obs_04_0022__b2012617347481">WARM</strong>, <strong id="obs_04_0022__b10126034184812">COLD</strong></p>
<p id="obs_04_0022__p983512824220">Value options: <strong id="obs_04_0022__b383617319217">STANDARD</strong>, <strong id="obs_04_0022__b8836133192117">WARM</strong>, <strong id="obs_04_0022__b1183717317215">COLD</strong></p>
<p id="obs_04_0022__p13497736">Ancestor: ListVersionsResult.Version</p>
</td>
</tr>

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

@ -59,9 +59,9 @@ Date:<span class="w"> </span>date
</div>
</div>
<div class="section" id="obs_04_0023__section34535095"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0023__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<p id="obs_04_0023__p34922606"><a href="#obs_04_0023__table13151171313444">Table 2</a> lists additional response header parameters that are used except for the common response header parameters.</p>
<p id="obs_04_0023__p34922606">In addition to the common response headers, the message headers listed in <a href="#obs_04_0023__table13151171313444">Table 2</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0023__table13151171313444"></a><a name="table13151171313444"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0023__table13151171313444" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0023__row815181319449"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.7.4.2.3.1.1"><p id="obs_04_0023__p357332011449">Header</p>
<div class="tablenoborder"><a name="obs_04_0023__table13151171313444"></a><a name="table13151171313444"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0023__table13151171313444" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0023__row815181319449"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.7.4.2.3.1.1"><p id="obs_04_0023__p357332011449">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.7.4.2.3.1.2"><p id="obs_04_0023__p155736206445">Description</p>
</th>
@ -75,7 +75,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0023__row9151181314410"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.1 "><p id="obs_04_0023__p6681144134416">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p222815391378">Default storage class of the bucket. The options are as follows: <strong id="obs_04_0023__b78091625192111">STANDARD</strong> (Standard), <strong id="obs_04_0023__b107914312116">WARM</strong> (Warm), and <strong id="obs_04_0023__b071264912214">COLD</strong> (Cold).</p>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.4.2.3.1.2 "><p id="obs_04_0023__p222815391378">Default storage class of the bucket. The options are as follows: <strong id="obs_04_0023__b07232019123917">STANDARD</strong> (Standard), <strong id="obs_04_0023__b6655731153911">WARM</strong> (Warm), <strong id="obs_04_0023__b3267153763919">COLD</strong> (Cold).</p>
<p id="obs_04_0023__p86811444134410">Type: string</p>
</td>
</tr>
@ -127,7 +127,7 @@ Date:<span class="w"> </span>date
</table>
</div>
</div>
<div class="section" id="obs_04_0023__section42380405"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0023__p43090167">This response involves no elements.</p>
<div class="section" id="obs_04_0023__section42380405"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0023__p43090167">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0023__section45879330"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0023__p642611">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -31,7 +31,7 @@ Date:<span class="w"> </span>date
</div>
<div class="section" id="obs_04_0025__section12321766"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0025__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_0025__section43787032"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0025__p1039816">This response involves no elements.</p>
<div class="section" id="obs_04_0025__section43787032"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0025__p1039816">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0025__section58538975"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0025__p17116244">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -34,13 +34,13 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0027__section2565517"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0027__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_0027__section23089658"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0027__p19036118">This response involves no elements.</p>
<div class="section" id="obs_04_0027__section23089658"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0027__p19036118">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0027__section6480335"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0027__p65530572">No special error responses are returned. For details, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0027__section7816985174739"><h4 class="sectiontitle">Sample Request 1</h4><p id="obs_04_0027__p06017817213"><strong id="obs_04_0027__b136120251916">Grant permissions to an OBS tenant</strong>.</p>
<p id="obs_04_0027__p53741710144436">Grant permissions to the tenant whose ID is <strong id="obs_04_0027__b2073374316920">783fc6652cf246c096ea836694f71855</strong>.</p>
<p id="obs_04_0027__p924568111514">For details about how to obtain the tenant ID, see <a href="obs_04_0117.html">Obtaining the Domain ID and User ID</a>.</p>
<p id="obs_04_0027__p924568111514">For details about how to obtain the tenant ID, see <a href="obs_04_0117.html">Obtaining a Domain ID and a User ID</a>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0027__screen7883203144447"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
@ -105,7 +105,7 @@ Server:<span class="w"> </span>OBS
</div>
<div class="section" id="obs_04_0027__section62420254162610"><h4 class="sectiontitle">Sample Request 2</h4><p id="obs_04_0027__p960291982112"><strong id="obs_04_0027__b842352706103715">Grant permissions to an OBS user</strong>.</p>
<p id="obs_04_0027__p16263207144548">The user ID is <strong id="obs_04_0027__b649711143112">71f3901173514e6988115ea2c26d1999</strong>, and the account ID is <strong id="obs_04_0027__b149814146116">783fc6652cf246c096ea836694f71855</strong>.</p>
<p id="obs_04_0027__p95111020229">For details about how to obtain the account ID and user ID, see <a href="obs_04_0117.html">Obtaining the Domain ID and User ID</a>.</p>
<p id="obs_04_0027__p95111020229">For details about how to obtain the account ID and user ID, see <a href="obs_04_0117.html">Obtaining a Domain ID and a User ID</a>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0027__screen43469162144559"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
@ -170,7 +170,7 @@ Server:<span class="w"> </span>OBS
</div>
<div class="section" id="obs_04_0027__section18012296430"><h4 class="sectiontitle">Sample Request 3</h4><p id="obs_04_0027__p765843452119"><strong id="obs_04_0027__b12901747191618">Deny all users except the specified one all the operation permissions</strong>.</p>
<p id="obs_04_0027__p7510155920435">The user ID is <strong id="obs_04_0027__b12262652153511">71f3901173514e6988115ea2c26d1999</strong>, and the account ID is <strong id="obs_04_0027__b17417817368">783fc6652cf246c096ea836694f71855</strong>.</p>
<p id="obs_04_0027__p19354162619221">For details about how to obtain the account ID and user ID, see <a href="obs_04_0117.html">Obtaining the Domain ID and User ID</a>.</p>
<p id="obs_04_0027__p19354162619221">For details about how to obtain the account ID and user ID, see <a href="obs_04_0117.html">Obtaining a Domain ID and a User ID</a>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0027__screen92591418114414"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>

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

@ -35,7 +35,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0029__section66641315"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0029__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_0029__section62900926"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0029__p27546096">This response involves no elements.</p>
<div class="section" id="obs_04_0029__section62900926"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0029__p27546096">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0029__section29237425"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0029__p16641336">No special error responses are returned. For details, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

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

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

@ -361,7 +361,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0032__section28032721"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0032__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_0032__section50967898"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0032__p52134235">This response involves no elements.</p>
<div class="section" id="obs_04_0032__section50967898"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0032__p52134235">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0032__section56057905"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0032__p62123516">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -220,7 +220,7 @@ Content-MD5:<span class="w"> </span>MD5
<p id="obs_04_0034__p20305823">Children node: NoncurrentDays, StorageClass</p>
<p id="obs_04_0034__p48534684">Ancestor node: Rule</p>
</td>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p38995332">Required if the <strong id="obs_04_0034__b1385673702">Transition</strong>, <strong id="obs_04_0034__b539982119">Expiration</strong>, <strong id="obs_04_0034__b187701445812">AbortIncompleteMultipartUpload</strong>, or <strong id="obs_04_0034__b1830737814">NoncurrentVersionExpiration</strong> element is absent.</p>
<td class="cellrowborder" valign="top" width="20.200000000000003%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0034__p38995332">Required if the <strong id="obs_04_0034__b383910001">Transition</strong>, <strong id="obs_04_0034__b2113801632">Expiration</strong>, <strong id="obs_04_0034__b187701445812">AbortIncompleteMultipartUpload</strong>, or <strong id="obs_04_0034__b237906129">NoncurrentVersionExpiration</strong> element is absent.</p>
</td>
</tr>
<tr id="obs_04_0034__row15413673"><td class="cellrowborder" valign="top" width="27.27%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0034__p40548035">NoncurrentVersionExpiration</p>
@ -299,7 +299,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0034__section47227600"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0034__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_0034__section22395217"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0034__p49591759">This response involves no elements.</p>
<div class="section" id="obs_04_0034__section22395217"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0034__p49591759">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0034__section230369"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0034__p57509508">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -34,7 +34,7 @@ Date:<span class="w"> </span>date
</div>
<div class="section" id="obs_04_0036__section63914128"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0036__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_0036__section38356240"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0036__p59393822">This response involves no elements.</p>
<div class="section" id="obs_04_0036__section38356240"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0036__p59393822">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0036__section9661843"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0036__p46170314">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -81,7 +81,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0037__section8877856"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0037__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_0037__section12791844"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0037__p27783412">This response involves no elements.</p>
<div class="section" id="obs_04_0037__section12791844"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0037__p27783412">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0037__section48017739"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0037__p35863881">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -218,7 +218,7 @@ Content-Type:<span class="w"> </span>type
</div>
<div class="section" id="obs_04_0039__section63826011"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0039__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_0039__section37563192"><h4 class="sectiontitle">Response Elements</h4><p class="MsoNormal" id="obs_04_0039__p27029470">This response involves no elements.</p>
<div class="section" id="obs_04_0039__section37563192"><h4 class="sectiontitle">Response Elements</h4><p class="MsoNormal" id="obs_04_0039__p27029470">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0039__section2524413"><h4 class="sectiontitle">Error Responses</h4><p class="MsoNormal" id="obs_04_0039__p41903465">When this operation is being called, the system checks whether the <strong id="obs_04_0039__b1435147703">NotificationConfiguration</strong> element is valid and whether the configuration is valid. The following table lists the common errors and possible causes of this operation.</p>

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

@ -46,7 +46,7 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>
<td class="cellrowborder" valign="top" width="51%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0044__p23397285">Specifies the default storage class for a bucket.</p>
<p id="obs_04_0044__p4701910132510">Type: string</p>
<p id="obs_04_0044__p78072113256">Value options: <strong id="obs_04_0044__b11157171664314">STANDARD</strong>, <strong id="obs_04_0044__b7160122504318">WARM</strong>, <strong id="obs_04_0044__b1099115294433">COLD</strong></p>
<p id="obs_04_0044__p15884183444011">The available storage classes include Standard (<strong id="obs_04_0044__b116747265409">STANDARD</strong>), Warm (<strong id="obs_04_0044__b13777134919406">WARM</strong>), and Cold (<strong id="obs_04_0044__b0223652194012">COLD</strong>).</p>
<p id="obs_04_0044__p15884183444011">The available storage classes are as follows: Standard (<strong id="obs_04_0044__b1157914452516">STANDARD</strong>), Warm (<strong id="obs_04_0044__b205795452520">WARM</strong>), Cold (<strong id="obs_04_0044__b8579345259">COLD</strong>). </p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0044__p10969390">Yes</p>
</td>
@ -64,7 +64,7 @@ Date:<span class="w"> </span>date<span class="w"> </span>
</div>
<div class="section" id="obs_04_0044__section4403461"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0044__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_0044__section39631152"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0044__p56965307">This response involves no elements.</p>
<div class="section" id="obs_04_0044__section39631152"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0044__p56965307">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0044__section21136050"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0044__p50787178">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -1,7 +1,7 @@
<a name="obs_04_0046"></a><a name="obs_04_0046"></a>
<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 the cross-region replication function, OBS can copy new objects and modified objects from a source bucket to destination buckets in different regions.</p>
<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>
<p class="msonormal" id="obs_04_0046__p48546637">The following two requirements must be met when configuring the cross-region replication for a bucket:</p>
<ol id="obs_04_0046__ol34266555"><li id="obs_04_0046__li37398182">Cross-region replication can be configured only when the versioning statuses of the source and destination buckets are the same. For details about how to configure bucket versioning, see <a href="obs_04_0037.html">Configuring Versioning for a Bucket</a>.</li><li id="obs_04_0046__li9353888">The owner and agency (OBS) of the source bucket must have the permission to write the destination bucket (configured with <strong id="obs_04_0046__b1592694132310">BucketPolicy</strong>), and the agency (OBS) must have the read permission for the source bucket. This permission delegation needs to be implemented by calling the <strong id="obs_04_0046__b16791144117276">BucketPolicy</strong> API.</li></ol>
<p class="msonormal" id="obs_04_0046__p24127570">For details about how to configure the bucket policy, see <a href="obs_04_0027.html">Configuring a Bucket Policy</a>. After the bucket policy is set, the agency (OBS) can read objects from the source bucket and copy objects to the destination bucket.</p>
@ -209,7 +209,7 @@ Content-Length:<span class="w"> </span>contentlength
</div>
<div class="section" id="obs_04_0046__section23710250"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0046__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_0046__section12065659"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0046__p3724653">This response involves no elements.</p>
<div class="section" id="obs_04_0046__section12065659"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0046__p3724653">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0046__section41482067"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0046__p33261462">No special error responses are returned for this request.</p>
</div>

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

@ -33,7 +33,7 @@ Connection:<span class="w"> </span>keep-alive
</div>
<div class="section" id="obs_04_0048__section57572026"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0048__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_0048__section48386187"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0048__p18525005">This response involves no elements.</p>
<div class="section" id="obs_04_0048__section48386187"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0048__p18525005">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0048__section32822506"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0048__p24130428">No special error responses are returned for this request.</p>
</div>

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

@ -2,9 +2,9 @@
<h1 class="topictitle1">Configuring Tags for a Bucket</h1>
<div id="body1522727142744"><div class="section" id="obs_04_0049__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0049__p1985519852420">This operation adds tags to a bucket.</p>
<p id="obs_04_0049__p785517882418">After tags are added to a bucket, all charging data records (CDRs) generated by the requests for this bucket will take the same tags. Thus, CDR reports can be categorized for detailed cost analysis. For example, if a running application uploads data to a bucket, you can tag the bucket with the application name. In this manner, the costs on the application can be analyzed using tags on CDRs.</p>
<p id="obs_04_0049__p785517882418">After tags are added to a bucket, all service detail records (SDRs) generated by the requests for this bucket will have the same tags. You can categorize the SDRs for detailed cost analysis. For example, if a running application uploads data to a bucket, you can tag the bucket with the application name. In this manner, the costs on the application can be analyzed using tags in SDRs.</p>
<p id="obs_04_0049__p1485518152413">To perform this operation, you must have the <strong id="obs_04_0049__b195451167169">PutBucketTagging</strong> permission. By default, only the bucket owner can delete the tags of a bucket. The bucket owner can allow other users to perform this operation by setting a bucket policy or granting them the permission.</p>
<div class="note" id="obs_04_0049__note878716573168"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_04_0049__ul1636661521717"><li id="obs_04_0049__li83661215171711">A bucket can have a maximum of 10 tags.</li><li id="obs_04_0049__li451851791819">A tag key and key value can contain a maximum of 36 and 43 characters, respectively.</li><li id="obs_04_0049__li199962513289">Tag keys and key values cannot contain commas (,), asterisks (*), vertical bars (|), slashes (/), less-than signs (&lt;), greater-than signs (&gt;), equal signs (=), backslashes (\), or ASCII codes (0x00 to 0x1F).</li></ul>
<div class="note" id="obs_04_0049__note878716573168"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_04_0049__ul1636661521717"><li id="obs_04_0049__li83661215171711">A bucket can have up to 20 tags.</li><li id="obs_04_0049__li451851791819">A tag key and key value can contain a maximum of 36 and 43 characters, respectively.</li><li id="obs_04_0049__li199962513289">Tag keys and values cannot contain commas (,), asterisks (*), vertical bars (|), slashes (/), less-than signs (&lt;), greater-than signs (&gt;), equal signs (=), backslashes (\), or ASCII control character code (0x00 to 0x1F). These tag keys and values must be URL encoded before being sent to a server.</li></ul>
</div></div>
</div>
<div class="section" id="obs_04_0049__section20347124652614"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0049__screen656246211548"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
@ -135,7 +135,7 @@ Date:<span class="w"> </span>date
</div>
<div class="section" id="obs_04_0049__section1253385718430"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0049__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_0049__section7363166184419"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0049__p1281810185018">This response involves no elements.</p>
<div class="section" id="obs_04_0049__section7363166184419"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0049__p1281810185018">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0049__section8123191694414"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0049__p45601120165018">In addition to common error codes, this API also returns other error codes. The following table lists common errors and possible causes. For details, see <a href="#obs_04_0049__table12876123320500">Table 3</a>.</p>
@ -165,7 +165,8 @@ Date:<span class="w"> </span>date
</table>
</div>
</div>
<div class="section" id="obs_04_0049__section14819157124617"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0049__screen42901510155312"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0049__section14819157124617"><h4 class="sectiontitle">Sample Request</h4><p id="obs_04_0049__p16581418134619">This example adds a tag whose key is <strong id="obs_04_0049__b1277982918305">TagKey(Name1)</strong> and value is <strong id="obs_04_0049__b2136154233019">TagValue(Value1)</strong> to bucket <strong id="obs_04_0049__b9680345143014">examplebucket</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0049__screen42901510155312"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
@ -193,8 +194,8 @@ Content-Length:<span class="w"> </span>182
<span class="nt">&lt;Tagging</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;http://obs.example.com/doc/2015-06-30/&quot;</span><span class="nt">&gt;</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;Key&gt;</span>TagKey%28Name1%29<span class="nt">&lt;/Key&gt;</span>
<span class="w"> </span><span class="nt">&lt;Value&gt;</span>TagValue%28Value1%29<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>

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

@ -36,7 +36,7 @@ Date:<span class="w"> </span>date
</div>
<div class="section" id="obs_04_0051__section0233121717529"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0051__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_0051__section151181751135216"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0051__p5814125795219">This response involves no elements.</p>
<div class="section" id="obs_04_0051__section151181751135216"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0051__p5814125795219">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0051__section1211411715310"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0051__p9928192695312">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -65,7 +65,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0052__section10860736"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0052__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_0052__section30637762"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0052__p23768554">This response involves no elements.</p>
<div class="section" id="obs_04_0052__section30637762"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0052__p23768554">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0052__section7304408"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0052__p46204722">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -66,7 +66,7 @@ Content-Length:<span class="w"> </span>0
</div>
<div class="section" id="obs_04_0059__section25421546193914"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0059__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_0059__section37921407409"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0059__p1844815207155">This response involves no elements.</p>
<div class="section" id="obs_04_0059__section37921407409"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0059__p1844815207155">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0059__section7651222194014"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0059__p117237512114">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -60,7 +60,7 @@ Date:<span class="w"> </span>date
</div>
<div class="section" id="obs_04_0061__section1033718854612"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0061__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_0061__section1193415543460"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0061__p157031112183617">This response involves no elements.</p>
<div class="section" id="obs_04_0061__section1193415543460"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0061__p157031112183617">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0061__section69808131474"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0061__p117033916213">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -2,10 +2,10 @@
<h1 class="topictitle1">Configuring Bucket Encryption</h1>
<div id="body1549963978429"><div class="section" id="obs_04_0062__section154118471125"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0062__p199653120135">OBS uses the PUT method to create or update the default server-side encryption for a bucket.</p>
<p id="obs_04_0062__p15667131417392">After encryption is enabled for a bucket, objects uploaded to the bucket are encrypted with the encryption configuration the bucket. Currently, it only supports the server-side encryption using keys hosted by KMS (SSE-KMS). For details about SSE-KMS, see <a href="obs_04_0106.html">Server-Side Encryption (SSE-KMS)</a>.</p>
<p id="obs_04_0062__p55541638152311">To perform this operation, you must have the permission to configure encryption for the bucket. By default, the bucket owner has this permission and can assign this permission to other users.</p>
<p id="obs_04_0062__p52751062712">After you configure encryption for a bucket, objects uploaded to this bucket will be encrypted with the bucket encryption settings you specified. Available encryption methods include server-side encryption with KMS-managed keys (SSE-KMS) and server-side encryption with customer-provided keys (SSE-C). For details, see <a href="obs_04_0104.html">Server-Side Encryption</a>.</p>
<p id="obs_04_0062__p55541638152311">To perform this operation, you must have the <strong id="obs_04_0062__b1543122123112">PutEncryptionConfiguration</strong> permission. By default, the bucket owner has this permission and can grant it to others.</p>
</div>
<div class="section" id="obs_04_0062__section4392141416911"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0062__screen656246211548"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<div class="section" id="obs_04_0062__section4392141416911"><h4 class="sectiontitle">Request Syntax (SSE-KMS)</h4><div class="codecoloring" codetype="Xml" id="obs_04_0062__screen656246211548"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
@ -40,7 +40,7 @@ Content-Length:<span class="w"> </span>length
</div>
</div>
<div class="section" id="obs_04_0062__section5883101142415"><h4 class="sectiontitle">Request parameters</h4><p id="obs_04_0062__p174461242241">This request contains no message parameters.</p>
<div class="section" id="obs_04_0062__section5883101142415"><h4 class="sectiontitle">Request Parameters</h4><p id="obs_04_0062__p174461242241">This request contains no message parameters.</p>
</div>
<div class="section" id="obs_04_0062__section1363153342420"><h4 class="sectiontitle">Request Headers</h4><p id="obs_04_0062__p146681635112411">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
@ -99,9 +99,9 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p19616854174215">Customer master key (CMK) used in SSE-KMS encryption mode. If you do not specify this header, the default master key will be used.</p>
<p id="obs_04_0062__p7616135414424">Type: string</p>
<p id="obs_04_0062__p6679135313114">Valid value formats are as follows:</p>
<ol id="obs_04_0062__ol28871657184419"><li id="obs_04_0062__li388775774418"><em id="obs_04_0062__i513511341548">regionID:domainID (account ID)</em><strong id="obs_04_0062__b10135133425411">:key/</strong><em id="obs_04_0062__i41351334115418">key_id</em></li><li id="obs_04_0062__li1216183134518"><em id="obs_04_0062__i18971441107541">key_id</em></li></ol>
<ol id="obs_04_0062__ol28871657184419"><li id="obs_04_0062__li388775774418"><em id="obs_04_0062__i19524203191914">regionID</em><strong id="obs_04_0062__b111901227191919">:</strong><em id="obs_04_0062__i10933173413191">domainID</em><strong id="obs_04_0062__b10135133425411">:key/</strong><em id="obs_04_0062__i41351334115418">key_id</em></li><li id="obs_04_0062__li1216183134518"><em id="obs_04_0062__i18971441107541">key_id</em></li></ol>
<p id="obs_04_0062__p5150033112717">In the preceding formats:</p>
<ul id="obs_04_0062__ul1812312350279"><li id="obs_04_0062__li48526363273"><em id="obs_04_0062__i1082183695015">regionID</em> indicates the ID of the region where the key resides.</li><li id="obs_04_0062__li453410383271"><em id="obs_04_0062__i8343117105118">domainID</em> indicates the ID of the domain to which the key belongs. For details, see <a href="obs_04_0117.html">Obtaining the Domain ID and User ID</a>.</li><li id="obs_04_0062__li2123235142713"><em id="obs_04_0062__i339792814549">key_id</em> indicates the ID of the key created in KMS.</li></ul>
<ul id="obs_04_0062__ul1812312350279"><li id="obs_04_0062__li48526363273"><em id="obs_04_0062__i1082183695015">regionID</em> indicates the ID of the region where the key belongs.</li><li id="obs_04_0062__li453410383271"><em id="obs_04_0062__i8343117105118">domainID</em> indicates the ID of the domain to which the key belongs. For details, see <a href="obs_04_0117.html">Obtaining a Domain ID and a User ID</a>.</li><li id="obs_04_0062__li2123235142713"><em id="obs_04_0062__i339792814549">key_id</em> indicates the ID of the key created in KMS.</li></ul>
<p id="obs_04_0062__p2616105415423">Ancestor: ApplyServerSideEncryptionByDefault</p>
</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>
@ -135,7 +135,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0062__section1111516502421"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0062__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_0062__section1684610713438"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0062__p128781711134314">This response contains no element.</p>
<div class="section" id="obs_04_0062__section1684610713438"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0062__p128781711134314">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0062__section1821915316431"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0062__p184128334439">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -40,7 +40,7 @@ Date:<span class="w"> </span>date<span class="w"> </span>
</div>
<div class="section" id="obs_04_0064__section4327836215"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0064__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_0064__section2085012491723"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0064__p63829146313">This response involves no elements.</p>
<div class="section" id="obs_04_0064__section2085012491723"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0064__p63829146313">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0064__section75624441842"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0064__p9928192695312">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -74,7 +74,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0068__section8877856"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0068__p5510113014018">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_0068__section12791844"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0068__p27783412">This response involves no elements.</p>
<div class="section" id="obs_04_0068__section12791844"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0068__p27783412">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0068__section48017739"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0068__p35863881">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -271,7 +271,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0071__section3798667"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0071__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_0071__section34188005"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0071__p25846950">This response contains no element.</p>
<div class="section" id="obs_04_0071__section34188005"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0071__p25846950">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0071__section39256590"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0071__p13228234">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -34,7 +34,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0073__section63452526"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0073__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_0073__section34201824"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0073__p20251155">This response involves no elements.</p>
<div class="section" id="obs_04_0073__section34201824"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0073__p20251155">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0073__section39380968"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0073__p29730838">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -170,7 +170,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0074__section35852719"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0074__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_0074__section54239021"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0074__p1126282">This response contains no element.</p>
<div class="section" id="obs_04_0074__section54239021"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0074__p1126282">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0074__section18389141"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0074__p24120021">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -34,7 +34,7 @@ Content-Length:<span class="w"> </span>length
</div>
<div class="section" id="obs_04_0076__section67044897"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0076__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_0076__section66533169"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0076__p14489975">This response involves no elements.</p>
<div class="section" id="obs_04_0076__section66533169"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0076__p14489975">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0076__section61927609"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0076__p32837330">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -131,7 +131,7 @@ Content-Length:<span class="w"> </span>length
</table>
</div>
</div>
<div class="section" id="obs_04_0077__section5256624"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0077__p36530666">This response involves no elements.</p>
<div class="section" id="obs_04_0077__section5256624"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0077__p36530666">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0077__section47309617"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0077__p6193979"><a href="#obs_04_0077__table1322139420210">Table 3</a> describes possible special errors in the request.</p>

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

@ -129,7 +129,7 @@ Content-Length:<span class="w"> </span>length
</table>
</div>
</div>
<div class="section" id="obs_04_0078__section21752117"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0078__p36491643">This response involves no elements.</p>
<div class="section" id="obs_04_0078__section21752117"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0078__p36491643">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0078__section61551329"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0078__p3033124"><a href="#obs_04_0078__table38908138205823">Table 3</a> describes possible special errors in the request.</p>

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

@ -1,7 +1,7 @@
<a name="obs_04_0080"></a><a name="obs_04_0080"></a>
<h1 class="topictitle1">Uploading Objects - PUT</h1>
<div id="body25727187"><div class="section" id="obs_04_0080__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0080__p57130901">After creating a bucket in OBS, you can use this operation to upload an object to the bucket. This operation uploads an object to a bucket. To use this operation, you must have the write permission on the bucket.</p>
<div id="body25727187"><div class="section" id="obs_04_0080__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0080__p57130901">After creating a bucket in OBS, you can use this operation to upload an object to the bucket. This operation uploads an object to a bucket. To use this operation, you must have the write permission for the bucket.</p>
<div class="note" id="obs_04_0080__note44416069"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="obs_04_0080__p30218092">The name of each object in a bucket must be unique.</p>
</div></div>
<p class="msonormal" id="obs_04_0080__p148472556134">With versioning not enabled, if an object to be uploaded has the same name as an existing object in the bucket, the newly uploaded object will overwrite the existing one. To protect data from being corrupted during transmission, you can add the <strong id="obs_04_0080__b736611115814">Content-MD5</strong> header in the request. After receiving the uploaded object, OBS compares the provided MD5 value to the MD5 value it calculates. If the two values do not match, OBS reports an error.</p>
@ -115,7 +115,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p3110729">When creating an object, you can use this header to specify the storage class for the object. If you do not use this header, the object storage class is the default storage class of the bucket.</p>
<p id="obs_04_0080__p27996566">Type: string</p>
<p id="obs_04_0080__p14339210104117">Storage class value options: <strong id="obs_04_0080__b4435141185710">STANDARD</strong> (Standard), <strong id="obs_04_0080__b768142405719">WARM</strong> (Warm), <strong id="obs_04_0080__b831518319579">COLD</strong> (Cold). These values are case sensitive.</p>
<p id="obs_04_0080__p14339210104117">Storage class options: <strong id="obs_04_0080__b7978125265316">STANDARD</strong> (Standard), <strong id="obs_04_0080__b09791552155319">WARM</strong> (Warm), <strong id="obs_04_0080__b18979115235317">COLD</strong> (Cold). These values are case sensitive.</p>
<p id="obs_04_0080__p53129340">Example: <strong id="obs_04_0080__b1115816794616">x-obs-storage-class: STANDARD</strong></p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0080__p8509283">No</p>
@ -156,7 +156,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row58960965"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0080__p11108823">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p27399486">Master key ID. This header is used in SSE-KMS mode. If the customer does not provide the master key ID, the default master key ID will be used. If there is no such a default master key, OBS will create one and use it by default.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p27399486">Indicates the master key when SSE-KMS is used. If this header is not provided, the default master key will be used. If there is no such a default master key, OBS will create one and use it by default.</p>
<p id="obs_04_0080__p45268789">Type: string</p>
<p id="obs_04_0080__p6679135313114">The following two formats are supported:</p>
<p id="obs_04_0080__p486340133414">- <em id="obs_04_0080__i184740245012">regionID</em><strong id="obs_04_0080__b11474202418012">:</strong><em id="obs_04_0080__i114743247014">domainID</em><strong id="obs_04_0080__b1347422413010">:key/</strong><em id="obs_04_0080__i24741241001">key_id</em></p>
@ -171,7 +171,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row51805439"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0080__p35491065">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p56204044">Encryption algorithm. The header is used in SSE-C mode.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p56204044">Indicates the encryption algorithm when SSE-C is used.</p>
<p id="obs_04_0080__p36074350">Type: string</p>
<p id="obs_04_0080__p56233695">Example: <strong id="obs_04_0080__b0697153916464">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
<p id="obs_04_0080__p36341208">Constraint: This header must be used together with <strong id="obs_04_0080__b11583133231714">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0080__b154311480174">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
@ -181,7 +181,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row51848422"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0080__p38972650">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p2668111">Key for encrypting objects in SSE-C mode.</p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p2668111">Indicates the key for encrypting objects when SSE-C is used.</p>
<p id="obs_04_0080__p24013005">Type: string</p>
<p id="obs_04_0080__p14790461">Example: <strong id="obs_04_0080__b15597134479">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0080__p66005286">Constraint: This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0080__b5178479">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0080__b46606312">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
@ -191,7 +191,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0080__row798417"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0080__p64671816">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p3925735">Indicates the MD5 value of a key used to encrypt objects. The header is used in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0080__p3925735">Indicates the MD5 value of the encryption key when SSE-C is used. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0080__p35331622">Type: string</p>
<p id="obs_04_0080__p49549143">Example: <strong id="obs_04_0080__b1951419189471">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0080__p43289109">Constraint: This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0080__b1830803952110">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0080__b18869185016212">x-obs-server-side-encryption-customer-key</strong>.</p>
@ -275,7 +275,7 @@ Content-Type:<span class="w"> </span>type
</tr>
<tr id="obs_04_0080__row23757124"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0080__p45278863">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0080__p43709291">Indicates the master key ID. This header is included in a response if SSE-KMS is used. </p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0080__p43709291">Indicates the master key ID. This header is included in a response when SSE-KMS is used. </p>
<p id="obs_04_0080__p119654525336">Type: string</p>
<p id="obs_04_0080__p9548134263614">Format: <em id="obs_04_0080__i7268621365">regionID</em><strong id="obs_04_0080__b172741626617">:</strong><em id="obs_04_0080__i82747217614">domainID</em><strong id="obs_04_0080__b132751321764">:key/</strong><em id="obs_04_0080__i192752022610">key_id</em></p>
<p id="obs_04_0080__p1399473215337"><em id="obs_04_0080__i10127115115713">regionID</em> indicates the ID of the region where the key belongs. <em id="obs_04_0080__i1119611917578">domainID</em> indicates the ID of the tenant where the key belongs. <em id="obs_04_0080__i98931215155718">key_id</em> indicates the key ID used in this encryption.</p>
@ -284,14 +284,14 @@ Content-Type:<span class="w"> </span>type
</tr>
<tr id="obs_04_0080__row50791679"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0080__p20485364">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0080__p48701810">An encryption algorithm. This header is included in a response if SSE-C is used. </p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0080__p48701810">Indicates the encryption algorithm. This header is included in a response when SSE-C is used.</p>
<p id="obs_04_0080__p35663107">Type: string</p>
<p id="obs_04_0080__p52532512">Example: <strong id="obs_04_0080__b1352914544812">x-obs-server-side-encryption-customer-algorithm: AES256</strong></p>
</td>
</tr>
<tr id="obs_04_0080__row3030560"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0080__p44148826">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0080__p19285144">The MD5 value of a key used to encrypt objects. This header is included in a response if SSE-C is used. </p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0080__p19285144">Indicates the MD5 value of the key for encrypting objects. This header is included in a response when SSE-C is used.</p>
<p id="obs_04_0080__p39348572">Type: string</p>
<p id="obs_04_0080__p18592835">Example: <strong id="obs_04_0080__b198645132483">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
</td>
@ -306,7 +306,7 @@ Content-Type:<span class="w"> </span>type
</table>
</div>
</div>
<div class="section" id="obs_04_0080__section33686208"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0080__p10058442">This response involves no elements.</p>
<div class="section" id="obs_04_0080__section33686208"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0080__p10058442">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0080__section34740423"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0080__p9427499">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

@ -100,7 +100,7 @@ Range:bytes=byte_range<span class="w"> </span>
</tr>
<tr id="obs_04_0083__row3210135204916"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p021018529498">attname</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p1612114765018">Rewrites the <strong id="obs_04_0083__b744120994">Content-Disposition</strong> header in the response.</p>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p1612114765018">Rewrites the <strong id="obs_04_0083__b1537970484">Content-Disposition</strong> header in the response.</p>
<p id="obs_04_0083__p1612197195017">Type: string</p>
<p id="obs_04_0083__p20472268503">Example:</p>
<p id="obs_04_0083__p11253017500">attname=name1</p>
@ -157,7 +157,7 @@ Range:bytes=byte_range<span class="w"> </span>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p44587619">Returns the object only if its ETag is the same as the one specified by this header. Otherwise, <strong id="obs_04_0083__b64501877">412 Precondition Failed</strong> is returned.</p>
<p id="obs_04_0083__p65744258">Type: string</p>
<p id="obs_04_0083__p54827416">Example: <strong id="obs_04_0083__b1709368589">0f64741bf7cb1089e988e4585d0d3434</strong></p>
<p id="obs_04_0083__p54827416">ETag example: <strong id="obs_04_0083__b174366342919">0f64741bf7cb1089e988e4585d0d3434</strong></p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0083__p11835734">No</p>
</td>
@ -173,7 +173,7 @@ Range:bytes=byte_range<span class="w"> </span>
</tr>
<tr id="obs_04_0083__row63916672"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p9867961">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p61107346">Indicates an encryption algorithm. The header is used in SSE-C mode.</p>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p61107346">Indicates the encryption algorithm when SSE-C is used.</p>
<p id="obs_04_0083__p13095202">Type: string</p>
<p id="obs_04_0083__p50747955">Example: <strong id="obs_04_0083__b19884915814">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0083__p54078414">Constraint: This header must be used together with <strong id="obs_04_0083__b4396112217114">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0083__b6402192218118">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
@ -183,7 +183,7 @@ Range:bytes=byte_range<span class="w"> </span>
</tr>
<tr id="obs_04_0083__row30261231"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p35240666">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p35921710">Indicates a key used to encrypt objects. The header is used in SSE-C mode. This key is used to decrypt objects.</p>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p35921710">Indicates the key for decrypting objects when SSE-C is used.</p>
<p id="obs_04_0083__p54859934">Type: string</p>
<p id="obs_04_0083__p23977361">Example: <strong id="obs_04_0083__b15385853195815">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0083__p14469665">Constraint: This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0083__b77117144583">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0083__b147118149585">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
@ -193,7 +193,7 @@ Range:bytes=byte_range<span class="w"> </span>
</tr>
<tr id="obs_04_0083__row12294571"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p56336176">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p66936422">Indicates the MD5 value of a key used to encrypt objects. The header is used in SSE-C mode. 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.7.3.2.4.1.2 "><p id="obs_04_0083__p66936422">Indicates the MD5 value of the encryption key when SSE-C is used. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0083__p65556891">Type: string</p>
<p id="obs_04_0083__p53141108">Example: <strong id="obs_04_0083__b831615813582">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0083__p8507932">Constraint: This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0083__b203881913604">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0083__b739516131404">x-obs-server-side-encryption-customer-key</strong>.</p>
@ -227,9 +227,9 @@ Last-Modified:<span class="w"> </span>time<span class="w"> </span>
</div>
</div>
<div class="section" id="obs_04_0083__section56977142"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0083__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<p class="MsoNormal" id="obs_04_0083__p40541517">In addition to the common response headers, the following message headers may also be used. For details, see <a href="#obs_04_0083__table40465940">Table 3</a>.</p>
<p class="MsoNormal" id="obs_04_0083__p40541517">In addition to the common response headers, the message headers listed in <a href="#obs_04_0083__table40465940">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0083__table40465940"></a><a name="table40465940"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0083__table40465940" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0083__row62215211"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.10.4.2.3.1.1"><p id="obs_04_0083__p6267364">Header</p>
<div class="tablenoborder"><a name="obs_04_0083__table40465940"></a><a name="table40465940"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0083__table40465940" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0083__row62215211"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.10.4.2.3.1.1"><p id="obs_04_0083__p6267364">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.10.4.2.3.1.2"><p id="obs_04_0083__p37894481">Description</p>
</th>
@ -308,7 +308,7 @@ Last-Modified:<span class="w"> </span>time<span class="w"> </span>
</table>
</div>
</div>
<div class="section" id="obs_04_0083__section43032235"><h4 class="sectiontitle">Response Elements</h4><p class="MsoNormal" id="obs_04_0083__p34627725">This response involves no elements.</p>
<div class="section" id="obs_04_0083__section43032235"><h4 class="sectiontitle">Response Elements</h4><p class="MsoNormal" id="obs_04_0083__p34627725">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0083__section51745800"><h4 class="sectiontitle">Error Responses</h4><p class="MsoNormal" id="obs_04_0083__p53382370">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
@ -462,7 +462,7 @@ Content-range:<span class="w"> </span>bytes<span class="w"> </span>40-50/4583
</pre></div></td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section1081716488230"><h4 class="sectiontitle">Sample Request: Checking the ETag Value of an Object</h4><p id="obs_04_0083__p55313703612"><strong id="obs_04_0083__b4957920171011">Download an object if its Etag value matches</strong>.</p>
<div class="section" id="obs_04_0083__section1081716488230"><h4 class="sectiontitle">Sample Request: Checking the ETag Value of an Object</h4><p id="obs_04_0083__p55313703612"><strong id="obs_04_0083__b4957920171011">Download an object if its ETag value is matched</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen1988837122916"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
@ -480,7 +480,7 @@ Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEB
</div>
</div>
<div class="section" id="obs_04_0083__section154154183317"><h4 class="sectiontitle">Sample Response: Checking the ETag Value of an Object (ETag Mismatch)</h4><p id="obs_04_0083__p31791351372">If the Etag value of the stored object is not <strong id="obs_04_0083__b61482710149">682e760adb130c60c120da3e333a8b09</strong>, the system displays a message indicating that the download fails.</p>
<div class="section" id="obs_04_0083__section154154183317"><h4 class="sectiontitle">Sample Response: Checking the ETag Value of an Object (ETag Mismatch)</h4><p id="obs_04_0083__p31791351372">If the object's ETag value is not <strong id="obs_04_0083__b61482710149">682e760adb130c60c120da3e333a8b09</strong>, the system displays a download failure message.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen1654618411336"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
@ -514,7 +514,7 @@ Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </sp
</div>
</div>
<div class="section" id="obs_04_0083__section65816410333"><h4 class="sectiontitle">Sample Response: Checking the ETag Value of an Object (ETag Matched)</h4><p id="obs_04_0083__p88331650133713">If the Etag value of the stored object is <strong id="obs_04_0083__b34660378151">682e760adb130c60c120da3e333a8b09</strong>, the download is successful.</p>
<div class="section" id="obs_04_0083__section65816410333"><h4 class="sectiontitle">Sample Response: Checking the ETag Value of an Object (ETag Matched)</h4><p id="obs_04_0083__p88331650133713">If the object's ETag value is <strong id="obs_04_0083__b34660378151">682e760adb130c60c120da3e333a8b09</strong>, the download is successful.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen5585144133317"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>

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

@ -68,7 +68,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0084__row56307738"><td class="cellrowborder" valign="top" width="19.388061193880613%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0084__p64632904">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0084__p773838">Indicates a decryption algorithm. The header is used in SSE-C mode.</p>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0084__p773838">Indicates the decryption algorithm when SSE-C is used.</p>
<p id="obs_04_0084__p6964546">Type: string</p>
<p id="obs_04_0084__p62680917">Example: <strong id="obs_04_0084__b48053075917">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0084__p27257344">Constraint: This header must be used together with <strong id="obs_04_0084__b1116775151115">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0084__b1617312518113">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
@ -78,7 +78,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0084__row6380420"><td class="cellrowborder" valign="top" width="19.388061193880613%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0084__p47052029">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0084__p53117974">Indicates a key used to decrypt objects. The header is used in SSE-C mode.</p>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0084__p53117974">Indicates the decryption key when SSE-C is used.</p>
<p id="obs_04_0084__p8299718">Type: string</p>
<p id="obs_04_0084__p7588599">Example: <strong id="obs_04_0084__b653616341591">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0084__p1188530">Constraint: This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0084__b159154910590">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0084__b098495596">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
@ -88,7 +88,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0084__row61132595"><td class="cellrowborder" valign="top" width="19.388061193880613%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0084__p52793182">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0084__p48389362">Indicates the MD5 value of a key used to decrypt objects. The header is used in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key.</p>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0084__p48389362">Indicates the MD5 value of the decryption key when SSE-C is used. The MD5 value is used to check whether any error occurs during the transmission of the key.</p>
<p id="obs_04_0084__p32851074">Type: string</p>
<p id="obs_04_0084__p27224213">Example: <strong id="obs_04_0084__b13838193965919">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0084__p43691333">Constraint: This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0084__b2087516241207">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0084__b1188118241505">x-obs-server-side-encryption-customer-key</strong>.</p>
@ -118,7 +118,7 @@ Last-Modified:<span class="w"> </span>time
</div>
</div>
<div class="section" id="obs_04_0084__section35159826"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0084__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<p class="msonormal" id="obs_04_0084__p56384785">In addition to the common response headers, the following message headers may also be used. For details, see <a href="#obs_04_0084__table53333691145218">Table 3</a>.</p>
<p class="msonormal" id="obs_04_0084__p56384785">In addition to the common response headers, the message headers listed in <a href="#obs_04_0084__table53333691145218">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0084__table53333691145218"></a><a name="table53333691145218"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0084__table53333691145218" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0084__row48853136"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0084__p64789980">Header</p>
</th>
@ -253,7 +253,7 @@ Last-Modified:<span class="w"> </span>time
</table>
</div>
</div>
<div class="section" id="obs_04_0084__section48002983"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0084__p4861884">This response involves no elements.</p>
<div class="section" id="obs_04_0084__section48002983"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0084__p4861884">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0084__section29373671"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0084__p58268319">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -82,7 +82,7 @@ Date:<span class="w"> </span>date
</table>
</div>
</div>
<div class="section" id="obs_04_0085__section16332845"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0085__p24646447">This response involves no elements.</p>
<div class="section" id="obs_04_0085__section16332845"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0085__p24646447">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0085__section12777878"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0085__p50205220">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -98,7 +98,7 @@ Date:<span class="w"> </span>date
</div>
<div class="section" id="obs_04_0087__section12197851"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0087__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_0087__section42671798"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0087__p522982">This response involves no elements.</p>
<div class="section" id="obs_04_0087__section42671798"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0087__p522982">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0087__section48501865"><h4 class="sectiontitle">Error Responses</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0087__table42361618" frame="border" border="1" rules="all"><caption><b>Table 2 </b>List of OBS access error codes</caption><thead align="left"><tr id="obs_04_0087__row29259155"><th align="left" class="cellrowborder" valign="top" width="25.509999999999998%" id="mcps1.3.10.2.2.4.1.1"><p id="obs_04_0087__p21181321">Error Code</p>

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

@ -163,9 +163,9 @@ Content-Type:<span class="w"> </span>application/xml
</div>
</div>
<div class="section" id="obs_04_0089__section47403265"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0089__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<p id="obs_04_0089__p44587388">In addition to the common response headers, the following message headers may also be used. For details, see <a href="#obs_04_0089__table21765641102739">Table 3</a>.</p>
<p id="obs_04_0089__p44587388">In addition to the common response headers, the message headers listed in <a href="#obs_04_0089__table21765641102739">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0089__table21765641102739"></a><a name="table21765641102739"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0089__table21765641102739" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header parameters</caption><thead align="left"><tr id="obs_04_0089__row52223563"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0089__p2250249">Header</p>
<div class="tablenoborder"><a name="obs_04_0089__table21765641102739"></a><a name="table21765641102739"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0089__table21765641102739" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0089__row52223563"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.8.4.2.3.1.1"><p id="obs_04_0089__p2250249">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.8.4.2.3.1.2"><p id="obs_04_0089__p48052491">Description</p>
</th>
@ -181,7 +181,7 @@ Content-Type:<span class="w"> </span>application/xml
</table>
</div>
</div>
<div class="section" id="obs_04_0089__section23976207"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0089__p24605804">This response involves no elements.</p>
<div class="section" id="obs_04_0089__section23976207"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0089__p24605804">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0089__section14459276"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0089__p46913122">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

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

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

@ -83,7 +83,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0091__row56307738"><td class="cellrowborder" valign="top" width="19.388061193880613%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0091__p10438133128">Content-Encoding</p>
</td>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0091__p18438113191212">Specifies the content encoding format when an object is being uploaded.</p>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0091__p18438113191212">Specifies the content encoding format when an object is being downloaded.</p>
<p id="obs_04_0091__p9149531151911">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0091__p55120132614">No</p>
@ -130,7 +130,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="63.26367363263674%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0091__p3110729">Specifies the storage class of an object.</p>
<p id="obs_04_0091__p27996566">Type: string</p>
<p id="obs_04_0091__p14339210104117">Storage class value options: <strong id="obs_04_0091__b1761818361400">STANDARD</strong> (OBS Standard), <strong id="obs_04_0091__b166191536803">WARM</strong> (OBS Warm), <strong id="obs_04_0091__b2619163611019">COLD</strong> (OBS Cold). These values are case sensitive.</p>
<p id="obs_04_0091__p14339210104117">Storage class options: <strong id="obs_04_0091__b1761818361400">STANDARD</strong> (Standard), <strong id="obs_04_0091__b166191536803">WARM</strong> (Warm), <strong id="obs_04_0091__b2619163611019">COLD</strong> (Cold). These values are case sensitive.</p>
<p id="obs_04_0091__p53129340">Example: <strong id="obs_04_0091__b1362711521274">x-obs-storage-class: STANDARD</strong></p>
</td>
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0091__p22246592613">No</p>
@ -192,7 +192,7 @@ Last-Modified:<span class="w"> </span>time
</tr>
<tr id="obs_04_0091__row185718915191"><td class="cellrowborder" valign="top" width="23.46%" headers="mcps1.3.7.2.2.3.1.1 "><p id="obs_04_0091__p8585195199">Content-Encoding</p>
</td>
<td class="cellrowborder" valign="top" width="76.53999999999999%" headers="mcps1.3.7.2.2.3.1.2 "><p id="obs_04_0091__p6585109121913">Specifies the content encoding format when an object is being uploaded. If a request carries this header field, the response message must contain this header field.</p>
<td class="cellrowborder" valign="top" width="76.53999999999999%" headers="mcps1.3.7.2.2.3.1.2 "><p id="obs_04_0091__p6585109121913">Specifies the content encoding format when an object is being downloaded. If a request carries this header field, the response message must contain this header field.</p>
<p id="obs_04_0091__p15585149161911">Type: string</p>
</td>
</tr>
@ -230,7 +230,7 @@ Last-Modified:<span class="w"> </span>time
</table>
</div>
</div>
<div class="section" id="obs_04_0091__section107960298020"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0091__p15500174120">This response involves no elements.</p>
<div class="section" id="obs_04_0091__section107960298020"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0091__p15500174120">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0091__section7010441604"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0091__p1170348119">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -66,7 +66,7 @@ x-obs-id-2:<span class="w"> </span>id
</div>
<div class="section" id="obs_04_0092__section8271421124512"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0092__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_0092__section16332845"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0092__p24646447">This response involves no elements.</p>
<div class="section" id="obs_04_0092__section16332845"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0092__p24646447">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0092__section12777878"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0092__p50205220">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -60,7 +60,7 @@ Date:<span class="w"> </span>Date
</div>
<div class="section" id="obs_04_0093__section209761791549"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0093__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_0093__section16332845"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0093__p24646447">This response involves no elements.</p>
<div class="section" id="obs_04_0093__section16332845"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0093__p24646447">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0093__section12777878"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0093__p50205220">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -59,7 +59,7 @@ Date:<span class="w"> </span>Date
</div>
<div class="section" id="obs_04_0094__section69450302141"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0094__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_0094__section16332845"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0094__p24646447">This response involves no elements.</p>
<div class="section" id="obs_04_0094__section16332845"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0094__p24646447">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0094__section12777878"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0094__p50205220">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>

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

@ -12,7 +12,7 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0100.html">Copying Parts</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0101.html">Listing Uploaded Parts of an Object</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0101.html">Listing Uploaded Parts</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0102.html">Completing a Multipart Upload</a></strong><br>
</li>

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

@ -183,7 +183,7 @@ Content-Length:<span class="w"> </span>length
</tr>
<tr id="obs_04_0097__row33625114"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p39279732">IsTruncated</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p27541714">Indicates whether the returned list of multipart uploads is truncated. <strong id="obs_04_0097__b773114255012">true</strong>: Not all results are returned. <strong id="obs_04_0097__b773624210501">false</strong>: All results have been returned.</p>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p27541714">Indicates whether the returned list of multipart uploads is truncated. The value <strong id="obs_04_0097__b4202024182615">true</strong> indicates that the list was truncated and <strong id="obs_04_0097__b720124182615">false</strong> indicates that the list was not truncated.</p>
<p id="obs_04_0097__p46548838">Type: boolean</p>
<p id="obs_04_0097__p16286365">Ancestor: ListMultipartUploadsResult</p>
</td>

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

@ -100,7 +100,7 @@ Authorization:<span class="w"> </span>authorization
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0098__p37032594">When initiating a multipart upload, you can add this header to specify the storage class for the object. If you do not use this header, the object storage class is the default storage class of the bucket.</p>
<p id="obs_04_0098__p64857896">Type: string</p>
<p id="obs_04_0098__p14339210104117">Storage class value options: <strong id="obs_04_0098__b1677713810441">STANDARD</strong> (Standard), <strong id="obs_04_0098__b777763814443">WARM</strong> (Warm), <strong id="obs_04_0098__b1477819384446">COLD</strong> (Cold). These values are case sensitive.</p>
<p id="obs_04_0098__p14339210104117">Storage class options: <strong id="obs_04_0098__b164311513131913">STANDARD</strong> (Standard), <strong id="obs_04_0098__b1843111319199">WARM</strong> (Warm), <strong id="obs_04_0098__b16431141312194">COLD</strong> (Cold). These values are case sensitive.</p>
<p id="obs_04_0098__p18998234">Example: <strong id="obs_04_0098__b116516302814">x-obs-storage-class: STANDARD</strong></p>
</td>
<td class="cellrowborder" valign="top" width="9.180000000000001%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0098__p62462009">No</p>
@ -127,7 +127,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row63524059"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0098__p45175155">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0098__p35308952">Master key ID. This header is used in SSE-KMS mode. If the customer does not provide the master key ID, the default master key ID will be used. If there is no such a default master key, OBS will create one and use it by default.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0098__p35308952">Indicates the master key when SSE-KMS is used. If this header is not provided, the default master key will be used. If there is no such a default master key, OBS will create one and use it by default.</p>
<p id="obs_04_0098__p49345114">Type: string</p>
<p id="obs_04_0098__p6679135313114">The following two formats are supported:</p>
<p id="obs_04_0098__p14701134894919">- <em id="obs_04_0098__i64591304515">regionID</em><strong id="obs_04_0098__b1946617308515">:</strong><em id="obs_04_0098__i44668309515">domainID</em><strong id="obs_04_0098__b74661730352">:key/</strong><em id="obs_04_0098__i5466530351">key_id</em></p>
@ -142,7 +142,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row20138464"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0098__p20602859">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0098__p58218887">Indicates an encryption algorithm. The header is used in SSE-C mode.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0098__p58218887">Indicates the encryption algorithm when SSE-C is used.</p>
<p id="obs_04_0098__p54207939">Type: string</p>
<p id="obs_04_0098__p18109403">Example: <strong id="obs_04_0098__b2267174216813">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0098__p28766906">Constraint: This header must be used together with <strong id="obs_04_0098__b20101191201216">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0098__b1910871201217">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
@ -152,7 +152,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row33109454"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0098__p64620092">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0098__p66844930">The key used to encrypt objects. The header is used in SSE-C mode. This key is used to encrypt objects.</p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0098__p66844930">Indicates the key for encrypting objects when SSE-C is used.</p>
<p id="obs_04_0098__p64733462">Type: string</p>
<p id="obs_04_0098__p45730249">Example: <strong id="obs_04_0098__b13372247988">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0098__p8919060">Constraint: This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0098__b123399319412">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0098__b19339731348">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
@ -162,7 +162,7 @@ Authorization:<span class="w"> </span>authorization
</tr>
<tr id="obs_04_0098__row59544184"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0098__p58349617">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0098__p28698506">Indicates the MD5 value of a key used to encrypt objects. The header is used in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<td class="cellrowborder" valign="top" width="67.35%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0098__p28698506">Indicates the MD5 value of the encryption key when SSE-C is used. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0098__p56959962">Type: string</p>
<p id="obs_04_0098__p42877611">Example: <strong id="obs_04_0098__b11772201120919">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0098__p50354182">Constraint: This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0098__b42631542303">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0098__b1126916421505">x-obs-server-side-encryption-customer-key</strong>.</p>

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