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

OBS api-ref 2.0.38.SP5

Browse Source 
Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Jawei, Li <lijiawei5@huawei.com>
Co-committed-by: Jawei, Li <lijiawei5@huawei.com>
This commit is contained in:
Jawei, Li 2022-11-03 11:54:51 +00:00 committed by zuul
parent 0d1ba8215b
commit f1cb839979
139 changed files with 21366 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

952
docs/obs/api-ref/ALL_META.TXT.json Normal file
View File

File diff suppressed because it is too large Load Diff

857
docs/obs/api-ref/CLASS.TXT.json Normal file
View File

File diff suppressed because it is too large Load Diff

3
docs/obs/api-ref/PARAMETERS.txt Normal file
View File

@ -0,0 +1,3 @@
version=""
language="en-us"
type=""

BIN
docs/obs/api-ref/en-us_image_0100846816.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 27 KiB

BIN
docs/obs/api-ref/en-us_image_0100846818.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.9 KiB

BIN
docs/obs/api-ref/en-us_image_0100846820.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 9.1 KiB

BIN
docs/obs/api-ref/en-us_image_0100846822.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 8.3 KiB

BIN
docs/obs/api-ref/en-us_image_0100846824.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 8.4 KiB

BIN
docs/obs/api-ref/en-us_image_0100846826.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

13
docs/obs/api-ref/en-us_topic_0031051947.html Normal file
View File

@ -0,0 +1,13 @@
<a name="en-us_topic_0031051947"></a><a name="en-us_topic_0031051947"></a>
<h1 class="topictitle1">Overview</h1>
<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 <span style="color:#3D3F43;">creating, modifying, and deleting bucket, as well as uploading, downloading, and deleting objects</span>. 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>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0001.html">Before You Start</a></div>
</div>
</div>

34
docs/obs/api-ref/obs_04_0000.html Normal file
View File

@ -0,0 +1,34 @@
<a name="obs_04_0000"></a><a name="obs_04_0000"></a>
<h1 class="topictitle1">Change History</h1>
<div id="body1522724120157">
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0000__table13715134616186" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_04_0000__row13715114681815"><th align="left" class="cellrowborder" valign="top" width="30.3%" id="mcps1.3.1.1.3.1.1"><p id="obs_04_0000__p14715546151813">Date</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="69.69999999999999%" id="mcps1.3.1.1.3.1.2"><p id="obs_04_0000__p871584611816">Change History</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0000__row592217458019"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p191924910014">2022-09-07</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p109197491701">This is the third official release.</p>
<p id="obs_04_0000__p139194495017">This issue incorporates the following change:</p>
<p id="obs_04_0000__p1891916496014">Added lifecycle descriptions about the not merged parts (fragments) in an incomplete upload. For details, see parameters <strong id="obs_04_0000__b1902144532111">AbortIncompleteMultipartUpload</strong> and <strong id="obs_04_0000__b17825194742115">DaysAfterInitiation</strong> in <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__row61251651869"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p207251681866">2021-08-11</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p16725581864">This is the second official release.</p>
<p id="obs_04_0000__p125319289615">This issue incorporates the following change:</p>
<p id="obs_04_0000__p460019401617">Fixed some usability and accuracy issues.</p>
</td>
</tr>
<tr id="obs_04_0000__row8715134616188"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_04_0000__p15715246171810">2021-07-10</p>
</td>
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_04_0000__p13715946161815">This is the first official release.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>

17
docs/obs/api-ref/obs_04_0001.html Normal file
View File

@ -0,0 +1,17 @@
<a name="obs_04_0001"></a><a name="obs_04_0001"></a>
<h1 class="topictitle1">Before You Start</h1>
<div id="body1559715459464"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="en-us_topic_0031051947.html">Overview</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0002.html">API Calling</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0003.html">Endpoints</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0004.html">Basic Concepts</a></strong><br>
</li>
</ul>
</div>

11
docs/obs/api-ref/obs_04_0002.html Normal file
View File

