Создание аренды BLOB-объектов и управление ими с помощью .NET
В этой статье показано, как создавать аренды BLOB-объектов и управлять ими с помощью клиентской библиотеки служба хранилища Azure для .NET. Клиентская библиотека может использовать для получения, продления, выпуска и прерывания аренды BLOB-объектов.
Необходимые компоненты
- В этой статье предполагается, что у вас уже есть проект, настроенный для работы с клиентской библиотекой Хранилище BLOB-объектов Azure для .NET. Сведения о настройке проекта, включая установку пакета, добавление
usingдиректив и создание авторизованного клиентского объекта, см. в статье "Начало работы с Хранилище BLOB-объектов Azure и .NET". - Механизм авторизации должен иметь разрешения на работу с арендой BLOB-объектов. Дополнительные сведения см. в руководстве по авторизации для следующей операции REST API:
- Lease Blob (Аренда BLOB-объекта)
Сведения об аренде BLOB-объектов
Аренда создает и управляет блокировкой большого двоичного объекта для операций записи и удаления. Длительность блокировки может составлять 15–60 секунд либо быть бесконечной. Аренда большого двоичного объекта обеспечивает монопольный доступ на запись и удаление большого двоичного объекта. Чтобы записать в большой двоичный объект с активной арендой, клиент должен включить активный идентификатор аренды с запросом на запись.
Дополнительные сведения о состояниях аренды и о том, когда можно выполнить данное действие по аренде, см. в разделе "Состояния аренды" и действия.
Все операции контейнера разрешены в контейнере, включающее большие двоичные объекты с активной арендой, включая удаление контейнера. Поэтому контейнер может быть удален даже в том случае, если в нем есть активные аренды больших двоичных объектов. Используйте операцию "Контейнер аренды" для управления правами на удаление контейнера.
Операции аренды обрабатываются классом BlobLeaseClient , который предоставляет клиенту все операции аренды для больших двоичных объектов и контейнеров. Дополнительные сведения об аренде контейнеров с помощью клиентской библиотеки см. в статье "Создание аренды контейнеров и управление ими с помощью .NET".
Получение аренды
При получении аренды BLOB-объектов вы получите идентификатор аренды, который код может использовать для работы с большим двоичным объектом. Если большой двоичный объект уже имеет активную аренду, можно запросить только новую аренду с помощью активного идентификатора аренды. Однако можно указать новую длительность аренды.
Чтобы получить аренду, создайте экземпляр класса BlobLeaseClient , а затем используйте один из следующих методов:
Следующий пример получает 30-секундную аренду для большого двоичного объекта:
public static async Task<BlobLeaseClient> AcquireBlobLeaseAsync(
BlobClient blobClient)
{
// Get a BlobLeaseClient object to work with a blob lease
BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient();
Response<BlobLease> response =
await leaseClient.AcquireAsync(duration: TimeSpan.FromSeconds(30));
// Use response.Value to get information about the blob lease
return leaseClient;
}
Продление аренды
Вы можете продлить аренду BLOB-объектов, если идентификатор аренды, указанный в запросе, соответствует идентификатору аренды, связанному с большим двоичным объектом. Аренда может быть продлена даже в том случае, если срок его действия истек, если большой двоичный объект не был изменен или арендован еще раз после истечения срока действия этой аренды. При продлении аренды длительность сброса аренды.
Чтобы продлить аренду, используйте один из следующих методов в экземпляре BlobLeaseClient :
В следующем примере возобновляется аренда большого двоичного объекта:
public static async Task RenewBlobLeaseAsync(
BlobClient blobClient,
string leaseID)
{
// Get a BlobLeaseClient object to work with a blob lease
BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient(leaseID);
await leaseClient.RenewAsync();
}
Освобождение аренды
Вы можете освободить аренду BLOB-объектов, если идентификатор аренды, указанный в запросе, соответствует идентификатору аренды, связанному с большим двоичным объектом. Освобождение аренды позволяет другому клиенту получить аренду большого двоичного объекта сразу после завершения выпуска.
Вы можете освободить аренду с помощью одного из следующих методов в экземпляре BlobLeaseClient :
В следующем примере освобождается аренда большого двоичного объекта:
public static async Task ReleaseBlobLeaseAsync(
BlobClient blobClient,
string leaseID)
{
// Get a BlobLeaseClient object to work with a blob lease
BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient(leaseID);
await leaseClient.ReleaseAsync();
}
Прерывание аренды
Вы можете нарушить аренду BLOB-объектов, если большой двоичный объект имеет активную аренду. Любой авторизованный запрос может нарушить аренду; Запрос не требуется для указания соответствующего идентификатора аренды. Аренда не может быть продлена после того, как она нарушена, и разрыв аренды предотвращает получение новой аренды в течение определенного периода времени, пока исходная аренда не истекает или не будет освобождена.
Вы можете разорвать аренду с помощью одного из следующих методов в экземпляре BlobLeaseClient :
В следующем примере прерывается аренда большого двоичного объекта:
public static async Task BreakBlobLeaseAsync(
BlobClient blobClient)
{
// Get a BlobLeaseClient object to work with a blob lease
BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient();
await leaseClient.BreakAsync();
}
Состояния аренды и действия
На следующей схеме показаны пять состояний аренды, а также команды или события, вызывающие изменение состояния аренды.
В следующей таблице перечислены пять состояний аренды, краткое описание каждого из них и список действий аренды, разрешенных в заданном состоянии. Эти действия аренды вызывают переходы состояния, как показано на схеме.
| Состояние аренды | Description | Разрешенные действия аренды |
|---|---|---|
| Доступно | Аренда разблокирована и может быть приобретена. | acquire |
| Аренду | Аренда заблокирована. | acquire (один и тот же идентификатор аренды), renew, change, releaseи break |
| Срок действия истек | Срок аренды истек. | acquire, renew, release и break |
| Нарушение | Аренда была нарушена, но аренда будет по-прежнему заблокирована до истечения периода перерыва. | release и break. |
| Неисправно | Аренда была нарушена, и срок перерыва истек. | acquire, release и break |
По истечении срока аренды идентификатор аренды сохраняется службой BLOB-объектов до тех пор, пока большой двоичный объект не будет изменен или арендован снова. Клиент может попытаться продлить или освободить аренду с помощью идентификатора аренды с истекшим сроком действия. Если эта операция выполнена успешно, клиент знает, что большой двоичный объект не был изменен с момента последнего действия идентификатора аренды. Если запрос завершается ошибкой, клиент знает, что большой двоичный объект был изменен, или большой двоичный объект был арендован снова после последней активности аренды. Затем клиент должен получить новую аренду большого двоичного объекта.
Если срок действия аренды истекает, а не освобождается явным образом, клиенту может потребоваться подождать до одной минуты, прежде чем будет получена новая аренда для большого двоичного объекта. Однако клиент может продлить аренду с идентификатором аренды немедленно, если большой двоичный объект не был изменен.
Аренда не может быть предоставлена для моментального снимка BLOB-объектов, так как моментальные снимки доступны только для чтения. Запрос аренды для моментального снимка приводит к коду 400 (Bad Request)состояния.
Ресурсы
Дополнительные сведения об управлении арендой BLOB-объектов с помощью клиентской библиотеки Хранилище BLOB-объектов Azure для .NET см. в следующих ресурсах.
Операции REST API
Пакет SDK Azure для .NET содержит библиотеки, которые создаются на основе REST API Azure, что позволяет взаимодействовать с операциями REST API через знакомые парадигмы .NET. Методы клиентской библиотеки для управления арендами BLOB-объектов используют следующую операцию REST API:
- Lease Blob (Аренда BLOB-объекта)