Удалить контейнер

Операция Delete Container удаляет указанный контейнер.

запрос

Можно создать запрос Delete Container следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS. Замените myaccount именем учетной записи хранения.

Метод Запрос URI Версия HTTP
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1

URI эмулированной службы хранилища

При отправке запроса к эмулируемой службе хранилища укажите имя узла эмулятора и порт хранилища BLOB-объектов Azure как 127.0.0.1:10000, а затем имя эмулируемой учетной записи хранения.

Метод Запрос URI Версия HTTP
DELETE http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container HTTP/1.1

Дополнительные сведения см. в статье Использование эмулятора Azurite для разработки локального хранилища Azure.

Параметры URI

Вы можете указать следующий дополнительный параметр в URI запроса.

Parameter Description
timeout Optional. Параметр timeout выражается в секундах. Дополнительные сведения см. в статье Настройка времени ожидания для операций с хранилищем BLOB-объектов.

Заголовки запроса

В следующей таблице описаны обязательные и необязательные заголовки запросов.

Заголовок запроса Description
Authorization Required. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
Date или x-ms-date Required. Указывает универсальное время (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
x-ms-lease-id: <ID> Требуется для версии 2012-02-12 и выше, если контейнер имеет активный договор аренды. Чтобы вызвать Delete Container контейнер с активным договором аренды, укажите идентификатор аренды в этом заголовке. Если этот заголовок не указан при активной аренде, Delete Container возвращается ошибка 409 (Conflict). Если вы указали неправильный идентификатор договора аренды или ID на контейнере без активного договора аренды, Delete Container появляется ошибка 412 (предварительное условие не выполнено).
x-ms-version Требуется для всех авторизованных запросов. Указывает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
x-ms-client-request-id Optional. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Настоятельно рекомендуется использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Мониторинг хранилища BLOB-объектов Azure.

Эта операция также поддерживает использование условных заголовков для удаления контейнера только при выполнении заданного условия. Дополнительные сведения см. в разделе Указание условных заголовков для операций хранилища BLOB-объектов.

Текст запроса

Нет.

Образец запроса

Request Syntax:  
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Sun, 25 Sep 2011 21:44:34 GMT  
Authorization: SharedKey devstoreaccount1:t7mf5htNuwLFX9g0S2LDdRtRn1FQzMAluBvHy1QPpnM=

Response

Ответ включает код состояния HTTP и набор заголовков ответа.

Код состояния

Успешная операция возвращает код состояния 202 (принято). Сведения о кодах состояния см. в коды состояния и коды ошибок.

Заголовки ответа

Ответ для этой операции включает следующие заголовки. Ответ также может содержать дополнительные, стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

Заголовок ответа Description
x-ms-request-id Этот заголовок однозначно идентифицирует выполненный запрос и может использоваться для устранения неполадок запроса. Дополнительные сведения см. в разделе Устранение неполадок с операциями API.
x-ms-version Указывает версию хранилища BLOB-объектов, используемую для выполнения запроса. Этот заголовок возвращается для запросов, сделанных с версией 2009-09-19 и более поздними.
Date Значение даты и времени в формате UTC, указывающее время, в течение которого был инициирован ответ. Служба создает это значение.
x-ms-client-request-id Этот заголовок можно использовать для устранения неполадок запросов и соответствующих ответов. Значение этого заголовка равно значению x-ms-client-request-id заголовка, если он присутствует в запросе. Значение составляет не более 1 024 видимых символов ASCII. Если в запросе отсутствует заголовок x-ms-client-request-id, этот заголовок не будет присутствовать в ответе.

Основная часть ответа

Нет.

Пример ответа

Response Status:  
HTTP/1.1 202 Accepted  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-Type: application/xml  
Date: Sun, 25 Sep 2011 21:45:00 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Authorization

Авторизация требуется при вызове любой операции доступа к данным в службе хранилища Azure. Вы можете авторизовать операцию Delete Container, как описано ниже.

Important

Корпорация Майкрософт рекомендует использовать идентификатор Microsoft Entra с управляемыми удостоверениями для авторизации запросов в службу хранилища Azure. Идентификатор Microsoft Entra обеспечивает более высокую безопасность и удобство использования по сравнению с авторизацией общего ключа.

служба хранилища Azure поддерживает использование идентификатора Microsoft Entra для авторизации запросов к данным BLOB-объектов. С помощью идентификатора Microsoft Entra можно использовать управление доступом на основе ролей Azure (Azure RBAC) для предоставления разрешений субъекту безопасности. Субъект безопасности может быть пользователем, группой, субъектом-службой приложений или управляемым удостоверением Azure. Принципал безопасности проходит проверку подлинности с помощью Microsoft Entra ID, чтобы вернуть токен OAuth 2.0. Затем токен можно использовать для авторизации запроса к службе Blob.

Дополнительные сведения об авторизации с помощью идентификатора Microsoft Entra см. в статье Авторизация доступа к большим двоичным объектам с помощью идентификатора Microsoft Entra ID.

Permissions

Ниже приведены действия RBAC, необходимые для пользователя Microsoft Entra, группы, управляемого удостоверения или субъекта-службы для вызова операции Delete Container и минимально привилегированной встроенной роли Azure RBAC, которая включает в себя следующее:

Дополнительные сведения о назначении ролей с помощью Azure RBAC см. в статье Назначение роли Azure для доступа к данным BLOB-объектов.

Remarks

Когда контейнер удаляется, контейнер с таким же названием не может быть создан как минимум 30 секунд. Контейнер может быть недоступен более 30 секунд, если служба по-прежнему обрабатывает запрос. Пока контейнер удаляется, попытки создать контейнер с тем же именем с кодом статуса 409 (Конфликт) неудачны. Служба указывает, что контейнер удаляется. Операции с блобами внутри контейнера, включая чтение и запись, могут продолжать выполняться успешно до 30 секунд после принятия запроса на удаление. После этого периода все операции с контейнером и его blob-ами заканчиваются с кодом статуса 404 (не найден).

Billing

Плата за запросы за учетные записи хранения не взимается Delete Container .

См. также

Коды статуса иошибокХранилище BLOB-объектов errorcodesУказание условных заголовков для операций Хранилище BLOB-объектов

  • Last updated on