@ -0,0 +1,11 @@
<a name="obs_04_0002"></a><a name="obs_04_0002"></a>
<h1 class="topictitle1">API Calling</h1>
<div id="body1559715459464"><p id="obs_04_0002__p1619805611182">OBS provides Representational State Transfer (REST) APIs, allowing you to use HTTP or HTTPS requests to call them. For details, see <a href="obs_04_0006.html">Calling APIs</a>.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0001.html">Before You Start</a></div>
</div>
</div>

12
docs/obs/api-ref/obs_04_0003.html Normal file
View File

@ -0,0 +1,12 @@
<a name="obs_04_0003"></a><a name="obs_04_0003"></a>
<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__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>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0001.html">Before You Start</a></div>
</div>
</div>

21
docs/obs/api-ref/obs_04_0004.html Normal file
View File

@ -0,0 +1,21 @@
<a name="obs_04_0004"></a><a name="obs_04_0004"></a>
<h1 class="topictitle1">Basic Concepts</h1>
<div id="body1559715459464"><div class="section" id="obs_04_0004__section766842619411"><h4 class="sectiontitle">Basic Concepts Related to OBS APIs</h4><ul id="obs_04_0004__ul218710618517"><li id="obs_04_0004__li11265170420">Domain<p id="obs_04_0004__p1826610828"><a name="obs_04_0004__li11265170420"></a><a name="li11265170420"></a>You can register a domain with the cloud service. The domain has full access permissions for all the resources and cloud services that are subscribed under it. The domain can also reset user passwords and grant permissions to users. A domain is a payment entity. To keep the domain secure, it is recommended that you create users under the domain to perform routine management operations.</p>
</li><li id="obs_04_0004__li15896816113116">User<p id="obs_04_0004__p589691603117"><a name="obs_04_0004__li15896816113116"></a><a name="li15896816113116"></a>You can create users under a domain on Identity and Access Management (IAM), and authorize the users with permissions required for accessing cloud services. Each IAM user has its own identity credentials (password and access keys).</p>
<p id="obs_04_0004__p9896121653112"></p>
<p id="obs_04_0004__p1390083911281">On the <strong id="obs_04_0004__b1155161692820">My Credentials</strong> page on the console, you can view the domain ID and user ID, you can also manage the access keys of the domain and IAM users.</p>
<p id="obs_04_0004__p734065315164">Access keys of the domain and its IAM users are required for authentication when calling APIs.</p>
</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 the object named <strong id="obs_04_0004__b138471314173217">picture.jpg</strong> is stored in the <strong id="obs_04_0004__b16848101413328">photo</strong> bucket, you can use the following URL to access the object: <strong id="obs_04_0004__b884914141326">http://photo.obs.<em id="obs_04_0004__i19848514103212">region</em>.<em id="obs_04_0004__i5849191413321">example</em>.com/picture.jpg</strong>.</p>
</li><li class="MsoNormal" id="obs_04_0004__li898161894818">Objects<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 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 regions, see <a href="obs_04_0003.html">Endpoints</a>.</p>
</li></ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0001.html">Before You Start</a></div>
</div>
</div>

355
docs/obs/api-ref/obs_04_0005.html Normal file
View File

File diff suppressed because it is too large Load Diff

15
docs/obs/api-ref/obs_04_0006.html Normal file
View File

@ -0,0 +1,15 @@
<a name="obs_04_0006"></a><a name="obs_04_0006"></a>
<h1 class="topictitle1">Calling APIs</h1>
<div id="body1522723593124"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_04_0007.html">Constructing a Request</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0008.html">Authentication</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0013.html">Returned Values</a></strong><br>
</li>
</ul>
</div>

185
docs/obs/api-ref/obs_04_0007.html Normal file
View File

File diff suppressed because it is too large Load Diff

21
docs/obs/api-ref/obs_04_0008.html Normal file
View File

@ -0,0 +1,21 @@
<a name="obs_04_0008"></a><a name="obs_04_0008"></a>
<h1 class="topictitle1">Authentication</h1>
<div id="body50447774"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_04_0009.html">User Signature Authentication</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0010.html">Authentication of Signature in a Header</a></strong><br>
</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>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0006.html">Calling APIs</a></div>
</div>
</div>

97
docs/obs/api-ref/obs_04_0009.html Normal file
View File

