Creare e gestire lease blob con JavaScript o TypeScript
Questo articolo illustra come creare e gestire lease di BLOB usando la libreria client di Archiviazione di Azure per JavaScript. È possibile usare la libreria client per acquisire, rinnovare, rilasciare e interrompere i lease di BLOB.
Prerequisiti
- Gli esempi in questo articolo presuppongono che sia già stato configurato un progetto per l'uso con la libreria client di Archiviazione BLOB di Azure per JavaScript. Per informazioni sulla configurazione del progetto, incluse l'installazione del pacchetto, l'importazione di moduli e la creazione di un oggetto client autorizzato per l'uso con le risorse dati, consultare Introduzione ad Archiviazione BLOB di Azure e JavaScript.
- Il meccanismo di autorizzazione deve disporre delle autorizzazioni necessarie per usare un lease di BLOB. Per maggiori informazioni, consultare il materiale sussidiario per l'autorizzazione per l'operazione API REST seguente:
Informazioni sui lease di BLOB
Un lease crea e gestisce un blocco su un BLOB per operazioni di scrittura ed eliminazione. La durata del blocco può variare da 15 a 60 secondi o può essere infinita. Un lease su un BLOB fornisce un accesso esclusivo per scrittura ed eliminazione al BLOB. Per scrivere su un BLOB con un lease attivo, un client deve includere l'ID del lease attivo con la richiesta di scrittura.
Per ulteriori informazioni sugli stati di lease e su quando è possibile eseguire una determinata azione su un lease, consultare Stati di lease e azioni.
Su un contenitore che include BLOB con un lease attivo, sono consentite tutte le operazioni dei contenitori, inclusa l'operazione Delete Container. Pertanto, un contenitore può essere eliminato anche se i BLOB al suo interno presentano lease attivi. Usare l'operazione Lease Container per controllare i diritti di eliminazione di un contenitore.
Le operazioni di lease sono gestite dalla classe BlobLeaseClient, che fornisce un client contenente tutte le operazioni di lease per BLOB e contenitori. Per altre informazioni sui lease di contenitori tramite la libreria client, consultare Creare e gestire lease di contenitori con JavaScript.
Acquisire un lease
Quando si acquisisce un lease di un BLOB, si ottiene un ID lease che può essere usato dal codice per operare sul BLOB. Se il BLOB ha già un lease attivo, è possibile richiedere un nuovo lease soltanto usando l'ID del lease attivo. Tuttavia, è possibile specificare una nuova durata del lease.
Per acquisire un lease, creare un‘istanza della classe BlobLeaseClient, quindi utilizzare uno dei seguenti metodi:
L'esempio seguente acquisisce un lease di 30 secondi per un BLOB:
async function acquireBlobLeaseAsync(blobClient) {
const leaseClient = blobClient.getBlobLeaseClient();
await leaseClient.acquireLease(30);
return leaseClient;
}
Rinnovare un lease
È possibile rinnovare il lease di un BLOB se l'ID del lease specificato nella richiesta corrisponde all'ID del lease associato al BLOB. Il lease può essere rinnovato anche se scade, purché il BLOB non sia stato modificato o sottoposto nuovamente a lease dopo la scadenza del lease. Quando si rinnova un lease, la durata del lease viene reimpostata.
Per rinnovare un lease, usare uno dei seguenti metodi in un'istanza BlobLeaseClient:
L'esempio seguente mostra il rinnovo di un lease per un BLOB:
async function renewBlobLeaseAsync(blobClient, leaseID) {
const leaseClient = blobClient.getBlobLeaseClient(leaseID);
await leaseClient.renewLease();
}
Rilasciare un lease
È possibile rilasciare il lease di un BLOB se l'ID del lease specificato nella richiesta corrisponde all'ID del lease associato al BLOB. Il rilascio di un lease consente a un altro client di acquisire un lease per il BLOB non appena il rilascio viene completato.
È possibile rilasciare un lease usando uno dei metodi seguenti in un'istanza BlobLeaseClient di JavaScript:
Il seguente esempio rilascia un lease su un BLOB:
async function releaseBlobLeaseAsync(blobClient, leaseID) {
const leaseClient = blobClient.getBlobLeaseClient(leaseID);
await leaseClient.releaseLease();
}
Interrompere un lease
È possibile interrompere un lease di BLOB se il BLOB presenta un lease attivo. Qualsiasi richiesta autorizzata può interrompere il lease; non è necessario che nella richiesta sia specificato un ID del lease corrispondente. Dopo essere stato interrotto, un lease non può essere rinnovato e l'interruzione impedisce l'acquisizione di un nuovo lease fino alla scadenza o al rilascio del lease originale.
Per interrompere un lease, usare uno dei seguenti metodi in un'istanza di BlobLeaseClient:
Il seguente esempio mostra l’interruzione di un lease in un BLOB:
async function breakBlobLeaseAsync(blobClient) {
const leaseClient = blobClient.getBlobLeaseClient();
await leaseClient.breakLease();
}
Azioni e stati dei lease
Il diagramma seguente illustra i cinque stati di un lease e i comandi o gli eventi che causano modifiche dello stato del lease.
La tabella seguente elenca i cinque stati di lease, fornisce una breve descrizione di ognuno di essi ed elenca le azioni di lease consentite in un determinato stato. Queste azioni di lease causano transizioni di stato, come illustrato nel diagramma.
| Stato lease | Descrizione | Azioni di lease consentite |
|---|---|---|
| Disponibile | Il lease è sbloccato e può essere acquisito. | acquire |
| Sottoposto a lease | Il lease è bloccato. | acquire (solo stesso ID del lease), renew, change, release e break |
| Scaduta | La durata del lease è scaduta. | acquire, renew, release e break |
| Interruzione | Il lease è stato interrotto, ma rimarrà bloccato fino alla scadenza del periodo di interruzione. | release e break |
| Interrotto | Il lease è stato interrotto e il periodo di interruzione è scaduto. | acquire, release e break |
Quando un lease scade, l’ID lease viene mantenuto dal servizio BLOB finché il BLOB non viene modificato o nuovamente sottoposto a lease. Un client può provare a rinnovare o rilasciare il lease usando l'ID lease scaduto. Se l'operazione ha esito positivo, il client sa che il BLOB non è stato modificato dall'ultima volta che l'ID è stato ritenuto valido. Se la richiesta ha esito negativo, il client sa che il BLOB è stato modificato o nuovamente associato a un lease dall’ultima validità del lease. Il client deve quindi acquisire un nuovo lease sul BLOB.
Se un lease scade anziché essere rilasciato in modo esplicito, è possibile che un client debba attendere fino a un minuto prima di poter acquisire un nuovo lease per il BLOB. Tuttavia, se il BLOB non è stato modificato, il client può rinnovare subito il lease con il relativo ID lease.
Non è possibile concedere un lease per uno snapshot del BLOB, poiché gli snapshot sono di sola lettura. La richiesta di un lease per uno snapshot risulterà nel codice di stato 400 (Bad Request).
Risorse
Per maggiori informazioni sulla gestione dei lease di BLOB tramite la libreria client di Archiviazione BLOB di Azure per JavaScript, consultare le seguenti risorse.
Esempi di codice
- Visualizzare esempi di codice JavaScript e TypeScript di questo articolo (GitHub)
Operazioni dell'API REST
Azure SDK per JavaScript contiene librerie basate sull'API REST di Azure che consentono di interagire con le operazioni dell'API REST tramite paradigmi noti di JavaScript. I metodi della libreria client per gestire i lease di BLOB usano la seguente operazione API REST:
Risorse della libreria client
- Documentazione di riferimento della libreria client
- Codice sorgente della libreria client
- Pacchetto (npm)
Vedi anche
Contenuto correlato
- Questo articolo fa parte della guida per sviluppatori di Archiviazione BLOB per JavaScript/TypeScript. Per altre informazioni, vedere l'elenco completo degli articoli della guida per sviluppatori in Creare l'app JavaScript/TypeScript.