Condividi tramite

Creare e gestire lease di contenitori con TypeScript

  • Articolo

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 all'archiviazione BLOB di Azure e a TypeScript.
  • Il meccanismo di autorizzazione deve disporre delle autorizzazioni per utilizzare un lease di contenitore. Per ulteriori informazioni, consultare le linee guida per l'autorizzazione della seguente operazione API REST:

Informazioni sui lease contenitore

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 accesso esclusivo al contenitore per eliminazione. Un lease sul contenitore controlla esclusivamente la possibilità di eliminare il contenitore tramite l'operazione API REST Elimina contenitore. 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 l’ID. Se l'eliminazione temporanea dei contenitori è stata abilitata, è possibile ripristinare i contenitori eliminati.

Per ulteriori informazioni sugli stati di lease e su quando è possibile eseguire una determinata azione in un lease, consultare Stati e azioni di 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 ulteriori informazioni sui lease di BLOB che usano la libreria client, consultare Creare e gestire lease di BLOB con TypeScript.

Acquisire un lease

Quando si acquisisce un lease di un contenitore, si otterrà un ID del lease che può essere usato dal codice per operare sul contenitore. Se il contenitore ha già un lease attivo, è possibile richiedere un nuovo lease solo 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 usare uno dei seguenti metodi:

Il seguente esempio acquisisce un lease di 30 secondi per un contenitore:

async function acquireContainerLeaseAsync(blobContainerClient: ContainerClient) {
  const leaseClient: BlobLeaseClient = blobContainerClient.getBlobLeaseClient();
  await leaseClient.acquireLease(30);
  return leaseClient;
}

Rinnovare un lease

È possibile rinnovare un lease del contenitore se l'ID del lease specificato nella richiesta corrisponde all'ID del lease associato al contenitore. Il lease può essere rinnovato anche se scaduto, purché il contenitore non sia stato associato a un nuovo lease dopo la scadenza di quello corrente. 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: ContainerClient, leaseID: string) {
  const leaseClient: BlobLeaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
  await leaseClient.renewLease();
}

Rilasciare un lease

È possibile rilasciare un lease del contenitore se l'ID lease specificato nella richiesta corrisponde all'ID 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: ContainerClient, leaseID: string) {
  const leaseClient: BlobLeaseClient = 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 BlobLeaseClient:

Il seguente esempio interrompe il lease in un contenitore:

async function breakContainerLeaseAsync(blobContainerClient: ContainerClient, breakPeriod: number) {
  const leaseClient: BlobLeaseClient = blobContainerClient.getBlobLeaseClient();
  await leaseClient.breakLease(breakPeriod);
}

Stati e azioni dei lease

Il seguente diagramma illustra i cinque stati di un lease e i comandi o gli eventi che causano modifiche dello stato del lease.

A diagram showing container lease states and state change triggers.

La seguente tabella elenca i cinque stati di lease, fornisce una breve descrizione di ciascun oggetto 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
Con 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

Dopo la scadenza del lease, il relativo ID viene mantenuto dal servizio BLOB finché il contenitore non viene modificato o finché non viene impostato un nuovo lease. Un client può tentare di rinnovare o rilasciare il lease usando l'ID del lease scaduto. Se la richiesta ha esito negativo, il client sa che il contenitore è stato nuovamente sottoposto a lease o eliminato dopo l’ultima attività del lease.

Se un lease scade anziché essere rilasciato intenzionalmente, il client potrebbe dover 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.

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:

Esempi di codice

Risorse per la libreria client

Vedi anche