@ -0,0 +1,97 @@
<a name="obs_04_0009"></a><a name="obs_04_0009"></a>
<h1 class="topictitle1">User Signature Authentication</h1>
<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. Format example: <strong id="obs_04_0009__b0602125118582">HCY8BGCN1YM5ZWYOK1MH</strong></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. Format example: <strong id="obs_04_0009__b4661163595910">9zYwf1uabSQY0JTnFqbUqG7vcfqYBaTdXde2GUcq</strong></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 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>
<div class="tablenoborder"><a name="obs_04_0009__table1151632183812"></a><a name="table1151632183812"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0009__table1151632183812" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Signature calculation and verification procedure</caption><thead align="left"><tr id="obs_04_0009__row515218324385"><th align="left" class="cellrowborder" colspan="2" valign="top" id="mcps1.3.7.2.4.1.1"><p id="obs_04_0009__p3152193211383">Procedure</p>
</th>
<th align="left" class="cellrowborder" valign="top" id="mcps1.3.7.2.4.1.2"><p id="obs_04_0009__p81521032133820">Example</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0009__row6152133216385"><td class="cellrowborder" rowspan="5" valign="top" width="8.61086108610861%" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p5152163218386">Signature calculation</p>
</td>
<td class="cellrowborder" valign="top" width="30.733073307330734%" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p632064774014">1. Construct an HTTP message.</p>
</td>
<td class="cellrowborder" valign="top" width="60.65606560656066%" headers="mcps1.3.7.2.4.1.2 "><p id="obs_04_0009__p14357122794415">PUT /object HTTP/1.1</p>
<p id="obs_04_0009__p16356162764414">Host: bucket.obs.region.example.com</p>
<p id="obs_04_0009__p1835632744418">Date: Tue, 04 Jun 2019 06:54:59 GMT</p>
<p id="obs_04_0009__p13356122734416">Content-Type: text/plain</p>
<p id="obs_04_0009__p4356152744418">Content-Length: 5913</p>
</td>
</tr>
<tr id="obs_04_0009__row1915220322385"><td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p12829251114013">2. Calculate <strong id="obs_04_0009__b12910173913143">StringToSign</strong> based on the signature rule.</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p155065339446">StringToSign = HTTP-Verb + "\n" + Content-MD5 + "\n" + Content-Type + "\n" + Date + "\n" + CanonicalizedHeaders + CanonicalizedResource</p>
</td>
</tr>
<tr id="obs_04_0009__row215363216385"><td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p3893242398">3. Prepare the AK and SK.</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p1057319401446">AK: ******</p>
<p id="obs_04_0009__p13573124015441">SK: ******</p>
</td>
</tr>
<tr id="obs_04_0009__row18153732123817"><td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p1089024123912">4. Calculate <strong id="obs_04_0009__b5305134913151">Signature</strong>.</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p37515457444">Signature = Base64( HMAC-SHA1( <strong id="obs_04_0009__b8751453442">SecretAccessKeyID</strong>, UTF-8-Encoding-Of( <strong id="obs_04_0009__b1943716215219">StringToSign</strong> ) ) )</p>
</td>
</tr>
<tr id="obs_04_0009__row1715383203813"><td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p389724133911">5. Add a signature header and send the request to OBS.</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p1189124113914">PUT /object HTTP/1.1</p>
<p id="obs_04_0009__p1489172413915">Host: bucket.obs.region.example.com</p>
<p id="obs_04_0009__p389162414392">Date: Tue, 04 Jun 2019 06:54:59 GMT</p>
<p id="obs_04_0009__p98922403920">Content-Type: text/plain</p>
<p id="obs_04_0009__p17891524153918">Content-Length: 5913</p>
<p id="obs_04_0009__p108992415391">Authorization: OBS <strong id="obs_04_0009__b68942493914">AccessKeyID</strong>:<strong id="obs_04_0009__b78952443920">Signature</strong></p>
</td>
</tr>
<tr id="obs_04_0009__row111532032133817"><td class="cellrowborder" rowspan="5" valign="top" width="8.61086108610861%" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p9153932153815">Signature authentication</p>
</td>
<td class="cellrowborder" valign="top" width="30.733073307330734%" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p226116397399">6. Receive the HTTP message.</p>
</td>
<td class="cellrowborder" valign="top" width="60.65606560656066%" headers="mcps1.3.7.2.4.1.2 "><p id="obs_04_0009__p9261193953912">PUT /object HTTP/1.1</p>
<p id="obs_04_0009__p112611639103912">Host: bucket.obs.region.example.com</p>
<p id="obs_04_0009__p72611339133917">Date: Tue, 04 Jun 2019 06:54:59 GMT</p>
<p id="obs_04_0009__p1261123923915">Content-Type: text/plain</p>
<p id="obs_04_0009__p6261153983915">Content-Length: 5913</p>
<p id="obs_04_0009__p122618399391">Authorization: OBS <strong id="obs_04_0009__b8261839163920">AccessKeyID</strong>:<strong id="obs_04_0009__b1826213923920">Signature</strong></p>
</td>
</tr>
<tr id="obs_04_0009__row3153133243810"><td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p72629399395">7. Obtain the SK based on the AK in the request.</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p182621639143916">Obtain the AK from the authorization header and obtain the SK of the user from IAM.</p>
</td>
</tr>
<tr id="obs_04_0009__row31531632163818"><td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p1726212397394">8. Calculate <strong id="obs_04_0009__b36658016285">StringToSign</strong> based on the signature rule.</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p82628392394">StringToSign = HTTP-Verb + "\n" + Content-MD5 + "\n" + Content-Type + "\n" + Date + "\n" + CanonicalizedHeaders + CanonicalizedResource</p>
</td>
</tr>
<tr id="obs_04_0009__row015318327382"><td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p16262143983915">9. Calculate <strong id="obs_04_0009__b072528192816">Signature</strong>.</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p1926273913398">Signature = Base64( HMAC-SHA1( <strong id="obs_04_0009__b72620397396">SecretAccessKeyID</strong>, UTF-8-Encoding-Of( <strong id="obs_04_0009__b865475915228">StringToSign</strong> ) ) )</p>
</td>
</tr>
<tr id="obs_04_0009__row1915323273819"><td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p926213915391">10. Authenticate the signature.</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.7.2.4.1.1 "><p id="obs_04_0009__p226213398393">Verify that the value of <strong id="obs_04_0009__b76321945102817">Signature</strong> in the authorization header is the same as the value of <strong id="obs_04_0009__b042683122913">Signature</strong> calculated by the server.</p>
<p id="obs_04_0009__p026213943919">If the two values are the same, the signature verification is successful.</p>
<p id="obs_04_0009__p0262103915396">If the two values are different, the signature verification fails.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0008.html">Authentication</a></div>
</div>
</div>

