你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
还原共享
该 Restore Share 操作) 之前已软删除的共享还原 (或 取消删除 。 此 API 完全受支持，但它是旧版管理 API。 请改用存储资源提供程序提供的 “文件共享 - 还原”， (Microsoft.Storage) 。 若要详细了解如何使用存储资源提供程序以编程方式与 FileShare 资源交互，请参阅 对 FileShares 的操作。
共享连同其所有数据、元数据和快照一起还原。 共享资源包括共享的元数据和属性。
协议可用性
| 已启用文件共享协议 | 可用 |
|---|---|
| SMB |  |
| NFS |  |
请求
可以按如下所示构造 Restore Share 请求。 建议使用 HTTPS。
| 方法 | 请求 URI | HTTP 版本 |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/restoredShareName?restype=share&comp=undelete |
HTTP/1.1 |
将请求 URI 中所示的路径组件替换为你自己的组件，如下所示：
| 路径组件 | 说明 |
|---|---|
myaccount |
存储帐户的名称。 |
restoredShareName |
要用于还原的共享的名称。 如果已存在具有此名称的共享，则操作将失败。 |
有关路径命名限制的详细信息，请参阅 命名和引用共享、目录、文件和元数据。
URI 参数
可以在请求 URI 上指定以下附加参数。
| 参数 | 说明 |
|---|---|
timeout |
可选。 超时参数以秒表示。 有关详细信息，请参阅设置Azure 文件存储操作的超时。 |
请求标头
下表介绍必需和可选的请求标头。
| 请求标头 | 说明 |
|---|---|
Authorization |
必需。 指定身份验证方案、帐户名和签名。 有关详细信息，请参阅 Azure 存储服务的身份验证。 |
x-ms-date |
必需。 为请求指定协调世界时 (UTC) 时间。 有关详细信息，请参阅 Azure 存储服务的身份验证。 |
x-ms-version |
对于所有验证的请求是必需的。 指定用于此请求的操作的版本。 有关详细信息，请参阅 Azure 存储服务的版本控制。 |
x-ms-deleted-share-name |
必需。 标识要还原的软删除文件共享。 此值必须与 的值 restoredShareName匹配。 |
x-ms-deleted-share-version |
必需。 按版本唯一标识软删除的文件共享。 |
x-ms-client-request-id |
可选。 提供客户端生成的不透明值，其中包含 1-kibite (KiB) 配置日志记录时记录在日志中的字符限制。 强烈建议使用此标头将客户端活动与服务器接收的请求相关联。 有关详细信息，请参阅监视Azure Blob 存储。 |
请求正文
无。
示例请求
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=undelete HTTP/1.1
Request Headers:
x-ms-version: 2019-12-12
x-ms-deleted-share-name: myshare
x-ms-deleted-share-version: 01D2AC0C18EDFE36
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
响应
响应包括 HTTP 状态代码和一组响应标头。
状态代码
此操作成功后返回状态代码 201（已创建）。 如果目标文件共享名称由有效的未删除文件共享使用，则请求将失败，并显示 409 (冲突) 。 如果源文件共享未软删除、已还原，或者源文件共享已超过其保留期且已过期，则请求将失败，) “找不到 404 (”。
有关状态代码的信息，请参阅 状态和错误代码。
响应头
此操作的响应包括以下标头。 响应还可以包含其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范。
| 响应标头 | 说明 |
|---|---|
ETag |
包含一个值，该值以引号表示共享的版本。 |
Last-Modified |
返回上次修改共享的日期和时间。 有关详细信息，请参阅 标头中的日期时间值的表示形式。 修改共享或其属性或元数据的任何操作更新上次修改时间。 对文件执行的操作不会影响共享的上次修改时间。 |
x-ms-request-id |
唯一标识发出的请求，可用于对请求进行故障排除。 有关详细信息，请参阅 API 操作故障排除。 |
x-ms-version |
指示用于运行请求Azure 文件存储的版本。 |
Date |
指示启动响应的时间的 UTC 日期/时间值。 服务生成此值。 |
x-ms-client-request-id |
可用于对请求和相应的响应进行故障排除。 如果请求中存在，则此标头的值 x-ms-client-request-id header等于 的值。 该值最多为 1，024 个可见 ASCII 字符。 x-ms-client-request-id header如果 请求中不存在，则响应中不会存在。 |
响应正文
无。
示例响应
Response Status:
HTTP/1.1 201 Created
Response Headers:
x-ms-request-id: 78c46801-f01a-0089-31fb-486017000000
x-ms-version: 2019-12-12
Content-Length: 0
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
授权
存储帐户所有者可以调用此操作。 此外，具有有效帐户共享访问签名令牌的用户可以调用此操作。 令牌必须包含容器资源的写入权限，才能授权此操作。
注解
无法将共享还原为其他名称。 还原共享时，如果存在同名的另一个共享，则操作会失败，状态代码为 409 (冲突) 。 必须先删除同名的共享，然后才能取消删除软删除的共享。
删除共享时，同名共享在至少 30 秒内无法还原。 删除共享时，尝试还原同名共享失败，状态代码为 409 (冲突) 。 该服务返回其他错误信息，指示正在删除共享。