vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/s3api/en-us_topic_0125560379.html
zhangyue 6fcdbfd13e OBS S3 API DOC 
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2024-02-26 11:17:13 +00:00

313 lines
29 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0125560379"></a><a name="EN-US_TOPIC_0125560379"></a>
<h1 class="topictitle1">HEAD Object</h1>
<div id="body8422040"><p id="EN-US_TOPIC_0125560379__p12347023">You can use this operation to view an object's metadata, as long as you have <strong id="EN-US_TOPIC_0125560379__b8689502">READ</strong> permission for the object.</p>
<p id="EN-US_TOPIC_0125560379__p2516897617143">This operation makes server-side encryption available.</p>
<div class="section" id="EN-US_TOPIC_0125560379__section44014347"><h4 class="sectiontitle">Versioning</h4><p id="EN-US_TOPIC_0125560379__p26414404">By default, the metadata of the object of the latest version is obtained. If the version ID of the object is a deletion mark, <strong id="EN-US_TOPIC_0125560379__b15558102810105">404</strong> is returned. You can specify <strong id="EN-US_TOPIC_0125560379__b36403044">versionId</strong> to obtain the metadata of an object of the desired version.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section62065135"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560379__screen26644240113444">HEAD /ObjectName HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: authorization</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section21715305"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560379__p35500737"><a href="#EN-US_TOPIC_0125560379__table59191946">Table 1</a> describes the request parameter.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560379__table59191946"></a><a name="table59191946"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560379__table59191946" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameter</caption><thead align="left"><tr id="EN-US_TOPIC_0125560379__row1513354"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.3.2.4.1.1"><p id="EN-US_TOPIC_0125560379__p55472867">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.3.2.4.1.2"><p id="EN-US_TOPIC_0125560379__p64117212">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.3.2.4.1.3"><p id="EN-US_TOPIC_0125560379__p26111645">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560379__row33678216"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560379__p43581001">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560379__p40400231">Indicates the version ID of an object.</p>
<p id="EN-US_TOPIC_0125560379__p28057764">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560379__p58086424">Optional</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section61220018"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560379__p66418811">This request uses common headers. For details about common request headers, see section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
<p id="EN-US_TOPIC_0125560379__p33822709">If you want to obtain CORS configuration information, you must use the headers in <a href="#EN-US_TOPIC_0125560379__table62965470">Table 2</a>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560379__table62965470"></a><a name="table62965470"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560379__table62965470" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers of CORS configuration</caption><thead align="left"><tr id="EN-US_TOPIC_0125560379__row15558717"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.4.2.4.1.1"><p id="EN-US_TOPIC_0125560379__p52296527">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="38.74387438743875%" id="mcps1.3.6.4.2.4.1.2"><p id="EN-US_TOPIC_0125560379__p8160310">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="27.92279227922792%" id="mcps1.3.6.4.2.4.1.3"><p id="EN-US_TOPIC_0125560379__p57005402">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560379__row54034850"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560379__p14746743">Origin</p>
</td>
<td class="cellrowborder" valign="top" width="38.74387438743875%" headers="mcps1.3.6.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560379__p53635520">Indicates an origin specified by a pre-request. Generally, it is a domain name.</p>
<p id="EN-US_TOPIC_0125560379__p12957636">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="27.92279227922792%" headers="mcps1.3.6.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560379__p42935575">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row50875856"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560379__p27303654">Access-Control-Request-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="38.74387438743875%" headers="mcps1.3.6.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560379__p64112402">Indicates the HTTP headers of a request. The request can use multiple HTTP headers.</p>
<p id="EN-US_TOPIC_0125560379__p40140706">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="27.92279227922792%" headers="mcps1.3.6.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560379__p30171783">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row49813360103218"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560379__p3302128517216">x-amz-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="38.74387438743875%" headers="mcps1.3.6.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560379__p5747846017216">Indicates a decryption algorithm. The header is used in SSE-C mode.</p>
<p id="EN-US_TOPIC_0125560379__p4754409217216">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p2524364617216">Example: x-amz-server-side-encryption-customer-algorithm:AES256</p>
<p id="EN-US_TOPIC_0125560379__p2586622817216">Constraints: This header must be used together with <strong id="EN-US_TOPIC_0125560379__b3146946117216">x-amz-server-side-encryption-customer-key</strong> and <strong id="EN-US_TOPIC_0125560379__b1478970017216">x-amz-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="27.92279227922792%" headers="mcps1.3.6.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560379__p5711506117216">No. This header is mandatory when SSE-C is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row21664203103222"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560379__p2938416617216">x-amz-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="38.74387438743875%" headers="mcps1.3.6.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560379__p3130723117216">Indicates a key used to decrypt objects. The header is used in SSE-C mode.</p>
<p id="EN-US_TOPIC_0125560379__p1332962717216">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p5285778117216">Example: x-amz-server-side-encryption-customer-key:K7QkYpBkM5+hcs27fsNkUnNVaobncnLht/rCB2o/9Cw=</p>
<p id="EN-US_TOPIC_0125560379__p595798217216">Constraints: This header is a base64-encoded 256-bit or 512-bit key and must be used together with <strong id="EN-US_TOPIC_0125560379__b5362183917216">x-amz-server-side-encryption-customer-algorithm</strong> and <strong id="EN-US_TOPIC_0125560379__b1283450517216">x-amz-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="27.92279227922792%" headers="mcps1.3.6.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560379__p3296198917216">No. This header is mandatory when SSE-C is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row36443734103226"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560379__p431700017216">x-amz-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="38.74387438743875%" headers="mcps1.3.6.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560379__p1413274017216">Indicates the MD5 value of a key used to decrypt objects. The header is used in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key.</p>
<p id="EN-US_TOPIC_0125560379__p6008580417216">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p390132517216">Example: x-amz-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</p>
<p id="EN-US_TOPIC_0125560379__p3511193017216">Constraints: This header is a base64-encoded 128-bit MD5 value and must be used together with <strong id="EN-US_TOPIC_0125560379__b4757191417216">x-amz-server-side-encryption-customer-algorithm</strong> and <strong id="EN-US_TOPIC_0125560379__b2549404817216">x-amz-server-side-encryption-customer-key</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="27.92279227922792%" headers="mcps1.3.6.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560379__p5175200717216">No. This header is mandatory when SSE-C is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row101687305396"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560379__p10523133113916">x-amz-security-token</p>
</td>
<td class="cellrowborder" valign="top" width="38.74387438743875%" headers="mcps1.3.6.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560379__p18523163153915">Header field used to identify the request of a federated user. When the federal authentication function is enabled, users sending such requests are identified as federated users.</p>
<p id="EN-US_TOPIC_0125560379__p12523183163915">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="27.92279227922792%" headers="mcps1.3.6.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560379__p1352316311397">Optional. This parameter must be carried in the request sent by federated users.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section14109251"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560379__p50631838">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section37049649"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560379__screen836209111356">HTTP/1.1 status_code
Server: Server Name
x-amz-request-id: request id
x-amz-id-2: id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Accept-Ranges: bytes
Content-Type: type
Date: date
Content-Length: length
Etag: etag
Last-Modified: time</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section65011387"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560379__p11082291">This response uses common headers. For details about common response headers, see section <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
<p id="EN-US_TOPIC_0125560379__p25926813">This response can also include an optional header. <a href="#EN-US_TOPIC_0125560379__table53033363">Table 3</a> describes the header.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560379__table53033363"></a><a name="table53033363"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560379__table53033363" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Optional response header</caption><thead align="left"><tr id="EN-US_TOPIC_0125560379__row11065763"><th align="left" class="cellrowborder" valign="top" width="38.35%" id="mcps1.3.9.4.2.3.1.1"><p id="EN-US_TOPIC_0125560379__p23911583">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="61.650000000000006%" id="mcps1.3.9.4.2.3.1.2"><p id="EN-US_TOPIC_0125560379__p57790096">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560379__row50486238"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p62853488">x-amz-expiration</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p57967791">This header is included in the response if the object expiration is configured. This header includes <strong id="EN-US_TOPIC_0125560379__b10684135211308">expiry-date</strong> and <strong id="EN-US_TOPIC_0125560379__b11283104012151">rule-id</strong> key value pairs to provide object expiration information.</p>
<p id="EN-US_TOPIC_0125560379__p47044503">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row20747346"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p2813446">x-amz-website-redirect-location</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p26562567">When a bucket is configured as a website, you can set this metadata for the object so that the website endpoint will evaluate the request for the object as a 301 redirect to another object in the same bucket or an external URL.</p>
<p id="EN-US_TOPIC_0125560379__p37736511">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row4084284"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p62391565">x-amz-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p20552036">Indicates the version ID of an object. If an object has no version ID specified, this header is not returned.</p>
<p id="EN-US_TOPIC_0125560379__p50750596">Valid values: String</p>
<p id="EN-US_TOPIC_0125560379__p54102182">Default: None</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row17157596"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p47588012">Access-Control-Allow-Origin</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p29423773">CORS is configured for buckets. If <strong id="EN-US_TOPIC_0125560379__b63487369">Origin</strong> in the request meets the CORS configuration requirements, <strong id="EN-US_TOPIC_0125560379__b34515414">Origin</strong> is included in the response.</p>
<p id="EN-US_TOPIC_0125560379__p42203278">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row44285184"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p30330179">Access-Control-Allow-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p40825414">CORS is configured for buckets. If <strong id="EN-US_TOPIC_0125560379__b31884407">headers</strong> in the request meet the CORS configuration requirements, <strong id="EN-US_TOPIC_0125560379__b18524209">headers</strong> are included in the response.</p>
<p id="EN-US_TOPIC_0125560379__p32500157">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row24065965"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p3186145">Access-Control-Max-Age</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p56751222">Indicates <strong id="EN-US_TOPIC_0125560379__b40998956">MaxAgeSeconds</strong> in the CORS configuration of a server when CORS is configured for buckets.</p>
<p id="EN-US_TOPIC_0125560379__p33446292">Type: Integer</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row32581173"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p21829362">Access-Control-Allow-Methods</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p23347916">CORS is configured for buckets. If <strong id="EN-US_TOPIC_0125560379__b8804655">Access-Control-Request-Method</strong> in the request meets the CORS configuration requirements, methods in the rule are included in the response.</p>
<p id="EN-US_TOPIC_0125560379__p12133034">Type: String</p>
<p id="EN-US_TOPIC_0125560379__p42088446">Valid values: <strong id="EN-US_TOPIC_0125560379__b43251701">GET</strong>, <strong id="EN-US_TOPIC_0125560379__b53720990">PUT</strong>, <strong id="EN-US_TOPIC_0125560379__b13726868">HEAD</strong>, <strong id="EN-US_TOPIC_0125560379__b56432951">POST</strong>, and <strong id="EN-US_TOPIC_0125560379__b38134512">DELETE</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row7666288"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p16989553">Access-Control-Expose-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p33976547">Indicates <strong id="EN-US_TOPIC_0125560379__b987214491518">ExposeHeader</strong> in the CORS configuration of a server when CORS is configured for buckets.</p>
<p id="EN-US_TOPIC_0125560379__p636909">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row54805475103250"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p780079817247">x-amz-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p2788494017247">This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560379__p4963787317247">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p4408767817247">Example: x-amz-server-side-encryption:aws:kms</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row28852491103254"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p6188084017247">x-amz-server-side-encryption-aws-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p4629218117247">Indicates the master key ID. This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560379__p1397644817247">Example: x-amz-server-side-encryption-aws-kms-key-id:arn:aws:kms:sichuan:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row44732321103258"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p5539231117247">x-amz-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p5759222117247">Indicates a decryption algorithm. This header is included in a response if SSE-C is used.</p>
<p id="EN-US_TOPIC_0125560379__p4856794617247">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p3445833117247">Example: x-amz-server-side-encryption-customer-algorithm:AES256</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row2546809010331"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p2140888217247">x-amz-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p5639784417247">Indicates the MD5 value of a key used to decrypt objects. This header is included in a response if SSE-C is used.</p>
<p id="EN-US_TOPIC_0125560379__p3781855417247">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p482266717247">Example: x-amz-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row39621742203855"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p6728147203912">x-amz-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p5284058595917">This header is returned when the storage class of an object is not Standard.</p>
<p id="EN-US_TOPIC_0125560379__p5627849695922">Type: String</p>
<p id="EN-US_TOPIC_0125560379__p27438820203855">Valid values: <strong id="EN-US_TOPIC_0125560379__b33981158203921">STANDARD_IA</strong> and <strong id="EN-US_TOPIC_0125560379__b18355429203924">GLACIER</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row6625129720391"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p6466818203940">x-amz-restore</p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p6194510820407">The following provides examples of object restoration status:</p>
<ul id="EN-US_TOPIC_0125560379__ul2063506520407"><li id="EN-US_TOPIC_0125560379__li5149785820407"><strong id="EN-US_TOPIC_0125560379__b6082754620407">ongoing-request="true"</strong>indicates that the object is being restored.</li><li id="EN-US_TOPIC_0125560379__li1057700920407"><strong id="EN-US_TOPIC_0125560379__b2808422520407">ongoing-request="false"</strong>indicates that the object has been restored.</li><li id="EN-US_TOPIC_0125560379__li5143143320407">In <strong id="EN-US_TOPIC_0125560379__b6022971520407">expiry-date="Wed, 07 Nov 2012 00:00:00 GMT"</strong>, <strong id="EN-US_TOPIC_0125560379__b519652920407">expiry-date</strong> indicates the expiry date of the restored object.</li></ul>
<p id="EN-US_TOPIC_0125560379__p4676876220407">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row35695312710"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p5180191819182"><span style="color:#494949;">x-amz-object-lock-mode</span></p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p6180918151813">WORM mode that will be applied to the object. Currently, only <strong id="EN-US_TOPIC_0125560379__b2443165812187">COMPLIANCE</strong> is supported. This header is returned only when the object has any object-level retention policy configured or has the default bucket-level WORM policy applied. To configure this header, the <strong id="EN-US_TOPIC_0125560379__b335715924120">GetObjectRetention</strong> permission is required.</p>
<p id="EN-US_TOPIC_0125560379__p14496145181918">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p154228537191">Example: <strong id="EN-US_TOPIC_0125560379__b773731920020">x-amz-object-lock-mode:COMPLIANCE</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560379__row34811551872"><td class="cellrowborder" valign="top" width="38.35%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560379__p14809920131812"><span style="color:#494949;">x-amz-object-lock-retain-until-date</span></p>
</td>
<td class="cellrowborder" valign="top" width="61.650000000000006%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560379__p97201718162111">Indicates the expiration time of the WORM retention. The value must be a UTC time that complies with ISO 8601, for example, <strong id="EN-US_TOPIC_0125560379__b937161762618">2015-07-01T04:11:15Z</strong>. This header is returned only when the object has any object-level retention policy configured or has the default bucket-level WORM policy applied. To configure this header, the <strong id="EN-US_TOPIC_0125560379__b10371151782610">GetObjectRetention</strong> permission is required.</p>
<p id="EN-US_TOPIC_0125560379__p1972081822113">Type: string</p>
<p id="EN-US_TOPIC_0125560379__p372031872119">Example: <strong id="EN-US_TOPIC_0125560379__b131940433014">x-amz-object-lock-retain-until-date:2015-07-01T04:11:15Z</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section48231578"><h4 class="sectiontitle">Response elements</h4><p id="EN-US_TOPIC_0125560379__p61654013">This response involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section31431022"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0125560379__p27919180">No special error responses are returned. For details about error responses, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section63026140"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560379__screen18482081113524">HEAD /test HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Sat, 03 Dec 2011 09:17:57 +0000
Authorization: AWS BF6C09F302931425E9A7:++6NkzwVhw4qccNfIqf4G2vMggg=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section30364352"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560379__screen48804690113537">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: 001B21A61C6C0000013403373811529D
x-amz-id-2: MDAxQjIxQTYxQzZDMDAwMDAxMzQwMzM3MzgxMTUyOURBQUFBQUFBQWJiYmJiYmJi
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Accept-Ranges: bytes
ETag: "507e3fff69b69bf57d303e807448560b"
Last-Modified: Sat, 03 Dec 2011 08:47:50 GMT
Content-Length: 30
Content-Type: binary/octet-stream
Date: Sat, 03 Dec 2011 09:17:57 GMT </pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section43593438"><h4 class="sectiontitle">Sample Request (Getting the Metadata of an Object with Version ID Specified)</h4><pre class="screen" id="EN-US_TOPIC_0125560379__screen1609408113549">HEAD /object?versionId=AAABQ4-glIvc0vycq3gAAAAVVURTRkha HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Tue, 14 Jan 2014 07:22:17 +0000
Authorization: AWS C9590CEB8EC051BDEC9D:CTunmEJMuOBqUa4zfJNz6zxkjBE=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section56796626"><h4 class="sectiontitle">Sample Response (Getting the Metadata of an Object with Version ID Specified)</h4><pre class="screen" id="EN-US_TOPIC_0125560379__screen42078011362">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: DCD2FC9CAB78000001438FA11E6CBB07
x-amz-id-2: SSfKQyh2Gr6ygerqHhJLZ6rxPiv+ucjWabr48RssNJMWmGyKh9gDdXC0jvo1JmFs
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Accept-Ranges: bytes
ETag: "ba1f2511fc30423bdbb183fe33f3dd0f"
Last-Modified: Tue, 14 Jan 2014 07:21:42 GMT
Content-Length: 4
x-amz-version-id: AAABQ4-glIvc0vycq3gAAAAVVURTRkha
Content-Type: binary/octet-stream
Date: Tue, 14 Jan 2014 07:22:17 GMT</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section3311378921371"><h4 class="sectiontitle">Sample Request (Getting Object Metadata and CORS Configuration when CORS is properly configured)</h4><pre class="screen" id="EN-US_TOPIC_0125560379__screen2425173105454">HEAD /object HTTP/1.1
User-Agent: curl/7.19.0 (x86_64-suse-linux-gnu) libcurl/7.19.0 OpenSSL/0.9.8{ zlib/1.2.3 libidn/1.10
Host: bucketname.obs.example.com
Accept: */*
Date: Tue, 28 Apr 2015 14:03:45 +0000
Authorization: AWS D13E0C94E722DD69423C:YcuaA/lJkmWn8AqjfWvIodNJ/yM=
Origin:www.example.com
Access-Control-Request-Headers:AllowedHeader_1</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560379__section23469382251"><h4 class="sectiontitle">Sample Response (Getting Object Metadata and CORS Configuration when CORS is properly configured)</h4><pre class="screen" id="EN-US_TOPIC_0125560379__screen3784860810555">HTTP/1.1 200 OK
x-amz-request-id: D168613B12D6EE5744A69C524D3AA876
x-amz-id-2: 35Sas+J9yUY4xz3PrL0O938UKDg+Dc8EfSw0m9LtfoqB7s0wiMc44TOGguSLNyOv
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Access-Control-Allow-Origin: www.example.com
Access-Control-Allow-Methods: POST,GET,HEAD,PUT,DELETE
Access-Control-Allow-Headers: AllowedHeader_1
Access-Control-Max-Age: 100
Access-Control-Expose-Headers: ExposeHeader_1
Accept-Ranges: bytes
ETag: "6bcb16084a88ae550811429c0c1e8bc7"
Last-Modified: Tue, 28 Apr 2015 13:38:05 GMT
Content-Length: 264
Content-Type: binary/octet-stream
Date: Tue, 28 Apr 2015 14:03:45 GMT</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560489.html">Operations on Objects</a></div>
</div>
</div>
View Git Blame Copy Permalink