769
docs/obs/api-ref/obs_04_0010.html Normal file
View File

File diff suppressed because it is too large Load Diff

673
docs/obs/api-ref/obs_04_0011.html Normal file
View File

File diff suppressed because it is too large Load Diff

330
docs/obs/api-ref/obs_04_0012.html Normal file
View File

File diff suppressed because it is too large Load Diff

70
docs/obs/api-ref/obs_04_0013.html Normal file
View File

@ -0,0 +1,70 @@
<a name="obs_04_0013"></a><a name="obs_04_0013"></a>
<h1 class="topictitle1">Returned Values</h1>
<div id="body1559725268739"><p id="obs_04_0013__p91929371531">After sending a request, you will receive a response, including the status code, response header, and response body.</p>
<div class="section" id="obs_04_0013__section9372312739"><h4 class="sectiontitle">Status Codes</h4><p id="obs_04_0013__p127892023034">A status code is a group of digits ranging from 2<em id="obs_04_0013__i3412193934115">xx</em> (indicating successes) to 4<em id="obs_04_0013__i1841363918414">xx</em> or 5<em id="obs_04_0013__i1386995015421">xx</em> (indicating errors). It indicates the status of a response. For more information, see <a href="obs_04_0114.html">Status Codes</a>.</p>
</div>
<div class="section" id="obs_04_0013__section7804143005810"><h4 class="sectiontitle">Response Headers</h4><p id="obs_04_0013__p8893366518">A response header corresponds to a request header, for example, Content-Type.</p>
<div class="p" id="obs_04_0013__p186593415539">For details about common response headers, see <a href="#obs_04_0013__d0e686">Table 1</a>.
<div class="tablenoborder"><a name="obs_04_0013__d0e686"></a><a name="d0e686"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0013__d0e686" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Common response headers</caption><thead align="left"><tr id="obs_04_0013__row58885148"><th align="left" class="cellrowborder" valign="top" width="23%" id="mcps1.3.3.3.2.2.3.1.1"><p id="obs_04_0013__p4967702">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="77%" id="mcps1.3.3.3.2.2.3.1.2"><p id="obs_04_0013__p66839572">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0013__row45296255"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p45118014">Content-Length</p>
</td>
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p30680506">The length (in bytes) of the response body.</p>
<p id="obs_04_0013__p7689098">Type: string</p>
<p id="obs_04_0013__p2093018">Default value: none</p>
</td>
</tr>
<tr id="obs_04_0013__row18837163"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p49415229">Connection</p>
</td>
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p43210599">Indicates whether the connection to the server is a long connection or a short connection.</p>
<p id="obs_04_0013__p53351077">Type: string</p>
<p id="obs_04_0013__p10397650">Valid values: keep-alive | close</p>
<p id="obs_04_0013__p26469991">Default value: none</p>
</td>
</tr>
<tr id="obs_04_0013__row36903334"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p36380041">Date</p>
</td>
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p61102246">The date and time at which OBS responds to the request.</p>
<p id="obs_04_0013__p13049305">Type: string</p>
<p id="obs_04_0013__p50334883">Default value: none</p>
</td>
</tr>
<tr id="obs_04_0013__row50360765"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p52690158">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p40044371">128-bit MD5 digest of the Base64 code of an object. ETag is the unique identifier of the object content. It can be used to identify whether the object content is changed. For example, if ETag value is <strong id="obs_04_0013__b1729195513584">A</strong> when an object is uploaded and the ETag value has changed to <strong id="obs_04_0013__b773055585819">B</strong> when the object is downloaded, it indicates that the object content is changed. The actual ETag is the hash value of the object, which only reflects the changed content rather than the metadata. An uploaded object or copied object has a unique ETag after being encrypted using MD5. If an object is uploaded in the multipart mode, the MD5 splits ETag regardless of the encryption method. In this case, the ETag is not an MD5 digest.</p>
<p id="obs_04_0013__p24855020">Type: string</p>
</td>
</tr>
<tr id="obs_04_0013__row22368596"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p67025883">x-obs-id-2</p>
</td>
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p60387405">A special symbol that helps troubleshoot faults.</p>
<p id="obs_04_0013__p6615739">Type: string</p>
<p id="obs_04_0013__p59541652">Default value: none</p>
</td>
</tr>
<tr id="obs_04_0013__row66112827"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p53538780">x-obs-request-id</p>
</td>
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p41673925">The value created by OBS to uniquely identify the request. OBS uses this value to troubleshoot faults.</p>
<p id="obs_04_0013__p39521013">Type: string</p>
<p id="obs_04_0013__p20144799">Default value: none</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="obs_04_0013__section034615592583"><h4 class="sectiontitle">(Optional) Response Body</h4><p id="obs_04_0013__p133921631940">A response body is generally returned in a structured format (for example, JSON or XML), corresponding to <strong id="obs_04_0013__b842352706144729">Content-Type</strong> in the response header, and is used to transfer content other than the response header.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0006.html">Calling APIs</a></div>
</div>
</div>

