Удаление общего ресурса
Операция Delete Share удаляет указанный общий ресурс или snapshot общей папки. Этот API полностью поддерживается, но имейте в виду, что это устаревший API управления.
Вместо этого рекомендуется использовать общие папки — удалить . Он предоставляется поставщиком ресурсов хранилища (Microsoft.Storage). Дополнительные сведения о программном взаимодействии с FileShare ресурсами с помощью поставщика ресурсов хранилища см. в разделе Операции с общими папками.
Доступность протокола
| Включенный протокол общей папки | Доступно |
|---|---|
| SMB |  |
| NFS | |
Запрос
Запрос можно создать Delete Share следующим образом. Рекомендуется использовать протокол HTTPS.
| Метод | Универсальный код ресурса (URI) запроса | параметр "Версия HTTP" |
|---|---|---|
DELETE |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
DELETE |
https://myaccount.file.core.windows.net/myshare?sharesnapshot=<DateTime>&restype=share |
HTTP/1.1 |
Замените компоненты пути, показанный в URI запроса, следующим образом:
| Компонент path | Описание |
|---|---|
myaccount |
Имя учетной записи хранения. |
myshare |
Имя файлового ресурса. |
Дополнительные сведения об ограничениях именования путей см. в статье Именование общих папок, каталогов, файлов и метаданных и ссылки на нее.
Параметры универсального кода ресурса (URI)
В URI запроса можно указать следующие дополнительные параметры.
| Параметр | Описание |
|---|---|
sharesnapshot |
Необязательный элемент. Версия 17.04.2017 и более поздняя. Параметр sharesnapshot является непрозрачным значениемDateTime, которое при его наличии указывает общий snapshot для удаления. |
timeout |
Необязательный элемент. Параметр timeout указывается в секундах. Дополнительные сведения см. в разделе Настройка времени ожидания для Файлы Azure операций. |
Заголовки запросов
В следующей таблице перечислены обязательные и необязательные заголовки запросов.
| Заголовок запроса | Описание |
|---|---|
Authorization |
Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure. |
Date или x-ms-date |
Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure. |
x-ms-version |
Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure. |
x-ms-delete-snapshots: { include, include-leased } |
Необязательно, если в общей папке есть связанные моментальные снимки. Укажите один из следующих параметров:
|
x-ms-client-request-id |
Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в разделе Мониторинг Файлы Azure. |
x-ms-lease-id: <ID> |
Требуется, если в целевой общей папке есть активная аренда. Доступно для версии 2020-02-10 и более поздних версий. Если запрос не содержит идентификатор аренды или он недопустим, операция завершается ошибкой с кодом состояния 412 (сбой условия). Если этот заголовок указан, а в общей папке назначения в настоящее время нет активной аренды, операция также завершается ошибкой с кодом состояния 412 (сбой предварительного условия). |
Текст запроса
Нет.
Пример запроса
DELETE https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ= TBD
Ответ
Ответ включает код состояния HTTP и набор заголовков ответа.
Код состояния
Успешная операция возвращает код состояния 202 (принято). Сведения о кодах состояния см. в разделе Коды состояния и ошибок.
Заголовки ответов
Ответ для этой операции включает следующие заголовки. Ответ также может содержать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.
| Заголовок ответа | Описание |
|---|---|
x-ms-request-id |
Этот заголовок однозначно идентифицирует выполненный запрос и может использоваться для устранения неполадок с запросом. Дополнительные сведения см. в разделе Устранение неполадок операций API. |
x-ms-version |
Указывает версию Файлы Azure, используемой для выполнения запроса. |
Date или x-ms-date |
Значение даты и времени в формате UTC, указывающее время, в которое был инициирован ответ. Служба создает это значение. |
x-ms-client-request-id |
Этот заголовок можно использовать для устранения неполадок с запросами и соответствующими ответами. Значение этого заголовка равно значению заголовка x-ms-client-request-id , если он присутствует в запросе. Значение равно не более 1024 видимых символов ASCII. Если заголовок x-ms-client-request-id отсутствует в запросе, этот заголовок не будет присутствовать в ответе. |
Текст ответа
Нет.
Авторизация
Только владелец учетной записи может вызвать эту операцию.
Комментарии
При удалении общей папки нельзя создать общую папку с тем же именем не менее 30 секунд. Во время удаления общей папки попытки повторно создать общую папку с тем же именем завершатся ошибкой с кодом состояния 409 (конфликт). Служба возвращает дополнительные сведения об ошибке, указывающие на удаление общей папки. Все остальные операции во время удаления общего ресурса, включая операции с файлами внутри общего ресурса, завершаются ошибкой и возвращают код состояния 404 (не найдено).
В настоящее время удаление общей папки с моментальными снимками запрещено. Моментальные снимки общего ресурса можно удалить по отдельности или вместе с общей папкой с помощью заголовка x-ms-delete-snapshots=include .
Следует указать x-ms-delete-snapshots только для запроса к ресурсу базового общего ресурса. Если этот заголовок указан в запросе на удаление отдельного snapshot, Файлы Azure возвращает код состояния 400 (недопустимое значение параметра запроса). Если этот заголовок не указан в запросе на удаление и в общей папке есть связанные моментальные снимки, Файлы Azure возвращает код состояния 409 (общий ресурс имеет моментальные снимки).