Lease Container (Аренда контейнера)

Операция Lease Container устанавливает блокировку контейнера для операций удаления и управляет этой блокировкой. Длительность блокировки может составлять 15–60 секунд либо быть бесконечной.

Операцию можно вызвать Lease Container в одном из следующих режимов:

• Acquire — запрос новой аренды;

• Renew — продление существующей аренды;

• Change — изменение идентификатора существующей аренды;

• Release, чтобы освободить аренду, если она больше не нужна, чтобы другой клиент сразу же получил аренду контейнера.

• Break, чтобы завершить аренду, но убедиться, что другой клиент не может приобрести новую аренду, пока не истечет текущий период аренды.

Запрос

Запрос можно создать Lease Container следующим образом. Рекомендуется использовать протокол HTTPS. Замените myaccount именем своей учетной записи хранения.

Чтобы указать корневой контейнер, введите $root в качестве имени контейнера.

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

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

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

Параметры универсального кода ресурса (URI)

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

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

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

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

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

Нет.

Пример запроса

В следующем примере показан запрос на приобретение аренды.

  
Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=lease HTTP/1.1  
  
Request Headers:  
x-ms-version: 2012-02-12  
x-ms-lease-action: acquire  
x-ms-lease-duration: -1  
x-ms-proposed-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
x-ms-date: Thu, 26 Jan 2012 23:30:18 GMT  
Authorization: SharedKey testaccount1:esSKMOYdK4o+nGTuTyeOLBI+xqnqi6aBmiW4XI699+o=  
  

Ответ

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

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

Коды состояния успешного выполнения для операций аренды.

• Acquire: успешная операция возвращает код состояния 201 (создано).

• Renew: успешная операция возвращает код состояния 200 (ОК).

• Change: успешная операция возвращает код состояния 200 (ОК).

• Release: успешная операция возвращает код состояния 200 (ОК).

• Break: успешная операция возвращает код состояния 202 (Принято).

Сведения о кодах состояния см. в разделе Коды состояния и ошибок.

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

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

Текст ответа

Нет.

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

Ниже приведен пример ответа на запрос приобретения аренды.

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402  
x-ms-version: 2012-02-12  
x-ms-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
Date: Thu, 26 Jan 2012 23:30:18 GMT  
  

Авторизация

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

Комментарии

Аренда контейнера обеспечивает монопольный доступ к контейнеру при удалении. Аренда контейнера управляет только возможностью удаления контейнера с помощью операции удаления контейнера . Для удаления контейнера с активной арендой клиент наряду с запросом на удаление должен ввести активный идентификатор аренды. Если идентификатор аренды не включен, операция завершается ошибкой 412 (сбой предварительного условия). Все остальные операции с контейнерами успешно выполняются в арендованном контейнере без включения идентификатора аренды. Аренда предоставляется на период, указанный при получении аренды, который может составлять от 15 до 60 секунд или бесконечное время.

Когда клиент приобретает аренду, возвращается идентификатор аренды. Хранилище BLOB-объектов создает идентификатор аренды, если он не указан в запросе на получение. Клиент может использовать этот идентификатор аренды для продления аренды, изменения идентификатора аренды или освобождения аренды. На следующей схеме показаны возможные состояния аренды, а также команды или события, вызывающие изменение состояния аренды.

Аренда может находиться в одном из пяти штатов в зависимости от того, заблокирована или разблокирована аренда, а также является ли аренда возобновляемой в этом состоянии. Действия аренды, показанные на предыдущей схеме, вызывают переходы состояния.

• Available — аренда разблокирована и может быть приобретена. Допустимое действие: acquire.

• Leased — аренда заблокирована. Допустимые действия: acquire (только с одинаковым идентификатором аренды), renew, change, releaseи break.

• Expired — срок аренды истек. Допустимые действия: acquire, renew, releaseи break.

• Breaking, аренда была нарушена, но аренда будет по-прежнему заблокирована до истечения периода перерыва. Допустимые действия: release и break.

• Broken, аренда была нарушена, а период перерыва истек. Допустимые действия: acquire, releaseи break.

Хранилище BLOB-объектов сохраняет идентификатор аренды после истечения срока аренды контейнера. Клиент может продлить или освободить аренду, используя идентификатор аренды с истекшим сроком действия. Если клиент пытается продлить или освободить аренду с истекшим сроком действия с предыдущим идентификатором аренды и запрос завершается ошибкой, контейнер был снова арендован или удален, так как аренда клиента была последней активной.

Если срок аренды истекает, а не освобождается явным образом, клиенту может потребоваться подождать до одной минуты, прежде чем можно будет получить новую аренду для контейнера. Однако клиент может сразу обновить аренду с идентификатором аренды с истекшим сроком действия.

Свойство контейнера Last-Modified-Time не обновляется вызовами Lease Container.

В следующих таблицах показаны результаты действий с контейнерами с арендой в разных состояниях. Буквы (A), (B) и (C) представляют идентификаторы аренды, а (X) — идентификатор аренды, созданный хранилищем BLOB-объектов.

Результаты действий с контейнерами по состоянию аренды

Результаты операций с контейнерами по состоянию аренды

Выставление счетов

Запросы на ценообразование могут исходить от клиентов, использующих API хранилища BLOB-объектов, напрямую через REST API хранилища BLOB-объектов или из клиентской библиотеки службы хранилища Azure. Эти запросы начисляют плату за каждую транзакцию. Тип транзакции влияет на способ оплаты учетной записи. Например, транзакции чтения начисляются на категорию выставления счетов, отличную от категории операций записи. В следующей таблице показана категория выставления счетов для Lease Container запросов на основе типа учетной записи хранения.

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

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

Авторизация запросов к службе хранилища Azure
Коды состояний и ошибок
Коды ошибок хранилища BLOB-объектов
Аренда BLOB-объекта