15
docs/obs/api-ref/obs_04_0014.html Normal file
View File

@ -0,0 +1,15 @@
<a name="obs_04_0014"></a><a name="obs_04_0014"></a>
<h1 class="topictitle1">Getting Started</h1>
<div id="body1559726121440"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_04_0015.html">Creating a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0016.html">Listing Buckets</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0017.html">Uploading an Object</a></strong><br>
</li>
</ul>
</div>

299
docs/obs/api-ref/obs_04_0015.html Normal file
View File

File diff suppressed because it is too large Load Diff

296
docs/obs/api-ref/obs_04_0016.html Normal file
View File

File diff suppressed because it is too large Load Diff

314
docs/obs/api-ref/obs_04_0017.html Normal file
View File

File diff suppressed because it is too large Load Diff

21
docs/obs/api-ref/obs_04_0018.html Normal file
View File

@ -0,0 +1,21 @@
<a name="obs_04_0018"></a><a name="obs_04_0018"></a>
<h1 class="topictitle1">APIs</h1>
<div id="body1522723593124"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_04_0019.html">Operations on Buckets</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0026.html">Advanced Bucket Settings</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0070.html">Static Website Hosting</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0079.html">Operations on Objects</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0096.html">Operations on Multipart Upload</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0104.html">Server-Side Encryption</a></strong><br>
</li>
</ul>
</div>

