Удаление общего ресурса

Операция 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 }	Необязательно, если в общей папке есть связанные моментальные снимки. Укажите один из следующих параметров: include: удалите базовую общую папку и все ее моментальные снимки. include-leased: версия 2020-02-10 и более поздние. Удалите базовую общую папку и все ее моментальные снимки, даже если один или несколько моментальных снимков имеют аренду активных общих папок.
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 (общий ресурс имеет моментальные снимки).

См. также раздел

Операции с общими папками (Файлы Azure)