创建容器
本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

创建容器

 

Create Container 操作创建指定的帐户下的新容器。 如果已存在具有相同名称的容器,则操作将失败。

容器资源包括元数据和为该容器的属性。 它不包括容器所包含的 blob 的列表。

Create Container 请求可以按以下方式构造。 建议使用 HTTPS。mycontainer 值只能包含小写字符。 替换 myaccount 替换为你的存储帐户名称:

方法

请求 URI

HTTP 版本

PUT

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

HTTP/1.1

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

方法

请求 URI

HTTP 版本

PUT

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

HTTP/1.1

有关详细信息,请参阅 使用 Azure 存储模拟器进行开发和测试差异之间的存储模拟器与 Azure 存储服务

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

参数

说明

timeout

此参数可选。 timeout 参数以秒为单位。 有关详细信息,请参阅 为 Blob 服务操作设置超时

下表介绍必需和可选请求标头。

请求标头

说明

Authorization

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

Datex-ms-date

必需。 指定请求的格式为协调世界时 (UTC) 时间。 有关详细信息,请参阅 Azure 存储服务身份验证

x-ms-version

请求所需的所有经过身份验证。 指定要用于此请求的操作的版本。 有关详细信息,请参阅 Azure 存储服务的版本控制

x-ms-meta-name:value

此参数可选。 作为元数据与容器关联的名称 / 值对。

请注意,从版本 2009年-09-19 开始,元数据名称必须遵守的命名规则 C# 标识符

x-ms-blob-public-access 

此参数可选。 指定是否可以公开访问容器中的数据和访问级别。 可能值包括:

  • container:指定对容器和 blob 数据的完整公共读取访问权限。 客户端可以枚举通过匿名请求,容器中的 blob,但无法枚举存储帐户中的容器。

  • blob: 指定对 blob 的公共读取访问权限。 可以通过匿名请求读取此容器中的 blob 数据,但容器数据不可用。 客户端不能枚举通过匿名请求容器中的 blob。

如果在请求中未包括此标头,则容器数据是帐户所有者私有的。

x-ms-client-request-id

此参数可选。 具有 1 KB 字符限制的启用存储分析日志记录时,在分析日志记录提供客户生成的、 不透明值。 强烈建议使用此标头将客户端活动与服务器接收的请求相关联。 有关详细信息,请参阅 关于存储分析日志记录Azure 日志记录:使用日志跟踪存储请求

Request Syntax: PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1 Request Headers: x-ms-version: 2011-08-18 x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT x-ms-meta-Name: StorageSample Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

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

此操作成功后返回状态代码 201 (已创建)。

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

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

响应标头

说明

ETag

容器的 ETag。 如果请求版本为 2011年-08-18 或更高版本,ETag 值将用引号引起来。

Last-Modified

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

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

x-ms-request-id

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

x-ms-version

指示用于执行请求的 Blob 服务的版本。 此标头是针对 2009年-09-19 版本发出的请求返回及更高版本。

Date

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

Response Status: HTTP/1.1 201 Created Response Headers: Transfer-Encoding: chunked Date: Sun, 25 Sep 2011 23:00:12 GMT ETag: “0x8CB14C3E29B7E82” Last-Modified: Sun, 25 Sep 2011 23:00:06 GMT x-ms-version: 2011-08-18 Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

只有帐户所有者可以调用此操作。

在存储帐户下立即创建容器。 不能嵌套在另一个下面的一个容器。

为您的存储帐户,可以选择创建默认包文件夹或根容器。 从请求 blob 资源的 URL,可能会推断出的根容器。 根容器就可以从存储帐户层次结构的顶层引用 blob,而无需引用容器名称。

若要将根容器添加到您的存储帐户中,创建名为的容器 $root 如下所示构造请求:

Request Syntax: PUT https://myaccount.blob.core.windows.net/$root?restype=container HTTP/1.1 Request Headers: x-ms-version: 2011-08-18 x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT x-ms-meta-Name: StorageSample Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

您可以在通过包含在请求上的一个或多个元数据标头创建的时指定容器的元数据。 元数据标头的格式是 x-ms-meta-name:value

按相同名称的容器是否正被删除时 Create Container 是调用,则服务器将返回状态代码 409 (冲突),与其他错误信息以指示正在删除容器。

显示:
© 2016 Microsoft