25
docs/obs/api-ref/obs_04_0019.html Normal file
View File

@ -0,0 +1,25 @@
<a name="obs_04_0019"></a><a name="obs_04_0019"></a>
<h1 class="topictitle1">Operations on Buckets</h1>
<div id="body35636952"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_04_0020.html">Listing Buckets</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0021.html">Creating a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0022.html">Listing Objects in a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0023.html">Obtaining Bucket Metadata</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0024.html">Obtaining Bucket Location</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0025.html">Deleting Buckets</a></strong><br>
</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0018.html">APIs</a></div>
</div>
</div>

213
docs/obs/api-ref/obs_04_0020.html Normal file
View File

File diff suppressed because it is too large Load Diff

269
docs/obs/api-ref/obs_04_0021.html Normal file
View File

File diff suppressed because it is too large Load Diff

636
docs/obs/api-ref/obs_04_0022.html Normal file
View File

File diff suppressed because it is too large Load Diff

225
docs/obs/api-ref/obs_04_0023.html Normal file
View File

File diff suppressed because it is too large Load Diff

102
docs/obs/api-ref/obs_04_0024.html Normal file
View File

File diff suppressed because it is too large Load Diff

68
docs/obs/api-ref/obs_04_0025.html Normal file
View File

@ -0,0 +1,68 @@
<a name="obs_04_0025"></a><a name="obs_04_0025"></a>
<h1 class="topictitle1">Deleting Buckets</h1>
<div id="body60784478"><div class="section" id="obs_04_0025__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0025__p42554878">This operation deletes specified buckets. This operation can be performed only by the bucket owner and users who have been authorized (via a policy) with the permission to delete the bucket. The bucket to be deleted must be an empty bucket. If a bucket has an object or a multipart task, the bucket is not empty. You can list objects and multipart upload tasks in a bucket to check whether the bucket is empty.</p>
<p class="msonormal" id="obs_04_0025__p47449588">Note:</p>
<p class="msonormal" id="obs_04_0025__p1744612505522">If the server returns a <strong id="obs_04_0025__b1251137171516">5XX</strong> error or times out when a bucket is being deleted, the system needs to synchronize the bucket information. During this period, the bucket information may be inaccurate. Therefore, wait a while and then check whether the bucket is successfully deleted. If the bucket can still be queried, send the deletion request again.</p>
</div>
<div class="section" id="obs_04_0025__section18211396"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0025__screen24595657"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE / HTTP/1.1
Host: bucketname.obs.region.example.com
Date: date
Authorization: authorization
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0025__section29684841"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0025__p20958252">This request contains no parameter.</p>
</div>
<div class="section" id="obs_04_0025__section65836981"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0025__p19896826">This request uses common request headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="obs_04_0025__section55661921"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0025__p9271588">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0025__section31195246"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0025__screen12801154"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 status_code
Date: date
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0025__section12321766"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0025__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
</div>
<div class="section" id="obs_04_0025__section43787032"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0025__p1039816">This response involves no elements.</p>
</div>
<div class="section" id="obs_04_0025__section58538975"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0025__p17116244">No special error responses are involved. 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_0025__section14482163815396"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0025__screen8484163863919"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 02:31:25 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:jZiAT8Vx4azWEvPRMWi0X5BpJMA=
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0025__section76081155815"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0025__screen8485113814"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 204 No Content
Server: OBS
x-obs-request-id: BF260000016435DE6D67C35F9B969C47
x-obs-id-2: 32AAAQAAEAABKAAQAAEAABAAAQAAEAABCTukraCnXLsb7lEw4ZKjzDWWhzXdgme3
Date: WED, 01 Jul 2015 02:31:25 GMT
</pre></div>
</td></tr></table></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0019.html">Operations on Buckets</a></div>
</div>
</div>

