Delen via

Blob-leases maken en beheren met .NET

  • Artikel

In dit artikel wordt beschreven hoe u blobleases maakt en beheert met behulp van de Azure Storage-clientbibliotheek voor .NET. U kunt de clientbibliotheek gebruiken om blob-leases te verkrijgen, vernieuwen, vrijgeven en verbreken.

Vereisten

Uw omgeving instellen

Als u geen bestaand project hebt, ziet u in deze sectie hoe u een project instelt voor gebruik met de Azure Blob Storage-clientbibliotheek voor .NET. De stappen omvatten pakketinstallatie, het toevoegen van using instructies en het maken van een geautoriseerd clientobject. Zie Aan de slag met Azure Blob Storage en .NET voor meer informatie.

Pakketten installeren

Installeer vanuit uw projectmap pakketten voor de Azure Blob Storage- en Azure Identity-clientbibliotheken met behulp van de dotnet add package opdracht. Het Azure.Identity-pakket is nodig voor verbindingen zonder wachtwoord met Azure-services.

dotnet add package Azure.Storage.Blobs
dotnet add package Azure.Identity

Voeg using-instructies toe

Voeg deze using instructies toe aan het begin van het codebestand:

using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using Azure.Storage.Blobs.Specialized;

Voor sommige codevoorbeelden in dit artikel zijn mogelijk aanvullende using instructies vereist.

Een clientobject maken

Als u een app wilt verbinden met Blob Storage, maakt u een exemplaar van BlobServiceClient. In het volgende voorbeeld ziet u hoe u een clientobject maakt met behulp van DefaultAzureCredential autorisatie:

public BlobServiceClient GetBlobServiceClient(string accountName)
{
    BlobServiceClient client = new(
        new Uri($"https://{accountName}.blob.core.windows.net"),
        new DefaultAzureCredential());

    return client;
}

U kunt een serviceclient registreren voor afhankelijkheidsinjectie in een .NET-app.

U kunt ook clientobjecten maken voor specifieke containers of blobs. Zie Clientobjecten maken en beheren die interactie hebben met gegevensbronnen voor meer informatie over het maken en beheren van clientobjecten.

Autorisatie

Het autorisatiemechanisme moet over de benodigde machtigingen beschikken om te kunnen werken met een blob-lease. Voor autorisatie met Microsoft Entra ID (aanbevolen) hebt u ingebouwde Azure RBAC-rol Opslagblobgegevensbijdrager of hoger nodig. Zie de autorisatierichtlijnen voor Lease Blob (REST API) voor meer informatie.

Over blob-leases

Een lease maakt en beheert een vergrendeling op een blob voor schrijf- en verwijderbewerkingen. De vergrendelingsduur kan 15 tot 60 seconden zijn of kan oneindig zijn. Een lease op een blob biedt exclusieve schrijf- en verwijdertoegang tot de blob. Als u wilt schrijven naar een blob met een actieve lease, moet een client de actieve lease-id met de schrijfaanvraag opnemen.

Zie Leasestatussen en acties voor meer informatie over leasestatussen en wanneer u een bepaalde actie voor een lease kunt uitvoeren.

Alle containerbewerkingen zijn toegestaan voor een container met blobs met een actieve lease, inclusief Delete Container. Daarom kan een container worden verwijderd, zelfs als blobs in deze container actieve leases hebben. Gebruik de leasecontainerbewerking om rechten te beheren om een container te verwijderen.

Leasebewerkingen worden verwerkt door de BlobLeaseClient-klasse , die een client biedt die alle leasebewerkingen voor blobs en containers bevat. Zie Containerleases maken en beheren met .NET voor meer informatie over containerleases met behulp van de clientbibliotheek.

Een lease verkrijgen

Wanneer u een blob-lease verkrijgt, verkrijgt u een lease-id die uw code kan gebruiken om op de blob te werken. Als de blob al een actieve lease heeft, kunt u alleen een nieuwe lease aanvragen met behulp van de actieve lease-id. U kunt echter een nieuwe leaseduur opgeven.

Als u een lease wilt verkrijgen, maakt u een exemplaar van de BlobLeaseClient-klasse en gebruikt u vervolgens een van de volgende methoden:

In het volgende voorbeeld wordt een lease van 30 seconden voor een blob verkregen:

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;
}

Een lease verlengen

U kunt een blob-lease vernieuwen als de lease-id die is opgegeven voor de aanvraag overeenkomt met de lease-id die is gekoppeld aan de blob. De lease kan worden verlengd, zelfs als deze is verlopen, zolang de blob niet opnieuw is gewijzigd of geleased sinds de vervaldatum van die lease. Wanneer u een lease verlengt, wordt de duur van de lease opnieuw ingesteld.

