yexinru/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
2025-05-23 14:00:46 +00:00
committed by zuul
parent b1f896759f
commit 1f5944ef64
51 changed files with 1048 additions and 971 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

File diff suppressed because it is too large Load Diff

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

@ -110,7 +110,7 @@
{
"desc":"OBS supports browser-based uploads using POST requests. Authenticating such a request uses the signature carried in the form. First, create a policy to specify the requir",
"product_code":"obs",
"title":"Authentication of Signature Carried in the Table Uploaded Through a Browser",
"title":"Authenticating the Signature Carried in a Form Uploaded Through a Browser",
"uri":"obs_04_0012.html",
"doc_type":"api",
"p_code":"9",
@ -513,7 +513,7 @@
"code":"57"
},
{
"desc":"OBS uses the PUT method to configure a custom domain name for a bucket. After the configuration is successful, you can access the bucket through the domain name.Ensure th",
"desc":"OBS uses the PUT method to configure a custom domain name for a bucket. After the configuration is successful, you can access the bucket through the domain name.To perfor",
"product_code":"obs",
"title":"Configuring a Custom Domain Name for a Bucket",
"uri":"obs_04_0059.html",
@ -522,7 +522,7 @@
"code":"58"
},
{
"desc":"OBS uses the GET method to obtain the custom domain name of a bucket.This request message does not contain the request parameters.This request uses common headers. For de",
"desc":"OBS uses the GET method to obtain the custom domain name of a bucket.To perform this operation, the user must be the bucket owner or the bucket owner's IAM user that has ",
"product_code":"obs",
"title":"Obtaining the Custom Domain Name of a Bucket",
"uri":"obs_04_0060.html",
@ -531,7 +531,7 @@
"code":"59"
},
{
"desc":"OBS uses the DELETE method to delete the custom domain name of a bucket.This request uses common headers. For details, see Table 3.This request involves no elements.The r",
"desc":"OBS uses the DELETE method to delete the custom domain name of a bucket.To perform this operation, the user must be the bucket owner or the bucket owner's IAM user that h",
"product_code":"obs",
"title":"Deleting the Custom Domain Name of a Bucket",
"uri":"obs_04_0061.html",
@ -831,7 +831,7 @@
"desc":"This operation returns tags of an object.If you do not specify a version ID in a request, make sure that you have the GetObjectTagging permission. If you do specify a ver",
"product_code":"obs",
"title":"Obtaining Object Tags",
"uri":"en-us_topic_0000001399487626.html",
"uri":"obs_04_0164.html",
"doc_type":"api",
"p_code":"77",
"code":"93"
@ -840,7 +840,7 @@
"desc":"This operation deletes tags from an object.If you do not specify a version ID in a request, make sure that you have the DeleteObjectTagging permission. If you do specify ",
"product_code":"obs",
"title":"Deleting Object Tags",
"uri":"en-us_topic_0000001399647606.html",
"uri":"obs_04_0165.html",
"doc_type":"api",
"p_code":"77",
"code":"94"
@ -891,7 +891,7 @@
"code":"99"
},
{
"desc":"After a multipart upload task is created, you can upload parts for this task using the obtained multipart upload ID. Alternatively, you can make an API call to add a part",
"desc":"After a multipart upload task is created, you can upload parts for this task using the obtained multipart upload ID. Alternatively, you can make an API call to copy a par",
"product_code":"obs",
"title":"Copying Parts",
"uri":"obs_04_0100.html",

80
docs/obs/api-ref/en-us_topic_0000001399647606.html
View File

@ -1,80 +0,0 @@
<a name="EN-US_TOPIC_0000001399647606"></a><a name="EN-US_TOPIC_0000001399647606"></a>
<h1 class="topictitle1">Deleting Object Tags</h1>
<div id="body0000001399647606"><div class="section" id="EN-US_TOPIC_0000001399647606__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="EN-US_TOPIC_0000001399647606__p328123010563">This operation deletes tags from an object.</p>
<p id="EN-US_TOPIC_0000001399647606__p028114308563">If you do not specify a version ID in a request, make sure that you have the <strong id="EN-US_TOPIC_0000001399647606__b47911221893">DeleteObjectTagging</strong> permission. If you do specify a version ID in a request, make sure that you have the <strong id="EN-US_TOPIC_0000001399647606__b7135933898">DeleteObjectTagging</strong> and <strong id="EN-US_TOPIC_0000001399647606__b8136333696">DeleteObjectVersionTagging</strong> permissions. By default, only the object owner can perform this operation. The object owner can grant this permission to others by using a bucket or user policy.</p>
<p id="EN-US_TOPIC_0000001399647606__p57251938173210">OBS deletes tags from the current object version by default. You can use the <strong id="EN-US_TOPIC_0000001399647606__b1626312461517">versionId</strong> parameter to delete tags from any other version. If the version you are deleting tags from is a delete marker, OBS returns <strong id="EN-US_TOPIC_0000001399647606__b17627605102453">404 Not Found</strong>.</p>
</div>
<div class="note" id="EN-US_TOPIC_0000001399647606__note12421825144411"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001399647606__p942162554417">Tags are not supported for files in parallel file systems.</p>
</div></div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section45065450485"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001399647606__screen3610323119435"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span>DELETE<span class="w"> </span>/objectname?tagging<span class="err">&amp;</span>versionId=versionid<span class="w"> </span>HTTP/1.1<span class="w"> </span>
Host:<span class="w"> </span>bucketname.obs.region.example.com
Date:<span class="w"> </span>date
Authorization:<span class="w"> </span>authorization<span class="w"> </span>string
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section1296694711492"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0000001399647606__p593111435014">This request contains no message parameters.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section2781110155011"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0000001399647606__p114042151502">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section126870405505"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0000001399647606__p168011556165016">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section910630175111"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001399647606__screen1535102455116"><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
x-obs-request-id:<span class="w"> </span>request<span class="w"> </span>id
x-obs-id-2:<span class="w"> </span>id
x-obs-version-id:<span class="w"> </span>version<span class="w"> </span>id
Content-Length:<span class="w"> </span>length
Date:<span class="w"> </span>date
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section0233121717529"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0000001399647606__p1231635205817">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section151181751135216"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0000001399647606__p5814125795219">This response contains no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section1211411715310"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0000001399647606__p9928192695312">No special error responses are returned. For details, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>. If the object has no tags or the tag deletion is successful, OBS returns a 204 error.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section9741154135612"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001399647606__screen207308135711"><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>DELETE<span class="w"> </span>/objectname?tagging<span class="err">&amp;</span>versionId=G001018455096CE600005306000000DD<span class="w"> </span>HTTP/1.1<span class="w"> </span>
User-Agent:<span class="w"> </span>curl/7.19.7<span class="w"> </span>
Host:<span class="w"> </span>bucketname.obs.region.example.com
Accept:<span class="w"> </span>*/*<span class="w"> </span>
Date:<span class="w"> </span>Wed,<span class="w"> </span>27<span class="w"> </span>Jun<span class="w"> </span>2018<span class="w"> </span>13:46:58<span class="w"> </span>GMT<span class="w"> </span>
Authorization:<span class="w"> </span>authorization<span class="w"> </span>string
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001399647606__section18791259195717"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001399647606__screen491841285816"><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>204<span class="w"> </span>No<span class="w"> </span>Content<span class="w"> </span>
x-obs-request-id:<span class="w"> </span>0002B7532E0000015BEB2C212E53A17L<span class="w"> </span>
x-obs-id-2:<span class="w"> </span>CqT+86nnOkB+Cv9KZoVgZ28pSgMF+uGQBUC68flvkQeq6CxoCz65wWFMNBpXvea4<span class="w"> </span>
x-obs-version-id:<span class="w"> </span>G001018455096CE600005306000000DD
Content-Length:<span class="w"> </span>0
Date:<span class="w"> </span>Wed,<span class="w"> </span>27<span class="w"> </span>Jun<span class="w"> </span>2018<span class="w"> </span>13:46:58<span class="w"> </span>GMT
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0079.html">Operations on Objects</a></div>
</div>
</div>

4
docs/obs/api-ref/en-us_topic_0031051947.html
View File

@ -4,6 +4,10 @@
<div id="body5203777"><p id="en-us_topic_0031051947__p168977384184">Welcome to the <em id="en-us_topic_0031051947__i6901726141219">Object Storage Service API Reference</em>. Object Storage Service (OBS) provides massive, secure, reliable, and cost-effective data storage capabilities for users to store data of any type and size. It is suitable for scenarios such as enterprise backup/archiving, video on demand (VoD), and video surveillance.</p>
<p id="en-us_topic_0031051947__p1089723818188">This document describes how to use application programming interfaces (APIs) to perform operations on OBS, such as creating, modifying, and deleting bucket, as well as uploading, downloading, and deleting objects. For details about all supported operations, see <a href="obs_04_0005.html">API Overview</a>.</p>
<p id="en-us_topic_0031051947__p61208411347">Before calling OBS APIs, ensure that you have fully understood relevant concepts. For details, see <a href="obs_04_0004.html">Basic Concepts</a>.</p>
<p id="en-us_topic_0031051947__p186801420155715">OBS provides Representational State Transfer (REST) APIs that you can call by making HTTP or HTTPS requests. For details, see <a href="obs_04_0006.html">Calling APIs</a>.</p>
<div class="section" id="en-us_topic_0031051947__section124911550580"><a name="en-us_topic_0031051947__section124911550580"></a><a name="section124911550580"></a><h4 class="sectiontitle">Endpoints</h4><p id="en-us_topic_0031051947__p1748961421910">An endpoint is a <strong id="en-us_topic_0031051947__b417913582412">request address</strong> for calling an API. Endpoints vary depending on services and regions. For the endpoints of all services, see <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
<p id="en-us_topic_0031051947__p9108202217345">OBS provides a different second-level domain name for each region. You can use the domain names provided by OBS or define your own domain names to access OBS.</p>
</div>
</div>
<div>
<div class="familylinks">

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

@ -8,11 +8,25 @@
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0000__row1370781516168"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p370810154161">2024-08-02</p>
<tbody><tr id="obs_04_0000__row1410225654711"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p16695125744720">2025-05-09</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p176951857124717">This issue is the fourteenth official release.</p>
<p id="obs_04_0000__p16951557184710">This issue incorporates the following changes:</p>
<p id="obs_04_0000__p196951057194711">Updated <a href="obs_04_0034.html">Configuring Bucket Lifecycle Rules</a> and <a href="obs_04_0035.html">Obtaining Bucket Lifecycle Configuration</a>.</p>
</td>
</tr>
<tr id="obs_04_0000__row1780118351220"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p1480619171215">2025-04-07</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p13806498120">This is the thirteenth official release.</p>
<p id="obs_04_0000__p13806209161212">This issue incorporates the following changes:</p>
<p id="obs_04_0000__p1562043081216">Updated <a href="obs_04_0034.html">Configuring Bucket Lifecycle Rules</a>, <a href="obs_04_0062.html">Configuring Bucket Encryption</a>, <a href="obs_04_0102.html">Completing a Multipart Upload</a>, <a href="obs_04_0100.html">Copying Parts</a>, <a href="obs_04_0082.html">Copying an Object</a>, and <a href="obs_04_0049.html">Configuring Tags for a Bucket</a>.</p>
</td>
</tr>
<tr id="obs_04_0000__row1370781516168"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p370810154161">2024-08-02</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p1756812403167">This is the twelfth official release.</p>
<p id="obs_04_0000__p18684145661613">This issue incorporates the following changes:</p>
<ul id="obs_04_0000__ul8419311151714"><li id="obs_04_0000__li2419611131717">Added the object tag interfaces in <a href="obs_04_0172.html">Adding Object Tags</a>, <a href="en-us_topic_0000001399487626.html">Obtaining Object Tags</a>, and <a href="en-us_topic_0000001399647606.html">Deleting Object Tags</a>.</li><li id="obs_04_0000__li1631114141178">Updated the description of the <strong id="obs_04_0000__b1972435917276">CanonicalizedResource</strong> parameter in <a href="obs_04_0010.html">Authentication of Signature in a Header</a> and <a href="obs_04_0011.html">Authentication of Signature in a URL</a>.</li></ul>
<ul id="obs_04_0000__ul8419311151714"><li id="obs_04_0000__li2419611131717">Added the object tag interfaces in <a href="obs_04_0172.html">Adding Object Tags</a>, <a href="obs_04_0164.html">Obtaining Object Tags</a>, and <a href="obs_04_0165.html">Deleting Object Tags</a>.</li><li id="obs_04_0000__li1631114141178">Updated the description of the <strong id="obs_04_0000__b1972435917276">CanonicalizedResource</strong> parameter in <a href="obs_04_0010.html">Authentication of Signature in a Header</a> and <a href="obs_04_0011.html">Authentication of Signature in a URL</a>.</li></ul>
</td>
</tr>
<tr id="obs_04_0000__row172721060100"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p137551511171020">2024-03-21</p>

1
docs/obs/api-ref/obs_04_0003.html
View File

@ -2,6 +2,7 @@
<h1 class="topictitle1">Endpoints</h1>
<div id="body1559715459464"><p id="obs_04_0003__p45630894315">An endpoint is the <strong id="obs_04_0003__b18341052968">request address</strong> for calling an API. Endpoints vary depending on services and regions. For the endpoints of services, see <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
<p id="obs_04_0003__p7602122693513"></p>
<p id="obs_04_0003__p9570141317585">OBS provides a second-level domain name for each region. You can use the domain name provided by OBS or a custom domain name to access OBS.</p>
</div>
<div>

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

@ -9,7 +9,7 @@
</li><li id="obs_04_0004__li68043103485">Bucket<p id="obs_04_0004__p11547143222614"><a name="obs_04_0004__li68043103485"></a><a name="li68043103485"></a>A bucket is a container where objects are stored. It is the top namespace in OBS. Each object must reside in a bucket. For example, if you store object <strong id="obs_04_0004__b811803415150">picture.jpg</strong> in bucket <strong id="obs_04_0004__b8228738141518">photo</strong>, the object can be accessed by using this URL: <strong id="obs_04_0004__b8482172061618">http://photo.obs.</strong><em id="obs_04_0004__i720615817166">region</em>.<em id="obs_04_0004__i2020614815169">example</em><strong id="obs_04_0004__b652362581616">.com/picture.jpg</strong></p>
</li><li class="MsoNormal" id="obs_04_0004__li898161894818">Object<p class="MsoNormal" id="obs_04_0004__p60841141"><a name="obs_04_0004__li898161894818"></a><a name="li898161894818"></a>An object is a basic data unit on OBS. A bucket can store multiple objects, and OBS does not distinguish between object file types. Objects are serialized in OBS. An object may be a text, a video, or any other types of files. In OBS, the size of a file can range from 0 bytes to 48.8 TB. However, when an object is uploaded through the <strong id="obs_04_0004__b180871023713">PutObject</strong> operation, it cannot exceed the maximum size of 5 GB. Use the multipart upload method, if the object size is larger than 5 GB.</p>
</li><li id="obs_04_0004__li1564913617106">Region<p id="obs_04_0004__p10588103711107"><a name="obs_04_0004__li1564913617106"></a><a name="li1564913617106"></a>A region is a geographic area in which cloud resources are deployed. Availability zones (AZs) in the same region can communicate with each other over an intranet, while AZs in different regions are isolated from each other. Deploying cloud resources in different regions can better suit certain user requirements or comply with local laws or regulations.</p>
<p class="MsoNormal" id="obs_04_0004__p29185427">Each bucket in OBS must reside in a region. You can specify the region when creating the bucket. Once a bucket is created, its region cannot be changed. Select the most appropriate region for a bucket based on the location, cost, and regulatory compliance requirements. For details about the available regions, see <a href="obs_04_0003.html">Endpoints</a>.</p>
<p class="MsoNormal" id="obs_04_0004__p29185427">Each bucket in OBS must reside in a region. You can specify the region when creating the bucket. Once a bucket is created, its region cannot be changed. Select the most appropriate region for a bucket based on the location, cost, and regulatory compliance requirements. For details about the available regions, see <a href="en-us_topic_0031051947.html#en-us_topic_0031051947__section124911550580">Endpoints</a>.</p>
</li></ul>
</div>
</div>

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

@ -343,7 +343,7 @@
</tr>
<tr id="obs_04_0005__row5345769"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p42768539"><a href="obs_04_0087.html">Restoring Cold Objects</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__p99055582354">Restores objects from the Cold storage class.</p>
<td class="cellrowborder" valign="top" width="59.199999999999996%" headers="mcps1.3.4.2.2.3.1.2 "><p id="obs_04_0005__p99055582354">Restores objects from the <span id="obs_04_0005__text159312125617">Cold</span> storage class.</p>
</td>
</tr>
<tr id="obs_04_0005__row55629712"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p48538422"><a href="obs_04_0089.html">Configuring an Object ACL</a></p>
@ -381,12 +381,12 @@
<td class="cellrowborder" valign="top" width="59.199999999999996%" headers="mcps1.3.4.2.2.3.1.2 "><p id="obs_04_0005__p1770843412465">Adds tags to an object.</p>
</td>
</tr>
<tr id="obs_04_0005__row12957151824711"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p19296283473"><a href="en-us_topic_0000001399487626.html">Obtaining Object Tags</a></p>
<tr id="obs_04_0005__row12957151824711"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p19296283473"><a href="obs_04_0164.html">Obtaining Object Tags</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__p20958141854716">Obtains tags of an object.</p>
</td>
</tr>
<tr id="obs_04_0005__row084404914711"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p9844649154711"><a href="en-us_topic_0000001399647606.html">Deleting Object Tags</a></p>
<tr id="obs_04_0005__row084404914711"><td class="cellrowborder" valign="top" width="40.8%" headers="mcps1.3.4.2.2.3.1.1 "><p id="obs_04_0005__p9844649154711"><a href="obs_04_0165.html">Deleting Object Tags</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__p1884424914719">Deletes tags of an object.</p>
</td>
@ -424,7 +424,7 @@
</tr>
<tr id="obs_04_0005__row54094565"><td class="cellrowborder" valign="top" width="40.65%" headers="mcps1.3.5.2.2.3.1.1 "><p id="obs_04_0005__p42774091"><a href="obs_04_0100.html">Copying Parts</a></p>
</td>
<td class="cellrowborder" valign="top" width="59.35%" headers="mcps1.3.5.2.2.3.1.2 "><p id="obs_04_0005__p1056291419425">Copies part or all of an existing object as a part.</p>
<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 its part as a part of a multipart upload 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 that Have Not Been Assembled</a></p>

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

@ -10,7 +10,7 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0011.html">Authentication of Signature in a URL</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0012.html">Authentication of Signature Carried in the Table Uploaded Through a Browser</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0012.html">Authenticating the Signature Carried in a Form Uploaded Through a Browser</a></strong><br>
</li>
</ul>

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

@ -4,7 +4,7 @@
<div id="body33357028"><p id="obs_04_0009__p29043216362">OBS signs a request using AK/SK. When a client is sending a request to OBS, the message header must contain the SK, request time, request type, and other information of the signature.</p>
<ul id="obs_04_0009__ul354274103710"><li id="obs_04_0009__li1254374203710">AK: access key ID, which is a unique identifier associated with a secret access key (SK). The AK and SK are used together to obtain an encrypted signature for a request. </li><li id="obs_04_0009__li1854312443719">SK: secret access key, which is used together with the AK to sign requests, identify a request sender, and prevent the request from being modified. </li></ul>
<p class="msonormal" id="obs_04_0009__p17204813423">A user can obtain the AK and SK from IAM. For details, see <a href="obs_04_0116.html">Obtaining Access Keys (AK/SK)</a>.</p>
<p class="msonormal" id="obs_04_0009__p22691253">OBS provides three signature calculation methods based on application scenarios: <a href="obs_04_0010.html">Authentication of Signature in a Header</a>, <a href="obs_04_0011.html">Authentication of Signature in a URL</a>, and <a href="obs_04_0012.html">Authentication of Signature Carried in the Table Uploaded Through a Browser</a>.</p>
<p class="msonormal" id="obs_04_0009__p22691253">OBS provides three signature calculation methods based on application scenarios: <a href="obs_04_0010.html">Authentication of Signature in a Header</a>, <a href="obs_04_0011.html">Authentication of Signature in a URL</a>, and <a href="obs_04_0012.html">Authenticating the Signature Carried in a Form Uploaded Through a Browser</a>.</p>
<p id="obs_04_0009__p0668336193112">The SDK provided by OBS integrates signature calculation. It is recommended that you use the SDK for development.</p>
<p class="msonormal" id="obs_04_0009__p2894687"><a href="#obs_04_0009__table1151632183812">Table 1</a> shows the user signature verification process in which a signature is carried in a header. For details about the parameters and code examples of authentication of signature in a header, see <a href="obs_04_0010.html">Authentication of Signature in a Header</a>.</p>

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

@ -45,7 +45,7 @@
</tr>
<tr id="obs_04_0010__row42990474"><td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.7.3.2.3.1.1 "><p id="obs_04_0010__p59676394">CanonicalizedHeaders</p>
</td>
<td class="cellrowborder" valign="top" width="73%" headers="mcps1.3.7.3.2.3.1.2 "><p id="obs_04_0010__p1949763">OBS request header field in an HTTP request header, referring to header fields starting with <strong id="obs_04_0010__b319919585174">x-obs-</strong>, such as, <strong id="obs_04_0010__b2415161111183">x-obs-date</strong>, <strong id="obs_04_0010__b1872619143186">x-obs-acl</strong>, and <strong id="obs_04_0010__b184151419201818">x-obs-meta-*</strong>. When calling an API, choose a header that is supported by the API as required.</p>
<td class="cellrowborder" valign="top" width="73%" headers="mcps1.3.7.3.2.3.1.2 "><p id="obs_04_0010__p1949763">HTTP request headers that start with <strong id="obs_04_0010__b104017133409">x-obs-</strong>, such as <strong id="obs_04_0010__b040261324013">x-obs-date</strong>, <strong id="obs_04_0010__b13402101319402">x-obs-acl</strong>, and <strong id="obs_04_0010__b204021913184018">x-obs-meta-*</strong>. When calling an API, choose a header that is supported by the API as required.</p>
<ol id="obs_04_0010__ol145715617477"><li id="obs_04_0010__li1685416455352">All characters of keywords in a request header field must be converted to lowercase letters (content values must be case sensitive, for example, <strong id="obs_04_0010__b111291138163018">x-obs-storage-class:STANDARD</strong>). If a request contains multiple header fields, these fields should be organized by keyword in the alphabetical order from a to z.</li><li id="obs_04_0010__li1497111394712">If multiple header fields in a request have the same prefix, combine the header fields into one. For example, <strong id="obs_04_0010__b18992135642213">x-obs-meta-name:name1</strong> and <strong id="obs_04_0010__b615756114620">x-obs-meta-name:name2</strong> should be reorganized into <strong id="obs_04_0010__b76247410237">x-obs-meta-name:name1,name2</strong>. Use comma to separate the values.</li><li id="obs_04_0010__li18224198471">Keywords in the request header field cannot contain non-ASCII or unrecognizable characters, which are also not advisable for values in the request header field. If the two types of characters are necessary, they should be encoded and decoded on the client side. Either URL encoding or Base64 encoding is acceptable, but the server does not perform decoding.</li><li id="obs_04_0010__li8253142214474">Delete meaningless spaces and tabs in a header field. For example, <strong id="obs_04_0010__b1433317110158">x-obs-meta-name: name</strong> (with a meaningless space before <strong id="obs_04_0010__b14794533166">name</strong>) must be changed to <strong id="obs_04_0010__b54278376">x-obs-meta-name:name</strong>.</li><li id="obs_04_0010__li67877331819">Each header field occupies a separate line. See <a href="#obs_04_0010__table46456687212511">Table 4</a>.</li></ol>
</td>
</tr>
@ -250,7 +250,7 @@
</pre></div></td></tr></table></div>
</div>
</div>
<div class="p" id="obs_04_0010__p1327215229377">The signature is generated as follows based on the StringToSign and SK. The hash-based message authentication code algorithm (HMAC algorithm) is used to generate the signature.<pre class="screen" id="obs_04_0010__screen150142413554">Signature = Base64( HMAC-SHA1( YourSecretAccessKeyID, UTF-8-Encoding-Of( StringToSign ) ) )</pre>
<div class="p" id="obs_04_0010__p1327215229377">The signature is generated as follows based on the StringToSign and SK. The hash-based message authentication code algorithm (HMAC algorithm) is used to generate the signature.<pre class="screen" id="obs_04_0010__screen150142413554">Signature = Base64( HMAC-SHA1( Your_SK, UTF-8-Encoding-Of( StringToSign ) ) )</pre>
</div>
<div class="p" id="obs_04_0010__p0492171931017">For example, to create a private bucket named <strong id="obs_04_0010__b529993718413">newbucketname2</strong> in a region, the format of a client request is as follows:<pre class="screen" id="obs_04_0010__screen8127628105617">PUT / HTTP/1.1
Host: newbucketname2.obs.<em id="obs_04_0010__i153011141175118">region</em>.example.com
@ -726,7 +726,7 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<span class="c1"># Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</span>
<span class="c1"># In this example, the AK and SK are stored in environment variables for identity authentication. Before running the code in this example, configure environment variables OTCCLOUD_SDK_AK and OTCCLOUD_SDK_SK.</span>
<span class="n">yourSecretAccessKeyID</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getenv</span><span class="p">(</span><span class="s1">'OTCCLOUD_SDK_SK'</span><span class="p">)</span>
<span class="n">Your_SK</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getenv</span><span class="p">(</span><span class="s1">'OTCCLOUD_SDK_SK'</span><span class="p">)</span>
<span class="n">httpMethod</span> <span class="o">=</span> <span class="s2">&quot;PUT&quot;</span>
<span class="n">contentType</span> <span class="o">=</span> <span class="s2">&quot;application/xml&quot;</span>
<span class="c1"># &quot;date&quot; is the time when the request was actually generated</span>
@ -735,10 +735,10 @@ Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=
<span class="n">CanonicalizedResource</span> <span class="o">=</span> <span class="s2">&quot;/newbucketname2&quot;</span>
<span class="n">canonical_string</span> <span class="o">=</span> <span class="n">httpMethod</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">+</span> <span class="n">contentType</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">+</span> <span class="n">date</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">+</span> <span class="n">canonicalizedHeaders</span> <span class="o">+</span> <span class="n">CanonicalizedResource</span>
<span class="k">if</span> <span class="n">IS_PYTHON2</span><span class="p">:</span>
<span class="n">hashed</span> <span class="o">=</span> <span class="n">hmac</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="n">yourSecretAccessKeyID</span><span class="p">,</span> <span class="n">canonical_string</span><span class="p">,</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">sha1</span><span class="p">)</span>
<span class="n">hashed</span> <span class="o">=</span> <span class="n">hmac</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="n">Your_SK</span><span class="p">,</span> <span class="n">canonical_string</span><span class="p">,</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">sha1</span><span class="p">)</span>
<span class="n">encode_canonical</span> <span class="o">=</span> <span class="n">binascii</span><span class="o">.</span><span class="n">b2a_base64</span><span class="p">(</span><span class="n">hashed</span><span class="o">.</span><span class="n">digest</span><span class="p">())[:</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">hashed</span> <span class="o">=</span> <span class="n">hmac</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="n">yourSecretAccessKeyID</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">'UTF-8'</span><span class="p">),</span> <span class="n">canonical_string</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">'UTF-8'</span><span class="p">),</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">sha1</span><span class="p">)</span>
<span class="n">hashed</span> <span class="o">=</span> <span class="n">hmac</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="n">Your_SK</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">'UTF-8'</span><span class="p">),</span> <span class="n">canonical_string</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">'UTF-8'</span><span class="p">),</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">sha1</span><span class="p">)</span>
<span class="n">encode_canonical</span> <span class="o">=</span> <span class="n">binascii</span><span class="o">.</span><span class="n">b2a_base64</span><span class="p">(</span><span class="n">hashed</span><span class="o">.</span><span class="n">digest</span><span class="p">())[:</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s1">'UTF-8'</span><span class="p">)</span>
<span class="nb">print</span><span class="p">(</span><span class="n">encode_canonical</span><span class="p">)</span>

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

@ -28,7 +28,7 @@ Host: bucketname.obs.<em id="obs_04_0011__i41621102549">region</em>.example.com<
</tr>
<tr id="obs_04_0011__row8913420"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0011__p50898414">Expires</p>
</td>
<td class="cellrowborder" valign="top" width="58.160000000000004%" headers="mcps1.3.7.2.4.1.2 "><p id="obs_04_0011__p29130856">When the URL expires, in UTC (how many seconds have elapsed since 00:00:00 UTC on January 1, 1970)</p>
<td class="cellrowborder" valign="top" width="58.160000000000004%" headers="mcps1.3.7.2.4.1.2 "><p id="obs_04_0011__p29130856">When the URL expires, measured as a Unix timestamp (how many seconds elapsed since 00:00:00 on January 1, 1970). After the specified time elapses, the URL expires.</p>
<p id="obs_04_0011__p60851118">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="16.33%" headers="mcps1.3.7.2.4.1.3 "><p id="obs_04_0011__p29993536">Yes</p>
@ -93,7 +93,7 @@ Host: bucketname.obs.<em id="obs_04_0011__i41621102549">region</em>.example.com<
</tr>
<tr id="obs_04_0011__row42990474"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.13.2.3.1.1 "><p id="obs_04_0011__p59676394">CanonicalizedHeaders</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.13.2.3.1.2 "><p id="obs_04_0011__p1949763">HTTP request headers that start with <strong id="obs_04_0011__b392010210819">x-obs-</strong>, such as <strong id="obs_04_0011__b692082382">x-obs-date</strong>, <strong id="obs_04_0011__b3920621280">x-obs-acl</strong>, and <strong id="obs_04_0011__b1892019213811">x-obs-meta-*</strong>.</p>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.13.2.3.1.2 "><p id="obs_04_0011__p1949763">HTTP request headers that start with <strong id="obs_04_0011__b187541037134012">x-obs-</strong>, such as <strong id="obs_04_0011__b10755163717407">x-obs-date</strong>, <strong id="obs_04_0011__b57551437154019">x-obs-acl</strong>, and <strong id="obs_04_0011__b075553764010">x-obs-meta-*</strong>.</p>
<ol id="obs_04_0011__ol145715617477"><li id="obs_04_0011__li75756104712">All characters in a header name must be lower-case. Multiple header names are sorted in alphabetical order.</li><li id="obs_04_0011__li1497111394712">If a header has more than one value, combine them using commas (,). For example, <strong id="obs_04_0011__b14763015115016">x-obs-meta-name:name1</strong> and <strong id="obs_04_0011__b67632015125013">x-obs-meta-name:name2</strong> need to be written as <strong id="obs_04_0011__b1763515155017">x-obs-meta-name:name1,name2</strong>.</li><li id="obs_04_0011__li18224198471">Non-ASCII or unrecognizable characters are not allowed for header names and also not recommended for header values. If such characters are required, encode or decode them on the client using URL or Base64. The server does not perform decoding.</li><li id="obs_04_0011__li8253142214474">Delete meaningless spaces or tabs in a header. For example, <strong id="obs_04_0011__b1347516196813">x-obs-meta-name: name</strong> (there is a meaningless space before the second <strong id="obs_04_0011__b15475219784">name</strong>) must be changed to <strong id="obs_04_0011__b147515192089">x-obs-meta-name:name</strong>.</li><li id="obs_04_0011__li1011862617470">Each header occupies a separate line.</li></ol>
</td>
</tr>
@ -111,7 +111,7 @@ Host: bucketname.obs.<em id="obs_04_0011__i41621102549">region</em>.example.com<
</table>
</div>
<p id="obs_04_0011__p1327215229377">Use hash-based message authentication code (HMAC) to calculate the signature based on the StringToSign and SK:</p>
<pre class="screen" id="obs_04_0011__screen149461737419">Signature = URL-Encode( Base64( HMAC-SHA1( YourSecretAccessKeyID, UTF-8-Encoding-Of( StringToSign ) ) ) )</pre>
<pre class="screen" id="obs_04_0011__screen149461737419">Signature = URL-Encode( Base64( HMAC-SHA1( Your_SK, UTF-8-Encoding-Of( StringToSign ) ) ) )</pre>
<p class="msonormal" id="obs_04_0011__p50970824">Compared with the Authorization header method:</p>
<ul id="obs_04_0011__ul56084236"><li id="obs_04_0011__li29737353">URLs must use URL encoding — after using Base64 — for signatures.</li><li id="obs_04_0011__li66309591"><strong id="obs_04_0011__b64244561">Expires</strong> in <strong id="obs_04_0011__b41330139">StringToSign</strong> of a URL is similar to <strong id="obs_04_0011__b36426933">Date</strong> in the <strong id="obs_04_0011__b13970192213124">Authorization</strong> header.</li></ul>
<p id="obs_04_0011__p7875151012718"></p>
@ -157,7 +157,7 @@ Host: bucketname.obs.<em id="obs_04_0011__i41621102549">region</em>.example.com<
</table>
</div>
<p id="obs_04_0011__p6969185355414">Calculation rule of the signature</p>
<pre class="screen" id="obs_04_0011__screen3282186165515">Signature = URL-Encode( Base64( HMAC-SHA1( YourSecretAccessKeyID, UTF-8-Encoding-Of( StringToSign ) ) ) )</pre>
<pre class="screen" id="obs_04_0011__screen3282186165515">Signature = URL-Encode( Base64( HMAC-SHA1( Your_SK, UTF-8-Encoding-Of( StringToSign ) ) ) )</pre>
<p id="obs_04_0011__p1944104195517">Calculate the signature and use the host as the prefix of the URL to generate a predefined URL:</p>
<p id="obs_04_0011__p1364618274112">http(s)://examplebucket.obs.<em id="obs_04_0011__i1749314281013">region</em>.example.com/objectkey?AccessKeyId=AccessKeyID&amp;Expires=1532779451&amp;Signature=0Akylf43Bm3mD1bh2rM3dmVp1Bo%3D</p>
<p id="obs_04_0011__p6821252165918">If you enter the address in the browser, then the object <strong id="obs_04_0011__b1377451633517">objectkey</strong> in the <strong id="obs_04_0011__b54493329350">examplebucket</strong> bucket can be downloaded. The validity period of this link is <strong id="obs_04_0011__b1544254193517">1532779451</strong> (indicating Sat Jul 28 20:04:11 CST 2018).</p>

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

@ -1,11 +1,11 @@
<a name="obs_04_0012"></a><a name="obs_04_0012"></a>
<h1 class="topictitle1">Authentication of Signature Carried in the Table Uploaded Through a Browser</h1>
<h1 class="topictitle1">Authenticating the Signature Carried in a Form Uploaded Through a Browser</h1>
<div id="body1523611911872"><p id="obs_04_0012__p56208005173927">OBS supports browser-based uploads using POST requests. Authenticating such a request uses the signature carried in the form. First, create a policy to specify the requirements for requests, such as bucket name or object name prefix. Then, create a signature based on this policy. The request form to be signed must contain a valid signature and policy. Finally, create a form to upload the object to the bucket.</p>
<p id="obs_04_0012__p43211767104750">The process of calculating a signature is as follows:</p>
<ol id="obs_04_0012__ol824835510489"><li id="obs_04_0012__li13246145519488"><a name="obs_04_0012__li13246145519488"></a><a name="li13246145519488"></a>Encode the policy content in UTF-8.</li><li id="obs_04_0012__li1160858144812"><a name="obs_04_0012__li1160858144812"></a><a name="li1160858144812"></a>Encode the result of <a href="#obs_04_0012__li13246145519488">1</a> in Base64.</li><li id="obs_04_0012__li207269014915"><a name="obs_04_0012__li207269014915"></a><a name="li207269014915"></a>Use the SK to calculate the HMAC-SHA1 signature on the result of <a href="#obs_04_0012__li1160858144812">2</a>.</li><li id="obs_04_0012__li257072134920">Encode the result of <a href="#obs_04_0012__li207269014915">3</a> in Base64 to obtain the signature.</li></ol>
<pre class="screen" id="obs_04_0012__screen5989837711856">StringToSign = Base64( UTF-8-Encoding-Of( policy ) )
Signature = Base64( HMAC-SHA1( YourSecretAccessKeyID, StringToSign ) )</pre>
Signature = Base64( HMAC-SHA1( Your_SK, StringToSign ) )</pre>
<p id="obs_04_0012__p5741530311850">The content of the policy is as follows:</p>
<pre class="screen" id="obs_04_0012__screen12376195894310">{ "expiration": "2017-12-31T12:00:00.000Z",
"conditions": [

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

@ -7,6 +7,8 @@
<div class="section" id="obs_04_0017__section144871505442"><h4 class="sectiontitle">Prerequisites</h4><ul id="obs_04_0017__ul12934161525320"><li id="obs_04_0017__li178515325563">You have obtained the AK and SK. For details, see <a href="obs_04_0116.html">Obtaining Access Keys (AK/SK)</a>.</li><li id="obs_04_0017__li18934815155312">At least one bucket is available.</li><li id="obs_04_0017__li88633714534">The file to be uploaded has been prepared and you know the complete local path of the file.</li><li id="obs_04_0017__li1048216251531">You have obtained the region of the bucket which you want to upload files to and determined the endpoint required for API calls. For details, see <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</li></ul>
</div>
<div class="section" id="obs_04_0017__section1660112120579"><h4 class="sectiontitle">Uploading the Object <strong id="obs_04_0017__b1275825014418">objecttest1</strong> to Bucket <strong id="obs_04_0017__b12152162665020">bucket001</strong> in the a1 Region</h4><p id="obs_04_0017__p175871257125719">In this example, an Apache HttpClient is used.</p>
<div class="note" id="obs_04_0017__note15820151620305"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0017__p6820191653018">If the <strong id="obs_04_0017__b490125012819">contentType</strong> parameter in the sample code is left blank, the parameter in the signature header must also be left blank during signature calculation. Otherwise, a signature mismatch error is reported.</p>
</div></div>
<div class="codecoloring" codetype="Java" id="obs_04_0017__screen19523142685013"><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>

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

@ -14,7 +14,7 @@ Authorization:<span class="w"> </span>authorization
</div>
</div>
<div class="note" id="obs_04_0020__note19290105612398"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0020__p52905560398">Regardless of the endpoint you specified, a list of buckets spanning all regions is returned.</p>
<p id="obs_04_0020__p762241611019">Do not list buckets during bucket creation.</p>
<p id="obs_04_0020__p762241611019">When creating a bucket, do not list buckets.</p>
</div></div>
<div class="section" id="obs_04_0020__section51585610"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0020__p40868721">This request contains no parameters.</p>
</div>
@ -164,7 +164,9 @@ Content-Length:<span class="w"> </span>length
<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>GET<span class="w"> </span>/<span class="w"> </span>HTTP/1.1
<span class="normal">6</span>
<span class="normal">7</span></pre></div></td><td class="code"><div><pre><span></span>GET<span class="w"> </span>/
<span class="w"> </span>HTTP/1.1
User-Agent:<span class="w"> </span>curl/7.29.0
Host:<span class="w"> </span>obs.region.example.com
Accept:<span class="w"> </span>*/*

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

@ -133,10 +133,10 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0023__p23514417237"><strong id="obs_04_0023__b21109619048383">Explanation</strong>:</p>
<p id="obs_04_0023__p1359212281313">Whether it is a parallel file system</p>
<p id="obs_04_0023__p1735204422317"><strong id="obs_04_0023__b504163615">Restrictions</strong>:</p>
<p id="obs_04_0023__p1735204422317"><strong id="obs_04_0023__b306144009">Restrictions</strong>:</p>
<p id="obs_04_0023__p75111695139">If this header field is not carried, the bucket is not a parallel file system.</p>
<p id="obs_04_0023__p153210263557"><strong id="obs_04_0023__b132192625513">Value range</strong>:</p>
<p id="obs_04_0023__p43211926205515">The value can be <strong id="obs_04_0023__b1484915031">Enabled</strong> (parallel file system).</p>
<p id="obs_04_0023__p43211926205515">The value can be <strong id="obs_04_0023__b1526708937">Enabled</strong> (parallel file system).</p>
<p id="obs_04_0023__p332117263559"><strong id="obs_04_0023__b132192614555">Default value</strong>:</p>
<p id="obs_04_0023__p5321926155511">None</p>
</td>
@ -174,7 +174,7 @@ Date:<span class="w"> </span>date
<td class="cellrowborder" valign="top" width="14.34%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0023__p6238161771110">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0023__p20111108152414"><strong id="obs_04_0023__b18690710158383">Explanation</strong>:</p>
<p id="obs_04_0023__p87814319139">Value of <strong id="obs_04_0023__b816555405">MaxAgeSeconds</strong> in the CORS configuration of the server when CORS is configured for buckets.</p>
<p id="obs_04_0023__p87814319139">Value of <strong id="obs_04_0023__b1656373990">MaxAgeSeconds</strong> in the CORS configuration of the server when CORS is configured for buckets.</p>
<p id="obs_04_0023__p111824321708"><strong id="obs_04_0023__b5182732103">Restrictions</strong>:</p>
<p id="obs_04_0023__p41821326011">None</p>
<p id="obs_04_0023__p9182632204"><strong id="obs_04_0023__b111827321908">Value range</strong>:</p>
@ -188,7 +188,7 @@ Date:<span class="w"> </span>date
<td class="cellrowborder" valign="top" width="14.34%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0023__p15777194815109">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0023__p6792161082412"><strong id="obs_04_0023__b14339165568383">Explanation</strong>:</p>
<p id="obs_04_0023__p1088121116115">Indicates that methods in the rule are included in the response if <strong id="obs_04_0023__b151409763">Access-Control-Request-Method</strong> in the request meets the CORS configuration requirements when CORS is configured for buckets.</p>
<p id="obs_04_0023__p1088121116115">Indicates that methods in the rule are included in the response if <strong id="obs_04_0023__b15136712">Access-Control-Request-Method</strong> in the request meets the CORS configuration requirements when CORS is configured for buckets.</p>
<p id="obs_04_0023__p854935142720"><strong id="obs_04_0023__b105491854276">Restrictions</strong>:</p>
<p id="obs_04_0023__p390574817013">None</p>
<p id="obs_04_0023__p87921410102413"><strong id="obs_04_0023__b118699730384037">Value range</strong>:</p>
@ -201,13 +201,13 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="14.34%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0023__p133351506106">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0023__p62035417"><strong id="obs_04_0023__b1186534753">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0023__p62035417"><strong id="obs_04_0023__b333517218">Explanation</strong>:</p>
<p id="obs_04_0023__p6203511110"><strong id="obs_04_0023__b7252194111485">ExposeHeader</strong> in the CORS rules of the bucket. It specifies additional headers allowed in the response by a CORS rule, which are used to provide extra information to clients. By default, a browser can access only headers <strong id="obs_04_0023__b1061971995010">Content-Length</strong> and <strong id="obs_04_0023__b462014191506">Content-Type</strong>. If the browser needs to access other headers, you need to configure them in this parameter.</p>
<p id="obs_04_0023__p1120105915"><strong id="obs_04_0023__b19201051714">Restrictions</strong>:</p>
<p id="obs_04_0023__p7201251412">Spaces, wildcard characters (*), ampersands (&amp;), colons (:), less-than signs (&lt;), and full-width characters are not allowed.</p>
<p id="obs_04_0023__p2020145617"><strong id="obs_04_0023__b2201351118">Value range</strong>:</p>
<p id="obs_04_0023__p8206510113">None</p>
<p id="obs_04_0023__p8201352117"><strong id="obs_04_0023__b1140532728">Default value</strong>:</p>
<p id="obs_04_0023__p8201352117"><strong id="obs_04_0023__b628625348">Default value</strong>:</p>
<p id="obs_04_0023__p1820105216">None</p>
</td>
</tr>

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

@ -297,6 +297,69 @@ Server:<span class="w"> </span>OBS
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0027__section8914826113214"><h4 class="sectiontitle">Sample Request 5</h4><p id="obs_04_0027__p19854204113352"><strong id="obs_04_0027__b14854174119358">Granting permissions to a specified agency</strong></p>
<p id="obs_04_0027__p10799272001">The tenant whose account ID is <strong id="obs_04_0027__b290111861913">783fc6652cf246c096ea836694f71855</strong> has an agency named <strong id="obs_04_0027__b7863383193">exampleAgency</strong>. This example grants the agency the permission to view logs of the <strong id="obs_04_0027__b175264519193">logging.bucket</strong> bucket.</p>
<p id="obs_04_0027__p1622874973319"></p>
<div class="codecoloring" codetype="Xml" id="obs_04_0027__screen522874943314"><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>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span></pre></div></td><td class="code"><div><pre><span></span>PUT<span class="w"> </span>/?policy<span class="w"> </span>HTTP/1.1
Host:<span class="w"> </span>examplebucket.obs.region.example.com
Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>02:32:25<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:jZiAT8Vx4azWEvPRMWi0X5BpJMA=
{
<span class="w"> </span>&quot;Statement&quot;:<span class="w"> </span>[
<span class="w"> </span>{
<span class="w"> </span>&quot;Sid&quot;:<span class="w"> </span>&quot;Stmt1375240018061&quot;,
<span class="w"> </span>&quot;Action&quot;:<span class="w"> </span>[
<span class="w"> </span>&quot;GetBucketLogging&quot;
<span class="w"> </span>],
<span class="w"> </span>&quot;Effect&quot;:<span class="w"> </span>&quot;Allow&quot;,
<span class="w"> </span>&quot;Resource&quot;:<span class="w"> </span>&quot;logging.bucket&quot;,
<span class="w"> </span>&quot;Principal&quot;:<span class="w"> </span>{
<span class="w"> </span>&quot;ID&quot;:<span class="w"> </span>[
<span class="w"> </span>&quot;domain/783fc6652cf246c096ea836694f71855:agency/exampleAgency&quot;
<span class="w"> </span>]
<span class="w"> </span>}
<span class="w"> </span>}
<span class="w"> </span>]
}
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0027__section198312494329"><h4 class="sectiontitle">Sample Response 5</h4><div class="codecoloring" codetype="Xml" id="obs_04_0027__screen105251259155818"><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>204<span class="w"> </span>No<span class="w"> </span>Content<span class="w"> </span>
x-obs-request-id:<span class="w"> </span>A603000001604A7DFE4A4AF31E301891
x-obs-id-2:<span class="w"> </span>BKOvGmTlt6sda5X4G89PuMO4fabObGYmnpRGkaMba1LqPt0fCACEuCMllAObRK1n
Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>02:34:34<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>0
Server:<span class="w"> </span>OBS
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">

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

@ -118,12 +118,12 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="9.21%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0030__p172134391412">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="44.89%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0030__p1679912584312"><strong id="obs_04_0030__b4097900008385">Explanation</strong>:</p>
<p id="obs_04_0030__p718113411161">Tenant ID of the grantee.</p>
<p id="obs_04_0030__p718113411161">Account ID of the authorized user.</p>
<p id="obs_04_0030__p7799105104318"><strong id="obs_04_0030__b157991657438">Restrictions</strong>:</p>
<p id="obs_04_0030__p41754217320">None</p>
<p id="obs_04_0030__p725103618360"><strong id="obs_04_0030__b507497060">Value range</strong>:</p>
<p id="obs_04_0030__p725103618360"><strong id="obs_04_0030__b519160291">Value range</strong>:</p>
<p id="obs_04_0030__p141181723123419">None</p>
<p id="obs_04_0030__p1825163633615"><strong id="obs_04_0030__b700957865">Default value</strong>:</p>
<p id="obs_04_0030__p1825163633615"><strong id="obs_04_0030__b611628792">Default value</strong>:</p>
<p id="obs_04_0030__p17634852163111">None</p>
</td>
</tr>
@ -135,11 +135,11 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="44.89%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0030__p1193128194314"><strong id="obs_04_0030__b19576657228385">Explanation</strong>:</p>
<p id="obs_04_0030__p2694103310163">Container for the grantee and the granted permissions</p>
<p id="obs_04_0030__p15211843101413"><strong id="obs_04_0030__b1914034614">Restrictions</strong>:</p>
<p id="obs_04_0030__p15211843101413"><strong id="obs_04_0030__b1157587128">Restrictions</strong>:</p>
<p id="obs_04_0030__p73552111358">A single bucket can contain at most 100 grants in its ACL.</p>
<p id="obs_04_0030__p163554290356"><strong id="obs_04_0030__b1601486753">Value range</strong>:</p>
<p id="obs_04_0030__p163554290356"><strong id="obs_04_0030__b137796547">Value range</strong>:</p>
<p id="obs_04_0030__p1552912415311">None</p>
<p id="obs_04_0030__p18355829103511"><strong id="obs_04_0030__b1920313684">Default value</strong>:</p>
<p id="obs_04_0030__p18355829103511"><strong id="obs_04_0030__b512387192">Default value</strong>:</p>
<p id="obs_04_0030__p12240137135">None</p>
</td>
</tr>
@ -153,9 +153,9 @@ Content-Length:<span class="w"> </span>length
<p id="obs_04_0030__p522943121414">Grantee information</p>
<p id="obs_04_0030__p208051100434"><strong id="obs_04_0030__b1214064716019">Restrictions</strong>:</p>
<p id="obs_04_0030__p98781654532">None</p>
<p id="obs_04_0030__p198034326357"><strong id="obs_04_0030__b872838018">Value range</strong>:</p>
<p id="obs_04_0030__p198034326357"><strong id="obs_04_0030__b394292267">Value range</strong>:</p>
<p id="obs_04_0030__p120811565311">None</p>
<p id="obs_04_0030__p7803163218354"><strong id="obs_04_0030__b2031380226">Default value</strong>:</p>
<p id="obs_04_0030__p7803163218354"><strong id="obs_04_0030__b1731496317">Default value</strong>:</p>
<p id="obs_04_0030__p8442957930">None</p>
</td>
</tr>
@ -214,7 +214,7 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="9.21%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0030__p7222434143">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="44.89%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0030__p169373200433"><strong id="obs_04_0030__b5099066238385">Explanation</strong>:</p>
<p id="obs_04_0030__p122210436147">Indicates an ACL, which consists of three elements: <strong id="obs_04_0030__b545219762">Grant</strong>, <strong id="obs_04_0030__b73433518">Grantee</strong>, and <strong id="obs_04_0030__b1351503529">Permission</strong>.</p>
<p id="obs_04_0030__p122210436147">Indicates an ACL, which consists of three elements: <strong id="obs_04_0030__b1150637825">Grant</strong>, <strong id="obs_04_0030__b1709632564">Grantee</strong>, and <strong id="obs_04_0030__b941561554">Permission</strong>.</p>
<p id="obs_04_0030__p129370205436"><strong id="obs_04_0030__b5937192013430">Restrictions</strong>:</p>
<p id="obs_04_0030__p11181128252">None</p>
<p id="obs_04_0030__p29374206435"><strong id="obs_04_0030__b14319401284039">Value range</strong>:</p>

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

@ -1,7 +1,7 @@
<a name="obs_04_0032"></a><a name="obs_04_0032"></a>
<h1 class="topictitle1">Configuring Logging for a Bucket</h1>
<div id="body64023878"><div class="section" id="obs_04_0032__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0032__p1070114345575">When a bucket is created, the logging function is not enabled by default. To generate logs recording operations on buckets, you need to enable the logging function for the bucket. After the logging function is enabled, a log is generated for each operation on a bucket and multiple logs are packed into a log file. When enabling the logging function, you need to specify a location where log files are stored. They can be stored in the bucket for which the logging is enabled, or in other buckets that you have the required permissions. However, the bucket where log files are stored and the bucket for which the logging is enabled must be in the same region.</p>
<div id="body64023878"><div class="section" id="obs_04_0032__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0032__p1070114345575">When a bucket is created, the logging function is not enabled by default. To generate logs recording operations on buckets, you need to enable the logging function for the bucket. After the logging function is enabled, a log is generated for each operation on a bucket and multiple logs are packed into a log file. The target bucket for storing log files must be specified when logging is enabled. It can be the bucket logging is enabled for, or any other bucket you have access to. If you specify another bucket for storing logs, the bucket must be in the same region as the logged bucket.</p>
<p class="msonormal" id="obs_04_0032__p122341134410">Log files are generated by OBS and uploaded to the bucket where logs are stored. Therefore, OBS needs to be authorized to upload generated log files. Before configuring the logging function, you need to create an agency for OBS in IAM, the agency name is configured as a parameter of the bucket, and the logging function must be configured under the <strong id="obs_04_0032__b1169231102719">LoggingEnabled</strong> tag in the XML file. You only need to authorize the agency with the upload permissions for the target bucket.</p>
</div>
<div class="section" id="obs_04_0032__section17415154115136"><h4 class="sectiontitle">Example of agency permissions</h4><pre class="screen" id="obs_04_0032__screen94051115151515">{
@ -167,7 +167,7 @@ Authorization:<span class="w"> </span>signatureValue
</pre></div></td></tr></table></div>
</div>
<ul id="obs_04_0032__ul073034664916"><li id="obs_04_0032__li157301746184912">&lt;<em id="obs_04_0032__i05437014536">TargetPrefix</em>&gt; is the log name prefix specified by the user.</li><li id="obs_04_0032__li126116813504">YYYY-mm-DD-HH-MM-SS indicates the date and time when the log is generated.</li><li id="obs_04_0032__li351373315513"><em id="obs_04_0032__i20118747155314">&lt;UniqueString&gt;</em> indicates a character string generated by OBS.</li></ul>
<p id="obs_04_0032__p10161523105316">The following is an example of a log file name:</p>
<p id="obs_04_0032__p10161523105316">The following is an example of a log object name:</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0032__screen541212713562"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span>bucket-log2015-06-29-12-22-07-N7MXLAF1BDG7MPDV
</pre></div></td></tr></table></div>
</div>

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

File diff suppressed because it is too large Load Diff

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

@ -58,7 +58,14 @@ Authorization:<span class="w"> </span>authorization
<span class="normal">36</span>
<span class="normal">37</span>
<span class="normal">38</span>
<span class="normal">39</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>status_code
<span class="normal">39</span>
<span class="normal">40</span>
<span class="normal">41</span>
<span class="normal">42</span>
<span class="normal">43</span>
<span class="normal">44</span>
<span class="normal">45</span>
<span class="normal">46</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
Content-Type:<span class="w"> </span>application/xml<span class="w"> </span>
Date:<span class="w"> </span>date
@ -68,6 +75,13 @@ Content-Length:<span class="w"> </span>length
<span class="nt">&lt;LifecycleConfiguration</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;http://obs.region.example.com/doc/2015-06-30/&quot;</span><span class="nt">&gt;</span>
<span class="w"> </span><span class="nt">&lt;Rule&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;ID&gt;</span>id<span class="nt">&lt;/ID&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Filter&gt;</span>
<span class="w"> </span><span class="nt">&lt;And&gt;</span>
<span class="w"> </span><span class="nt">&lt;Prefix&gt;</span>prefix<span class="nt">&lt;/Prefix&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Tag&gt;&lt;Key&gt;</span>key1<span class="nt">&lt;/Key&gt;&lt;Value&gt;</span>value1<span class="nt">&lt;/Value&gt;&lt;/Tag&gt;</span>
<span class="w"> </span><span class="nt">&lt;Tag&gt;&lt;Key&gt;</span>key2<span class="nt">&lt;/Key&gt;&lt;Value&gt;</span>value2<span class="nt">&lt;/Value&gt;&lt;/Tag&gt;</span>
<span class="w"> </span><span class="nt">&lt;/And&gt;</span>
<span class="w"> </span><span class="nt">&lt;/Filter&gt;</span>
<span class="w"> </span><span class="nt">&lt;Prefix&gt;</span>prefix<span class="nt">&lt;/Prefix&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Status&gt;</span>status<span class="nt">&lt;/Status&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Expiration&gt;</span><span class="w"> </span>
@ -201,6 +215,43 @@ Content-Length:<span class="w"> </span>length
<p id="obs_04_0035__p19593133511015">Parent: AbortIncompleteMultipartUpload</p>
</td>
</tr>
<tr id="obs_04_0035__row201552167424"><td class="cellrowborder" valign="top" width="37.37373737373738%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0035__p10818332104215">Filter</p>
</td>
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p18185326422">A specific filter. The lifecycle rule will apply to the objects matching this filter in a bucket.</p>
<p id="obs_04_0035__p13818232114212">You can filter objects by object key prefix, object tag, or both. If there are multiple filters in a rule, use the And logic to combine them.</p>
<p id="obs_04_0035__p9818113214217">Type: XML</p>
<p id="obs_04_0035__p19818732134211">Parent: Rule</p>
</td>
</tr>
<tr id="obs_04_0035__row415571617427"><td class="cellrowborder" valign="top" width="37.37373737373738%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0035__p1581823274218">And</p>
</td>
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p1681817328425">The And logic among filtering criteria.</p>
<p id="obs_04_0035__p98181232184211">The And logic can be used when both the object name prefix and object tag are used.</p>
<p id="obs_04_0035__p128181832184217">Type: XML</p>
<p id="obs_04_0035__p1781883274211">Parent: Filter</p>
</td>
</tr>
<tr id="obs_04_0035__row1215519161428"><td class="cellrowborder" valign="top" width="37.37373737373738%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0035__p18181032114210">Tag</p>
</td>
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p581843215427">The Tag element.</p>
<p id="obs_04_0035__p10818143213422">Type: container</p>
<p id="obs_04_0035__p9818193244213">Parent: Filter or And</p>
</td>
</tr>
<tr id="obs_04_0035__row615641684219"><td class="cellrowborder" valign="top" width="37.37373737373738%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0035__p7818332124212">Key</p>
</td>
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p12818632134212">The key of the tag.</p>
<p id="obs_04_0035__p38181732134210">Type: string</p>
<p id="obs_04_0035__p10818153284210">Parent: Tag</p>
</td>
</tr>
<tr id="obs_04_0035__row115601654215"><td class="cellrowborder" valign="top" width="37.37373737373738%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0035__p148181532104216">Value</p>
</td>
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p1481833210428">The value of the tag.</p>
<p id="obs_04_0035__p381819324421">Type: string</p>
<p id="obs_04_0035__p14818123264216">Parent: Tag</p>
</td>
</tr>
<tr id="obs_04_0035__row9792936"><td class="cellrowborder" valign="top" width="37.37373737373738%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0035__p55030322">Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="62.62626262626263%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0035__p28271080">Object name prefix identifying one or more objects to which the rule applies.</p>
@ -314,6 +365,9 @@ Content-Length:<span class="w"> </span>919
<span class="nt">&lt;LifecycleConfiguration&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Rule&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;ID&gt;</span>delete-2-days<span class="nt">&lt;/ID&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Filter&gt;</span>
<span class="w"> </span><span class="nt">&lt;Prefix&gt;</span>test/<span class="nt">&lt;/Prefix&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;/Filter&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Status&gt;</span>Enabled<span class="nt">&lt;/Status&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Expiration&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Days&gt;</span>2<span class="nt">&lt;/Days&gt;</span><span class="w"> </span>
@ -337,9 +391,6 @@ Content-Length:<span class="w"> </span>919
<span class="w"> </span><span class="nt">&lt;NoncurrentDays&gt;</span>60<span class="nt">&lt;/NoncurrentDays&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;StorageClass&gt;</span>COLD<span class="nt">&lt;/StorageClass&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;/NoncurrentVersionTransition&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;AbortIncompleteMultipartUpload&gt;</span>
<span class="w"> </span><span class="nt">&lt;DaysAfterInitiation&gt;</span>10<span class="nt">&lt;/DaysAfterInitiation&gt;</span>
<span class="w"> </span><span class="nt">&lt;/AbortIncompleteMultipartUpload&gt;</span>
<span class="w"> </span><span class="nt">&lt;/Rule&gt;</span>
<span class="nt">&lt;/LifecycleConfiguration&gt;</span>
</pre></div></td></tr></table></div>

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

@ -66,7 +66,7 @@ Content-Length:<span class="w"> </span>contentlength<span class="w"> </span>
</thead>
<tbody><tr id="obs_04_0046__row1959714163339"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0046__p1457019193311">Content-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0046__p1145731919332">Base64-encoded 128-bit MD5 digest of the message calculated based on RFC 1864. For details about how to calculate the value of <strong id="obs_04_0046__b884172316252">Content-MD5</strong>, see <a href="obs_04_0010.html#obs_04_0010__section1255031191518">Content-MD5 Algorithm in Java</a>.</p>
<td class="cellrowborder" valign="top" width="53%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0046__p1145731919332">Base64-encoded 128-bit MD5 value of the request body calculated according to RFC 1864. For details about how to calculate Content-MD5, see <a href="obs_04_0010.html#obs_04_0010__section1255031191518">Content-MD5 Algorithm in Java</a>. </p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0046__p13457131923313">Yes</p>
</td>

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

@ -49,9 +49,16 @@ Content-MD5:<span class="w"> </span>md5
</thead>
<tbody><tr id="obs_04_0049__row520210419261"><td class="cellrowborder" valign="top" width="22.430000000000003%" headers="mcps1.3.5.3.2.4.1.1 "><p id="obs_04_0049__p1376912802612">Content-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0049__p179925362264">Base64-encoded 128-bit MD5 digest of the message according to RFC 1864. </p>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0049__p793733224511"><strong id="obs_04_0049__b1490911334454">Explanation</strong>:</p>
<p id="obs_04_0049__p179925362264">Base64-encoded 128-bit MD5 digest of the message according to RFC 1864. </p>
<p id="obs_04_0049__p3992123610265">Type: string</p>
<p id="obs_04_0049__p299210367269">Example: <strong id="obs_04_0049__b27324094519">n58IG6hfM7vqI4K0vnWpog==</strong></p>
<p id="obs_04_0049__p176064044514"><strong id="obs_04_0049__b8324124014510">Restrictions</strong>:</p>
<p id="obs_04_0049__p15152104111451">None</p>
<p id="obs_04_0049__p1320155144515"><strong id="obs_04_0049__b14206553450">Value range</strong>:</p>
<p id="obs_04_0049__p17201551456">None</p>
<p id="obs_04_0049__p132018557453"><strong id="obs_04_0049__b1205557459">Default value</strong>:</p>
<p id="obs_04_0049__p1420135514459">None</p>
</td>
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0049__p12769889268">Yes</p>
</td>
@ -72,7 +79,8 @@ Content-MD5:<span class="w"> </span>md5
</thead>
<tbody><tr id="obs_04_0049__row7197230193913"><td class="cellrowborder" valign="top" width="22.430000000000003%" headers="mcps1.3.6.3.2.4.1.1 "><p id="obs_04_0049__p125361017184212">Tagging</p>
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0049__p6536111718422">Root element for TagSet and Tag</p>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0049__p2495132311435"><strong id="obs_04_0049__b1792610235430">Explanation</strong>:</p>
<p id="obs_04_0049__p6536111718422">Root element for TagSet and Tag</p>
<p id="obs_04_0049__p85368172423">Type: container</p>
<p id="obs_04_0049__p125365178429">Parent: none</p>
</td>
@ -81,7 +89,8 @@ Content-MD5:<span class="w"> </span>md5
</tr>
<tr id="obs_04_0049__row12641636422"><td class="cellrowborder" valign="top" width="22.430000000000003%" headers="mcps1.3.6.3.2.4.1.1 "><p id="obs_04_0049__p3911152616425">TagSet</p>
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0049__p591252604217">Element of the tag set</p>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0049__p34172324434"><strong id="obs_04_0049__b82099359432">Explanation</strong>:</p>
<p id="obs_04_0049__p591252604217">Element of the tag set</p>
<p id="obs_04_0049__p391202634216">Type: container</p>
<p id="obs_04_0049__p4912142604210">Parent: Tagging</p>
</td>
@ -90,7 +99,8 @@ Content-MD5:<span class="w"> </span>md5
</tr>
<tr id="obs_04_0049__row944320444211"><td class="cellrowborder" valign="top" width="22.430000000000003%" headers="mcps1.3.6.3.2.4.1.1 "><p id="obs_04_0049__p163325395428">Tag</p>
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0049__p8333639114218">Information element of Tag</p>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0049__p1671315427430"><strong id="obs_04_0049__b34881439432">Explanation</strong>:</p>
<p id="obs_04_0049__p8333639114218">Information element of Tag</p>
<p id="obs_04_0049__p1233323919429">Type: container</p>
<p id="obs_04_0049__p0333163974214">Parent: TagSet</p>
</td>
@ -102,9 +112,9 @@ Content-MD5:<span class="w"> </span>md5
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0049__p552516115113"><strong id="obs_04_0049__b196511117135313">Explanation</strong>:</p>
<p id="obs_04_0049__p74952488427">Name of a tag. Type: string. Parent: Tag.</p>
<p id="obs_04_0049__p21387484532"><strong id="obs_04_0049__b1137626195416">Restrictions</strong>:</p>
<ul id="obs_04_0049__ul873012181414"><li id="obs_04_0049__li072146171410">A tag key can contain a maximum of 36 characters.</li><li id="obs_04_0049__li1273013211417">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 characters (0x00 to 0x1F). Tag keys and values must be URL encoded before being sent to a server.</li></ul>
<ul id="obs_04_0049__ul873012181414"><li id="obs_04_0049__li072146171410">A tag key can contain a maximum of 36 characters.</li><li id="obs_04_0049__li19867313893">Only digits, letters, underscores (_), hyphens (-) are allowed.</li></ul>
<p id="obs_04_0049__p149512481428"><strong id="obs_04_0049__b183292471315">Value range</strong>:</p>
<p id="obs_04_0049__p10120172216147">A string between 0 and 36 characters long.</p>
<p id="obs_04_0049__p10120172216147">A string between 1 and 36 characters long.</p>
<p id="obs_04_0049__p828473515177"><strong id="obs_04_0049__b1251664719177">Default value</strong>:</p>
<p id="obs_04_0049__p160454111716">None</p>
</td>
@ -116,9 +126,9 @@ Content-MD5:<span class="w"> </span>md5
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.6.3.2.4.1.2 "><p id="obs_04_0049__p193579331545"><strong id="obs_04_0049__b1690337135412">Explanation</strong>:</p>
<p id="obs_04_0049__p19616854174215">Tag value. Type: string. Parent: Tag.</p>
<p id="obs_04_0049__p874071055416"><strong id="obs_04_0049__b631714299549">Restrictions</strong>:</p>
<ul id="obs_04_0049__ul011114014143"><li id="obs_04_0049__li9346151711416">A key value can contain a maximum of 43 characters.</li><li id="obs_04_0049__li411120181416">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 characters (0x00 to 0x1F). Tag keys and values must be URL encoded before being sent to a server.</li></ul>
<ul id="obs_04_0049__ul011114014143"><li id="obs_04_0049__li9346151711416">A key value can contain a maximum of 43 characters.</li><li id="obs_04_0049__li119411850101217">Only digits, letters, underscores (_), hyphens (-) are allowed.</li></ul>
<p id="obs_04_0049__p15822812135"><strong id="obs_04_0049__b329612861318">Value range</strong>:</p>
<p id="obs_04_0049__p1469512261713">A string of 0 to 42 characters.</p>
<p id="obs_04_0049__p1469512261713">A string of 0 (included) to 43 (excluded) characters.</p>
<p id="obs_04_0049__p190412261173"><strong id="obs_04_0049__b1027914511174">Default value</strong>:</p>
<p id="obs_04_0049__p13767123014175">None</p>
</td>

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

@ -2,6 +2,7 @@
<h1 class="topictitle1">Configuring a Custom Domain Name for a Bucket</h1>
<div id="body1547543646680"><div class="section" id="obs_04_0059__section1097191013372"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0059__p52777375515">OBS uses the PUT method to configure a custom domain name for a bucket. After the configuration is successful, you can access the bucket through the domain name.</p>
<p id="obs_04_0059__p13803112713494">To perform this operation, the user must be the bucket owner or the bucket owner's IAM user that has permissions required for configuring custom domain names.</p>
<p id="obs_04_0059__p495617724216">Ensure that the custom domain name can correctly resolve to the OBS service through DNS.</p>
</div>
<div class="section" id="obs_04_0059__section567762953711"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0059__screen175419175810"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
@ -20,24 +21,29 @@ Content-Length:<span class="w"> </span>0
</pre></div></td></tr></table></div>
</div>
</div>
<p id="obs_04_0059__p3567245113820"></p>
<div class="section" id="obs_04_0059__section4177155819377"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0059__table34931235193212" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0059__row195001352328"><th align="left" class="cellrowborder" valign="top" width="22.430000000000003%" id="mcps1.3.3.2.2.4.1.1"><p id="obs_04_0059__p750214358321">Parameter</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0059__table34931235193212" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0059__row195001352328"><th align="left" class="cellrowborder" valign="top" width="22.430000000000003%" id="mcps1.3.4.2.2.4.1.1"><p id="obs_04_0059__p750214358321">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="53.260000000000005%" id="mcps1.3.3.2.2.4.1.2"><p id="obs_04_0059__p95049355327">Description</p>
<th align="left" class="cellrowborder" valign="top" width="53.260000000000005%" id="mcps1.3.4.2.2.4.1.2"><p id="obs_04_0059__p95049355327">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.310000000000002%" id="mcps1.3.3.2.2.4.1.3"><p id="obs_04_0059__p185061235143215">Mandatory</p>
<th align="left" class="cellrowborder" valign="top" width="24.310000000000002%" id="mcps1.3.4.2.2.4.1.3"><p id="obs_04_0059__p185061235143215">Mandatory</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0059__row175081135133212"><td class="cellrowborder" valign="top" width="22.430000000000003%" headers="mcps1.3.3.2.2.4.1.1 "><p id="obs_04_0059__p19510123510324">customdomain</p>
<tbody><tr id="obs_04_0059__row175081135133212"><td class="cellrowborder" valign="top" width="22.430000000000003%" headers="mcps1.3.4.2.2.4.1.1 "><p id="obs_04_0059__p19510123510324">customdomain</p>
</td>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.3.2.2.4.1.2 "><p id="obs_04_0059__p16551024153319">Custom domain name of a bucket.</p>
<p id="obs_04_0059__p3653204810576">Type: string, which must meet the naming conventions of domain names.</p>
<p id="obs_04_0059__p154809270334">Specifications: The value contains a maximum of 256 characters.</p>
<p id="obs_04_0059__p163341526203219">No default value.</p>
<p id="obs_04_0059__p1557415131589">Constraints: A bucket can have a maximum of 30 domain names. A custom domain name can be used for only one bucket.</p>
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.4.2.2.4.1.2 "><p id="obs_04_0059__p122588914915"><strong id="obs_04_0059__b470216154916">Explanation</strong>:</p>
<p id="obs_04_0059__p16551024153319">Custom domain name of a bucket.</p>
<p id="obs_04_0059__p89852224918">Type: String, which must meet the naming conventions of domain names.</p>
<p id="obs_04_0059__p176064044514"><strong id="obs_04_0059__b8324124014510">Restrictions</strong>:</p>
<p id="obs_04_0059__p15152104111451">A bucket can have a maximum of 30 domain names. One custom domain name can be used for only one bucket.</p>
<p id="obs_04_0059__p1320155144515"><strong id="obs_04_0059__b14206553450">Value range</strong>:</p>
<p id="obs_04_0059__p17201551456">The maximum length is 256 bytes.</p>
<p id="obs_04_0059__p132018557453"><strong id="obs_04_0059__b1205557459">Default value</strong>:</p>
<p id="obs_04_0059__p163341526203219">None</p>
</td>
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.3.2.2.4.1.3 "><p id="obs_04_0059__p853293516321">Yes</p>
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.4.2.2.4.1.3 "><p id="obs_04_0059__p853293516321">Yes</p>
</td>
</tr>
</tbody>
@ -68,7 +74,7 @@ Content-Length:<span class="w"> </span>0
</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>
<div class="section" id="obs_04_0059__section10465193414013"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0059__screen11617610142118"><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_0059__section10465193414013"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0059__screen1661152375719"><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>
@ -83,6 +89,7 @@ Authorization:<span class="w"> </span>OBS<span class="w"> </span>UDSIAMSTUBTEST0
Content-Length:<span class="w"> </span>0
</pre></div></td></tr></table></div>
</div>
<p id="obs_04_0059__p0609112615576"></p>
</div>
<div class="section" id="obs_04_0059__section0901443174010"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0059__screen12451330122319"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>

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

@ -2,6 +2,7 @@
<h1 class="topictitle1">Obtaining the Custom Domain Name of a Bucket</h1>
<div id="body1547543646680"><div class="section" id="obs_04_0060__section92945567408"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0060__p328123010563">OBS uses the GET method to obtain the custom domain name of a bucket.</p>
<p id="obs_04_0060__p13803112713494">To perform this operation, the user must be the bucket owner or the bucket owner's IAM user that has permissions required for obtaining custom domain names.</p>
</div>
<div class="section" id="obs_04_0060__section12731421194111"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0060__screen740133832512"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>

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

@ -2,6 +2,7 @@
<h1 class="topictitle1">Deleting the Custom Domain Name of a Bucket</h1>
<div id="body1547543646680"><div class="section" id="obs_04_0061__section137721429163611"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0061__p18313566411">OBS uses the DELETE method to delete the custom domain name of a bucket.</p>
<p id="obs_04_0061__p13803112713494">To perform this operation, the user must be the bucket owner or the bucket owner's IAM user that has permissions required for deleting custom domain names.</p>
</div>
<div class="section" id="obs_04_0061__section331952113719"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0061__screen8308647352"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>

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

@ -88,7 +88,7 @@ Content-Length:<span class="w"> </span>length
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.3.2.4.1.2 "><p id="obs_04_0062__p74952488427">Server-side encryption algorithm used for the default encryption configuration of a bucket.</p>
<p id="obs_04_0062__p1349514814423">Type: string</p>
<p id="obs_04_0062__p1268671911710">Value options:</p>
<ul id="obs_04_0062__ul132019478719"><li id="obs_04_0062__li02014477716"><strong id="obs_04_0062__b62926115499">kms</strong>: SSE-KMS encryption and the AES256 algorithm are used. To use the SM4 algorithm, you need to configure <strong id="obs_04_0062__b65321329185010">KMSDataEncryption</strong>.</li><li id="obs_04_0062__li72018473716"><strong id="obs_04_0062__b4641914124916">AES256</strong>: SSE-OBS encryption and the AES256 algorithm are used.</li></ul>
<ul id="obs_04_0062__ul132019478719"><li id="obs_04_0062__li02014477716"><strong id="obs_04_0062__b62926115499">kms</strong>: SSE-KMS encryption and the AES256 algorithm are used.</li><li id="obs_04_0062__li72018473716"><strong id="obs_04_0062__b4641914124916">AES256</strong>: SSE-OBS encryption and the AES256 algorithm are used.</li></ul>
<p id="obs_04_0062__p1089135793715">Parent: ApplyServerSideEncryptionByDefault</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.3.5.3.2.4.1.3 "><p id="obs_04_0062__p18495154864216">Yes</p>

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

@ -6,7 +6,7 @@
<p class="msonormal" id="obs_04_0071__p46399988">You can perform this operation to create or update the website configuration of a bucket.</p>
<p class="msonormal" id="obs_04_0071__p14946713">To perform this operation, you must have the <strong id="obs_04_0071__b14931727165717">PutBucketWebsite</strong> permission. By default, only the bucket owner can perform this operation. The bucket owner can grant the permission to other users by configuring the bucket policy or user policy.</p>
<div class="note" id="obs_04_0071__note302693"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="obs_04_0071__p26317097">Avoid using periods (.) in the destination bucket name. Otherwise, failures in client authentication certificate may occur when users use HTTPS for access.</p>
<p id="obs_04_0071__p130153912510">The maximum size of a network configuration request for a bucket is 10 KB.</p>
<p id="obs_04_0071__p130153912510">The maximum size of a request body for configuring static website hosting for a bucket is 10 KB.</p>
</div></div>
</div>
<div class="section" id="obs_04_0071__section2724241"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0071__screen51310142"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>

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

@ -2,9 +2,9 @@
<h1 class="topictitle1">Configuring Bucket CORS</h1>
<div id="body51020275"><div class="section" id="obs_04_0074__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0074__p32096233">Cross-origin resource sharing (CORS) is a standard mechanism proposed by World Wide Web Consortium (W3C) and allows cross-origin requests from clients. For standard web page requests, the scripts and contents at one website cannot interact with those at another website due to the existence of the Same Origin Policy (SOP).</p>
<p class="msonormal" id="obs_04_0074__p20430646">OBS allows buckets to store static web resources. The buckets of OBS can serve as website resources if the buckets are properly used (for details, see <a href="obs_04_0071.html">Configuring Static Website Hosting for a Bucket</a>). A website in OBS can respond to requests of another websites only after CORS is properly configured.</p>
<p class="msonormal" id="obs_04_0074__p20430646">OBS allows buckets to store static web resources. The buckets of OBS can serve as website resources if the buckets are properly used (for details, see <a href="obs_04_0071.html">Configuring Static Website Hosting for a Bucket</a>). A website in OBS can respond to cross-origin requests from another website only after CORS is configured.</p>
<p class="msonormal" id="obs_04_0074__p49658093">Typical application scenarios are as follows:</p>
<ul id="obs_04_0074__ul44269653"><li id="obs_04_0074__li39001642">With the support of CORS, you can use JavaScript and HTML5 to construct web applications and directly access the resources in OBS without the need to use proxy servers for transfer.</li><li id="obs_04_0074__li15470458">You can enable the dragging function of HTML 5 to directly upload files to the OBS (with the upload progress displayed) or update the OBS contents using web applications.</li><li id="obs_04_0074__li5016396">Hosts external web pages, style sheets, and HTML 5 applications in different origins. Web fonts or pictures on OBS can be shared by multiple websites.</li></ul>
<ul id="obs_04_0074__ul44269653"><li id="obs_04_0074__li39001642">With CORS, you can use JavaScript and HTML5 to construct web applications that allow direct access to resources in OBS without the need to use proxy servers for transfer.</li><li id="obs_04_0074__li15470458">You can enable the dragging function of HTML 5 to directly upload files to the OBS (with the upload progress displayed) or update the OBS contents using web applications.</li><li id="obs_04_0074__li5016396">Hosts external web pages, style sheets, and HTML 5 applications in different origins. Web fonts or pictures on OBS can be shared by multiple websites.</li></ul>
<p class="msonormal" id="obs_04_0074__p62882560">To perform this operation, you must have the <strong id="obs_04_0074__b7243652011">PutBucketCORS</strong> permission. By default, only the bucket owner can perform this operation. The bucket owner can grant the permission to other users by configuring the bucket policy or user policy.</p>
</div>
<div class="section" id="obs_04_0074__section29072136"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0074__screen3674947"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
@ -66,7 +66,7 @@ Content-MD5:<span class="w"> </span>MD5
<td class="cellrowborder" valign="top" width="63.54%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0074__p195513201711"><strong id="obs_04_0074__b115521022174">Explanation</strong>:</p>
<p id="obs_04_0074__p928175113812">Base64-encoded 128-bit MD5 digest of the message according to RFC 1864 </p>
<p id="obs_04_0074__p028110517382">Example: <strong id="obs_04_0074__b135034317596">n58IG6hfM7vqI4K0vnWpog==</strong></p>
<p id="obs_04_0074__p135526241711"><strong id="obs_04_0074__b1996387306">Restrictions</strong>:</p>
<p id="obs_04_0074__p135526241711"><strong id="obs_04_0074__b551054492">Restrictions</strong>:</p>
<p id="obs_04_0074__p59145553417">None</p>
<p id="obs_04_0074__p175521213171"><strong id="obs_04_0074__b1873731511442">Value range</strong>:</p>
<p id="obs_04_0074__p411817309610">None</p>
@ -116,7 +116,7 @@ Content-MD5:<span class="w"> </span>MD5
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__p1582711141713"><strong id="obs_04_0074__b458219114172">Explanation</strong>:</p>
<p id="obs_04_0074__p94092471085">CORS rules</p>
<p id="obs_04_0074__p18701175033812">Parent: CORSConfiguration</p>
<p id="obs_04_0074__p1358261117176"><strong id="obs_04_0074__b1243646857">Restrictions</strong>:</p>
<p id="obs_04_0074__p1358261117176"><strong id="obs_04_0074__b282722337">Restrictions</strong>:</p>
<p id="obs_04_0074__p6454135011816">CORSConfiguration can contain a maximum of 100 rules.</p>
<p id="obs_04_0074__p05821745191320"><strong id="obs_04_0074__b523641194414">Value range</strong>:</p>
<p id="obs_04_0074__p227816401375">None</p>
@ -155,7 +155,7 @@ Content-MD5:<span class="w"> </span>MD5
<p id="obs_04_0074__en-us_topic_0262515644_p1470012223452"><strong id="obs_04_0074__en-us_topic_0262515644_b2070072264511">Value range</strong>:</p>
<p id="obs_04_0074__en-us_topic_0262515644_p1453517573317">The following HTTP methods are supported:</p>
<ul id="obs_04_0074__en-us_topic_0262515644_ul1862243913291"><li id="obs_04_0074__en-us_topic_0262515644_li762243952910">GET</li><li id="obs_04_0074__en-us_topic_0262515644_li6213144119299">PUT</li><li id="obs_04_0074__en-us_topic_0262515644_li17251244102913">HEAD</li><li id="obs_04_0074__en-us_topic_0262515644_li5945470299">POST</li><li id="obs_04_0074__en-us_topic_0262515644_li126515814296">DELETE</li></ul>
<p id="obs_04_0074__en-us_topic_0262515644_p177001222124518"><strong id="obs_04_0074__b1983901900">Default value</strong>:</p>
<p id="obs_04_0074__en-us_topic_0262515644_p177001222124518"><strong id="obs_04_0074__b1165873542">Default value</strong>:</p>
<p id="obs_04_0074__p1857312613819">None</p>
</td>
</tr>
@ -185,11 +185,11 @@ Content-MD5:<span class="w"> </span>MD5
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__en-us_topic_0262515644_p817828104512"><strong id="obs_04_0074__en-us_topic_0262515644_b101702824511">Explanation</strong>:</p>
<p id="obs_04_0074__en-us_topic_0262515644_p713723514208">What headers are allowed in a CORS request. If a CORS request contains the <strong id="obs_04_0074__b572810247182">Access-Control-Request-Headers</strong> header, the headers listed in this header must match the headers in the <strong id="obs_04_0074__b8911121182119">AllowedHeader</strong> element so that the request can be considered valid. The matching is based on regular expressions.</p>
<p id="obs_04_0074__p96311957132516">Parent: CORSRule</p>
<p id="obs_04_0074__en-us_topic_0262515644_p181712824516"><strong id="obs_04_0074__b2059800310">Restrictions</strong>:</p>
<p id="obs_04_0074__en-us_topic_0262515644_p181712824516"><strong id="obs_04_0074__b1528543388">Restrictions</strong>:</p>
<p id="obs_04_0074__en-us_topic_0262515644_p147671948182016">At most one asterisk (*) is allowed. Spaces, ampersands (&amp;), colons (:), less-than signs (&lt;), and full-width characters are not allowed.</p>
<p id="obs_04_0074__p1238181415269"><strong id="obs_04_0074__b123744132451">Value range</strong>:</p>
<p id="obs_04_0074__p1246312531285">The value must comply with the CORS protocol and contain 0 to 20480 characters.</p>
<p id="obs_04_0074__en-us_topic_0262515644_p2181228104515"><strong id="obs_04_0074__b1318630430">Default value</strong>:</p>
<p id="obs_04_0074__en-us_topic_0262515644_p2181228104515"><strong id="obs_04_0074__b1770342577">Default value</strong>:</p>
<p id="obs_04_0074__en-us_topic_0262515644_p791893316215">None</p>
</td>
</tr>
@ -223,7 +223,7 @@ Content-MD5:<span class="w"> </span>MD5
<p id="obs_04_0074__p1496717473920">Spaces, asterisks (*), ampersands (&amp;), colons (:), less-than signs (&lt;), and full-width characters are not allowed.</p>
<p id="obs_04_0074__p0967247792"><strong id="obs_04_0074__b1954012784516">Value range</strong>:</p>
<p id="obs_04_0074__p1967134717916">The value that complies with the CORS</p>
<p id="obs_04_0074__p169674471091"><strong id="obs_04_0074__b1621942710">Default value</strong>:</p>
<p id="obs_04_0074__p169674471091"><strong id="obs_04_0074__b1322825542">Default value</strong>:</p>
<p id="obs_04_0074__p296724714916">None</p>
</td>
</tr>

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

@ -34,9 +34,9 @@
</li>
<li class="ulchildlink"><strong><a href="obs_04_0172.html">Adding Object Tags</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001399487626.html">Obtaining Object Tags</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0164.html">Obtaining Object Tags</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000001399647606.html">Deleting Object Tags</a></strong><br>
<li class="ulchildlink"><strong><a href="obs_04_0165.html">Deleting Object Tags</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0166.html">Configuring WORM Retention for an Object</a></strong><br>
</li>

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

File diff suppressed because it is too large Load Diff

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

@ -33,8 +33,15 @@ Authorization:<span class="w"> </span>authorization
</thead>
<tbody><tr id="obs_04_0085__row40173335"><td class="cellrowborder" valign="top" width="22.220000000000002%" headers="mcps1.3.5.4.2.4.1.1 "><p id="obs_04_0085__p32814727">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0085__p40747248">Object version ID</p>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.5.4.2.4.1.2 "><p id="obs_04_0085__p11897180115114"><strong id="obs_04_0085__b163732517516">Explanation</strong>:</p>
<p id="obs_04_0085__p18897108515">Version ID of the object to be deleted.</p>
<p id="obs_04_0085__p31180913">Type: string</p>
<p id="obs_04_0085__p198973015512"><strong id="obs_04_0085__b1643717817513">Restrictions</strong>:</p>
<p id="obs_04_0085__p18971705513">None</p>
<p id="obs_04_0085__p489715095113"><strong id="obs_04_0085__b320517118516">Value range</strong>:</p>
<p id="obs_04_0085__p1489716019519">The value must contain 32 characters.</p>
<p id="obs_04_0085__p12897103513"><strong id="obs_04_0085__b15241414135117">Default value</strong>:</p>
<p id="obs_04_0085__p3897160155114">None</p>
</td>
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.5.4.2.4.1.3 "><p id="obs_04_0085__p42625985">No</p>
</td>
@ -64,17 +71,28 @@ Date:<span class="w"> </span>date
</thead>
<tbody><tr id="obs_04_0085__row59084026"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0085__p21076811">x-obs-delete-marker</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0085__p29500132">Indicates whether an object is deleted. If the object is not marked as deleted, the response does not contain this header.</p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0085__p748657125212"><strong id="obs_04_0085__b144805712522">Explanation</strong>:</p>
<p id="obs_04_0085__p29500132">Whether an object has a delete marker. If the object is not marked as deleted, the response does not contain this header.</p>
<p id="obs_04_0085__p64174604">Type: boolean</p>
<p id="obs_04_0085__p40700526">Value options: <strong id="obs_04_0085__b5972123874714">true</strong>, <strong id="obs_04_0085__b5972163815473">false</strong></p>
<p id="obs_04_0085__p30760421">The default value is <strong id="obs_04_0085__b84235270618335">false</strong>.</p>
<p id="obs_04_0085__p538685185312"><strong id="obs_04_0085__b1038655125310">Restrictions</strong>:</p>
<p id="obs_04_0085__p18386456530">None</p>
<p id="obs_04_0085__p16386165135313"><strong id="obs_04_0085__b193869595313">Value range</strong>:</p>
<ul id="obs_04_0085__ul158475215532"><li id="obs_04_0085__li16847121175311"><strong id="obs_04_0085__b1751714421170">true</strong></li><li id="obs_04_0085__li2847132114533"><strong id="obs_04_0085__b113595071217">false</strong></li></ul>
<p id="obs_04_0085__p01941092532"><strong id="obs_04_0085__b183481412536">Default value</strong>:</p>
<p id="obs_04_0085__p30760421">false</p>
</td>
</tr>
<tr id="obs_04_0085__row8408337"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0085__p9986676">x-obs-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0085__p3614399">Object version ID. If the object has no version number specified, the response does not contain this header.</p>
<p id="obs_04_0085__p32529595">Valid value: string</p>
<p id="obs_04_0085__p24330907">Default value: none</p>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0085__p1873713135415"><strong id="obs_04_0085__b127375105419">Explanation</strong>:</p>
<p id="obs_04_0085__p3614399">Object version ID. If the object has no version number specified, the response does not contain this header.</p>
<p id="obs_04_0085__p187372145410">Type: string</p>
<p id="obs_04_0085__p4737119540"><strong id="obs_04_0085__b1773718115419">Restrictions</strong>:</p>
<p id="obs_04_0085__p8737516545">None</p>
<p id="obs_04_0085__p37373110542"><strong id="obs_04_0085__b147372185414">Value range</strong>:</p>
<p id="obs_04_0085__p87377125418">The value must contain 32 characters.</p>
<p id="obs_04_0085__p97377195416"><strong id="obs_04_0085__b973751135419">Default value</strong>:</p>
<p id="obs_04_0085__p9737201115410">None</p>
</td>
</tr>
</tbody>

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

@ -1,7 +1,7 @@
<a name="obs_04_0087"></a><a name="obs_04_0087"></a>
<h1 class="topictitle1">Restoring Cold Objects</h1>
<div id="body58597509"><div class="section" id="obs_04_0087__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0087__p13952829">To obtain the content of an object in the Cold storage class, you need to restore the object first and then you can download it. After an object is restored, a copy of the object is saved in the Standard storage class. By doing so, the object in the Cold storage class and its copy in the Standard storage class co-exist in the bucket. The copy will be automatically deleted once its retention period ends.</p>
<h1 class="topictitle1">Restoring <span id="text16862224724">Cold</span> Objects</h1>
<div id="body58597509"><div class="section" id="obs_04_0087__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0087__p13952829">To obtain the content of an object in the <span id="obs_04_0087__text66804411234">Cold</span> storage class, you need to restore the object first and then you can download it. After an object is restored, a copy of the object is saved in the Standard storage class. By doing so, the object in the <span id="obs_04_0087__text1333764711320">Cold</span> storage class and its copy in the Standard storage class co-exist in the bucket. The copy will be automatically deleted once its retention period ends.</p>
</div>
<div class="section" id="obs_04_0087__section58466603"><h4 class="sectiontitle">Versioning</h4><p class="msonormal" id="obs_04_0087__p48777806">By default, this operation returns the latest version of an object. If the object has a delete marker, status code 404 is returned. To restore an object of a specified version, the <strong id="obs_04_0087__b1866401892947">versionId</strong> parameter can be used to specify the desired version.</p>
</div>
@ -36,7 +36,7 @@ Content-MD5: <em id="obs_04_0087__i52653375">MD5</em>
<td class="cellrowborder" valign="top" width="8.64%" headers="mcps1.3.4.2.1.5.1.3 "><p id="obs_04_0087__p29451615134012">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.53999999999999%" headers="mcps1.3.4.2.1.5.1.4 "><p id="obs_04_0087__p7134184955020"><strong id="obs_04_0087__b17632520583829">Explanation</strong>:</p>
<p id="obs_04_0087__p6945201534013">Version ID of the Cold object to be restored</p>
<p id="obs_04_0087__p6945201534013">Version ID of the <span id="obs_04_0087__text56471914047">Cold</span> object to be restored</p>
<p id="obs_04_0087__p6244143815356"><strong id="obs_04_0087__b324433873516">Restrictions</strong>:</p>
<p id="obs_04_0087__p3244153833514">None</p>
<p id="obs_04_0087__p72444384359"><strong id="obs_04_0087__b17244173823512">Value range</strong>:</p>
@ -84,7 +84,7 @@ Content-MD5: <em id="obs_04_0087__i52653375">MD5</em>
</td>
<td class="cellrowborder" valign="top" width="13.450000000000001%" headers="mcps1.3.6.2.2.5.1.3 "><p id="obs_04_0087__p14767123314116">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="49.49%" headers="mcps1.3.6.2.2.5.1.4 "><p id="obs_04_0087__p52661949707"><strong id="obs_04_0087__b720861816">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="49.49%" headers="mcps1.3.6.2.2.5.1.4 "><p id="obs_04_0087__p52661949707"><strong id="obs_04_0087__b938973920">Explanation</strong>:</p>
<p id="obs_04_0087__p97431944655">After an object is restored, a Standard copy of it is generated. This parameter specifies how long the Standard copy can be retained, that is, the validity period of the restored object.</p>
<p id="obs_04_0087__p291315175519"><strong id="obs_04_0087__b29131817185116">Restrictions</strong>:</p>
<p id="obs_04_0087__p791319174514">None</p>
@ -116,7 +116,7 @@ Content-MD5: <em id="obs_04_0087__i52653375">MD5</em>
</td>
<td class="cellrowborder" valign="top" width="13.450000000000001%" headers="mcps1.3.6.2.2.5.1.3 "><p id="obs_04_0087__p1476717339418">No</p>
</td>
<td class="cellrowborder" valign="top" width="49.49%" headers="mcps1.3.6.2.2.5.1.4 "><p id="obs_04_0087__p1818216511507"><strong id="obs_04_0087__b1662598088">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="49.49%" headers="mcps1.3.6.2.2.5.1.4 "><p id="obs_04_0087__p1818216511507"><strong id="obs_04_0087__b1215976975">Explanation</strong>:</p>
<p id="obs_04_0087__p16721225165">Retrieval speed tier. You can select a tier that suits your retrieval needs.</p>
<p id="obs_04_0087__p21826514018"><strong id="obs_04_0087__b1118219518016">Value range</strong>:</p>
<ul id="obs_04_0087__ul173171648115317"><li id="obs_04_0087__li163171548115315"><strong id="obs_04_0087__b1019882112355">Expedited</strong> indicates that objects can be quickly restored from Archive storage within 1 to 5 minutes.</li><li id="obs_04_0087__li2317104818530"><strong id="obs_04_0087__b190433047843958">Standard</strong> indicates that objects can be restored from Archive storage within 3 to 5 hours.</li></ul>
@ -149,7 +149,7 @@ Date:<span class="w"> </span>date
</thead>
<tbody><tr id="obs_04_0087__row07301913435"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.10.2.2.4.1.1 "><p id="obs_04_0087__p173013118434">RestoreAlreadyInProgress</p>
</td>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p9251144715614"><strong id="obs_04_0087__b1820941395">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p9251144715614"><strong id="obs_04_0087__b682339853">Explanation</strong>:</p>
<p id="obs_04_0087__p5730817439">The object is being restored. The request conflicts with another.</p>
<p id="obs_04_0087__p147304110439">ErrorMessage: Object restore is already in progress</p>
</td>
@ -158,7 +158,7 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0087__row27301812437"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.10.2.2.4.1.1 "><p id="obs_04_0087__p19730131184318">ObjectHasAlreadyRestored</p>
</td>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p540724115718"><strong id="obs_04_0087__b107388827">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p540724115718"><strong id="obs_04_0087__b1973107206">Explanation</strong>:</p>
<p id="obs_04_0087__p5730121174319">The objects have been restored and the retention period of the objects cannot be shortened.</p>
<p id="obs_04_0087__p2730121164317">ErrorMessage: After restoring an archived object, you cannot shorten the restoration period of the archived object</p>
</td>
@ -167,8 +167,8 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0087__row273017110433"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.10.2.2.4.1.1 "><p id="obs_04_0087__p3730151184317">MalformedXML</p>
</td>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p27777519573"><strong id="obs_04_0087__b1825021250">Explanation</strong>:</p>
<p id="obs_04_0087__p873016115431">Invalid value for the <strong id="obs_04_0087__b2119160332">Days</strong> field (supposed to be an integer)</p>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p27777519573"><strong id="obs_04_0087__b1806741771">Explanation</strong>:</p>
<p id="obs_04_0087__p873016115431">Invalid value for the <strong id="obs_04_0087__b1378051886">Days</strong> field (supposed to be an integer)</p>
<p id="obs_04_0087__p1073011174317">ErrorMessage: The XML you provided was not well-formed or did not validate against our published schema</p>
</td>
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.10.2.2.4.1.3 "><p id="obs_04_0087__p1273061134315">400 Bad Request</p>
@ -176,8 +176,8 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0087__row373018124313"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.10.2.2.4.1.1 "><p id="obs_04_0087__p973013114433">InvalidArgument</p>
</td>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p5536107165711"><strong id="obs_04_0087__b2123084505">Explanation</strong>:</p>
<p id="obs_04_0087__p1973015164310">Invalid value for the <strong id="obs_04_0087__b465760451">Days</strong> field (valid range: 1 to 30).</p>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p5536107165711"><strong id="obs_04_0087__b569987012">Explanation</strong>:</p>
<p id="obs_04_0087__p1973015164310">Invalid value for the <strong id="obs_04_0087__b233233794">Days</strong> field (valid range: 1 to 30).</p>
<p id="obs_04_0087__p473019124310">ErrorMessage: restoration days should be at least 1 and at most 30</p>
</td>
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.10.2.2.4.1.3 "><p id="obs_04_0087__p07309110437">400 Bad Request</p>
@ -185,8 +185,8 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0087__row2730215430"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.10.2.2.4.1.1 "><p id="obs_04_0087__p1730613437">MalformedXML</p>
</td>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p4192111010579"><strong id="obs_04_0087__b338912889">Explanation</strong>:</p>
<p id="obs_04_0087__p4730213436">Invalid value for the <strong id="obs_04_0087__b280544503">Tier</strong> field.</p>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p4192111010579"><strong id="obs_04_0087__b481114191">Explanation</strong>:</p>
<p id="obs_04_0087__p4730213436">Invalid value for the <strong id="obs_04_0087__b1149612093">Tier</strong> field.</p>
<p id="obs_04_0087__p373011154313">ErrorMessage: The XML you provided was not well-formed or did not validate against our published schema</p>
</td>
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.10.2.2.4.1.3 "><p id="obs_04_0087__p1573016154310">400 Bad Request</p>
@ -194,8 +194,8 @@ Date:<span class="w"> </span>date
</tr>
<tr id="obs_04_0087__row1773091114316"><td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.10.2.2.4.1.1 "><p id="obs_04_0087__p16731101144317">InvalidObjectState</p>
</td>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p743371114578"><strong id="obs_04_0087__b401986853">Explanation</strong>:</p>
<p id="obs_04_0087__p873115114432">The restored object is not in the Cold storage.</p>
<td class="cellrowborder" valign="top" width="53.059999999999995%" headers="mcps1.3.10.2.2.4.1.2 "><p id="obs_04_0087__p743371114578"><strong id="obs_04_0087__b1797054416">Explanation</strong>:</p>
<p id="obs_04_0087__p873115114432">The restored object is not in the <span id="obs_04_0087__text1444052812417">Cold</span> storage.</p>
<p id="obs_04_0087__p67317118435">ErrorMessage: Restore is not allowed, as object's storage class is not COLD</p>
</td>
<td class="cellrowborder" valign="top" width="21.43%" headers="mcps1.3.10.2.2.4.1.3 "><p id="obs_04_0087__p127314118436">403 Forbidden</p>

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

@ -74,7 +74,7 @@ Date:<span class="w"> </span>date
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0091__p7134184955020"><strong id="obs_04_0091__b185641128883834">Explanation</strong>:</p>
<p id="obs_04_0091__p1418517162091">Metadata operation directive.</p>
<p id="obs_04_0091__p3134134945010"><strong id="obs_04_0091__b84422163312">Restrictions</strong>:</p>
<p id="obs_04_0091__p23611488377">None</p>
<p id="obs_04_0091__p23611488377">If you want to change the storage class of an object by modifying its metadata, <strong id="obs_04_0091__b4428628921">x-obs-metadata-directive</strong> must be set to <strong id="obs_04_0091__b1088822512211">REPLACE_NEW</strong>.</p>
<p id="obs_04_0091__p813444912504"><strong id="obs_04_0091__b12981320958417">Value range</strong>:</p>
<ul id="obs_04_0091__ul158661228288"><li id="obs_04_0091__li1686652162810"><strong id="obs_04_0091__b12259183823716">REPLACE_NEW</strong>: The metadata that has an existing value is replaced. A value is assigned to the metadata that does not have a value. The metadata that is not specified remains unchanged. Custom metadata is replaced.</li><li id="obs_04_0091__li686613212286"><strong id="obs_04_0091__b549016961812">REPLACE</strong>: All original metadata is replaced by metadata specified in the request. Metadata that is not specified (except for <strong id="obs_04_0091__b184902917182">x-obs-storage-class</strong>) is deleted.</li></ul>
<p id="obs_04_0091__p4134149115014"><strong id="obs_04_0091__b2781798598420">Default value</strong>:</p>
@ -187,7 +187,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0091__p151411745316"><strong id="obs_04_0091__b3649248283834">Explanation</strong>:</p>
<p id="obs_04_0091__p81851216590">If the bucket is configured with website hosting, the request for obtaining the object can be redirected to another object in the bucket or an external URL.</p>
<p id="obs_04_0091__p3185101613918">In the following example, the request header sets the redirection to an object (<strong id="obs_04_0091__b1138810904">anotherPage.html</strong>) in the same bucket:</p>
<p id="obs_04_0091__p3185101613918">In the following example, the request header sets the redirection to an object (<strong id="obs_04_0091__b1450856949">anotherPage.html</strong>) in the same bucket:</p>
<p id="obs_04_0091__p121854161891">x-obs-website-redirect-location:/anotherPage.html</p>
<p id="obs_04_0091__p1618519161198">In the following example, the request header sets the object redirection to an external URL:</p>
<p id="obs_04_0091__p131851916890">x-obs-website-redirect-location:http://www.example.com/</p>
@ -207,7 +207,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0091__p16842562318"><strong id="obs_04_0091__b160550266983834">Explanation</strong>:</p>
<p id="obs_04_0091__p1518516164914">Specifies the storage class of an object.</p>
<p id="obs_04_0091__p10186161613914">Example: <strong id="obs_04_0091__b1050565931">x-obs-storage-class: STANDARD</strong></p>
<p id="obs_04_0091__p10186161613914">Example: <strong id="obs_04_0091__b566660737">x-obs-storage-class: STANDARD</strong></p>
<p id="obs_04_0091__p128421065316"><strong id="obs_04_0091__b98421761138">Restrictions</strong>:</p>
<p id="obs_04_0091__p205201024461">The value is case-sensitive.</p>
<p id="obs_04_0091__p5842161312"><strong id="obs_04_0091__b7072906578417">Value range</strong>:</p>
@ -242,7 +242,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0091__p395914195318"><strong id="obs_04_0091__b35441376483834">Explanation</strong>:</p>
<p id="obs_04_0091__p01861169916">An object's tag information in key-value pairs. Multiple tags can be added at the same time.</p>
<p id="obs_04_0091__p201867165916">Example: <strong id="obs_04_0091__b355608248">x-obs-tagging:TagA=A&amp;TagB&amp;TagC</strong></p>
<p id="obs_04_0091__p201867165916">Example: <strong id="obs_04_0091__b752735594">x-obs-tagging:TagA=A&amp;TagB&amp;TagC</strong></p>
<p id="obs_04_0091__p195961912317"><strong id="obs_04_0091__b4115183110343">Restrictions</strong>:</p>
<ul id="obs_04_0091__ul1618620167918"><li id="obs_04_0091__li131865166913">If a tag key or value contains special characters, equal signs (=), or full-width characters, it must be URL-encoded.</li><li id="obs_04_0091__li1118671619910">If there is no equal sign (=) in a configuration, the tag value is considered left blank.</li></ul>
<p id="obs_04_0091__p52244813566"><strong id="obs_04_0091__b12224987561">Value range</strong>:</p>
@ -286,7 +286,7 @@ Last-Modified:<span class="w"> </span>time
<p id="obs_04_0091__p14676191213305">Metadata operation directive.</p>
<p id="obs_04_0091__p1265614254315"><strong id="obs_04_0091__b10452863118417">Value range</strong>:</p>
<ul id="obs_04_0091__ul1116820495434"><li id="obs_04_0091__li1616817497436"><strong id="obs_04_0091__b166687112512">REPLACE_NEW</strong>: The metadata that has an existing value is replaced. A value is assigned to the metadata that does not have a value. The metadata that is not specified remains unchanged. Custom metadata is replaced.</li><li id="obs_04_0091__li18169104974319"><strong id="obs_04_0091__b1371614272188">REPLACE</strong>: All original metadata is replaced by metadata specified in the request. Metadata that is not specified (except for <strong id="obs_04_0091__b16717627121811">x-obs-storage-class</strong>) is deleted.</li></ul>
<p id="obs_04_0091__p55491243125619"><strong id="obs_04_0091__b1575291401">Default value</strong>:</p>
<p id="obs_04_0091__p55491243125619"><strong id="obs_04_0091__b407939203">Default value</strong>:</p>
<p id="obs_04_0091__p1695117458711">None</p>
</td>
</tr>
@ -366,7 +366,7 @@ Last-Modified:<span class="w"> </span>time
</td>
<td class="cellrowborder" valign="top" width="70.78%" headers="mcps1.3.7.2.2.4.1.3 "><p id="obs_04_0091__p18695314313"><strong id="obs_04_0091__b3277104283834">Explanation</strong>:</p>
<p id="obs_04_0091__p193273314598">If the bucket is configured with website hosting, the request for obtaining the object can be redirected to another object in the bucket or an external URL.</p>
<p id="obs_04_0091__p54812206912">In the following example, the request header sets the redirection to an object (<strong id="obs_04_0091__b584032412">anotherPage.html</strong>) in the same bucket:</p>
<p id="obs_04_0091__p54812206912">In the following example, the request header sets the redirection to an object (<strong id="obs_04_0091__b185750227">anotherPage.html</strong>) in the same bucket:</p>
<p id="obs_04_0091__p148142016916">x-obs-website-redirect-location:/anotherPage.html</p>
<p id="obs_04_0091__p2481162011910">In the following example, the request header sets the object redirection to an external URL:</p>
<p id="obs_04_0091__p24812201920">x-obs-website-redirect-location:http://www.example.com/</p>

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

File diff suppressed because it is too large Load Diff

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

@ -2,7 +2,7 @@
<h1 class="topictitle1">Uploading Parts</h1>
<div id="body47090749"><div class="section" id="obs_04_0099__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0099__p35066376">After a multipart upload task is created, you can upload parts for this task using the obtained multipart upload ID. When parts are uploaded in a multipart upload of an object, the upload sequence does not affect part merging, namely, multiple parts can be uploaded concurrently.</p>
<p class="msonormal" id="obs_04_0099__p47161933">Part sizes range from 100 KB to 5 GB. However, when parts are being merged, the size of the last uploaded part ranges from 0 to 5 GB. The upload part ID ranges from 1 to 10,000.</p>
<p class="msonormal" id="obs_04_0099__p47161933">Ensure that the part size ranges from 100 KB to 5 GB and the size of the last part ranges from 0 to 5 GB. Otherwise, an error will be reported when you assemble parts. The upload part ID ranges from 1 to 10,000.</p>
<p class="msonormal" id="obs_04_0099__p21804221">This operation supports server-side encryption.</p>
<div class="notice" id="obs_04_0099__note21311462"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p class="cautiontext" id="obs_04_0099__p21163563">The value of <strong id="obs_04_0099__b2309841157">partNumber</strong> in a multipart task is unique. If you upload a part of the same <strong id="obs_04_0099__b46531132121512">partNumber</strong> repeatedly, the last part uploaded will overwrite the previous one. When multiple concurrent uploading of the same <strong id="obs_04_0099__b6982162951612">partNumber</strong> part of the same object is performed, the Last Write Win policy is applied. The time of <strong id="obs_04_0099__b560211143175">Last Write</strong> is defined as the time when the metadata of the part is created. To ensure data accuracy, the client must be locked to ensure concurrent upload of the same part of the same object. Concurrent upload of different parts of the same object does not need to be locked.</p>
</div></div>
@ -83,7 +83,7 @@ Content-MD5:<em id="obs_04_0099__i27511718141812">md5</em>
</td>
<td class="cellrowborder" valign="top" width="39.879999999999995%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0099__p164482717713"><strong id="obs_04_0099__b7770548283840">Explanation</strong>:</p>
<p id="obs_04_0099__p135031118462">The algorithm used for encryption.</p>
<p id="obs_04_0099__p33501111174610">Example: <strong id="obs_04_0099__b886198734">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0099__p33501111174610">Example: <strong id="obs_04_0099__b1036461930">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0099__p6442276711"><strong id="obs_04_0099__b31031223112011">Restrictions</strong>:</p>
<ul id="obs_04_0099__ul106667191155"><li id="obs_04_0099__li5666121910152">Indicates the encryption algorithm used when SSE-C is used.</li><li id="obs_04_0099__li12666319181518">This header must be used together with <strong id="obs_04_0099__b13104680825253">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0099__b4384346495253">x-obs-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0099__p512665210340"><strong id="obs_04_0099__b712695215349">Value range</strong>:</p>
@ -100,7 +100,7 @@ Content-MD5:<em id="obs_04_0099__i27511718141812">md5</em>
</td>
<td class="cellrowborder" valign="top" width="39.879999999999995%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0099__p18983112918710"><strong id="obs_04_0099__b199223973983840">Explanation</strong>:</p>
<p id="obs_04_0099__p7351911204614">The key used for encrypting an object.</p>
<p id="obs_04_0099__p2351181164620">Example: <strong id="obs_04_0099__b450436444">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0099__p2351181164620">Example: <strong id="obs_04_0099__b1599151303">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0099__p5983329476"><strong id="obs_04_0099__b1655572752019">Restrictions</strong>:</p>
<ul id="obs_04_0099__ul2055211469157"><li id="obs_04_0099__li2055218469159">This header is used only when SSE-C is used for encryption.</li><li id="obs_04_0099__li1855274621513">This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0099__b1690332532315">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0099__b790419255237">x-obs-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0099__p69834293720"><strong id="obs_04_0099__b209763687384113">Value range</strong>:</p>
@ -117,7 +117,7 @@ Content-MD5:<em id="obs_04_0099__i27511718141812">md5</em>
</td>
<td class="cellrowborder" valign="top" width="39.879999999999995%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0099__p38353310710"><strong id="obs_04_0099__b196822792683840">Explanation</strong>:</p>
<p id="obs_04_0099__p6351711204613">The MD5 value of the encryption key. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0099__p15351911154614">Example: <strong id="obs_04_0099__b2088578312">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0099__p15351911154614">Example: <strong id="obs_04_0099__b1289145198">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0099__p1183533777"><strong id="obs_04_0099__b10882143112201">Restrictions</strong>:</p>
<p id="obs_04_0099__p10259184318160">This header is used only when SSE-C is used for encryption.</p>
<p id="obs_04_0099__p1526443283520">This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0099__b373333220207">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0099__b18733143272012">x-obs-server-side-encryption-customer-key</strong>.</p>
@ -157,9 +157,9 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="25.650000000000002%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0099__p315012318381">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0099__p817413204155"><strong id="obs_04_0099__b1773799619">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0099__p817413204155"><strong id="obs_04_0099__b1008492033">Explanation</strong>:</p>
<p id="obs_04_0099__p2174122012155">The encryption method used by the server.</p>
<p id="obs_04_0099__p13174192013155">Example: <strong id="obs_04_0099__b1452580161">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0099__p13174192013155">Example: <strong id="obs_04_0099__b733338071">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0099__p317482018156"><strong id="obs_04_0099__b34619311256">Restrictions</strong>:</p>
<p id="obs_04_0099__p1817442020151">This header is included in a response if SSE-KMS is used. </p>
<p id="obs_04_0099__p121741520171510"><strong id="obs_04_0099__b131741420181513">Value range</strong>:</p>
@ -174,9 +174,9 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0099__p1246233102412"><strong id="obs_04_0099__b2736144112413">Explanation</strong>:</p>
<p id="obs_04_0099__p846216315247">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0099__p13462113122413"><strong id="obs_04_0099__b258073769">Restrictions</strong>:</p>
<p id="obs_04_0099__p13462113122413"><strong id="obs_04_0099__b214501463">Restrictions</strong>:</p>
<p id="obs_04_0099__p184628315241">This header can only be used when you specify <strong id="obs_04_0099__b5096579703711">kms</strong> for the <strong id="obs_04_0099__b18484099733711">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0099__p14628382412"><strong id="obs_04_0099__b1566293306">Default value</strong>:</p>
<p id="obs_04_0099__p14628382412"><strong id="obs_04_0099__b1019708303">Default value</strong>:</p>
<p id="obs_04_0099__p15462173172411">If you specify <strong id="obs_04_0099__b16583731643711">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
</td>
</tr>
@ -201,7 +201,7 @@ Content-Length:<span class="w"> </span>length
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0099__p178458531977"><strong id="obs_04_0099__b44446960383840">Explanation</strong>:</p>
<p id="obs_04_0099__p7250192504715">The MD5 value of the encryption key.</p>
<p id="obs_04_0099__p16250102519472">Example: <strong id="obs_04_0099__b999542934">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0099__p16250102519472">Example: <strong id="obs_04_0099__b1782564044">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0099__p93551620131213"><strong id="obs_04_0099__b1948133462516">Restrictions</strong>:</p>
<p id="obs_04_0099__p199265071311">This header is included in a response if SSE-C is used for server-side encryption.</p>
<p id="obs_04_0099__p752381515169"><strong id="obs_04_0099__b1552341513165">Value range</strong>:</p>

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

@ -1,13 +1,13 @@
<a name="obs_04_0100"></a><a name="obs_04_0100"></a>
<h1 class="topictitle1">Copying Parts</h1>
<div id="body20741762"><div class="section" id="obs_04_0100__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0100__p28787755">After a multipart upload task is created, you can upload parts for this task using the obtained multipart upload ID. Alternatively, you can make an API call to add a part (part of an object or the whole object).</p>
<div id="body20741762"><div class="section" id="obs_04_0100__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0100__p28787755">After a multipart upload task is created, you can upload parts for this task using the obtained multipart upload ID. Alternatively, you can make an API call to copy a part or a whole uploaded object as a part.</p>
<p class="msonormal" id="obs_04_0100__p57763204">This operation supports server-side encryption.</p>
<div class="notice" id="obs_04_0100__note48307965"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p class="cautiontext" id="obs_04_0100__p52458133">You cannot determine whether a request is successful only based on the <strong id="obs_04_0100__b1439410341502">status_code</strong> in the returned HTTP header. If <strong id="obs_04_0100__b7394133417504">200</strong> is returned for <strong id="obs_04_0100__b2394183411509">status_code</strong>, the server has received the request and started to process the request. The copy is successful only when the body in the response contains ETag.</p>
</div></div>
<p class="cautiontext" id="obs_04_0100__p32118502">Copy the source object and save it as <strong id="obs_04_0100__b1449910188292">part1</strong>. If a <strong id="obs_04_0100__b10351735162916">part1</strong> already exists before the copying, the original <strong id="obs_04_0100__b8516114819293">part1</strong> will be overwritten by the newly copied <strong id="obs_04_0100__b45591547316">part1</strong>. After the copy is successful, only the latest <strong id="obs_04_0100__b8996122103115">part1</strong> is displayed. The old <strong id="obs_04_0100__b2061133813112">part1</strong> data will be deleted. Therefore, ensure that the target part does not exist or has no value when using the part copy operation. Otherwise, data may be deleted by mistake. The source object in the copy process does not change.</p>
</div>
<div class="section" id="obs_04_0100__section20631062"><h4 class="sectiontitle">Cold Objects</h4><p class="msonormal" id="obs_04_0100__p21250418">If source objects are in the Cold storage class, ensure that these objects have been restored before you copy them. If the source object is not restored or is being restored, the copy fails and error <strong id="obs_04_0100__b469082335">403 Forbidden</strong> is returned. The fault is described as follows:</p>
<div class="section" id="obs_04_0100__section20631062"><h4 class="sectiontitle"><span id="obs_04_0100__text10221249101618">Cold</span> Objects</h4><p class="msonormal" id="obs_04_0100__p21250418">If source objects are in the <span id="obs_04_0100__text4648162211818">Cold</span> storage class, ensure that these objects have been restored before you copy them. If the source object is not restored or is being restored, the copy fails and error <strong id="obs_04_0100__b469082335">403 Forbidden</strong> is returned. The fault is described as follows:</p>
<p class="msonormal" id="obs_04_0100__p57036037">ErrorCode: InvalidObjectState</p>
<p class="msonormal" id="obs_04_0100__p43562287">ErrorMessage: Operation is not valid for the source object's storage class</p>
</div>
@ -49,7 +49,7 @@ Content-Length: <em id="obs_04_0100__i63865863">length</em></pre>
</table>
</div>
</div>
<div class="section" id="obs_04_0100__section7658674"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0100__p36793344">In addition the common message headers, the request uses two extended headers. <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a> describes the common message header.</p>
<div class="section" id="obs_04_0100__section7658674"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0100__p36793344">In addition to the common message headers, the request uses two extended headers. <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a> describes the common message header.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0100__table27470926" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="obs_04_0100__row11414663"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.3.2.4.1.1"><p id="obs_04_0100__p52172500">Header</p>
</th>

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

@ -2,7 +2,7 @@
<h1 class="topictitle1">Completing a Multipart Upload</h1>
<div id="body33184662"><div class="section" id="obs_04_0102__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0102__p34328485">After all parts are uploaded, you can call this API to assemble specified parts into an object. Before performing this operation, you cannot download the uploaded data. When merging parts, you need to copy the additional message header information recorded during the initialization of the multipart upload task to the object metadata. The processing process is the same as that of the common upload object with these message headers. In the case of merging parts concurrently, the Last Write Win policy must be followed but the time for initiating Last Write is specified as the time when a part multipart upload is initiated.</p>
<p id="obs_04_0102__p40520913">If a multipart upload has not been aborted, the uploaded parts occupy your storage quota. After all parts in the multipart upload are merged to an object, only the object occupies your storage quota. If a part uploaded in a multipart upload is not used in any merging parts multipart uploads, the part will be deleted to release storage quota.</p>
<p id="obs_04_0102__p40520913">As long as the multipart upload is not aborted, all uploaded parts occupy the space. However, after you assembled the specified parts, the uploaded but not assembled parts will be deleted to free up space.</p>
<p id="obs_04_0102__p29143897">You can send a request for downloading all or some data of the generated multipart by specifying a range.</p>
<p id="obs_04_0102__p60968488">You can send a request for deleting all parts uploaded in a multipart upload. Deleted data cannot be restored.</p>
<p id="obs_04_0102__p11845486">The merged parts do not use the MD5 value of entire object as the ETag. Their ETag is calculated as follows: <em id="obs_04_0102__i30226508">MD5</em><em id="obs_04_0102__i3603119">(M<sub id="obs_04_0102__sub32428072">1</sub>M<sub id="obs_04_0102__sub23417192">2</sub></em><em id="obs_04_0102__i9428136">...M<sub id="obs_04_0102__sub17744361">N</sub></em><em id="obs_04_0102__i25481524">)-N</em>, where <em id="obs_04_0102__i50737589">M<sub id="obs_04_0102__sub53985125">n</sub></em> is the MD5 value of part <em id="obs_04_0102__i8423526979055">n</em> (<em id="obs_04_0102__i20197182045511">N</em> is the total number of parts). As described in the <a href="#obs_04_0102__section74706439232">Sample Request</a>, there are three parts and each part has an MD5 value. The MD5 values of the three parts are recalculated to obtain a new MD5 value. Then <em id="obs_04_0102__i842352697937">-N</em> is added to the right of the MD5 value to get the ETag of the combined parts. In this example, <em id="obs_04_0102__i135621710195820">-N</em> is <strong id="obs_04_0102__b2695142115818">-3</strong>.</p>
@ -110,7 +110,7 @@ Authorization:<span class="w"> </span>authorization
<p id="obs_04_0102__p92876711186">None</p>
<p id="obs_04_0102__p1287207161819"><strong id="obs_04_0102__b62871276180">Value range</strong>:</p>
<p id="obs_04_0102__p19287147171814">None</p>
<p id="obs_04_0102__p1028717171819"><strong id="obs_04_0102__b102871579185">Default value</strong>:</p>
<p id="obs_04_0102__p1028717171819"><strong id="obs_04_0102__b377736613">Default value</strong>:</p>
<p id="obs_04_0102__p6287879185">None</p>
</td>
</tr>
@ -199,9 +199,9 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="11.97%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0102__p131553503716">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0102__p20380525132012"><strong id="obs_04_0102__b427266549">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0102__p20380525132012"><strong id="obs_04_0102__b43854114">Explanation</strong>:</p>
<p id="obs_04_0102__p138022562016">The encryption method used by the server.</p>
<p id="obs_04_0102__p838017254206">Example: <strong id="obs_04_0102__b380045281">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0102__p838017254206">Example: <strong id="obs_04_0102__b417398703">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0102__p16380425162020"><strong id="obs_04_0102__b157231836184513">Restrictions</strong>:</p>
<p id="obs_04_0102__p193801925112010">This header is included in a response if SSE-KMS is used.</p>
<p id="obs_04_0102__p938032532020"><strong id="obs_04_0102__b1138017258200">Value range</strong>:</p>
@ -216,10 +216,10 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0102__p861915510256"><strong id="obs_04_0102__b88351275418">Explanation</strong>:</p>
<p id="obs_04_0102__p36198519255">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0102__p5620357258"><strong id="obs_04_0102__b145716945">Restrictions</strong>:</p>
<p id="obs_04_0102__p16201551254">This header can only be used when you specify <strong id="obs_04_0102__b1067157295">kms</strong> for the <strong id="obs_04_0102__b133981838">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0102__p16209514255"><strong id="obs_04_0102__b801110308">Default value</strong>:</p>
<p id="obs_04_0102__p06201851253">If you specify <strong id="obs_04_0102__b1969347313">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
<p id="obs_04_0102__p5620357258"><strong id="obs_04_0102__b1950110419">Restrictions</strong>:</p>
<p id="obs_04_0102__p16201551254">This header can only be used when you specify <strong id="obs_04_0102__b1365375524">kms</strong> for the <strong id="obs_04_0102__b1141099136">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0102__p16209514255"><strong id="obs_04_0102__b1669280876">Default value</strong>:</p>
<p id="obs_04_0102__p06201851253">If you specify <strong id="obs_04_0102__b1609622545">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
</td>
</tr>
<tr id="obs_04_0102__row87463412101"><td class="cellrowborder" valign="top" width="32.910000000000004%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0102__p3746114191013">x-obs-server-side-encryption-customer-algorithm</p>
@ -228,7 +228,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0102__p22001332201117"><strong id="obs_04_0102__b190708194583842">Explanation</strong>:</p>
<p id="obs_04_0102__p17746449102">The algorithm used for encryption.</p>
<p id="obs_04_0102__p37461141105">Example: <strong id="obs_04_0102__b405917923">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0102__p37461141105">Example: <strong id="obs_04_0102__b626814293">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0102__p10200103210114"><strong id="obs_04_0102__b1418795164518">Restrictions</strong>:</p>
<p id="obs_04_0102__p116561477011">This header is included in a response if SSE-C is used for server-side encryption.</p>
<p id="obs_04_0102__p1180914118316"><strong id="obs_04_0102__b138091123115">Value range</strong>:</p>
@ -258,7 +258,7 @@ Date:<span class="w"> </span>date
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0102__p5352133681110"><strong id="obs_04_0102__b19160004283842">Explanation</strong>:</p>
<p id="obs_04_0102__p1675520171495">Path of the object after parts are assembled.</p>
<p id="obs_04_0102__p715314307317"><strong id="obs_04_0102__b63553364464">Restrictions</strong>:</p>
<p id="obs_04_0102__p79201447311">Format: /<em id="obs_04_0102__i1419724216463">bucketName</em>/<em id="obs_04_0102__i466344554616">objectName</em></p>
<p id="obs_04_0102__p79201447311">Format: http://bucketName.obs.<em id="obs_04_0102__i1750355133318">region</em>.example.com/objectName</p>
<p id="obs_04_0102__p1415320304317"><strong id="obs_04_0102__b815313016319">Value range</strong>:</p>
<p id="obs_04_0102__p18153930153114">None</p>
<p id="obs_04_0102__p615333014316"><strong id="obs_04_0102__b11153153083113">Default value</strong>:</p>
@ -269,7 +269,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="10.879999999999999%" headers="mcps1.3.10.3.2.4.1.2 "><p id="obs_04_0102__p1684511351680">String</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0102__en-us_topic_0262985982_p1125953"><strong id="obs_04_0102__b838041282">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0102__en-us_topic_0262985982_p1125953"><strong id="obs_04_0102__b14836225">Explanation</strong>:</p>
<p id="obs_04_0102__en-us_topic_0262985982_p0816182511324">Bucket where parts are assembled</p>
<p id="obs_04_0102__en-us_topic_0262985982_p232820406218"><strong id="obs_04_0102__b3538847104712">Restrictions</strong>:</p>
<ul id="obs_04_0102__en-us_topic_0262985982_ul1332894013215"><li id="obs_04_0102__en-us_topic_0262985982_li1328154012119">A bucket name must be unique across all accounts and regions.</li><li id="obs_04_0102__en-us_topic_0262985982_li11328940112116">A bucket name:<ul id="obs_04_0102__en-us_topic_0262985982_ul73288400216"><li id="obs_04_0102__en-us_topic_0262985982_li2328164012114">Must be 3 to 63 characters long and start with a digit or letter. Lowercase letters, digits, hyphens (-), and periods (.) are allowed.</li><li id="obs_04_0102__en-us_topic_0262985982_li9328540172118">Cannot be formatted as an IP address.</li><li id="obs_04_0102__en-us_topic_0262985982_li6328134016213">Cannot start or end with a hyphen (-) or period (.).</li><li id="obs_04_0102__en-us_topic_0262985982_li13281340182111">Cannot contain two consecutive periods (..), for example, <strong id="obs_04_0102__b155724472252512">my..bucket</strong>.</li><li id="obs_04_0102__en-us_topic_0262985982_li143284402214">Cannot contain a period (.) and a hyphen (-) adjacent to each other, for example, <strong id="obs_04_0102__b139485655852512">my-.bucket</strong> or <strong id="obs_04_0102__b181774168252512">my.-bucket</strong>.</li></ul>
@ -284,7 +284,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="10.879999999999999%" headers="mcps1.3.10.3.2.4.1.2 "><p id="obs_04_0102__p12346386816">String</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0102__en-us_topic_0262985982_p1781715255557"><strong id="obs_04_0102__b1853285115">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0102__en-us_topic_0262985982_p1781715255557"><strong id="obs_04_0102__b1716937672">Explanation</strong>:</p>
<p id="obs_04_0102__en-us_topic_0262985982_p48427543">Object name obtained after part assembling.</p>
<p id="obs_04_0102__en-us_topic_0262985982_en-us_topic_0262515577_en-us_topic_0000001592569149_p568755118152">An object is uniquely identified by an object name in a bucket. An object name is a complete path that does not contain the bucket name.</p>
<p id="obs_04_0102__p192389501818"><strong id="obs_04_0102__b9179150104816">Restrictions</strong>:</p>
@ -299,7 +299,7 @@ Date:<span class="w"> </span>date
</td>
<td class="cellrowborder" valign="top" width="10.879999999999999%" headers="mcps1.3.10.3.2.4.1.2 "><p id="obs_04_0102__p1082743818811">String</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0102__p47071424123516"><strong id="obs_04_0102__b1840734604">Explanation</strong>:</p>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0102__p47071424123516"><strong id="obs_04_0102__b866001760">Explanation</strong>:</p>
<p id="obs_04_0102__p47071724153511">The ETag that uniquely identifies the object after its parts were assembled, calculated based on the ETag of each part.</p>
<p id="obs_04_0102__p9707152453517"><strong id="obs_04_0102__b9963171216498">Restrictions</strong>:</p>
<p id="obs_04_0102__p1370716242353">If an object is encrypted using server-side encryption, the ETag is not the MD5 value of the object.</p>
@ -387,11 +387,11 @@ Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </sp
Content-Length:<span class="w"> </span>326
<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;yes&quot;?&gt;</span>
<span class="nt">&lt;CompleteMultipartUploadResult</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;Location&gt;</span>/examplebucket/object02<span class="nt">&lt;/Location&gt;</span>
<span class="w"> </span><span class="nt">&lt;Bucket&gt;</span>examplebucket<span class="nt">&lt;/Bucket&gt;</span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>object02<span class="nt">&lt;/Key&gt;</span>
<span class="w"> </span><span class="nt">&lt;ETag&gt;</span>&quot;03f814825e5a691489b947a2e120b2d3-3&quot;<span class="nt">&lt;/ETag&gt;</span>
<span class="nt">&lt;CompleteMultipartUploadResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;http://obs.region.example.com/doc/2015-06-30/&quot;</span><span class="nt">&gt;</span>
<span class="w"> </span><span class="nt">&lt;Location&gt;</span>http://examplebucket.obs.region.example.com/object02<span class="nt">&lt;/Location&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Bucket&gt;</span>examplebucket<span class="nt">&lt;/Bucket&gt;</span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>object02<span class="nt">&lt;/Key&gt;</span>
<span class="w"> </span><span class="nt">&lt;ETag&gt;</span>&quot;03f814825e5a691489b947a2e120b2d3-3&quot;<span class="nt">&lt;/ETag&gt;</span>
<span class="nt">&lt;/CompleteMultipartUploadResult&gt;</span>
</pre></div></td></tr></table></div>
</div>

1
docs/obs/api-ref/obs_04_0105.html
View File

@ -7,6 +7,7 @@
<p class="msonormal" id="obs_04_0105__p19789890">With SSE-KMS, OBS uses the keys provided by KMS for server-side encryption. You can create custom keys on KMS to encrypt your objects.</p>
<p class="msonormal" id="obs_04_0105__p43891289">With SSE-C, OBS uses the keys and MD5 values provided by customers for server-side encryption.</p>
<p class="msonormal" id="obs_04_0105__p59477283">When server-side encryption is used, the returned ETag value is not the object's MD5 value. </p>
<p id="obs_04_0105__p12401011143910">When server-side encryption is used, you are advised to use HTTPS to transmit and receive data.</p>
</div>
<div>
<div class="familylinks">

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

@ -24,7 +24,7 @@
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0106__p7134184955020"><strong id="obs_04_0106__b112951647783845">Explanation</strong>:</p>
<p id="obs_04_0106__p43151819496">Indicates that SSE-KMS is used for server-side encryption.</p>
<p id="obs_04_0106__p11315187494">Example: <strong id="obs_04_0106__b1945544762">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0106__p11315187494">Example: <strong id="obs_04_0106__b521080386">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0106__p143311189369"><strong id="obs_04_0106__b1333101810365">Restrictions</strong>:</p>
<p id="obs_04_0106__p13332018103617">None</p>
<p id="obs_04_0106__p633111883619"><strong id="obs_04_0106__b1233718173611">Value range</strong>:</p>
@ -39,9 +39,9 @@
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.5.2.4.1.3 "><p id="obs_04_0106__p15342554192512"><strong id="obs_04_0106__b112743984713">Explanation</strong>:</p>
<p id="obs_04_0106__p103422054142518">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0106__p4342185415257"><strong id="obs_04_0106__b1813193350">Restrictions</strong>:</p>
<p id="obs_04_0106__p4342185415257"><strong id="obs_04_0106__b968878625">Restrictions</strong>:</p>
<p id="obs_04_0106__p6342125462513">This header can only be used when you specify <strong id="obs_04_0106__b14059036583657">kms</strong> for the <strong id="obs_04_0106__b13081973103657">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0106__p23421754102514"><strong id="obs_04_0106__b221978884">Default value</strong>:</p>
<p id="obs_04_0106__p23421754102514"><strong id="obs_04_0106__b2065742916">Default value</strong>:</p>
<p id="obs_04_0106__p93428548259">If you specify <strong id="obs_04_0106__b12396748403657">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
</td>
</tr>

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

@ -3,7 +3,7 @@
<h1 class="topictitle1">Introduction</h1>
<div id="body1559727156453"><p id="obs_04_0110__p12450194413815">This section describes fine-grained permissions management for your OBS. If your account does not require individual IAM users, skip this section.</p>
<p id="obs_04_0110__p778681422211">By default, new IAM users do not have any permissions assigned. You need to add a user to one or more groups, and attach IAM policies to these groups. The user then inherits permissions from the groups it is a member of. This process is called authorization. After authorization, the user can perform specified operations on OBS based on the IAM policies.</p>
<p id="obs_04_0110__p1367973611316">For details about user policies related to OBS, see <a href="https://docs.otc.t-systems.com/en-us/usermanual/obs/obs_03_0045.html" target="_blank" rel="noopener noreferrer">Permissions Management</a> in the "Service Overview" section of <em id="obs_04_0110__i3187133510276">Object Storage Service User Guide</em>. For details about the syntax and examples of IAM policies, see <strong id="obs_04_0110__b14743133853416">Console Operation Guide</strong> &gt; <strong id="obs_04_0110__b175819612321">Permissions Control</strong> &gt; <strong id="obs_04_0110__b152541117193211">Permission Control Mechanisms</strong> &gt; <a href="https://docs.otc.t-systems.com/en-us/usermanual/obs/obs_03_0110.html" target="_blank" rel="noopener noreferrer">IAM Policies</a> in the <em id="obs_04_0110__i41011710363">Object Storage Service User Guide</em>. <em id="obs_04_0110__i125810619511">x.x.x</em> indicates the version number.</p>
<p id="obs_04_0110__p1367973611316">For details about user policies related to OBS, see <a href="https://docs.otc.t-systems.com/en-us/usermanual/obs/obs_03_0045.html" target="_blank" rel="noopener noreferrer">Permissions Management</a> in the "Service Overview" section of <em id="obs_04_0110__i3187133510276">Object Storage Service User Guide</em>. For details about the syntax and examples of IAM policies, see <strong id="obs_04_0110__b14743133853416">Console Operation Guide</strong> &gt; <strong id="obs_04_0110__b175819612321">Permissions Control</strong> &gt; <strong id="obs_04_0110__b152541117193211">Permission Control Mechanisms</strong> &gt; <a href="https://docs.otc.t-systems.com/en-us/usermanual/obs/obs_03_0110.html" target="_blank" rel="noopener noreferrer">IAM Policies</a> in the <em id="obs_04_0110__i41011710363">Object Storage Service User Guide</em>. </p>
<p id="obs_04_0110__p13451344980">There are fine-grained policies and role-based access control (RBAC) policies. An RBAC policy consists of permissions for an entire service. Users in a group with such a policy assigned are granted all of the permissions required for that service. A fine-grained policy consists of API-based permissions for operations on specific resource types. Fine-grained policies, as the name suggests, allow for more fine-grained control than RBAC policies.</p>
<div class="note" id="obs_04_0110__note6366144684"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_04_0110__ul1845115446819"><li id="obs_04_0110__li945194417819">If you want to allow or deny the access to an API, fine-grained authorization is a good choice.</li><li id="obs_04_0110__li1164319192118">Because of the cache, it takes about 10 to 15 minutes for the RBAC policy to take effect after being granted to users and user groups. After a fine-grained OBS policy is granted, it takes about 5 minutes for the policy to take effect.</li></ul>
</div></div>

21
docs/obs/api-ref/obs_04_0112.html
View File

@ -12,11 +12,10 @@
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0112__row154451029174017"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p1478220188253">Uploading objects with PUT or POST, copying objects, appending content to objects, initiating a multipart upload, as well as uploading, copying, and assembling parts</p>
<tbody><tr id="obs_04_0112__row154451029174017"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p1478220188253">Uploading objects with PUT or POST, appending content to objects, initiating a multipart upload, and uploading, copying, and assembling parts</p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p724153945816"><a href="obs_04_0080.html">Uploading an Object - PUT</a></p>
<p id="obs_04_0112__p102411039145819"><a href="obs_04_0081.html">Uploading an Object - POST</a></p>
<p id="obs_04_0112__p122411239105817"><a href="obs_04_0082.html">Copying an Object</a></p>
<p id="obs_04_0112__p1824123917589"><a href="obs_04_0098.html">Initiating a Multipart Upload</a></p>
<p id="obs_04_0112__p624143916580"><a href="obs_04_0099.html">Uploading Parts</a></p>
<p id="obs_04_0112__p1524113918581"><a href="obs_04_0102.html">Completing a Multipart Upload</a></p>
@ -26,6 +25,16 @@
<td class="cellrowborder" valign="top" width="14.285714285714285%" headers="mcps1.3.1.2.5.1.4 "><p id="obs_04_0112__p16131147125618">Supported</p>
</td>
</tr>
<tr id="obs_04_0112__row73074503122"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p330718505125">Copying an object</p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p122411239105817"><a href="obs_04_0082.html">Copying an Object</a></p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.3 "><p id="obs_04_0112__p1217411031511">obs:object:GetObject</p>
<p id="obs_04_0112__p17307105031211">obs:object:PutObject</p>
</td>
<td class="cellrowborder" valign="top" width="14.285714285714285%" headers="mcps1.3.1.2.5.1.4 "><p id="obs_04_0112__p17657652153">Supported</p>
</td>
</tr>
<tr id="obs_04_0112__row014819504445"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p55671403316">Obtaining the content and metadata of an object</p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p11241163975816"><a href="obs_04_0083.html">Downloading an Object</a></p>
@ -66,7 +75,7 @@
<td class="cellrowborder" valign="top" width="14.285714285714285%" headers="mcps1.3.1.2.5.1.4 "><p id="obs_04_0112__p11711173311590">Supported</p>
</td>
</tr>
<tr id="obs_04_0112__row866755874315"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p162638380413">Restoring Cold objects</p>
<tr id="obs_04_0112__row866755874315"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p162638380413">Restoring <span id="obs_04_0112__text11718115511311">Cold</span> objects</p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p3241163911583"><a href="obs_04_0087.html">Restoring Cold Objects</a></p>
</td>
@ -151,7 +160,7 @@
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p20430134242510"><a href="obs_04_0084.html">Querying Object Metadata</a></p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.3 "><p id="obs_04_0112__p543034219257">obs:object:GetObjectRetention</p>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.3 "><p id="obs_04_0112__p444113125542">obs:object:GetObject</p>
</td>
<td class="cellrowborder" valign="top" width="14.285714285714285%" headers="mcps1.3.1.2.5.1.4 "><p id="obs_04_0112__p1143019424256">Supported</p>
</td>
@ -167,7 +176,7 @@
</tr>
<tr id="obs_04_0112__row229042816552"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p172901828175515">Obtaining object tags</p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p1129117285554"><a href="en-us_topic_0000001399487626.html">Obtaining Object Tags</a></p>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p1129117285554"><a href="obs_04_0164.html">Obtaining Object Tags</a></p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.3 "><p id="obs_04_0112__p1493061955716">obs:object:GetObjectTagging</p>
</td>
@ -176,7 +185,7 @@
</tr>
<tr id="obs_04_0112__row629122819552"><td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.1 "><p id="obs_04_0112__p2291202817558">Deleting object tags</p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p1729114283554"><a href="en-us_topic_0000001399647606.html">Deleting Object Tags</a></p>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.2 "><p id="obs_04_0112__p1729114283554"><a href="obs_04_0165.html">Deleting Object Tags</a></p>
</td>
<td class="cellrowborder" valign="top" width="28.57142857142857%" headers="mcps1.3.1.2.5.1.3 "><p id="obs_04_0112__p1014419234572">obs:object:DeleteObjectTagging</p>
</td>

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

@ -73,7 +73,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
<div class="section" id="obs_04_0115__section94776254500"><h4 class="sectiontitle">Description</h4><p id="obs_04_0115__p11432785">If OBS encounters an error when processing a request, a response containing the error code and description is returned. <a href="#obs_04_0115__d0e843">Table 2</a> describes the error codes of OBS.</p>
</div>
<div class="tablenoborder"><a name="obs_04_0115__d0e843"></a><a name="d0e843"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0115__d0e843" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Error codes</caption><thead align="left"><tr id="obs_04_0115__row33785428"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.5.1.1"><p id="obs_04_0115__p1197255611201">Status Code</p>
<div class="tablenoborder"><a name="obs_04_0115__d0e843"></a><a name="d0e843"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0115__d0e843" width="100%" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Error codes</caption><thead align="left"><tr id="obs_04_0115__row33785428"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.5.1.1"><p id="obs_04_0115__p1197255611201">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.5.1.2"><p id="obs_04_0115__p52265146">Error Code</p>
</th>
@ -484,9 +484,9 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p9132720653">TooManyCustomDomains</p>
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p8133162010515">Too many user accounts are configured.</p>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p8133162010515">Too many custom domains are configured.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p1613362012511">Delete some user accounts and try again.</p>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p1613362012511">Delete some custom domains and try again.</p>
</td>
</tr>
<tr id="obs_04_0115__row2627661"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p18133320652">400 Bad Request</p>
@ -601,7 +601,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p13944143104915">InvalidObjectState</p>
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p10944173114914">You need to restore Cold objects before downloading them.</p>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p10944173114914">You need to restore <span id="obs_04_0115__text10221249101618">Cold</span> objects before downloading them.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p149448319495">Restore the object first.</p>
</td>
@ -610,7 +610,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p2133182011517">NotSignedUp</p>
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p1613319201557">Your account has not been registered with the system. Only a registered account can be used.</p>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p1613319201557">You have not registered with the system.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p2013318206520">Register OBS.</p>
</td>
@ -631,7 +631,7 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p1513319204515">The provided signature does not match the signature calculated by OBS.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p113310201355">Check your secret access key and signature algorithm. </p>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p113310201355">Check your secret access key and signature calculation method. </p>
</td>
</tr>
<tr id="obs_04_0115__row2530922194710"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p3530182211474">403 Forbidden</p>
@ -833,13 +833,31 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p67499341156">Ensure the new name indicates a consistent object type (file or directory) and has yet been used.</p>
</td>
</tr>
<tr id="obs_04_0115__row14104126133916"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p1772940123915">409 Conflict</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p9105122619398">FsRenameConflict</p>
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p1910515268396">The rename operation conflicts with another operation that is being performed on the object.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p1710532643919">Check the service logic to prevent unexpected operation results caused by concurrent operations on the same object.</p>
</td>
</tr>
<tr id="obs_04_0115__row1552515444399"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p195251444103917">409 Conflict</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p16525154433916">DirectoryNotEmpty</p>
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p7525444123916">Non-empty directories cannot be deleted.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p35251244193911">Empty the directory first.</p>
</td>
</tr>
<tr id="obs_04_0115__row11186540311"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p618716433113">409 ObjectNotAppendable</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p1218724173117">ObjectNotAppendable</p>
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p91871047312">The object is not appendable.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p11877493111">Check the bucket type. Parallel file systems do not support append upload. Check the object type. Cold objects are not appendable.</p>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p11877493111">Check the bucket type. Parallel file systems do not support append upload. Check the object type. <span id="obs_04_0115__text114091327668">Cold</span> objects are not appendable.</p>
</td>
</tr>
<tr id="obs_04_0115__row64459840102853"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p050891315168">411 Length Required</p>
@ -878,6 +896,16 @@ QUFBQUFBYmJiYmJiYmJD<span class="nt">&lt;/HostId&gt;</span><span class="w"> </sp
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p85080133168">Retry with the correct range.</p>
</td>
</tr>
<tr id="obs_04_0115__row123301731143614"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p833033113367">429 Too Many Requests</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p1331123183620">TooManyRequests</p>
</td>
<td class="cellrowborder" valign="top" width="29.099999999999998%" headers="mcps1.3.4.2.5.1.3 "><p id="obs_04_0115__p5336105313212">There are too many requests in a short period of time.</p>
<p id="obs_04_0115__p17336145310212">For example, there are too many concurrent requests for the metadata of the same object or bucket, such as concurrent object metadata modification, object upload, and object write.</p>
</td>
<td class="cellrowborder" valign="top" width="30.9%" headers="mcps1.3.4.2.5.1.4 "><p id="obs_04_0115__p533143153611">Reduce the number of requests or concurrent requests.</p>
</td>
</tr>
<tr id="obs_04_0115__row27428343103046"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.1 "><p id="obs_04_0115__p6509213151614">500 Internal Server Error</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.5.1.2 "><p id="obs_04_0115__p165098139164">InternalError</p>

42
docs/obs/api-ref/en-us_topic_0000001399487626.html → docs/obs/api-ref/obs_04_0164.html
View File

@ -1,13 +1,13 @@
<a name="EN-US_TOPIC_0000001399487626"></a><a name="EN-US_TOPIC_0000001399487626"></a>
<a name="obs_04_0164"></a><a name="obs_04_0164"></a>
<h1 class="topictitle1">Obtaining Object Tags</h1>
<div id="body0000001399487626"><div class="section" id="EN-US_TOPIC_0000001399487626__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="EN-US_TOPIC_0000001399487626__p328123010563">This operation returns tags of an object.</p>
<p id="EN-US_TOPIC_0000001399487626__p028114308563">If you do not specify a version ID in a request, make sure that you have the <strong id="EN-US_TOPIC_0000001399487626__b17493114614616">GetObjectTagging</strong> permission. If you do specify a version ID in a request, make sure that you have the <strong id="EN-US_TOPIC_0000001399487626__b138212146714">GetObjectTagging</strong> and <strong id="EN-US_TOPIC_0000001399487626__b13821014576">GetObjectVersionTagging</strong> permissions. By default, only the object owner can perform this operation. The object owner can grant this permission to others by using a bucket or user policy.</p>
<p id="EN-US_TOPIC_0000001399487626__p57251938173210">OBS returns the tags of the current object version by default. You can use the <strong id="EN-US_TOPIC_0000001399487626__b66331141445">versionId</strong> parameter to retrieve tags of any other version. If the version you are retrieving tags from is a delete marker, OBS returns <strong id="EN-US_TOPIC_0000001399487626__b19589165814815">404 Not Found</strong>.</p>
<div id="body0000001399487626"><div class="section" id="obs_04_0164__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0164__p328123010563">This operation returns tags of an object.</p>
<p id="obs_04_0164__p028114308563">If you do not specify a version ID in a request, make sure that you have the <strong id="obs_04_0164__b17493114614616">GetObjectTagging</strong> permission. If you do specify a version ID in a request, make sure that you have the <strong id="obs_04_0164__b138212146714">GetObjectTagging</strong> and <strong id="obs_04_0164__b13821014576">GetObjectVersionTagging</strong> permissions. By default, only the object owner can perform this operation. The object owner can grant this permission to others by using a bucket or user policy.</p>
<p id="obs_04_0164__p57251938173210">OBS returns the tags of the current object version by default. You can use the <strong id="obs_04_0164__b66331141445">versionId</strong> parameter to retrieve tags of any other version. If the version you are retrieving tags from is a delete marker, OBS returns <strong id="obs_04_0164__b19589165814815">404 Not Found</strong>.</p>
</div>
<div class="note" id="EN-US_TOPIC_0000001399487626__note18725120448"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001399487626__p10725520443">Tags are not supported for files in parallel file systems.</p>
<div class="note" id="obs_04_0164__note18725120448"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0164__p10725520443">Tags are not supported for files in parallel file systems.</p>
</div></div>
<div class="section" id="EN-US_TOPIC_0000001399487626__section760823317564"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001399487626__screen19232727152544"><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_0164__section760823317564"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0164__screen19232727152544"><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></pre></div></td><td class="code"><div><pre><span></span>GET<span class="w"> </span>/objectname?tagging<span class="err">&amp;</span>versionId=versionid<span class="w"> </span>HTTP/1.1
@ -17,13 +17,13 @@ Authorization:<span class="w"> </span>authorization<span class="w"> </span>strin
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001399487626__section1371325895711"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0000001399487626__p1815191317587">This request contains no message parameters.</p>
<div class="section" id="obs_04_0164__section1371325895711"><h4 class="sectiontitle">Request Parameters</h4><p id="obs_04_0164__p1815191317587">This request contains no message parameters.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399487626__section1082510151584"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0000001399487626__p1231635205817">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
<div class="section" id="obs_04_0164__section1082510151584"><h4 class="sectiontitle">Request Headers</h4><p id="obs_04_0164__p1231635205817">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399487626__section4216153718588"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0000001399487626__p512465625811">This request involves no elements.</p>
<div class="section" id="obs_04_0164__section4216153718588"><h4 class="sectiontitle">Request Elements</h4><p id="obs_04_0164__p512465625811">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399487626__section7375637599"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001399487626__screen1351602445911"><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_0164__section7375637599"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0164__screen1351602445911"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
@ -57,32 +57,32 @@ Date:<span class="w"> </span>date
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001399487626__section4327836215"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0000001399487626__p1610494415574">This response uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<div class="section" id="obs_04_0164__section4327836215"><h4 class="sectiontitle">Response Headers</h4><p id="obs_04_0164__p1610494415574">This response 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="EN-US_TOPIC_0000001399487626__section2085012491723"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0000001399487626__p63829146313">For more information about the object tag elements returned in the response, see <a href="obs_04_0172.html#obs_04_0172__table1181123018399">Table 3</a>.</p>
<div class="section" id="obs_04_0164__section2085012491723"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0164__p63829146313">For more information about the object tag elements returned in the response, see <a href="obs_04_0172.html#obs_04_0172__table1181123018399">Table 3</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001399487626__section75624441842"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0000001399487626__p2866601656">In addition to common error codes, this API also returns others. <a href="#EN-US_TOPIC_0000001399487626__table1488314173514">Table 1</a> lists the common errors and possible causes.</p>
<div class="section" id="obs_04_0164__section75624441842"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0164__p2866601656">In addition to common error codes, this API also returns others. <a href="#obs_04_0164__table1488314173514">Table 1</a> lists the common errors and possible causes.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001399487626__table1488314173514"></a><a name="table1488314173514"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001399487626__table1488314173514" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Error codes of obtaining object tags</caption><thead align="left"><tr id="EN-US_TOPIC_0000001399487626__row6181181352"><th align="left" class="cellrowborder" valign="top" width="33.67%" id="mcps1.3.10.3.2.4.1.1"><p id="EN-US_TOPIC_0000001399487626__p11810181514">Error Code</p>
<div class="tablenoborder"><a name="obs_04_0164__table1488314173514"></a><a name="table1488314173514"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0164__table1488314173514" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Error codes of obtaining object tags</caption><thead align="left"><tr id="obs_04_0164__row6181181352"><th align="left" class="cellrowborder" valign="top" width="33.67%" id="mcps1.3.10.3.2.4.1.1"><p id="obs_04_0164__p11810181514">Error Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.019999999999996%" id="mcps1.3.10.3.2.4.1.2"><p id="EN-US_TOPIC_0000001399487626__p618131810511">Description</p>
<th align="left" class="cellrowborder" valign="top" width="51.019999999999996%" id="mcps1.3.10.3.2.4.1.2"><p id="obs_04_0164__p618131810511">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.310000000000002%" id="mcps1.3.10.3.2.4.1.3"><p id="EN-US_TOPIC_0000001399487626__p18190181851">HTTP Status Code</p>
<th align="left" class="cellrowborder" valign="top" width="15.310000000000002%" id="mcps1.3.10.3.2.4.1.3"><p id="obs_04_0164__p18190181851">HTTP Status Code</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001399487626__row1719418653"><td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.10.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001399487626__p1019218752">NoSuchTagSet</p>
<tbody><tr id="obs_04_0164__row1719418653"><td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.10.3.2.4.1.1 "><p id="obs_04_0164__p1019218752">NoSuchTagSet</p>
</td>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.10.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001399487626__p14197185516">No tags were configured for the specified object.</p>
<td class="cellrowborder" valign="top" width="51.019999999999996%" headers="mcps1.3.10.3.2.4.1.2 "><p id="obs_04_0164__p14197185516">No tags were configured for the specified object.</p>
</td>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.10.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001399487626__p21916186514">404</p>
<td class="cellrowborder" valign="top" width="15.310000000000002%" headers="mcps1.3.10.3.2.4.1.3 "><p id="obs_04_0164__p21916186514">404</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001399487626__section51791023968"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001399487626__screen5561411267"><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_0164__section51791023968"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0164__screen5561411267"><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>
@ -96,7 +96,7 @@ Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEB
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001399487626__section18234571088"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001399487626__screen1219123011919"><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_0164__section18234571088"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0164__screen1219123011919"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>

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