Восстановление общей папки
Операция Restore Share восстанавливает (или отменяет) общий ресурс, который ранее был обратимо удален. Этот API полностью поддерживается, но это устаревший API управления. Вместо этого используйте общие папки — восстановление, предоставляемые поставщиком ресурсов хранилища (Microsoft.Storage). Дополнительные сведения о программном взаимодействии с FileShare ресурсами с помощью поставщика ресурсов хранилища см. в статье Операции с общими папками.
Общая папка восстанавливается вместе со всеми ее данными, метаданными и моментальными снимками. Ресурс общего ресурса содержит метаданные и свойства для общей папки.
Доступность протокола
| Включенный протокол общей папки | Доступно |
|---|---|
| SMB |  |
| NFS |  |
Запрос
Запрос можно создать Restore Share следующим образом. Рекомендуется использовать протокол HTTPS.
| Метод | Универсальный код ресурса (URI) запроса | параметр "Версия HTTP" |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/restoredShareName?restype=share&comp=undelete |
HTTP/1.1 |
Замените компоненты пути, показанный в URI запроса, следующим образом:
| Компонент path | Описание |
|---|---|
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 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в разделе Мониторинг Хранилище BLOB-объектов Azure. |
Текст запроса
Нет.
Пример запроса
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, если он присутствует в запросе. Значение равно не более 1024 видимых символов 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
Авторизация
Владелец учетной записи хранения может вызвать эту операцию. Кроме того, эту операцию могут вызывать пользователи с допустимыми маркерами подписанного URL-адреса учетной записи. Маркер должен включать разрешения на запись для ресурса контейнера для авторизации этой операции.
Комментарии
Вы не можете восстановить общую папку с другим именем. Если при восстановлении общей папки существует другой общий ресурс с тем же именем, операция завершается ошибкой с кодом состояния 409 (конфликт). Необходимо сначала удалить общую папку с тем же именем, прежде чем обратимо удаленную общую папку.
При удалении общей папки общая папка с тем же именем не может быть восстановлена в течение по крайней мере 30 секунд. Во время удаления общей папки попытки восстановить общую папку с тем же именем завершаются ошибкой с кодом состояния 409 (конфликт). Служба возвращает дополнительные сведения об ошибке, указывающие на удаление общей папки.