69
docs/obs/api-ref/obs_04_0026.html Normal file
View File

@ -0,0 +1,69 @@
<a name="obs_04_0026"></a><a name="obs_04_0026"></a>
<h1 class="topictitle1">Advanced Bucket Settings</h1>
<div id="body30612513"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="obs_04_0027.html">Configuring a Bucket Policy</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0028.html">Obtaining Bucket Policy Information</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0029.html">Deleting a Bucket Policy</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0030.html">Configuring a Bucket ACL</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0031.html">Obtaining Bucket ACL Information</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0032.html">Configuring Logging for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0033.html">Obtaining a Bucket Logging Configuration</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0034.html">Configuring Bucket Lifecycle Rules</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0035.html">Obtaining Bucket Lifecycle Configuration</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0036.html">Deleting Lifecycle Rules</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0037.html">Configuring Versioning for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0038.html">Obtaining Bucket Versioning Status</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0039.html">Configuring Event Notification for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0040.html">Obtaining the Event Notification Configuration of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0044.html">Configuring Storage Class for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0045.html">Obtaining Bucket Storage Class Information</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0049.html">Configuring Tags for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0050.html">Obtaining Bucket Tags</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0051.html">Deleting Tags</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0052.html">Configuring Bucket Storage Quota</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0053.html">Querying Bucket Storage Quota</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0054.html">Querying Information About Used Space in a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0059.html">Configuring a Custom Domain Name for a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0060.html">Obtaining the Custom Domain Name of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0061.html">Deleting the Custom Domain Name of a Bucket</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0062.html">Configuring Bucket Encryption</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0063.html">Obtaining Bucket Encryption Configuration</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="obs_04_0064.html">Deleting the Encryption Configuration of a Bucket</a></strong><br>
</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0018.html">APIs</a></div>
</div>
</div>

306
docs/obs/api-ref/obs_04_0027.html Normal file
View File

File diff suppressed because it is too large Load Diff

113
docs/obs/api-ref/obs_04_0028.html Normal file
View File

File diff suppressed because it is too large Load Diff

68
docs/obs/api-ref/obs_04_0029.html Normal file
View File

@ -0,0 +1,68 @@
<a name="obs_04_0029"></a><a name="obs_04_0029"></a>
<h1 class="topictitle1">Deleting a Bucket Policy</h1>
<div id="body40573325"><div class="section" id="obs_04_0029__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0029__p52023559">This operation uses the policy sub-resources to delete the policy of a specified bucket.</p>
<p class="msonormal" id="obs_04_0029__p65558853">To perform this operation, the user must be the bucket owner or the bucket owner's IAM user that has permissions required for deleting bucket policies.</p>
<p class="msonormal" id="obs_04_0029__p53158771">The 204 error code "No Content" is returned regardless of whether a requested bucket policy exists or not.</p>
</div>
<div class="section" id="obs_04_0029__section8666899"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0029__screen65213910"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE /?policy HTTP/1.1
Host: bucketname.obs.region.example.com
Date: date
Authorization: authorization
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0029__section10893228"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0029__p11035980">This request contains no parameter.</p>
</div>
<div class="section" id="obs_04_0029__section30930193"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0029__p21499207">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="obs_04_0029__section9936281"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0029__p36557059">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0029__section22317671"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0029__screen8331798"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 status_code
Date: date
Content-Type: text/xml
Content-Length: length
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0029__section66641315"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0029__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
</div>
<div class="section" id="obs_04_0029__section62900926"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0029__p27546096">This response involves no elements.</p>
</div>
<div class="section" id="obs_04_0029__section29237425"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0029__p16641336">No special error responses are returned. For details, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0029__section14482163815396"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0029__screen8484163863919"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE /?policy HTTP/1.1
Host: examplebucket.obs.region.example.com
Date: WED, 01 Jul 2015 02:36:06 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:jZiAT8Vx4azWEvPRMWi0X5BpJMA=
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0029__section76081155815"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0029__screen8485113814"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 204 No Content
x-obs-request-id: 9006000001643AAAF70BF6152D71BE8A
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSB4oWmNX3gVGGLr1cRPWjOhffEbq1XV
Date: WED, 01 Jul 2015 02:36:06 GMT
Server: OBS
</pre></div>
</td></tr></table></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0026.html">Advanced Bucket Settings</a></div>
</div>
</div>

