HeadContainer
  • PDF

HeadContainer

  • PDF

概述

查询容器(存储桶)的元数据。

语句

HEAD /v1/AUTH_{project_id}/{container}

请求

Name In Type Description
project_id path string 输入项目ID。
container (Optional) path string 输入要创建的容器(存储桶)名称。可输入3~30个字符。若包含slash(/),将被识别为{container}/{object},请注意
X-Auth-Token (Optional) header string 输入发放的Token值。
X-Newest (Optional) header boolean 若为true,则搜索所有副本,并使用最新副本的信息进行响应。如果省略了该报头,则使用响应最快的信息进行响应。

响应

Name In Type Description
X-Container-Meta-name header string 相应容器(存储桶)的元数据。报头名称name部分用作元数据的密钥。
Content-Length header string 响应结果的长度。(Bytes)
X-Container-Object-Count header integer 相应容器(存储桶)的对象数量。
X-Container-Bytes-Used header integer 相应容器(存储桶)使用的总容量大小。(Bytes)
X-Container-Read (Optional) header string 相应容器的READ ACL。
X-Container-Write (Optional) header string 相应容器的WRITE ACL。
X-Container-Meta-Quota-Bytes (Optional) header string 相应容器(存储桶)的容量限定值。(bytes)
X-Container-Meta-Quota-Count (Optional) header string 相应容器(存储桶)的对象数量的限定值。
X-Container-Meta-Access-Control-Allow-Origin (Optional) header string CORS
X-Container-Meta-Access-Control-Max-Age (Optional) header string CORS
X-Container-Meta-Access-Control-Expose-Headers (Optional) header string CORS
X-Container-Meta-Temp-URL-Key (Optional) header string 用于temporary URL的Secret Key值。
X-Container-Meta-Temp-URL-Key-2 (Optional) header string 用于temporary URL的第二个Secret Key值。
X-Timestamp header integer 相应容器(存储桶)创建的时间。(UNIX Time)
X-Container-Sync-Key (Optional) header string not supported
X-Container-Sync-To (Optional) header string not supported
Date header string 相应请求的响应时间。(UTC)
X-Trans-Id header string 相应请求的事务ID。
X-Openstack-Request-Id header string 相应请求的事务ID。(与X-Trans-Id相同。)
Content-Type (Optional) header string 响应结果的MIME类型。
X-Versions-Location (Optional) header string not supported
X-History-Location (Optional) header string not supported

示例

请求示例(查询容器元数据)

curl -i -X HEAD -H "X-Auth-Token:$token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}

响应示例

HTTP/1.1 204 No Content
Content-Length:0
X-Container-Object-Count:3
X-Timestamp:1536631895.01856
Accept-Ranges:bytes
Last-Modified:Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used:630036
Content-Type:text/plain; charset=utf-8
X-Trans-Id:tx51f8478e8e924403851a4-005b988014
X-Openstack-Request-Id:tx51f8478e8e924403851a4-005b988014
Date:Wed, 12 Sep 2018 02:55:16 GMT

请求成功后,响应No Content (204)状态代码。


本文是否有帮助

What's Next