Containerleases maken en beheren met JavaScript of TypeScript
In dit artikel wordt beschreven hoe u containerleases maakt en beheert met behulp van de Azure Storage-clientbibliotheek voor JavaScript. U kunt de clientbibliotheek gebruiken om containerleases te verkrijgen, vernieuwen, vrijgeven en verbreken.
Vereisten
- In de voorbeelden in dit artikel wordt ervan uitgegaan dat u al een project hebt ingesteld voor gebruik met de Azure Blob Storage-clientbibliotheek voor JavaScript. Zie Aan de slag met Azure Blob Storage en JavaScript voor meer informatie over het instellen van uw project, inclusief pakketinstallatie, het importeren van modules en het maken van een geautoriseerd clientobject voor gebruik met gegevensbronnen.
- Het autorisatiemechanisme moet machtigingen hebben om te kunnen werken met een containerlease. Zie de autorisatierichtlijnen voor de volgende REST API-bewerking voor meer informatie:
Over containerleases
Met een lease wordt een vergrendeling voor een container tot stand brengt en beheerd voor verwijderingsbewerkingen. De vergrendelingsduur kan 15 tot 60 seconden zijn of kan oneindig zijn. Een lease op een container biedt exclusieve verwijderingstoegang tot de container. Een containerlease bepaalt alleen de mogelijkheid om de container te verwijderen met behulp van de bewerking Container REST API verwijderen. Als u een container met een actieve lease wilt verwijderen, moet een client de actieve lease-id met de verwijderaanvraag opnemen. Alle andere containerbewerkingen slagen in een leasecontainer zonder de lease-id. Als u voorlopig verwijderen van containers hebt ingeschakeld, kunt u verwijderde containers herstellen.
Zie Leasestatussen en acties voor meer informatie over leasestatussen en wanneer u een bepaalde actie voor een lease kunt uitvoeren.
Leasebewerkingen worden verwerkt door de BlobLeaseClient-klasse , die een client biedt die alle leasebewerkingen voor blobs en containers bevat. Zie Blob-leases maken en beheren met JavaScript voor meer informatie over blob-leases met behulp van de clientbibliotheek.
Een lease verkrijgen
Wanneer u een containerlease verkrijgt, verkrijgt u een lease-id die uw code kan gebruiken om op de container te werken. Als de container 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 container verkregen:
async function acquireContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.getBlobLeaseClient();
await leaseClient.acquireLease(30);
return leaseClient;
}
Een lease verlengen
U kunt een containerlease vernieuwen als de lease-id die is opgegeven voor de aanvraag overeenkomt met de lease-id die is gekoppeld aan de container. De lease kan worden verlengd, zelfs als deze verloopt, zolang de container niet opnieuw is 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 containerlease vernieuwd:
async function renewContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.renewLease();
}
Een lease vrijgeven
U kunt een containerlease vrijgeven als de lease-id die is opgegeven voor de aanvraag overeenkomt met de lease-id die aan de container is gekoppeld. Door een lease vrij te geven, kan een andere client direct nadat de release is voltooid een lease voor de container 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 voor een container uitgebracht:
async function releaseContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.releaseLease();
}
Een lease onderbreken
U kunt een containerlease verbreken als de container 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 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 voor een container verbroken:
async function breakContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.getBlobLeaseClient();
await leaseClient.breakLease();
}
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.
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 container opnieuw wordt gewijzigd of geleased. Een client kan proberen de lease te verlengen of vrij te geven met behulp van de verlopen lease-id. Als de aanvraag mislukt, weet de client dat de container opnieuw is geleased of dat de container is verwijderd sinds de lease voor het laatst actief was.
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 container. De client kan de lease echter onmiddellijk verlengen met de verlopen lease-id.
Resources
Zie de volgende resources voor meer informatie over het beheren van containerleases met behulp van de Azure Blob Storage-clientbibliotheek voor JavaScript.
Codevoorbeelden
- Voorbeelden van JavaScript- en TypeScript-code weergeven uit dit artikel (GitHub)
REST API-bewerkingen
De Azure SDK voor JavaScript bevat bibliotheken die zijn gebaseerd op de Azure REST API, zodat u kunt communiceren met REST API-bewerkingen via bekende JavaScript-paradigma's. De clientbibliotheekmethoden voor het beheren van containerleases 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 JavaScript/Typescript. Zie de volledige lijst met artikelen over ontwikkelaarshandleidingen in Uw JavaScript-/Typescript-app bouwen voor meer informatie.