Als u een lease wilt verlengen, gebruikt u een van de volgende methoden op een BlobLeaseClient-exemplaar :

In het volgende voorbeeld wordt een lease voor een blob vernieuwd:

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();
}

Een lease vrijgeven

U kunt een blob-lease vrijgeven als de lease-id die is opgegeven voor de aanvraag overeenkomt met de lease-id die is gekoppeld aan de blob. Door een lease vrij te geven, kan een andere client direct nadat de release is voltooid een lease voor de blob verkrijgen.

U kunt een lease vrijgeven met behulp van een van de volgende methoden op een BlobLeaseClient-exemplaar :

In het volgende voorbeeld wordt een lease op een blob uitgebracht:

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();
}

Een lease onderbreken

U kunt een blob-lease verbreken als de blob een actieve lease heeft. Elke geautoriseerde aanvraag kan de lease verbreken; de aanvraag is niet vereist om een overeenkomende lease-id op te geven. Een lease kan niet worden verlengd nadat deze is verbroken en het verbreken van een lease voorkomt dat een nieuwe lease gedurende een bepaalde periode wordt verkregen totdat de oorspronkelijke lease verloopt of wordt vrijgegeven.

U kunt een lease verbreken met behulp van een van de volgende methoden op een BlobLeaseClient-exemplaar :

In het volgende voorbeeld wordt een lease op een blob verbroken:

public static async Task BreakBlobLeaseAsync(
    BlobClient blobClient)
{
    // Get a BlobLeaseClient object to work with a blob lease
    BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient();

    await leaseClient.BreakAsync();
}

Leasestatussen en -acties

In het volgende diagram ziet u de vijf statussen van een lease en de opdrachten of gebeurtenissen die tot wijzigingen in de leasestatus leiden.

Een diagram met blob-leasestatussen en statuswijzigingstriggers.

De volgende tabel bevat de vijf leasestatussen, geeft een korte beschrijving van elke status en vermeldt de leaseacties die in een bepaalde status zijn toegestaan. Deze leaseacties veroorzaken statusovergangen, zoals wordt weergegeven in het diagram.

Leasestatus Beschrijving Toegestane leaseacties
beschikbaar De lease is ontgrendeld en kan worden verkregen. acquire
Geleasd De lease is vergrendeld. acquire (alleen dezelfde lease-id), renew, change, , releaseen break
Verlopen De duur van de lease is verlopen. acquire, renew, release en break
Breken De lease is verbroken, maar de lease blijft vergrendeld totdat de onderbrekingsperiode is verlopen. release en break
Kapot De lease is verbroken en de onderbrekingsperiode is verlopen. acquire, release en break

Wanneer een lease verloopt, wordt de lease-id onderhouden door de Blob-service totdat de blob opnieuw wordt gewijzigd of opnieuw wordt geleased. Een client kan proberen de lease te verlengen of vrij te geven met behulp van de verlopen lease-id. Als deze bewerking is geslaagd, weet de client dat de blob niet is gewijzigd sinds de lease-id voor het laatst geldig was. Als de aanvraag mislukt, weet de client dat de blob is gewijzigd of dat de blob opnieuw is geleased sinds de lease voor het laatst actief was. De client moet vervolgens een nieuwe lease op de blob verkrijgen.

Als een lease verloopt in plaats van expliciet te worden vrijgegeven, moet een client mogelijk maximaal één minuut wachten voordat een nieuwe lease kan worden verkregen voor de blob. De client kan de lease echter onmiddellijk verlengen met de lease-id als de blob niet is gewijzigd.

Een lease kan niet worden verleend voor een blob-momentopname, omdat momentopnamen alleen-lezen zijn. Het aanvragen van een lease op basis van een momentopname resulteert in statuscode 400 (Bad Request).

Resources

Zie de volgende resources voor meer informatie over het beheren van blob-leases met behulp van de Azure Blob Storage-clientbibliotheek voor .NET.

Codevoorbeelden

REST API-bewerkingen

De Azure SDK voor .NET bevat bibliotheken die zijn gebaseerd op de Azure REST API, zodat u kunt communiceren met REST API-bewerkingen via bekende .NET-paradigma's. De clientbibliotheekmethoden voor het beheren van blob-leases maken gebruik van de volgende REST API-bewerking:

Clientbibliotheekbronnen

Zie ook

Gerelateerde inhoud

  • Dit artikel maakt deel uit van de ontwikkelaarshandleiding voor Blob Storage voor .NET. Zie de volledige lijst met artikelen over ontwikkelaarshandleidingen in Uw .NET-app bouwen voor meer informatie.