导出 (0) 打印
全部展开
此主题尚未评级 - 评价此主题

获取容器属性 (REST API)

更新时间: 2012年6月

Get Container Properties操作返回指定容器的所有用户定义的元数据和系统属性。返回的数据不包含该容器的 Blob 列表。

可以按如下方式构建Get Container Properties请求。建议使用 HTTPS。将 myaccount 替换为您的存储帐户名称:

 

方法 请求 URI HTTP 版本

GET/HEAD

https://myaccount.blob.core.windows.net/mycontainer?restype=container

HTTP/1.1

模拟的存储服务 URI

在针对模拟的存储服务发出请求时,请将模拟器主机名和 BLOB 服务端口指定为 127.0.0.1:10000,后跟模拟的存储帐户名称:

 

方法 请求 URI HTTP 版本

GET/HEAD

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container

HTTP/1.1

有关更多信息,请参见 Overview of the Windows Azure Storage Emulator存储仿真程序与 Windows Azure 存储服务之间的差异

URI 参数

可以在请求 URI 上指定以下附加参数。

 

Parameter 说明

timeout

可选。timeout parameter is expressed in seconds.有关更多信息,请参见为 BLOB 服务操作设置超时

请求标头

下表说明了必需和可选的请求标头。

 

请求标头 说明

Authorization

必需。指定身份验证方案、帐户名和签名。有关更多信息,请参见Windows Azure 存储服务身份验证

Datex-ms-date

必需。为请求指定协调世界时 (UTC)。有关更多信息,请参见Windows Azure 存储服务身份验证

x-ms-lease-id: <ID>

可选,2012-02-12 和更高版本。如果指定,只有在容器的租约处于活动状态并且与此 ID 匹配时,Get Container Properties才会成功。如果没有活动租约或者 ID 不匹配,则会返回 412 (Precondition Failed)

x-ms-version

对于所有验证的请求是必需的,对于匿名请求是可选的。指定用于此请求的操作的版本。有关更多信息,请参见Windows Azure 中 BLOB 服务、队列服务和表服务的版本管理

x-ms-client-request-id

可选。提供客户端生成的、具有 1 KB 字符限制的难理解的值,当启用存储分析日志记录时在分析日志中记录它。强烈建议使用此标头以将客户端活动与服务器收到的请求关联。有关更多信息,请参见关于存储分析日志记录Windows Azure 日志记录:使用日志跟踪存储请求

请求正文

无。

响应包括 HTTP 状态代码和一组响应标头。

状态代码

此操作成功后返回状态代码 200(正常)。

有关状态代码的信息,请参阅状态和错误代码

响应标头

此操作的响应包括以下标头。该响应还可能包括其他标准 HTTP 头。所有标准标头都遵循 HTTP/1.1 协议规范

 

响应标头 说明

x-ms-meta-name:value

返回一个字符串,其中包含作为元数据与容器关联的名称/值对。

ETag

容器的实体标记。如果请求版本为 2011-08-18 和更高版本,ETag 值将用引号引起来。

Last-Modified

返回上次修改容器的日期和时间。日期格式遵循 RFC 1123。有关更多信息,请参见标头中日期/时间值的表示

修改容器或者其属性或元数据的任何操作将更新上次修改时间。Blob 上的操作不会影响容器的上次修改时间。

x-ms-lease-status: <locked | unlocked>

2012-02-12 和更高版本。容器的租约状态。

x-ms-lease-state: <available | leased | expired | breaking | broken>

2012-02-12 和更高版本。容器的租约状态。

x-ms-lease-duration: <infinite | fixed >

2012-02-12 和更高版本,只有在租用容器时。指定容器上的租约是无限期还是固定时间。

x-ms-request-id

此标头唯一地标识发出的请求,并且可用于解决请求问题。有关详细信息,请参阅API 操作故障排除

x-ms-version

2009-09-19 和更高版本。指示用于执行请求的 BLOB 服务的版本。

如果使用 BLOB 服务的 2009-09-19 版将容器标记为公共访问,则也会为未指定版本的匿名请求返回此标头。

Date

服务生成的 UTC 日期/时间值指示启动响应的时间。

响应正文

无。

示例响应

Response Status:
HTTP/1.1 200 OK

Response Headers:
Transfer-Encoding: chunked
x-ms-meta-Name: StorageSample
Date: Sun, 25 Sep 2011 12:43:08 GMT
ETag: "0x8CAFB82EFF70C46"
Last-Modified: Sun, 25 Sep 2011 10:42:18 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

如果容器的访问控制列表 (ACL) 设置为允许匿名访问容器,则任何客户端都可以调用此操作。如果容器是私有的,则仅帐户所有者可以执行此操作。

无。

本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈
显示:
© 2014 Microsoft. 版权所有。