创建 Share (FileREST API) - Azure 文件存储

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

项目
02/28/2024

该Create Share操作在指定的帐户下创建新的Azure 文件存储共享。尽管此 API 完全受支持，但这是一个旧版管理 API。建议改用由 Azure 存储资源提供程序提供的 “文件共享 - 创建” (Microsoft.Storage) 。若要详细了解如何使用 Azure 存储资源提供程序以编程方式与 FileShare 资源交互，请参阅 FileShare 上的操作。

如果已存在同名的共享，则操作将失败。共享资源包括该共享的元数据和属性。它不包括共享中包含的文件列表。

协议可用性

已启用文件共享协议	可用
服务器消息块 (SMB)
网络文件系统 (NFS)

请求

可以构造请求， Create Share 如下所示。建议使用 HTTPS。

方法	请求 URI	HTTP 版本
`PUT`	`https://myaccount.file.core.windows.net/myshare?restype=share`	HTTP/1.1

将请求 URI 中显示的路径组件替换为自己的组件，如下所示：

路径组件	说明
`myaccount`	存储帐户的名称。
`myshare`	文件共享的名称。名称只能包含小写字符。

有关路径命名限制的详细信息，请参阅名称和引用共享、目录、文件和元数据。

URI 参数

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

参数	说明
`timeout`	可选。超时参数以秒表示。有关详细信息，请参阅设置文件服务操作的超时。

请求标头

下表描述了必需的和可选的请求标头：

请求标头	说明
`Authorization`	必需。指定授权方案、帐户名称和签名。有关详细信息，请参阅授权对 Azure 存储的请求。
`Date` 或 `x-ms-date`	必需。为请求指定协调世界时 (UTC) 时间。有关详细信息，请参阅授权对 Azure 存储的请求。
`x-ms-version`	对于所有已授权的请求是必需的。指定用于此请求的操作的版本。有关详细信息，请参阅 Azure 存储服务的版本控制。
`x-ms-meta-name:value`	可选。作为元数据与共享关联的名称-值对。元数据名称必须遵守 C# 标识符的命名规则。
`x-ms-share-quota`	可选。在版本 2015-02-21 及更高版本中受支持。指定共享的最大大小（以 giB (GiB) 为单位）。
`x-ms-access-tier`	可选。在版本 2019-12-12 及更高版本中受支持。指定共享的访问层。有效值为 `TransactionOptimized`、`Hot` 和 `Cool`。有关文件共享层的详细信息，请参阅Azure 文件存储存储层。
`x-ms-enabled-protocols: <SMB \\| NFS>`	可选。在版本 2019-07-07 及更高版本中受支持。指定共享上启用的协议。如果未指定，则默认值为 SMB。 - `SMB`：SMBv3.0、SMBv2.1 和 REST 可以访问共享。 - `NFS`：NFSv4.1 可以访问共享。此选项需要高级帐户。
`x-ms-root-squash: <NoRootSquash \\| RootSquash \\| AllSquash>`	可选。仅限 NFS。在版本 2019-07-07 及更高版本中受支持。指定启用 NFS 时共享上的根压缩行为。如果未指定，则默认值为 NoRootSquash。 - `NoRootSquash`：关闭根挤压。 - `RootSquash`：将请求从 uid/gid 0 映射到匿名 uid/gid。 - `AllSquash`：将所有 uid 和 gid 映射到匿名用户。
`x-ms-client-request-id`	可选。提供客户端生成的不透明值，其中包含 1-kibite (KiB) 配置日志记录时记录在日志中的字符限制。强烈建议使用此标头将客户端活动与服务器接收的请求相关联。有关详细信息，请参阅监视Azure 文件存储。

请求正文

无。

示例请求

PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: <date>  
x-ms-meta-Name: StorageSample  
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

响应

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

状态代码

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

有关详细信息，请参阅状态和错误代码。

响应头

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

响应标头	说明
`ETag`	包含一个值，该值表示共享的版本，用引号引起来。
`Last-Modified`	返回上次修改共享的日期和时间。日期格式遵循 RFC 1123。有关详细信息，请参阅在标头中表示日期/时间值。修改共享或者其属性或元数据的任何操作将更新上次修改时间。对文件执行的操作不会影响共享的上次修改时间。
`x-ms-request-id`	唯一标识请求，并可用于对请求进行故障排除。有关详细信息，请参阅 API 操作疑难解答
`x-ms-version`	指示用于执行请求的Azure 文件存储版本。
`Date`	由服务生成的 UTC 日期/时间值，指示启动响应的时间。
`x-ms-client-request-id`	可用于对请求和相应的响应进行故障排除。如果请求中存在标头， `x-ms-client-request-id` 并且该值包含的可见 ASCII 字符不超过 1,024 个，则此标头的值等于标头的值。 `x-ms-client-request-id`如果请求中不存在标头，则响应中不存在该标头。

响应正文

无。

示例响应

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: <date>  
x-ms-version: 2020-02-10  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

授权

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

注解

共享立即在存储帐户中创建。不能将一个共享嵌套在另一个共享中。

创建共享时，可以通过在请求中包含一个或多个元数据标头来指定共享的元数据。元数据头的格式为 x-ms-meta-name:value。

如果在调用 Create Share时删除同名共享，服务器将返回状态代码 409 (冲突) ，其他错误信息指示正在删除该共享。

可以使用共享大小配额来限制存储在共享上的文件大小。配额不会限制快照的大小。与文件关联并用于计算存储帐户计费大小的开销未计入配额。

当共享上的文件大小之和超过在共享上设置的配额时，尝试增加文件大小将失败，并且通过 REST) 创建新的非空文件 (将失败。你仍然可以创建空文件。

更改或设置该配额对计费没有影响。你仍需要为文件大小加上开销付费。

另请参阅

对Azure 文件存储共享的操作

创建共享