260
docs/obs/api-ref/obs_04_0030.html Normal file
View File

File diff suppressed because it is too large Load Diff

220
docs/obs/api-ref/obs_04_0031.html Normal file
View File

File diff suppressed because it is too large Load Diff

432
docs/obs/api-ref/obs_04_0032.html Normal file
View File

File diff suppressed because it is too large Load Diff

214
docs/obs/api-ref/obs_04_0033.html Normal file
View File

File diff suppressed because it is too large Load Diff

407
docs/obs/api-ref/obs_04_0034.html Normal file
View File

File diff suppressed because it is too large Load Diff

355
docs/obs/api-ref/obs_04_0035.html Normal file
View File

File diff suppressed because it is too large Load Diff

71
docs/obs/api-ref/obs_04_0036.html Normal file
View File

@ -0,0 +1,71 @@
<a name="obs_04_0036"></a><a name="obs_04_0036"></a>
<h1 class="topictitle1">Deleting Lifecycle Rules</h1>
<div id="body64162387"><div class="section" id="obs_04_0036__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0036__p34512320">This operation deletes the lifecycle configuration of a bucket. After the lifecycle configuration of a bucket is deleted, OBS will not automatically delete objects in that bucket.</p>
<p class="msonormal" id="obs_04_0036__p42175431">To perform this operation, you must have the <strong id="obs_04_0036__b47667158410">PutLifecycleConfiguration</strong> permission. By default, only the bucket owner can perform this operation. The bucket owner can grant the permission to other users by configuring the bucket policy or user policy.</p>
</div>
<div class="section" id="obs_04_0036__section44034561"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0036__screen29770839"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE /?lifecycle HTTP/1.1
Host: bucketname.obs.region.example.com
Date: date
Authorization: Authorization
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0036__section60766737"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0036__p45648629">This request contains no parameter.</p>
</div>
<div class="section" id="obs_04_0036__section10029727"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0036__p6551431">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="obs_04_0036__section23158684"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0036__p11264357">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0036__section7101569"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0036__screen39997734"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 status_code
Date: date
Content-Type: text/xml
Date: date
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0036__section63914128"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0036__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
</div>
<div class="section" id="obs_04_0036__section38356240"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0036__p59393822">This response involves no elements.</p>
</div>
<div class="section" id="obs_04_0036__section9661843"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0036__p46170314">No special error responses are involved. 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_0036__section14482163815396"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0036__screen8484163863919"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE /?lifecycle HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 03:12:22 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:5DGAS7SBbMC1YTC4tNXY57Zl2Fo=
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0036__section76081155815"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0036__screen8485113814"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 204 No Content
Server: OBS
x-obs-request-id: BF260000016436C2550A1EEA97614A98
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSB7A0KZEBOCutgcfZvaGVthTGOJSuyk
Date: WED, 01 Jul 2015 03:12:22 GMT
</pre></div>
</td></tr></table></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0026.html">Advanced Bucket Settings</a></div>
</div>
</div>

129
docs/obs/api-ref/obs_04_0037.html Normal file
View File

File diff suppressed because it is too large Load Diff

116
docs/obs/api-ref/obs_04_0038.html Normal file
View File

File diff suppressed because it is too large Load Diff

326
docs/obs/api-ref/obs_04_0039.html Normal file
View File

File diff suppressed because it is too large Load Diff

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