Creare e gestire lease di contenitori con JavaScript o TypeScript
Questo articolo illustra come creare e gestire lease di contenitori usando la libreria client di Archiviazione di Azure per JavaScript. È possibile usare la libreria client per acquisire, rinnovare, rilasciare e interrompere lease dei contenitori.
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 per utilizzare un lease di contenitore. Per altre informazioni, vedere il materiale sussidiario relativo all'autorizzazione della seguente operazione API REST:
Informazioni sui lease di contenitori
Un lease stabilisce e gestisce un blocco su un contenitore per le operazioni di eliminazione. La durata del blocco può variare da 15 a 60 secondi o può essere infinita. Un lease su un contenitore fornisce un accesso esclusivo con diritti di eliminazione al contenitore. Il lease del contenitore controlla unicamente la possibilità di eliminare il contenitore tramite l'operazione API REST Delete Container. Per eliminare un contenitore con un lease attivo, un client deve includere l'ID lease attivo con la richiesta di eliminazione. Tutte le altre operazioni hanno esito positivo su un contenitore con lease senza ID del lease. Se è stata abilitata l'eliminazione temporanea dei contenitori, sarà possibile ripristinare i contenitori eliminati.
Per ulteriori informazioni sugli stati dei lease e sapere quando è possibile eseguire una determinata azione su un lease, consultare Stati e azioni dei lease.
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 BLOB tramite la libreria client, vedere Creare e gestire lease di BLOB con JavaScript.
Acquisire un lease
Quando si acquisisce un lease di contenitore, si ottiene un ID del lease che può essere utilizzato dal codice per operare sul contenitore. Se il contenitore ha già un lease attivo, si può fare una richiesta per un nuovo lease soltanto utilizzando 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:
Il seguente esempio acquisisce un lease di 30 secondi per un contenitore:
async function acquireContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.getBlobLeaseClient();
await leaseClient.acquireLease(30);
return leaseClient;
}
Rinnovare un lease
È possibile rinnovare un lease di contenitore se l'ID del lease specificato nella richiesta corrisponde all'ID del lease associato al contenitore. Il lease può essere rinnovato anche se scade, purché il contenitore non sia stato nuovamente leased 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:
Il seguente esempio rinnova un lease di un contenitore:
async function renewContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.renewLease();
}
Rilasciare un lease
È possibile rilasciare un lease di contenitore se l'ID del lease specificato nella richiesta corrisponde all'ID del lease associato al contenitore. Il rilascio di un lease consente a un altro client di acquisire un lease per il contenitore non appena il rilascio è completato.
Per rilasciare un lease, usare uno dei seguenti metodi in un'istanza BlobLeaseClient:
Il seguente esempio rilascia un lease in un contenitore:
async function releaseContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.releaseLease();
}
Interrompere un lease
È possibile interrompere un lease di un contenitore se il contenitore ha 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 interrompe il lease in un contenitore:
async function breakContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.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, il relativo ID viene mantenuto dal servizio BLOB finché il contenitore non viene modificato o gli viene associato un nuovo lease. Un client può provare a rinnovare o rilasciare il lease utilizzando l'ID del lease scaduto. Se la richiesta ha esito negativo, il client sa che il contenitore è stato associato a un nuovo lease o è stato eliminato dall'ultima volta che il lease era attivo.
Se un lease scade anziché essere rilasciato in modo esplicito, è possibile che il client debba attendere fino a un minuto prima di poter acquisire un nuovo lease per il contenitore. Tuttavia, il client può rinnovare immediatamente il lease con l'ID del lease scaduto.
Risorse
Per ulteriori informazioni sulla gestione dei lease di contenitori 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 per gestire i lease di contenitori tramite la libreria client 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.